Developer Guide
- Acknowledgements
- Setting up, getting started
- Design
- Implementation
- Documentation, logging, testing, configuration, dev-ops
- Appendix: Requirements
- Appendix: Instructions for manual testing
- Appendix: Planned Enhancements
Acknowledgements
- Existing AB3 code structure and implementation was referenced for new TutorRec features.
Setting up, getting started
Refer to the guide Setting up and getting started.
Design
.puml
files used to create diagrams in this document docs/diagrams
folder. Refer to the PlantUML Tutorial at se-edu/guides to learn how to create and edit diagrams.
Architecture
The Architecture Diagram given above explains the high-level design of the App.
Given below is a quick overview of main components and how they interact with each other.
Main components of the architecture
Main
(consisting of classes Main
and MainApp
) is in charge of the app launch and shut down.
- At app launch, it initializes the other components in the correct sequence, and connects them up with each other.
- At shut down, it shuts down the other components and invokes cleanup methods where necessary.
The bulk of the app’s work is done by the following four components:
-
UI
: The UI of the App. -
Logic
: The command executor. -
Model
: Holds the data of the App in memory. -
Storage
: Reads data from, and writes data to, the hard disk.
Commons
represents a collection of classes used by multiple other components.
How the architecture components interact with each other
The Sequence Diagram below shows how the components interact with each other for the scenario where the user issues the command delete 1
.
Each of the four main components (also shown in the diagram above),
- defines its API in an
interface
with the same name as the Component. - implements its functionality using a concrete
{Component Name}Manager
class (which follows the corresponding APIinterface
mentioned in the previous point.
For example, the Logic
component defines its API in the Logic.java
interface and implements its functionality using the LogicManager.java
class which follows the Logic
interface. Other components interact with a given component through its interface rather than the concrete class (reason: to prevent outside component’s being coupled to the implementation of a component), as illustrated in the (partial) class diagram below.
The sections below give more details of each component.
UI component
The API of this component is specified in Ui.java
The UI consists of a MainWindow
that is made up of parts e.g.CommandBox
, ResultDisplay
, PersonListPanel
, StatusBarFooter
etc. All these, including the MainWindow
, inherit from the abstract UiPart
class which captures the commonalities between classes that represent parts of the visible GUI.
PersonCard
strictly represents a UI element depicting a Person
object as found in the Model
component.
ResultDisplay
is used to display any kind of output generated by commands. This includes command execution success/fail messages, command execution results and help messages. Command execution results vary depending on the command executed.
The UI
component uses the JavaFx UI framework. The layout of these UI parts are defined in matching .fxml
files that are in the src/main/resources/view
folder. For example, the layout of the MainWindow
is specified in MainWindow.fxml
The UI
component,
- executes user commands using the
Logic
component. - listens for changes to
Model
data so that the UI can be updated with the modified data. - keeps a reference to the
Logic
component, because theUI
relies on theLogic
to execute commands. - depends on some classes in the
Model
component, as it displaysPerson
object residing in theModel
.
Logic component
API : Logic.java
Here’s a (partial) class diagram of the Logic
component:
The sequence diagram below illustrates the interactions within the Logic
component, taking execute("delete 1")
API call as an example.
DeleteCommandParser
should end at the destroy marker (X) but due to a limitation of PlantUML, the lifeline continues till the end of diagram.
How the Logic
component works:
- When
Logic
is called upon to execute a command, it is passed to anAddressBookParser
object which in turn creates a parser that matches the command (e.g.,DeleteCommandParser
) and uses it to parse the command. - This results in a
Command
object (more precisely, an object of one of its subclasses e.g.,DeleteCommand
) which is executed by theLogicManager
. - The command can communicate with the
Model
when it is executed (e.g. to delete a person).
Note that although this is shown as a single step in the diagram above (for simplicity), in the code it can take several interactions (between the command object and theModel
) to achieve. - The result of the command execution is encapsulated as a
CommandResult
object which is returned back fromLogic
.
Here are the other classes in Logic
(omitted from the class diagram above) that are used for parsing a user command:
How the parsing works:
- When called upon to parse a user command, the
AddressBookParser
class creates anXYZCommandParser
(XYZ
is a placeholder for the specific command name e.g.,AddCommandParser
) which uses the other classes shown above to parse the user command and create aXYZCommand
object (e.g.,AddCommand
) which theAddressBookParser
returns back as aCommand
object. - All
XYZCommandParser
classes (e.g.,AddCommandParser
,DeleteCommandParser
, …) inherit from theParser
interface so that they can be treated similarly where possible e.g, during testing.
Model component
API : Model.java
The Model
component,
- stores the address book data i.e., all
Person
objects (which are contained in aUniquePersonList
object) and all associatedAppointment
objects (which are contained in aDisjointAppointmentList
). - stores the currently ‘selected’
Person
objects (e.g., results of a search query) as a separate filtered list which is exposed to outsiders as an unmodifiableObservableList<Person>
that can be ‘observed’ e.g. the UI can be bound to this list so that the UI automatically updates when the data in the list change. - stores a
UserPref
object that represents the user’s preferences. This is exposed to the outside as aReadOnlyUserPref
objects. - does not depend on any of the other three components (as the
Model
represents data entities of the domain, they should make sense on their own without depending on other components)
Storage component
API : Storage.java
The Storage
component,
- can save both address book data and user preference data in JSON format, and read them back into corresponding objects.
- inherits from both
AddressBookStorage
andUserPrefStorage
, which means it can be treated as either one (if only the functionality of only one is needed). - depends on some classes in the
Model
component (because theStorage
component’s job is to save/retrieve objects that belong to theModel
)
Common classes
Classes used by multiple components are in the seedu.addressbook.commons
package.
Implementation
This section describes some noteworthy details on how certain features are implemented.
Managing appointments
Implementation
A core feature of TutorRec is the ability to add appointments to a contact.
Appointments are added with the field (/ap
) when doing an add
or edit
command, for instance:
-
add n/John Doe /ap 12:00-13:00 MON
will add a person with the name “John Doe” and an appointment on Monday from 12:00 to 13:00 to the contact list.
The following diagram describes the process of adding a valid Person appointment with the add
command:
The appointments, after being parsed, are stored in a list of appointments within Person
.
This is implemented as an AppointmentList
field.
To prevent appointment overlap, we check both
-
Appointment
overlap withinPerson
’sAppointmentList
and -
Appointment
overlap between the appointments inAppointmentList
and the existing appointments inModel
.
Note that certain details, such as other fields in a Person
have been omitted for brevity.
Design Considerations
All existing appointments are stored in Model
in a DisjointAppointmentList
. We chose to make this distinction between
AppointmentList
and DisjointAppointmentList
to allow for easy utility of AppointmentList
in storing and working with
parsed appointments.
Notes for students
Implementation
TutorRec is able to add notes to each student. They are added as a field (/nt
) when doing an add
or edit
command, so something similar to:
edit 1 /nt "This student is very good at math, but struggles with English."
will edit the person on index 1 to have the note “This student is very good at math, but struggles with English.”
Duplicate contacts
Implementation
In TutorRec, contacts are uniquely identified by their names. No two contacts can have the exact same name, ensuring that duplicate contacts are not created.
Case Insensitivity: Contact names in TutorRec are not case-sensitive. For example, ‘John Doe’ and ‘JOhn dOE’ are treated as the same name.
Whitespace Sensitivity: Unlike case sensitivity, whitespaces in names do affect differentiation. Thus, ‘Mary Anne’ and ‘Maryanne’ are recognized as distinct names due to the difference in whitespace.
Handling Potential Duplicates: Whenever a user attempts to add or edit a contact, TutorRec checks for names that might be similar by ignoring differences in case or whitespace. If a potential duplicate is detected, the user is warned when the contact is added.
Contact Information Flexibility: Unlike names, a contact’s phone number and email address do not have to be unique in TutorRec. This allows for scenarios where a single contact detail, such as a phone number or email, might be associated with multiple contacts, such as a parent with several children enrolled. This design decision facilitates easier management of family-related records, ensuring that it is permissible for different contacts to share identical contact information.
Listing Students
Implementation
TutorRec is also able to list all current students in the address book. Note that the command list
does not modify the address book. Additionally, it does not take in any extra parameters. It can be simply called as follows:
-
list
will show all current students in the address book in thePersonListPanel
The example shown below will describe the process for listing all students during the list
command.
[Proposed] Undo/redo feature
Proposed Implementation
The proposed undo/redo mechanism is facilitated by VersionedAddressBook
. It extends AddressBook
with an undo/redo history, stored internally as an addressBookStateList
and currentStatePointer
. Additionally, it implements the following operations:
-
VersionedAddressBook#commit()
— Saves the current address book state in its history. -
VersionedAddressBook#undo()
— Restores the previous address book state from its history. -
VersionedAddressBook#redo()
— Restores a previously undone address book state from its history.
These operations are exposed in the Model
interface as Model#commitAddressBook()
, Model#undoAddressBook()
and Model#redoAddressBook()
respectively.
Given below is an example usage scenario and how the undo/redo mechanism behaves at each step.
Step 1. The user launches the application for the first time. The VersionedAddressBook
will be initialized with the initial address book state, and the currentStatePointer
pointing to that single address book state.
Step 2. The user executes delete 5
command to delete the 5th person in the address book. The delete
command calls Model#commitAddressBook()
, causing the modified state of the address book after the delete 5
command executes to be saved in the addressBookStateList
, and the currentStatePointer
is shifted to the newly inserted address book state.
Step 3. The user executes add n/David …
to add a new person. The add
command also calls Model#commitAddressBook()
, causing another modified address book state to be saved into the addressBookStateList
.
Model#commitAddressBook()
, so the address book state will not be saved into the addressBookStateList
.
Step 4. The user now decides that adding the person was a mistake, and decides to undo that action by executing the undo
command. The undo
command will call Model#undoAddressBook()
, which will shift the currentStatePointer
once to the left, pointing it to the previous address book state, and restores the address book to that state.
currentStatePointer
is at index 0, pointing to the initial AddressBook state, then there are no previous AddressBook states to restore. The undo
command uses Model#canUndoAddressBook()
to check if this is the case. If so, it will return an error to the user rather
than attempting to perform the undo.
The following sequence diagram shows how an undo operation goes through the Logic
component:
UndoCommand
should end at the destroy marker (X) but due to a limitation of PlantUML, the lifeline reaches the end of diagram.
Similarly, how an undo operation goes through the Model
component is shown below:
The redo
command does the opposite — it calls Model#redoAddressBook()
, which shifts the currentStatePointer
once to the right, pointing to the previously undone state, and restores the address book to that state.
currentStatePointer
is at index addressBookStateList.size() - 1
, pointing to the latest address book state, then there are no undone AddressBook states to restore. The redo
command uses Model#canRedoAddressBook()
to check if this is the case. If so, it will return an error to the user rather than attempting to perform the redo.
Step 5. The user then decides to execute the command list
. Commands that do not modify the address book, such as list
, will usually not call Model#commitAddressBook()
, Model#undoAddressBook()
or Model#redoAddressBook()
. Thus, the addressBookStateList
remains unchanged.
Step 6. The user executes clear
, which calls Model#commitAddressBook()
. Since the currentStatePointer
is not pointing at the end of the addressBookStateList
, all address book states after the currentStatePointer
will be purged. Reason: It no longer makes sense to redo the add n/David …
command. This is the behavior that most modern desktop applications follow.
The following activity diagram summarizes what happens when a user executes a new command:
Design considerations:
Aspect: How undo & redo executes:
-
Alternative 1 (current choice): Saves the entire address book.
- Pros: Easy to implement.
- Cons: May have performance issues in terms of memory usage.
-
Alternative 2: Individual command knows how to undo/redo by
itself.
- Pros: Will use less memory (e.g. for
delete
, just save the person being deleted). - Cons: We must ensure that the implementation of each individual command are correct.
- Pros: Will use less memory (e.g. for
Documentation, logging, testing, configuration, dev-ops
Appendix: Requirements
Product scope
Target user profile:
- busy home tutor for primary school students
- has a need to manage a large number of students
- prefer desktop apps over other types
- can type fast
- prefers typing to mouse interactions
- is reasonably comfortable using CLI apps
Value proposition: provides easy access to client info and organizes it in an efficient and readable way for day-to-day use, optimized for tutors that prefer CLI.
User stories
Priorities: High (must have) - * * *
, Medium (nice to have) - * *
, Low (unlikely to have) - *
Priority | As a … | I want to … | So that I can… |
---|---|---|---|
* * |
new home tutor | have adding information be intuitive and logical | use the app without hassle |
* * |
new user | have a quick start guide | learn how to use the app |
* * |
new home tutor | follow a set syllabus for my clients | |
* * |
new home tutor | be able to quickly create a student’s profile with their relevant information | |
* * |
new home tutor | track the performance of my students | prove to their parents that they are improving and my effectiveness as a tutor |
* * * |
new home tutor | track all my appointments | reduce the chance I forget or double book myself |
* * |
new home tutor | keep track of my finances–such as which client has paid me for my work over a month | reduce my stress when it comes to keeping track of who has paid me for my work, and so forth. |
* * |
busy home tutor | seamlessly create new tasks | quickly and efficiently set up my daily routine |
* * |
busy home tutor | be reminded about my upcoming appointments for the day | not accidentally forget |
* * |
returning home tutor | re-implementation of more information in a large amount to be easy | add information en masse without stress |
* * |
home tutor with clients who are nearing exam season | properly ensure that they are improving as planned, and also allow them to set benchmarks that I can remember | |
* * |
busy home tutor | block certain times out for lunch and dinner | not accidentally overwrite those times with an additional client |
* * * |
experienced home tutor | delete students I am no longer teaching on TutorRec | unclutter my interface |
* * * |
experienced home tutor | update student information and details | ensure accurate records are maintained |
* * * |
passionate home tutor | TutorRec to keep notes for each student | tailor my teaching style accordingly |
* * |
experienced home tutor with many students | ability to categorise students by skill level, subject or group (p1, p2, p3…) | quickly locate their information when needed |
* * |
experienced home tutor | flexibility to choose what to teach my students (custom lessons) | personalise each lesson for different students |
* * |
experienced home tutor | easily identify students with weak performance | focus on weaker students |
* * |
experienced home tutor | view a student’s records for the length of time I have tutored them | |
* * |
experienced home tutor | get some insights and analytics on a student’s performance over time | further refine my teaching methods accordingly |
* * |
busy home tutor | quickly reschedule my appointments with my clients | fit my ever-changing schedule, preventing a large amount of hassle |
* * |
tutor who just received a new wave of clients | separate my old and new clients | keep the interface orderly and easy-to-follow |
* * * |
busy home tutor | make quick notes about my students | keep track of information specific to each client |
* * |
assignment-ridden home tutor | note cancellations in my schedule due to increased workload from my end | my schedule is accurate to reality |
* * |
wary home tutor | backup and import data | safeguard myself against potential data corruption and/or physical destruction of my devices |
* * |
home tutor with a new device | quickly transfer data from one device to another | prevent the pain of having to input previous data manually |
* * |
online tutor | organize sessions with students in a different country and automatically convert dates and times to my time zone | |
* * |
online home tutor | keep Zoom links with sessions and other information about the student in one place | |
* * |
online home tutor with students who are abroad | convert time at a glance | be on time for my student’s lessons |
* * * |
home tutor who just moved abroad | remove previous clients I cannot tutor due to the distance gap | keep my schedule clean |
* * |
home tutor who just moved abroad | ways of tagging my students | keep track of different needs arising due to cultural differences |
Use cases
(For all use cases below, the System is the TutorRec
and the Actor is the user
, unless specified otherwise)
Use case: Delete a student
MSS
- User requests to list students
- TutorRec shows a list of students
- User requests to delete a specific student in the list
-
TutorRec deletes the student
Use case ends.
Extensions
-
2a. The list is empty.
Use case ends.
-
3a. The given index is invalid.
-
3a1. TutorRec shows an error message.
Use case resumes at step 2.
-
Use case: Viewing appointments
MSS
- User requests to view current appointments for the day
-
TutorRec shows a list of appointments for the day
Use case ends.
Extensions
-
1a. The list is empty.
Use case ends.
-
1b. User inputs an invalid day format as an input.
- 1b1. TutorRec shows an error message.
Use case ends.
Use case: Sorting students
MSS
- User requests to view students of a particular category
-
TutorRec shows a filtered list containing only students with this category
Use case ends.
Extensions
-
1a. The list is empty.
Use case ends.
-
1b. The given category does not have any students assigned to it.
- 1b1. TutorRec shows an empty list.
Use case ends.
-
1c. User inputs an invalid category.
- 1c1. TutorRec shows an error message.
Use case ends.
Use case: Editing a student’s details
MSS
- User requests to list students
- TutorRec displays a list of students
- User requests to edit the details of a specific student in the list
- TutorRec updates the details of this student
-
TutorRec displays the updated information of this student
Use case ends.
Extensions
-
2a. The list is empty.
Use case ends.
-
3a. The given index is invalid.
-
3a1. TutorRec shows an error message.
Use case resumes at step 2.
-
-
3b. User inputs a field that does not exist (e.g. adding a nonexistent /q field).
-
3b1. TutorRec shows an error message.
Use case resumes at step 2.
-
Use case: Finding a student
MSS
- User requests to list all students with a particular name
-
TutorRec displays a reduced list containing all students that meet the criteria of the name requested
Use case ends.
Extensions
-
1a. The list is empty.
Use case ends.
-
1b. No students exist with the given name.
-
1b1. TutorRec displays an empty list.
Use case ends.
-
Use case: Checking improvements of a student
MSS
- User requests to list students
- TutorRec displays a list of students
- User updates a specific student’s grades for a given test
- TutorRec updates the grades for this student
- TutorRec displays that the student’s grades has been updated
- User requests to view a list of a specific student’s grades
-
TutorRec displays a history of this student’s grades
Use case ends.
Extensions
-
2a. The list is empty.
Use case ends.
-
3a. The given index is invalid.
-
3a1. TutorRec shows an error message.
Use case resumes at step 2.
-
-
3b. An invalid score is listed as the input.
-
3b1. TutorRec shows an error message.
Use case resumes at step 2.
-
-
6a. The given index is invalid.
-
6a1. TutorRec shows an error message.
Use case resumes at step 2.
-
-
6b. The student has no grades saved.
-
6b1. TutorRec displays nothing.
Use case resumes at step 2.
-
Use case: Updating payment status
MSS
- User requests to list students
- TutorRec displays a list of students
- User chooses to mark a specific student as having made their payment
- TutorRec updates the payment status of this student to be complete
- User chooses to mark a specific as not having made their payment
-
TutorRec updates the payment status of this student to be incomplete
Use case ends.
Extensions
-
2a. The list is empty.
Use case ends.
-
3a. The given index is invalid.
-
3a1. TutorRec shows an error message.
Use case resumes at step 2.
-
-
3b. The student selected already has had their payment marked as made.
-
3b1. TutorRec shows an error message.
Use case resumes at step 2.
-
-
5a. The given index is invalid.
-
5a1. TutorRec shows an error message.
Use case resumes at step 2.
-
-
5b. The student selected already has had their payment marked as made.
-
5b1. TutorRec shows an error message.
Use case resumes at step 2.
-
Use case: Creating an appointment
MSS
- User requests to list students
- TutorRec displays a list of students
- User sets a specific student to have an appointment at a particular time and date
- TutorRec updates details about this student
-
TutorRec displays details of appointment to user
End of use case.
Extensions
-
2a. The list is empty.
Use case ends.
-
3a. The given index is invalid.
-
3a1. TutorRec shows an error message.
Use case resumes at step 2.
-
-
3b. Insufficient information is given to make an appointment.
-
3b1. TutorRec shows an error message.
Use case resumes at step 2.
-
-
3c. The time and date inputted by the user clashes with an existing appointment previously made by the user.
- 3c1. TutorRec shows an error message.
-
3c2. TutorRec displays information of student which has an appointment that resulted in the timing clash, and the date and time of this appointment.
Use case resumes at step 2.
Non-Functional Requirements
- TutorRec should work on any mainstream OS as long as it has Java
11
or above installed. - TutorRec should be able to hold up to 1000 persons without a noticeable sluggishness in performance for typical usage.
- A user with above average typing speed for regular English text (i.e. not code, not system admin commands) should be able to accomplish most of the tasks faster using commands than using the mouse.
- TutorRec is not required to handle multiple users (i.e. multi-user product); it is a single-user product.
- TutorRec needs to be developed in a breadth-first incremental manner, with weekly updates.
- TutorRec’s data should be stored locally and should be in a human editable text file.
- TutorRec should not use a DBMS to store data.
- TutorRec should work without requiring an installer.
- TutorRec should be packaged into a single JAR file for releases.
- TutorRec’s JAR files should not exceed 100MB.
- The development of TutorRec should follow the Object-oriented paradigm.
- TutorRec should be able to respond within three seconds.
- TutorRec should be designed to function offline.
- TutorRec should not require additional hardware beyond standard computing devices (e.g., desktops, laptops, tablets) commonly availabe to users.
Glossary
- Mainstream OS: Windows, Linux, Unix, MacOS
- Private contact detail: A contact detail that is not meant to be shared with others
Appendix: Instructions for manual testing
Given below are instructions to test the app manually.
Launch and shutdown
-
Initial launch
-
Download the jar file and copy into an empty folder
-
Open a terminal inside the folder containing the jar file and run
java -jar tutorrec.jar
Expected: Shows the GUI with a set of sample persons. The window size may not be optimum.
-
-
Saving window preferences
-
Resize the window to an optimum size. Move the window to a different location. Close the window.
-
Re-launch the app by running
java -jar tutorrec.jar
in the folder containing the jar file.
Expected: The most recent window size and location is retained.
-
-
Shutting down
- Use the
exit
command or click on the close window button on the title bar of TutorRec.
- Use the
Deleting a person
-
Deleting a person while all persons are being shown
-
Prerequisites: List all persons using the
list
command. Multiple persons in the list. -
Test case:
delete 1
Expected: First contact is deleted from the list. Details of the deleted contact shown in the status message. Timestamp in the status bar is updated. -
Test case:
delete 0
Expected: No person is deleted. Error details shown in the status message. Status bar remains the same. -
Other incorrect delete commands to try:
delete
,delete x
,...
(where x is larger than the list size)
Expected: Similar to previous.
-
Viewing all appointments / appointments on a specific day
- Viewing all appointments
- Prerequisites: TutorRec is running and contains persons with appointments. Each day of the week has at least 1 appointment belonging to any person. The current displayed list of persons is displaying all persons.
- Test case:
appointments
Expected: All appointments of the persons currently displayed in the list are displayed.
- Viewing appointments on a specific day
- Prerequisites: TutorRec is running and contains persons with appointments. There is at least one appointment scheduled on Monday belonging to any person in the current displayed list.
- Test case:
appointments MON
Expected: Appointments scheduled on Monday of the persons current displayed in the list are displayed.
Viewing details of a person
- Viewing details of a person currently displayed in the list
- Prerequisites: There is at least one person in the current displayed list.
- Run
view 1
.
Expected: All details of the person are displayed in the window on the right.
Saving data
-
Dealing with missing data file
- Open a terminal and run
java -jar tutorrec.jar
in the folder containing the jar file. This will cause TutorRec to generate a data folder containing addressbook.json which stores all person data. - Exit TutorRec.
- Delete the addressbook.json file in the data folder.
- Run
java -jar tutorrec.jar
in the terminal again.
Expected: TutorRec regenerates the data file containing some sample persons.
- Open a terminal and run
Appendix: Planned Enhancements
Team Size: 5
- Standardize display of person’s contact details with other fields when missing information: Currently when a person is missing contact information such as phone number, email and address, the view command shows ‘—’ instead of just ‘-‘ like other fields when there’s no information. This will be changed in a future version to show the same ‘-‘ as other fields when information is missing.
- Improve UI to handle extremely long tags going out of UI bounds: Currently when a tag contains a string that is extremely long, it will stretch beyond the boundary of the person list. This will be improved in a future version to allow the tag to wrap around to display the full tag.
- Set a limit to the length of a name: Currently TutorRec is capable of accepting a name of any length. This causes issues when the name entered is excessively long, resulting in it being not displayed properly in the UI. Setting a limit on the length of a name will prevent it from being cut-off in the UI.
-
Fix the
find
command to be reflective of the current list: Currently, thefind
command properly filters the user list when the command is typed, but does not respond todelete
commands properly. For example, if a person “David” is searched for in the list, andfind David
is used, then it currently will properly display a filtered list with “David” in it. Suppose David has index 1.- If
delete 1
is used, the filtered list will incorrectly still list David as still being in the list of contacts. - If
edit 1 [some edits]
is used, the filtered list will incorrectly completely reset to show the entire full list, with or without David. - In either case, any command to modify the list should properly interact with the previous
find
command, so it should remove David as part of the contact list ifdelete
is used, or continue showing the filtered list ifedit
is used, and so forth.
- If
-
Improve error message handling: Currently, there are certain user-inputted errors which are not properly reflected in TutorRec. For example, typing
edit 1 n/
is properly identified as an invalid command (as a person must not have their name removed), but the feedback given by TutorRec is that names should only be alphanumeric, and should not be blank - which is technically correct, but does not communicate sufficiently with the user that theName
field cannot be removed inedit
. - Improve appointment conflict detection: Currently, TutorRec disallows conflicting appointments, that is to say, appointments that overlap at a particular time on a particular day. This however, does not account for special cases where the timing of an appointment is different for two days but on the same day, (For example, two appointments, one on the current Sunday, and one on the next Sunday, the former from 1400-1700 and the latter at 1500-1800 is marked as a conflict.) and so an improvement to TutorRec’s way of detecting conflicting appointments could improve user experience.
-
Allow special characters as part of names: Currently, TutorRec strictly allows only alphanumeric characters to be part of a name. However, this does not account for people with special characters as part of their legal names, such as the use of
s/o
and-
. This improvement would allow for accurate recording of names. -
Improve consistency of multiple prefixes: Currently, TutorRec accepts multiple arguments for certain prefixes. For example, users can have multiple prefixes for
subject
,edit 4 s/ENGLISH s/MATH
resulting in the student having both subjects. However, for thenote
andlevel
prefixes, TutorRec allows multiple prefixes but only takes the last argument.edit 4 l/p1 l/p6
results in the student having only thep6
level assigned. To improve on this, we can enhance the consistency of accepting multiple prefixes across all commands in the project. - Enable resizing of TutorRec: Currently, TutorRec is not resizable as a window. This change would improve user experience.
- Improve duplicate name detection in TutorRec: Presently, TutorRec permits additional white spaces between names, such as ‘John Doe’, which is distinguished as a separate name from ‘John Doe’. We can refine duplicate name detection by devising a more robust algorithm to address this issue and efficiently identify near matches.