-
Notifications
You must be signed in to change notification settings - Fork 236
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
[CS2113T-F11-4] CLIvershelf #43
base: master
Are you sure you want to change the base?
[CS2113T-F11-4] CLIvershelf #43
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Overall, The documentation looks good to me, with enough visuals.
docs/DeveloperGuide.md
Outdated
4. `Main` calls `Command` object to `execute()`, and returning a `resultString` | ||
5. `Main` instantiates `UI` component to print the `resultString` | ||
|
||
![](diagrams/GeneralProgramFlowSequenceDiagram.png) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
docs/DeveloperGuide.md
Outdated
5. `Command` then checks the `ExitCommand` on whether the program should exit. | ||
6. In the absence of `ExitCommand`, UI then takes over to prompt and process the next user input. | ||
|
||
![](diagrams/seedu_duke_logic.drawio.svg) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
docs/DeveloperGuide.md
Outdated
|
||
### Model component | ||
|
||
![](diagrams/seedu_duke_model.drawio.svg) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
docs/DeveloperGuide.md
Outdated
1. [Introduction](#introduction) | ||
2. [Setting up](#setting-up) | ||
3. [Acknowledgements](#acknowledgements) | ||
4. [Design](#design) | ||
1. [Architecture](#architecture) | ||
2. [UI Component](#ui-component) | ||
3. [Logic Component](#logic-component) | ||
4. [Model Component](#model-component) | ||
5. [Storage Component](#storage-component) | ||
5. [Implementation](#implementation) | ||
1. [Adding an item](#adding-an-item) | ||
2. [Editing an item](#editing-an-item) | ||
3. [Listing all items](#listing-all-items) | ||
4. [Getting an item](#getting-an-item) | ||
5. [Selling an item](#selling-an-item) | ||
6. [Generating sales report](#generating-sales-report) | ||
7. [Getting help](#getting-help) | ||
8. [Exiting the program](#editing-an-item) | ||
6. [Product Scope](#product-scope) | ||
7. [User stories](#user-stories) | ||
8. [Non-Functional Requirements](#non-functional-requirements) | ||
9. [Glossary](#glossary) | ||
10. [Instructions for manual testing](#instructions-for-manual-testing) |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like the Anchors using here! It is easy to for me to reference to each specific parts. 😃
docs/DeveloperGuide.md
Outdated
### Removing a shelf | ||
|
||
### Adding an item | ||
|
||
### Deleting an item | ||
|
||
### Getting information of an item | ||
|
||
### Listing the items | ||
|
||
### Editing an item |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
oops! Missing contents
docs/DeveloperGuide.md
Outdated
|
||
### Editing an item | ||
|
||
### Getting a Report |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For the Getting a Report Part, It seems hard for me to read. Will it look more friendly if adjusting the format?
docs/DeveloperGuide.md
Outdated
2. Test case: `report t/stats` | ||
Expected: Shows a report of the statistics (total cost, total income, total profit) of the sales from the beginning of time. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
For example,
2. Test case: `report t/stats` | |
Expected: Shows a report of the statistics (total cost, total income, total profit) of the sales from the beginning of time. | |
2. Test case: `report t/stats` | |
*Expected:* Shows a report of the statistics (total cost, total income, total profit) of the sales from the beginning of time. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Overall great job! The diagrams are simple to comprehend. You just need ot finish up on the explanations as some are missing.
3. `Logic`: Parses and executes the user input commands. | ||
4. `Model`: Holds the data of the App in memory | ||
5. `Storage`: Reads data from, and writes data to, the hard disk. | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I like how you gave a brief description of each of your classes. This makes it easier to understand why your sequence/class diagrams implemented in such a manner.
docs/DeveloperGuide.md
Outdated
### Editing an item | ||
|
||
#### Design considerations: | ||
|
||
### Listing all items | ||
|
||
#### Design considerations: | ||
|
||
### Getting an item | ||
|
||
#### Design considerations: | ||
|
||
### Selling an item | ||
|
||
#### Design considerations: | ||
|
||
### Generating sales report | ||
|
||
#### Design considerations: | ||
|
||
### Getting help |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I believe that there's missing content here. Perhaps it may not be necessary to have design considerations for every single aspect here. It would be better to have an overall design considerations to encompass everything in this part.
docs/DeveloperGuide.md
Outdated
3. Getting a report when none of the items are sold | ||
1. Pre-requisite: `list shlv/soldItems` to check that there does **not** exist a shelf name sold items | ||
2. Test case: `report t/stats` | ||
Expected: Shows a message none of the items have been sold to generate the statistics report |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Perhaps it would be good to show the message that is printed instead of saying that a message will be printed.
|v2.0|user|retrieve a list of items low in stock|replenish items low in stock| | ||
|v2.0|user|mark an item as sold|remove item from inventory list and add to revenue| | ||
|v2.0|user|add the total cost of all the items|know the total cost and deduct from revenue to find profit| | ||
|v2.0|user|view the monthly sales report|know if I am making a profit| | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It's great that you structured your user stories in terms of v1.0 and v2.0 to give the reader an idea of how your app is progressing.
# Conflicts: # docs/DeveloperGuide.md
Fix links in DG manual testing
fix wrong diagram path
resolves #219
Refactored classes & packages
Update model class diagram
Minor updates to DG for storage component
Update UI diagrams, rename some diagrams
fix issue addressed by TA
fix reposense link
minor change
Fixed content table hyperlink in DG
Update PPP
Add full screen instruction to UG
Update UG
update ug
CLIvershelf helps bookstore owners to better manage their inventory and finances. It is optimized for CLI users so that frequent tasks can be done faster by typing in commands.