Skip to content

Commit 5d0a8e1

Browse files
committed
Final edits
1 parent 9a6fb1c commit 5d0a8e1

File tree

1 file changed

+54
-59
lines changed

1 file changed

+54
-59
lines changed

docs/DeveloperGuide.md

Lines changed: 54 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -143,7 +143,7 @@ The `Storage` component,
143143

144144
### Common classes
145145

146-
Classes used by multiple components are in the `seedu.addressbook.commons` package.
146+
Classes used by multiple components are in the `seedu.address.commons` package.
147147

148148
--------------------------------------------------------------------------------------------------------------------
149149

@@ -491,7 +491,7 @@ Priorities: High (must have) - `* * *`, Medium (nice to have) - `* *`, Low (unli
491491

492492
### Use cases
493493

494-
(For all use cases below, the **IMS** is the `ImmuniMate system` and the **Healthcare worker** is the `user`, unless specified otherwise)
494+
(For all use cases below, the **IMS** is the `ImmuniMate system` and the **Healthcare Worker** is the `user`, unless specified otherwise)
495495

496496
**Use Case: UC01 - Create Patient Profile**
497497

@@ -534,9 +534,9 @@ Priorities: High (must have) - `* * *`, Medium (nice to have) - `* *`, Low (unli
534534
**Use Case: UC02 - Read Patient Profile**
535535

536536
- **Actor:** Healthcare Worker
537-
- **Description:** Healthcare worker reads patient profile in the ImmuniMate Address Book System.
537+
- **Description:** Healthcare worker reads patient profile in the IMS.
538538
- **Preconditions:** Healthcare worker has logged into the system.
539-
- **Guarantees:** Existing patient profile in the ImmuniMate Address Book System is successfully displayed.
539+
- **Guarantees:** Existing patient profile in the IMS is successfully displayed.
540540
- **MSS:**
541541
1. Healthcare worker choose to read a patient profile.
542542
2. IMS requests the necessary detail for reading patient profile (NRIC).
@@ -572,7 +572,7 @@ Priorities: High (must have) - `* * *`, Medium (nice to have) - `* *`, Low (unli
572572
**Use Case: UC03 - Find Patient Information**
573573

574574
- **Actor:** Healthcare Worker
575-
- **Description:** Healthcare worker searches for specific patient information in the ImmuniMate Address Book System.
575+
- **Description:** Healthcare worker searches for specific patient information in the IMS.
576576
- **Preconditions:** Healthcare worker has logged into the system.
577577
- **Guarantees:** Relevant patient information is displayed for the healthcare worker to view.
578578
- **Basic Flow:**
@@ -590,9 +590,9 @@ Priorities: High (must have) - `* * *`, Medium (nice to have) - `* *`, Low (unli
590590
**Use Case: UC04 - Update Patient Information**
591591

592592
- **Actor:** Healthcare Worker
593-
- **Description:** Healthcare worker updates a patient's information in the ImmuniMate Address Book System.
593+
- **Description:** Healthcare worker updates a patient's information in the IMS.
594594
- **Preconditions:** Healthcare worker has logged into the system and has selected the patient whose information needs to be updated.
595-
- **Guarantees:** Patient's information is successfully updated in the ImmuniMate Address Book System.
595+
- **Guarantees:** Patient's information is successfully updated in the IMS.
596596
- **Basic Flow:**
597597
1. Healthcare worker chooses to update a certain patient’s certain information.
598598
2. IMS validates the new content.
@@ -612,9 +612,9 @@ Priorities: High (must have) - `* * *`, Medium (nice to have) - `* *`, Low (unli
612612
**Use Case: UC05 - Delete Patient Profile**
613613

614614
- **Actor:** Healthcare worker
615-
- **Description:** Healthcare worker deletes a patient's record from the ImmuniMate Address Book System.
615+
- **Description:** Healthcare worker deletes a patient's record from the IMS.
616616
- **Preconditions:** Healthcare worker has opened the app and has selected the patient whose record needs to be deleted.
617-
- **Guarantees:** Patient's record is successfully deleted from the ImmuniMate Address Book System.
617+
- **Guarantees:** Patient's record is successfully deleted from the IMS System.
618618
- **MSS:**
619619
1. Healthcare worker choose to delete a specified patient’s record.
620620
2. IMS validates the NRIC and deletes the patient's record from the database.
@@ -630,9 +630,9 @@ Priorities: High (must have) - `* * *`, Medium (nice to have) - `* *`, Low (unli
630630
**Use Case: UC06 - Delete Patient Information**
631631

632632
- **Actor:** Healthcare Worker
633-
- **Description:** Healthcare worker deletes specific information from a patient's record in the ImmuniMate Address Book System.
633+
- **Description:** Healthcare worker deletes specific information from a patient's record in the IMS.
634634
- **Preconditions:** Healthcare worker has logged into the system and has selected the patient whose information needs to be deleted.
635-
- **Guarantees:** Specified information is successfully deleted from the patient's record in the ImmuniMate Address Book System.
635+
- **Guarantees:** Specified information is successfully deleted from the patient's record in the IMS.
636636
- **MSS:**
637637
1. Healthcare worker chooses to delete certain fields of a certain patient's profile.
638638
2. IMS validates the information to be deleted and deletes the specified information from the patient's record in the database.
@@ -662,9 +662,9 @@ Priorities: High (must have) - `* * *`, Medium (nice to have) - `* *`, Low (unli
662662

663663

664664
- **Actor:** Healthcare Worker
665-
- **Description:** Healthcare worker adds a visit record for a patient in the ImmuniMate Address Book System.
665+
- **Description:** Healthcare worker adds a visit record for a patient in the IMS.
666666
- **Preconditions:** Healthcare worker has logged into the system.
667-
- **Guarantees:** A new visit record is successfully added for the patient in the ImmuniMate Address Book System.
667+
- **Guarantees:** A new visit record is successfully added for the patient in the IMS.
668668
- **Main Success Scenario (MSS):**
669669
1. Healthcare worker chooses to add a new patient visit.
670670
2. IMS requests the necessary details for the visit (NRIC, date of visit, diagnosis, symptoms, status).
@@ -699,15 +699,14 @@ Priorities: High (must have) - `* * *`, Medium (nice to have) - `* *`, Low (unli
699699
- *a2. Healthcare Worker confirms the cancellation.
700700
- Use case ends.
701701

702-
703702
---
704703

705704
**Use Case: UC08 - Check Patient Visit History**
706705

707706
- **Actor:** Healthcare Worker
708-
- **Description:** Healthcare worker checks patient visit history in the ImmuniMate Address Book System.
707+
- **Description:** Healthcare worker checks patient visit history in the IMS.
709708
- **Preconditions:** Healthcare worker has logged into the system.
710-
- **Guarantees:** Existing patient visit history in the ImmuniMate Address Book System is successfully displayed.
709+
- **Guarantees:** Existing patient visit history in the IMS is successfully displayed.
711710
- **MSS:**
712711
1. Healthcare worker choose to check a patient visit history.
713712
2. IMS requests the necessary detail for checking patient visit history (NRIC).
@@ -737,49 +736,53 @@ Priorities: High (must have) - `* * *`, Medium (nice to have) - `* *`, Low (unli
737736
*a2. Healthcare Worker confirms the cancellation.
738737
Use case ends.
739738

739+
---
740740

741-
### Non-Functional Requirements
742-
743-
1. Should work on any _mainstream OS_ as long as it has Java `11` or above installed.
744-
2. Should be able to hold up to 1000 persons without a noticeable sluggishness in performance for typical usage.
745-
*{More to be added}*
746-
747-
Data Requirements:
748-
* the app should have high data persistency
749-
750-
Environment Requirements:
751-
* the app should work on both 32-bit and 64-bit environments
752-
753-
Accessibility:
754-
* the app should be easily downloaded from websites/app stores, and need no prior setup
755-
756-
Capacity:
757-
* the app should be able to store 10000 profiles
758-
* the app should not exceed 10GB in storage space
741+
**Use Case: UC09 - Finding Clusters**
759742

760-
Compliance with regulations:
761-
* personal data collection on the app should adhere to the Personal Data Protection Act (PDPA)
743+
- **Actor:** Healthcare Worker
744+
- **Description:** Healthcare worker tries to identify disease clusters through data in the ImmuniMate System.
745+
- **Preconditions:** Healthcare worker has logged into the system.
746+
- **Guarantees:** There is at least 1 patient profile saved in IMS.
747+
- **MSS:**
748+
1. Healthcare worker wants to find disease clusters/potential disease clusters.
749+
2. IMS requests Healthcare Worker for relevant details.
750+
3. Healthcare worker enters integer, location and illness.
751+
4. IMS validates the entered data and displays all patients at that location unwell with the illness.
752+
- **Extensions:**
762753

763-
Extensibility:
764-
* the app should enable new profile fields to be added easily
765-
* the app should be convenient to expand its capacity when needed
754+
3a. IMS detects an error in the entered data (invalid cluster size).
766755

767-
Interoperability:
768-
* the app should be compatible with Windows, MacOS, Linux platforms
756+
* 3a1. IMS shows the conflicting existing entry
757+
* 3a2. IMS requests for the correct data.
758+
* 3a3. Healthcare Worker enters data with valid cluster size.<br>
759+
Steps 3a1-3a3 are repeated until the data entered are correct, or the user cancels the action.
760+
Use case resumes from step 4.
769761

770-
Maintainability:
771-
* the app should use automated testing
762+
3b. IMS detects an error in the entered data (empty location).
772763

773-
Performance requirements:
774-
* the app should respond to queries within 1 second
764+
* 3b1. IMS requests for the correct data.
765+
* 3b2. Healthcare Worker enters data with valid location.<br>
766+
Steps 3b1-3b2 are repeated until the data entered are correct.
767+
Use case resumes from step 4.
775768

776-
Process requirements:
777-
* the project should adhere to a schedule to deliver new features fortnightly
778-
* the project should aim to solve bugs found in one version by the next version
769+
### Non-Functional Requirements
779770

780-
Quality requirements:
781-
* the app should be usable by doctors/nurses/receptionists with limited guidance
782-
* the app should be faster to use by typing queries than using the mouse
771+
1. Should work on any _mainstream OS_ as long as it has Java `11` or above installed.
772+
2. Should be able to hold up to 10000 persons without a noticeable sluggishness in performance for typical usage.
773+
3. Should have high data persistency.
774+
4. Should work on both 32-bit and 64-bit environments.
775+
5. Should be easily downloaded from websites/app stores, and need no prior setup besides downloading Java 11.
776+
6. Should not exceed 100MB in storage space.
777+
7. Data collection on the app should adhere to the Personal Data Protection Act (PDPA).
778+
8. Unimplemented fields should be added easily.
779+
9. Should be convenient to expand storage capacity of the app when needed.
780+
10. Should use automated testing.
781+
11. Should respond to queries within 1 second.
782+
12. Project should adhere to a schedule to deliver new features fortnightly.
783+
13. Project should aim to solve bugs found in one version by the next version.
784+
14. Should be usable by doctors/nurses/receptionists with limited guidance.
785+
15. Should be faster to use by typing queries than using the mouse.
783786

784787
### Glossary
785788

@@ -995,14 +998,6 @@ testers are expected to do more *exploratory* testing.
995998
1. Test case: `check S1234567A`<br>
996999
Expected: The result panel shows the details of the checked person's visit history. The list panel shows the checked person.
9971000

998-
### Saving data
999-
1000-
1. Dealing with missing/corrupted data files
1001-
1002-
1. _{explain how to simulate a missing/corrupted file, and the expected behavior}_
1003-
1004-
1. _{ more test cases …​ }_
1005-
10061001
<div style="page-break-after: always;"></div>
10071002

10081003
## Planned enhancements

0 commit comments

Comments
 (0)