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
interfacewith the same name as the Component. - implements its functionality using a concrete
{Component Name}Managerclass (which follows the corresponding APIinterfacementioned 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
Logiccomponent. - listens for changes to
Modeldata so that the UI can be updated with the modified data. - keeps a reference to the
Logiccomponent, because theUIrelies on theLogicto execute commands. - depends on some classes in the
Modelcomponent, as it displaysPersonobject 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
Logicis called upon to execute a command, it is passed to anAddressBookParserobject which in turn creates a parser that matches the command (e.g.,DeleteCommandParser) and uses it to parse the command. - This results in a
Commandobject (more precisely, an object of one of its subclasses e.g.,DeleteCommand) which is executed by theLogicManager. - The command can communicate with the
Modelwhen 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
CommandResultobject 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
AddressBookParserclass creates anXYZCommandParser(XYZis a placeholder for the specific command name e.g.,AddCommandParser) which uses the other classes shown above to parse the user command and create aXYZCommandobject (e.g.,AddCommand) which theAddressBookParserreturns back as aCommandobject. - All
XYZCommandParserclasses (e.g.,AddCommandParser,DeleteCommandParser, …) inherit from theParserinterface 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
Personobjects (which are contained in aUniquePersonListobject) and all associatedAppointmentobjects (which are contained in aDisjointAppointmentList). - stores the currently ‘selected’
Personobjects (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
UserPrefobject that represents the user’s preferences. This is exposed to the outside as aReadOnlyUserPrefobjects. - does not depend on any of the other three components (as the
Modelrepresents 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
AddressBookStorageandUserPrefStorage, which means it can be treated as either one (if only the functionality of only one is needed). - depends on some classes in the
Modelcomponent (because theStoragecomponent’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 MONwill 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
-
Appointmentoverlap withinPerson’sAppointmentListand -
Appointmentoverlap between the appointments inAppointmentListand 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:
-
listwill 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
11or 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.jarin the folder containing the jar file.
Expected: The most recent window size and location is retained.
-
-
Shutting down
- Use the
exitcommand 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
listcommand. 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.jarin 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.jarin 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
findcommand to be reflective of the current list: Currently, thefindcommand properly filters the user list when the command is typed, but does not respond todeletecommands properly. For example, if a person “David” is searched for in the list, andfind Davidis used, then it currently will properly display a filtered list with “David” in it. Suppose David has index 1.- If
delete 1is 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
findcommand, so it should remove David as part of the contact list ifdeleteis used, or continue showing the filtered list ifeditis 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 theNamefield 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/oand-. 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/MATHresulting in the student having both subjects. However, for thenoteandlevelprefixes, TutorRec allows multiple prefixes but only takes the last argument.edit 4 l/p1 l/p6results in the student having only thep6level 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.