-
Notifications
You must be signed in to change notification settings - Fork 231
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
[CS2113-T15-4] StockMaster #45
base: master
Are you sure you want to change the base?
Conversation
…layBook Branch display book
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 think your DG could use more descriptions to show how the program works and interact within.
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 think you can add more visuals to aid in explaining your design and implementation
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.
The document looks neat!
### Storage | ||
Storage class contains methods to write description of items to the file `./StockMasterData.txt`, | ||
and retrieve information from the file when program restarts. | ||
### UI |
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 think your UI and Exception class is missing a description
### Storage | ||
Storage class contains methods to write description of items to the file `./StockMasterData.txt`, | ||
and retrieve information from the file when program restarts. | ||
### UI | ||
|
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 think you can add some description regarding your implementation for the functionalities
docs/DeveloperGuide.md
Outdated
@@ -7,31 +7,67 @@ | |||
## Design & implementation | |||
|
|||
{Describe the design and implementation of the product. Use UML diagrams and short code snippets where applicable.} | |||
### Exception | |||
### Itemlist | |||
Itemlist class is an object which contains items to be added to the stock inventory list. Able to add items, remove functions, edit items inside |
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.
Seems like you meant to say remove items
instead of remove functions
.
docs/DeveloperGuide.md
Outdated
* has a need to manage a significant number of inventory products | ||
* able to track revenue/loss of the business | ||
* prefer desktop apps over other types | ||
* can type fast | ||
* prefers typing to mouse interactions | ||
* is reasonably comfortable using CLI apps |
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.
Target users are clearly defined. Good job!
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.
Do consider adding in more visuals (sequence diagrams, class diagrams, etc.) for explanatory purposes.
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.
Looks clean, but needs more examples and images to help with the DG.
* list: list all items in the inventory | ||
* help: list all commands | ||
* exit: exit StockMaster | ||
|
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.
Hopefully, you can explain what the contents of each methods are and how the methods communicate with each related methods. This DG is to teach an interested developer how to contribute to the codebase.
docs/Diagrams/AddPromotion.png
Outdated
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.
The sequence diagram is clear and easy to understand, good job!
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.
You should add the return arrows to your sequence diagram
docs/Diagrams/DeletePromo.png
Outdated
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.
Maybe you could add both the activation bar and return arrows
docs/Diagrams/ListPromotion.png
Outdated
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.
You could try adding the activation bar and return arrows as well
docs/DeveloperGuide.md
Outdated
used in the product. | ||
|
||
{Describe the design of the product. Use UML diagrams and short code snippets where applicable.} | ||
### Exception |
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 think you could elaborate more on how your exception works
docs/Diagrams/DeletePromo.png
Outdated
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.
- missing closing bracket in print
- add return arrow when necessary :)
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.
maybe can include some class diagram and object diagram to show variance :)
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.
maybe the diagram is a bit small
src/main/java/common/Messages.java
Outdated
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.
good to see self invocation here !
docs/DeveloperGuide.md
Outdated
and retrieve information from the file when program restarts. | ||
### UI | ||
|
||
<<<<<<< HEAD |
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.
please delete the unnecessary lines :) !
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.
No problem for this diagram
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 am a bit confuse what does "BESTSELLER", "TOTAL_PROFIT", "TOTAL_REVENUE" means?
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.
Good job in use red to diftinquish the parts.
docs/Diagrams/AddPromotion.png
Outdated
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.
Good and clear format!
Update PPP
Update Cashier exception handling
Update DG
Update PPP Formatting
Update Storage Sequence Diagram
FINAL BUGFIX
Update PPP
Fix DG wording
Change UG and DG wording
Update UG
Update JAR link
Update UserGuide.md
StockMaster helps small business owners manage inventory of their business. It is optimized for CLI users so that frequent tasks can be done faster by typing in commands.