CulinaryContacts is a desktop app for managing contacts and reservations in your restaurant, optimized for use via a Command Line Interface (CLI) while still having the benefits of a Graphical User Interface (GUI). If you can type fast, CulinaryContacts can get your contact/reservation management tasks done faster than traditional GUI apps.
Ensure you have Java 11
or above installed in your Computer.
Download the latest culinarycontacts.jar
from here.
Copy the file to the folder you want to use as the home folder for CulinaryContacts.
Open a command terminal, cd
into the folder you put the jar file in, and use the java -jar culinarycontacts.jar
command to run the application.
A GUI similar to the below should appear in a few seconds. Note how the app contains some sample data.
Type the command in the command box and press Enter to execute it. e.g. typing help
and pressing Enter will open the help window.
Some example commands you can try:
list
: Lists all contacts.
add n/John Doe p/98765432 e/johnd@example.com a/John street, block 123, #01-01
: Adds a contact named John Doe
to CulinaryContacts.
delete 3
: Deletes the 3rd contact shown in the current list.
clear
: Removes all persons and reservations.
exit
: Exits the app.
Refer to the Features below for details of each command.
Component | Description |
---|---|
Command Box | Here is where you enter commands to perform actions within the app. |
Result Display | After executing commands in the Command Box, the Result Display shows the outcomes of your actions. This includes confirmation messages as well as command execution success and failure messages. |
Active Tab | The tab that is underlined is known as the active tab. This indicates whether the contacts list or the archived list is displayed in the Contacts Panel. |
Contacts Panel | This panel contains a list of Contact Cards. |
Reservation Panel | This panel contains a list of Reservation Cards. |
Component | Description |
---|---|
Contact Index Number | The INDEX used in edit , delete and rsv commands. |
Tags | Tags are used for finding persons with the filter command. |
NAME
, PHONE_NUMBER
, ADDRESS
and EMAIL
on the contact card will be truncated if they are too long, to maintain neatness. The character limit before truncation is sufficient for most inputs so normal usage is not hindered.Component | Description |
---|---|
Reservation Index Number | The INDEX used in the rsvdel command. |
Expiry Flag | The expiry flag indicates if the date and time of the reservation is after the date and time when the application is launched, or after the date and time when rsvsort is invoked. |
NAME
, PHONE_NUMBER
and reservation's PAX
on the reservation card will be truncated if they are too long, with the same reason as above.DATE
on the reservation card is in dd/MM/yyyy format.Important terms:
Notes about the command format:
Words in UPPER_CASE
are the parameters to be supplied by the user.
e.g. in add n/NAME
, NAME
is a parameter which can be used as add n/John Doe
.
Items in square brackets are optional.
e.g n/NAME [t/TAG]
can be used as n/John Doe t/friend
or as n/John Doe
.
Items with …
after them can be used multiple times.
e.g. [t/TAG]…
can be used as t/supplier
, t/seafood t/supplier
etc.
Parameters can be in any order.
e.g. if the command specifies n/NAME p/PHONE_NUMBER
, p/PHONE_NUMBER n/NAME
is also acceptable.
Extraneous parameters for commands that do not take in parameters (help
, list
, exit
, clear
, alist
, rsvsort
) will be ignored.
e.g. if the command specifies help 123
, it will be interpreted as help
.
If you are using a PDF version of this document, be careful when copying and pasting commands that span multiple lines as space characters surrounding line-breaks may be omitted when copied over to the application.
help
Shows the full command summary of CulinaryContacts at a glance.
Press q
to close the help window.
Format: help
clear
Removes all persons and reservations from CulinaryContacts.
Format: clear
CulinaryContacts data are saved in the hard disk automatically after any command that changes the data. There is no need to save manually.
CulinaryContacts data are saved automatically as a JSON file [JAR file location]/data/culinarycontacts.json
. Advanced users are welcome to update data directly by editing that data file.
Caution:
If your changes to the data file makes its format invalid, CulinaryContacts will discard all data and start with an empty data file at the next run. Hence, it is recommended to take a backup of the file before editing it.
Furthermore, certain edits can cause the CulinaryContacts to behave in unexpected ways (e.g., if a value entered is outside the acceptable range). Therefore, edit the data file only if you are confident that you can update it correctly.
exit
Exits the program.
Format: exit
add
Adds a person to the displayed person list.
Format: add n/NAME p/PHONE_NUMBER e/EMAIL a/ADDRESS [t/TAG]…
Tip: A person can have any number of tags (including 0).
NAME
cannot be blank.PHONE_NUMBER
should only contain numbers, and it should be at least 3 digits long.EMAIL
should be of the format local-part@domain and adhere to the following constraints:
ADDRESS
cannot be blank.Examples:
add n/Alex Yeoh p/87438807 e/alexyeoh@example.com a/Blk 30 Geylang Street 29, #01-40 t/supplier t/durian
add n/David Lee p/91031282 e/david@example.com a/Blk 436 Serangoon Gardens Street 26, #02-43 t/customer
list
Shows a list of all persons in the contacts list of CulinaryContacts.
Format: list
edit
Edits an existing person in the displayed person list.
Format: edit INDEX [n/NAME] [p/PHONE] [e/EMAIL] [a/ADDRESS] [t/TAG]…
INDEX
. The index refers to the index number shown in the displayed person list. The index must be a positive integer 1, 2, 3, …t/
without
specifying any tags after it.Examples:
edit 1 p/91234567 e/johndoe@example.com
Edits the phone number and email address of the 1st person to be 91234567
and johndoe@example.com
respectively.edit 2 n/Betsy Crower t/
Edits the name of the 2nd person to be Betsy Crower
and removes all existing tags.find
Finds persons in the displayed person list whose name contains any of the given keywords.
Format: find KEYWORD [MORE_KEYWORDS]...
hans
will match Hans
.Hans Bo
will match Bo Hans
.Han
will not match Hans
.OR
search).Examples:
find John
returns john
and John Doe
.find alex david
returns Alex Yeoh
and David Li
.filter
Finds persons in the displayed person list that have all the given tags.
Format: filter TAG [MORE_TAGS]...
supplier
will match with Supplier
.supplier
will not match suppliers
.AND
search).
e.g. seafood supplier
will return persons with both seafood
and supplier
tag.Examples:
filter supplier
returns persons with the supplier
tag.filter supplier seafood
returns persons with both supplier
and seafood
tags.delete
Deletes the specified person from the displayed person list.
Format: delete INDEX
INDEX
.Examples:
list
followed by delete 2
deletes the 2nd person in the contacts list of CulinaryContacts.archive
Removes the specified person from the contacts list and adds the person into the archived list.
Format: archive INDEX
INDEX
.list
to view the contacts list.Examples:
list
followed by archive 1
archives the 1st person in the contacts list of CulinaryContacts.unarchive
Removes the specified person from the archived list and adds the person back into the contacts list.
Format: unarchive INDEX
INDEX
.alist
to view the archived list.Examples:
alist
followed by unarchive 1
unarchives the 1st person in the archived list of CulinaryContacts.alist
Shows a list of all persons in the archived list of CulinaryContacts.
Format: alist
Notes about reservations:
rsv
Adds a reservation to CulinaryContacts.
Format: rsv INDEX d/DATE t/TIME p/PAX
INDEX
. The index refers to the index number shown in the displayed person list.DATE
must be in yyyy-MM-dd format.TIME
must be in HHmm format.PAX
must be a positive integer. Leading zeroes should be omitted (e.g., instead of typing p/03
, type p/3
).DATE
and TIME
(i.e., combination of DATE
, TIME
and name of person making reservation must be unique).Example:
rsv 1 d/2024-04-17 t/1800 p/8
rsvdel
Deletes the specified reservation from CulinaryContacts.
Format: rsvdel INDEX
INDEX
.Example:
rsvdel 2
deletes the 2nd reservation in CulinaryContacts.rsvsort
Shows a sorted list of all reservations in CulinaryContacts.
Format: rsvsort
rsvsort
will update the reservation card to show the expiry flag.Q: How do I transfer my data to another Computer?
A: Install the app in the other computer and overwrite the empty data file it creates with the file that contains the data of your previous CulinaryContacts home folder.
Q: Does archiving a contact affect reservations that were made under that contact?
A: No. The reservation feature is a completely independent feature from the archive feature. This means that:
preferences.json
file created by the application before running the application again.Command | Format, Examples |
---|---|
help | help |
clear | clear |
exit | exit |
add | add n/NAME p/PHONE_NUMBER e/EMAIL a/ADDRESS [t/TAG]… e.g., add n/Alex Yeoh p/87438807 e/alexyeoh@example.com a/Blk 30 Geylang Street 29, #01-40 t/supplier t/durian |
list | list |
edit | edit INDEX [n/NAME] [p/PHONE_NUMBER] [e/EMAIL] [a/ADDRESS] [t/TAG]… e.g., edit 2 n/James Lee e/jameslee@example.com |
find | find KEYWORD [MORE_KEYWORDS]... e.g., find James Jake |
filter | filter TAG [MORE_TAGS]... e.g., filter supplier seafood |
delete | delete INDEX e.g., delete 3 |
archive | archive INDEX e.g., archive 2 |
unarchive | unarchive INDEX e.g., unarchive 2 |
alist | alist |
rsv | rsv INDEX d/DATE t/TIME p/PAX e.g., rsv 1 d/2024-04-15 t/1800 p/4 |
rsvdel | rsvdel INDEX e.g., rsvdel 1 |
rsvsort | rsvsort |