RapidTracer

RapidTracer offers a fast-paced user interface (UI) for clinic managers to handle contacts and appointments. It combines:

• a simple and intuitive UI;
• swift navigation through complex patient data and contact histories;
• the ability to load and store large datasets; and is
• quick to use for fast typers!

This guide provides a walkthrough on how to use RapidTracer to assist you in your clinical workflows, starting from patient in-processing.

Quick start and installation

This section covers the download and installation process for RapidTracer.

1. Ensure you have Java 11 or above installed on your computer.
2. Download the latest version of RapidTracer.jar here.
3. Copy the file to the folder you want to store all RapidTracer data in.
4. Open a command terminal and navigate to the folder where RapidTracer.jar is located using the cd FOLDER_NAME command. Use the java -jar RapidTracer.jar command to start running RapidTracer.

If you encounter any issues running RapidTracer, you may refer to the detailed bug fixing here. Note that RapidTracer is intended to be used in fullscreen and some text may not show if the display window is re-sized to the minimum size.

Using RapidTracer

1. Input parameters
2. Registering patients and appointments
3. Searching existing records
4. Tracing close contacts
5. Editing and deleting records
6. Importing and exporting patient records
7. Clear
8. General help

1. Input parameters

The table below lists all input parameters and their possible values.

2. Registering patients and appointments

There are three ways you can register new patients and schedule new appointments.

1. Use the add command to register a new patient.
2. Use the addappt command to schedule a new appointment for an existing patient.
3. Use the add command to register a new patient and schedule an appointment immediately.

2.1. Use the add command to register a new patient

You can add new patients to our database with the add command. Each patient must minimally have a name and a phone number for administrative purposes.

Format: add n/NAME p/PHONE_NUMBER [a/ADDRESS] [t/TAG]
Example(s): add n/Min Rei p/87654321, add n/Min Rei p/87654321 a/UTown, add n/Min Rei p/87654321 t/COVID
Result of add n/Min Rei p/87654321 t/COVID:

• Parameters may be typed in any order.
• If you want to add multiple tags, please use multiple [t/TAG].

2.2. Use the addappt command to schedule a new appointment for an existing patient

Format: addappt PATIENT_INDEX d/DATE_TIME
Example(s): addappt 1 d/today 3pm-4pm, addappt 1 d/16/10/2024 3pm-4pm
Result of addappt 1 d/16/10/2024 3pm-4pm:

• Adds an appointment to the patient at the specified PATIENT_INDEX.
• Examples of accepted DATE_TIME:
  • 24/03/2024 10am-2pm
  • 24/03/2024 10AM-2PM
  • 24/03/2024 10am - 2pm
  • today 10am-2pm (this will create an appointment from 10am to 2pm with today's date)
  • tdy 10am-2pm (this will create an appointment from 10am to 2pm with today's date)

2.3. Use the add command to register a new patient and schedule an appointment immediately

For walk-in appointments, you can also create a new contact and add an appointment with a single command. This command automatically creates an appointment linked to the patient which is being added.

Format: add n/NAME p/PHONE_NUMBER [a/ADDRESS] [t/TAG] [d/DATE_TIME]
Example(s): add n/Boyd Anderson p/87654321 d/tdy 11am-12pm
Result of add n/Boyd Anderson p/87654321 d/tdy 11am-12pm:

• Parameters may be typed in any order.
• If you want to add multiple tags, please use multiple t/.
• Appointments cannot end on a different day from when they start.
• If you try to add multiple appointments by using multiple d/ in one single add command, only the appointment with the last specified DATE_TIME will be registered.
• Examples of accepted DATE_TIME:
  • 24/03/2024 10am-2pm
  • 24/03/2024 10AM-2PM
  • 24/03/2024 10am - 2pm
  • today 10am-2pm (this will create an appointment from 10am to 2pm with today's date)
  • tdy 10am-2pm (this will create an appointment from 10am to 2pm with today's date)

3. Searching existing records

RapidTracer offers search functions for both patient and appointment data. Beyond searching for specific patients and appointments, RapidTracer offers a list view to see all patient and appointment records. To reset the list view in both patient and appointment records, simply press the "Reset" button next to the search bar.

Searching for contacts: find

Shows a list of contacts in RapidTracer matching the keywords provided. The contact only needs to partially match any of the keywords provided.

Format: find KEYWORD [MORE_KEYWORDS]
Example(s): find min rei
Result of find min rei:

• The KEYWORD search is case-insensitive.
• Searches for the following patient information:
  • NAME
  • PHONE_NUMBER
  • ADDRESS

Finding appointment: findappt

Shows a list of appointments in RapidTracer matching the keywords provided. The appointment only needs to partially match any of the keywords provided.

Format: findappt KEYWORD [MORE_KEYWORDS]
Example(s): findappt min rei
Result of findappt min rei:

• The KEYWORD search is case-insensitive.
• Order of keywords does not matter.
• Searches for the following appointment information:
  • NAME of patient

Alternatively, simply double click any patient card to show the appointments associated with the patient.

Listing contacts: list

Shows a list of all patients in RapidTracer.

Format: list
Example(s): list
Result of list:

Listing appointments: listappt

Shows a list of all appointments in RapidTracer.

Format: listappt Example(s): listappt
Result of listappt:

4. Tracing close contacts

Performs contact tracing on the selected appointment. This shows a list of appointments that overlap with the selected appointment. This shows a list of patients that attended those appointments.

Format: trace APPT_INDEX
Example(s): trace 1
Result of trace 1:

• Traces the appointment at the specified APPT_INDEX.
• 2 Appointments are also considered overlapping if one appointment start at the same time as the other one ends.

Alternatively, simply double click any appointment card to trace all close contacts.

5. Editing and deleting records

In the event that patients update their contact details or reschedule an appointment, their details can be updated accordingly. RapidTracer also allows you to cancel appointments and delete patient records.

Editing contacts: edit

An existing patient's details can be updated in RapidTracer using the edit command. Note that only patient details are changed. Their corresponding appointments will also be updated.

Format: edit PATIENT_INDEX [n/NAME] [p/PHONE_NUMBER] [a/ADDRESS] [t/TAG]
Example(s): edit 1 p/12345678, edit 1 a/NUS UTown
Result of edit 1 a/NUS UTown:

• Edits the patient's details at the specified PATIENT_INDEX.
• Only one PATIENT_INDEX can be specified at a time.
• At least one of the optional fields must be provided.
• Existing values will be updated to input values.

Editing appointment: editappt

An appointment can be rescheduled with the editappt command to change the date and time of the appointment.

Format: editappt APPT_INDEX d/DATE_TIME
Example(s): editappt 1 d/tdy 5pm-6pm
Result of editappt 1 d/tdy 5pm-6pm:

• Edits the appointment's details at the specified APPT_INDEX.
• Only one APPT_INDEX can be specified at a time.
• Existing values will be updated to input values.
• The format of "DATE_TIME" is dd/mm/yyyy [x]am-[y]pm. Examples of accepted "DATE_TIME":
  • 24/03/2024 10am-2pm
  • 24/03/2024 10AM-2PM
  • 24/03/2024 10am - 2pm
  • today 10am-2pm (this will create an appointment from 10am to 2pm with today's date)
  • tdy 10am-2pm (this will create an appointment from 10am to 2pm with today's date)

Deleting patients: delete

In the event that a patient requests for their data to be deleted, you can use the delete command to remove their patient information.

Format: delete PATIENT_INDEX
Example(s): delete 2
Result of delete 2:

• Deletes the patient at the specified PATIENT_INDEX.
• Only one PATIENT_INDEX can be specified at a time.

Deleting appointments: deleteappt

In the event that an appointment is cancelled, you can delete it using the deleteappt command.

Format: deleteappt APPT_INDEX
Example(s): deleteappt 1
Result of deleteappt 1:

• Deletes the appointment at the specified APPT_INDEX.
• Only one APPT_INDEX can be specified at a time.

6. Importing and exporting patient records

Importing patient records: import

You can import patient data from a csv file.

Format: import i/./data/FILENAME.csv
Example(s): import i/./data/FILENAME.csv
Result of import i/./data/PatientData.csv:

Patient Data file:

Import command executed:

• The csv file should be formatted in a way that it only contains 4 columns with specific headings as shown above. If the patient does not have an address or a tag, please insert "NIL" before importing.
• If you want to add multiple tags for the same patient, please use ; to separate the tags.
• Please save your patient data file under the data directory created when you launch RapidTracer in an empty file.
• Enter the command stated above with "FILENAME" replaced by the name of csv file you have, e.g. import i/./data/sample.csv.

Exporting patient records: export

You can export existing patient data to a csv file stored in a specific location.

Format: export
Example(s): export
Result of export:

Export command executed:

After export:

• Create a directory named data (if it doesn't exist) in the directory RapidTracer launched from.
• Create a new csv file named PatientData.csv in the data directory.
• The pre-existing data in the csv file will be overwritten once you perform the export action.

7. Clearing data

Clearing all records: clear

Format: clear
Example(s): clear
Result of clear:

8. General help

Viewing help: help

For general help, click the Help option in the top left corner and click Help again, or type help to open the help window. The help window contains a link that directs to this current User Guide.

Format: help
Example(s): help
Result of help:

Exiting/closing RapidTracer: exit

To properly exit RapidTracer, click the File option in the top left corner and click Exit, or type exit. This will ensure that the data is saved properly.

Format: exit
Example(s): exit

FAQ

Q: How do I upload records into RapidTracer?
A: Use the import command!

Q: How do I download all my records from RapidTracer?
A: Use the export command!

Q: A command is not working, what am I doing wrong?
A: You can refer to the user guide above. If you're still having issues, please drop us an email at minrei.seah@u.nus.edu to let us know what's wrong.

Q: I still have an unanswered question!
A: Please drop us an email at minrei.seah@u.nus.edu

Known issues

1. When using multiple screens, if you move the application to a secondary screen, and later switch to using only the primary screen, the app will open off-screen. The remedy is to delete the preferences.json file created by the application before running the application again.

2. Overlapping appointments between different patients is allowed currently because we are working with the assumption that there are multiple doctors at the clinic to attend to different patients.

3. Reset button currently does not remove the focus on Patient and Appointment cards.

Command summary