Skip to content

[CS2113-T15-4] StockMaster #45

Open
fxe025 wants to merge 749 commits intonus-cs2113-AY2324S2:masterfrom
AY2324S2-CS2113-T15-4:master
Open

[CS2113-T15-4] StockMaster #45
fxe025 wants to merge 749 commits intonus-cs2113-AY2324S2:masterfrom
AY2324S2-CS2113-T15-4:master

Conversation

@fxe025
Copy link
Copy Markdown

@fxe025 fxe025 commented Mar 7, 2024

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.

yeozongyao pushed a commit to yeozongyao/tp that referenced this pull request Mar 29, 2024
Copy link
Copy Markdown

@fungg0 fungg0 left a 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.

Comment thread docs/DeveloperGuide.md
Copy link
Copy Markdown

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

Comment thread docs/DeveloperGuide.md
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The document looks neat!

Comment thread docs/DeveloperGuide.md
### 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
Copy link
Copy Markdown

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

Comment thread docs/DeveloperGuide.md
Storage class contains methods to write description of items to the file `./StockMasterData.txt`,
and retrieve information from the file when program restarts.
### UI

Copy link
Copy Markdown

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

Comment thread docs/DeveloperGuide.md Outdated
{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
Copy link
Copy Markdown

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.

Comment thread docs/DeveloperGuide.md
Comment on lines +40 to +45
* 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
Copy link
Copy Markdown

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!

Comment thread docs/DeveloperGuide.md
Copy link
Copy Markdown

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.

Copy link
Copy Markdown

@T0nyLin T0nyLin left a 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.

Comment thread docs/DeveloperGuide.md
* list: list all items in the inventory
* help: list all commands
* exit: exit StockMaster

Copy link
Copy Markdown

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.

Comment thread docs/Diagrams/AddPromotion.png Outdated
Copy link
Copy Markdown

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!

Copy link
Copy Markdown

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

Comment thread docs/Diagrams/DeletePromo.png Outdated
Copy link
Copy Markdown

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

Comment thread docs/Diagrams/ListPromotion.png Outdated
Copy link
Copy Markdown

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

Comment thread docs/DeveloperGuide.md Outdated
used in the product.

{Describe the design of the product. Use UML diagrams and short code snippets where applicable.}
### Exception
Copy link
Copy Markdown

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

Comment thread docs/Diagrams/DeletePromo.png Outdated
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  1. missing closing bracket in print
  2. add return arrow when necessary :)

Copy link
Copy Markdown

@ZhuSijia0711 ZhuSijia0711 left a 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 :)

Comment thread docs/DeveloperGuide.md
Copy link
Copy Markdown

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

Copy link
Copy Markdown

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 !

Comment thread docs/DeveloperGuide.md Outdated
and retrieve information from the file when program restarts.
### UI

<<<<<<< HEAD
Copy link
Copy Markdown

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 :) !

Comment thread docs/Diagrams/Storage_class_diagram.png Outdated
Copy link
Copy Markdown

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

Copy link
Copy Markdown

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?

Copy link
Copy Markdown

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.

Comment thread docs/Diagrams/AddPromotion.png Outdated
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good and clear format!

Shu and others added 30 commits April 15, 2024 22:39
Update Storage Sequence Diagram
Change UG and DG wording
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.