Skip to content

Commit

Permalink
Merge c15de3b into 3a09feb
Browse files Browse the repository at this point in the history
  • Loading branch information
Cary-Xx committed Nov 11, 2019
2 parents 3a09feb + c15de3b commit 245ee85
Show file tree
Hide file tree
Showing 35 changed files with 278 additions and 371 deletions.
4 changes: 2 additions & 2 deletions README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -17,13 +17,13 @@ endif::[]
It has a GUI but most of the user interactions happen using a CLI (Command Line Interface).
* It is a Java sample application intended for students and young adults to manage their personal daily expenses.
## Target Users
== Target Users

Our target users are students and young adults.
This group of people are usually too busy to remember every single expense in their daily life which makes it difficult for them to keep track of their spending.
MYMorise hopes to resolve this issue by being their expense manager and helping them to keep their spendings in check.

## Why use MYMorise?
== Why use MYMorise?

Have you experienced moments where your money seem to always be gone, then you remembered that you've used it on something but you just can't recall exactly where/what you have spent your money on?
Or maybe you just want a platform to record your spendings so that you can better manage them the next time?
Expand Down
4 changes: 2 additions & 2 deletions build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -135,8 +135,8 @@ asciidoctor {
idprefix: '', // for compatibility with GitHub preview
idseparator: '-',
'site-root': "${sourceDir}", // must be the same as sourceDir, do not modify
'site-name': 'AddressBook-Level3',
'site-githuburl': 'https://github.com/se-edu/addressbook-level3',
'site-name': 'MYMorise',
'site-githuburl': 'https://github.com/AY1920S1-CS2103-T14-4/main',
'site-seedu': true, // delete this line if your project is not a fork (not a SE-EDU project)
]

Expand Down
216 changes: 0 additions & 216 deletions docs/LearningOutcomes.adoc

This file was deleted.

65 changes: 27 additions & 38 deletions docs/UserGuide.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ By: `Team T14-4` Since: `Sep 2019` Licence: `MIT`

== Introduction

MYMorise -- Manage Your Money(MYM) is a desktop application for those who *prefer tracking personal expenses on their
*MYMorise -- Manage Your Money(MYM)* is a desktop application for those who *prefer tracking personal expenses on their
computers*. With MYMorise, you can easily see your daily expenses as well as a summary, along with other useful
functionalities. More importantly, MYMorise is *optimized for those who prefer to work with Command Line Interface (CLI)* while still having the benefits of a *Graphical User Interface
(GUI)*. Interested? Jump to the <<Quick Start>> to get started. Enjoy!
Expand All @@ -43,19 +43,18 @@ functionalities. More importantly, MYMorise is *optimized for those who prefer t
. Ensure you have Java `11` or above installed in your Computer.
. Download the latest `MYMorise.jar`.
. Copy the jar file to the folder you want to use as the home folder for MYMorise.
. Double-click the jar to start the app. The GUI should appear in a few seconds.
. If Step 4 doesn't work, try `java -jar MYMorise.jar` in your CLI.
. Run `java -jar path_to_folder/MYMorise.jar` in your CLI. The GUI should appear in a few seconds.
+
image::Ui.png[width="790"]
+
. Type the command in the command box and press kbd:[Enter] to execute it. +
e.g. typing *`help`* and pressing kbd:[Enter] will open the help window.
. Some example commands you can try:

* *`listDefaultExpenses`* : lists all expenses
* **`expense`**`n/Textbook a/23.50 t/education t/school` : adds an expense named `Textbook` to the expense list with the tags
`education` and `school`.
* **`delete`**`3` : deletes the 3rd expense shown in the current list
* *`listDefaultExpenses`* : lists all expenses that do not fall into any budget.
* **`expense`**`n/Textbook a/23.50 t/education` : adds an expense named `Textbook` to the expense list with the tag
`education`.
* **`delete`**`3` : deletes the 3rd item shown in the centre list panel.
* *`exit`* : exits the app

. Refer to <<Features>> for details of each command.
Expand All @@ -68,7 +67,6 @@ e.g. typing *`help`* and pressing kbd:[Enter] will open the help window.
* Words in `UPPER_CASE` are the parameters to be supplied by the user
* Items in square brackets are optional e.g `n/NAME [t/TAG]` can be used as `n/Bread t/Food` or as `n/Bread`.
* Items post-fixed with `…`​ can be used zero or more times e.g. `[t/TAG]…`​ can be excluded or include 1 or more tags `t/food t/drinks`.
====

=== Viewing help : `help`
Expand All @@ -88,12 +86,10 @@ Adds an expense to track.* +
Format: `expense n/NAME a/AMOUNT [c/CURRENCY] [d/DATE] [t/TAG]…​`

[TIP]
An expense with no currency specified will have the default currency set.
An expense with no currency specified will have the default currency set (SGD).
[TIP]
An expense with no date specified will default to current date and time of addition.
[TIP]
An expense can have any number of tags (including no tags).
[TIP]
User may input time in the format "HHMM" in the [d/DATE] portion to specify current date with specified time
[TIP]
If user wants to add an expense onto the last day of a month, just specify the day to be 31 and it will automatically be added onto the last day of the month. +
Expand Down Expand Up @@ -221,7 +217,7 @@ Deletes the second budget in the budget list in MYMorise.
// end::delete[]

=== Automatic currency conversion for foreign currencies
MyMorise is able to automatically display foreign currencies in the default currency set by the user. By default this is set
MYMorise is able to automatically display foreign currencies in the default currency set by the user. By default this is set
to Singapore Dollars (SGD). The conversions are done in the following scenarios:

* When an expenses specifies a currency that is not the default currency
Expand All @@ -232,6 +228,13 @@ a cleaner experience when viewing budgets and expenses with multiple differing c

The latest Foreign Exchange data for a limited set of supported currencies are updated whenever the application is launched. The list of supported currencies are as follows:

[width="80%",cols="10%,10%,10%,10%,10%,10%,10%,10%,10%,10%,10%",options="header",]
|=======================================================================
| CAD | HKD | ISK | PHP | DKK | HUF | CZK | GBP | RON | SEK | IDR
| INR | BRL | RUB | HRK | JPY | THB | CHF | EUR | MYR | BGN | TRY
| CNY | NOK | NZD | ZAR | USD | MXN | SGD | AUD | ILS | KRW | PLN
|=======================================================================

=== Clearing a list : `clear`
Deletes all items in the current list.* +
Format: `clear`
Expand All @@ -251,6 +254,16 @@ When the user types, if there are suggestions for a certain input, user can pres
suggestion or press kbd:[DOWN] and kbd:[UP] to navigate between suggestions and then press kbd:[tab] or kbd:[enter]
to autofill the selected item. User may also just kbd:[click] on an item to autofill.

=== Retrieve the history of the commands executed: `history`
Returns the list of history commands executed.
[TIP]
Press kbd:[F3] to navigate to previous input; Press kbd:[F4] to navigate to next input;
[NOTE]
Use keyboard to navigate through the history will only take effect when the focus is in `TextField`.
[NOTE]
kbd:[UP] and kbd:[DOWN] cannot be used here to navigate through the history since they are used to navigate through
the autocomplete suggestions.

=== Exiting the program : `exit`
Exits the program. +
Format: `exit`
Expand All @@ -261,26 +274,7 @@ Expense and Budget data are saved in the hard disk automatically after any comma
There is no need to save manually.
// end::saving[]

=== Automatic currency conversion for foreign currencies `[coming in v1.4]`
MYMorise is able to automatically display foreign currencies in the default currency set by the user. By default this is set
to Singapore Dollars (SGD). The conversions are done in the following scenarios:

* When an expenses specifies a currency that is not the default currency
* When an expense specifies a currency that is different from that budget it is associated to.

This automatic conversion allows for the computation of budgets and expenses regardless of their underlying currencies to provide
a cleaner experience when viewing budgets and expenses with multiple differing currencies.

The latest Foreign Exchange data for a limited set of supported currencies are updated whenever the application is launched. The list of supported currencies are as follows:

[width="80%",cols="10%,10%,10%,10%,10%,10%,10%,10%,10%,10%,10%",options="header",]
|=======================================================================
| CAD | HKD | ISK | PHP | DKK | HUF | CZK | GBP | RON | SEK | IDR
| INR | BRL | RUB | HRK | JPY | THB | CHF | EUR | MYR | BGN | TRY
| CNY | NOK | NZD | ZAR | USD | MXN | SGD | AUD | ILS | KRW | PLN
|=======================================================================

=== Locating expenses by name: `find` `[coming in v1.4]`
=== Locating expenses by name: `find` `[coming in v2.0]`
Finds all expenses by name, date, tag. +
Format: `find [n/NAME] [d/DATE] [t/TAG]`

Expand All @@ -299,18 +293,12 @@ Returns `coffee` and `Starbucks Coffee`.
* `find n/Cheesecake` +
Returns any expense having names `Cheesecake`, eg: `Strawberry Cheesecake`, `Blueberry Cheesecake`.

=== Display expense by tag in chart `[coming in v2.0]`
_{Displays the expense in a pie chart to show breakdown of expenses.}_

=== Set a Recurring Expense `[coming in v2.0]`
_{Sets a recurring expense for a specific duration and frequency.}_

=== Undo/Redo commands `[coming in v2.0]`
_{Allows user to undo and redo commands.}_

=== Show command history `[coming in v2.0]`
_{User is able to navigate using up and down keys to cycle through past commands typed during the session.}_

=== FAQ

*Q*: How do I transfer my data to another Computer? +
Expand All @@ -336,5 +324,6 @@ e.g. `find t/nourishment`
* *Delete* : `delete INDEX` +
e.g. `delete 3`
* *Clear* : `clear`
* *History*: `history`
* *Exit* : `exit`

Binary file modified docs/images/Ui.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 245ee85

Please sign in to comment.