Skip to content

[CS2113-W12-4] Fit Track#13

Open
J0shuaLeong wants to merge 701 commits into
nus-cs2113-AY2324S1:masterfrom
AY2324S1-CS2113-W12-4:master
Open

[CS2113-W12-4] Fit Track#13
J0shuaLeong wants to merge 701 commits into
nus-cs2113-AY2324S1:masterfrom
AY2324S1-CS2113-W12-4:master

Conversation

@J0shuaLeong

Copy link
Copy Markdown

FitTrack allows users to track meals and workouts, helping them to adjust their diet and exercise to lead a healthy lifestyle. It is optimised for CLI users so that tracking can be done efficiently and easily by typing in commands.

Brian030601 added a commit to Brian030601/tp that referenced this pull request Oct 17, 2023

@NeoMinWei NeoMinWei left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

LGTM, class diagrams can be included as well

Comment thread docs/DeveloperGuide.md Outdated

<div markdown="span" class="alert alert-primary">

:bulb: **Tip:** The '.puml' files used to create the diagrams in this document can be found in [diagrams](./diagrams)

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 :bulb is not showing up correctly

Comment thread docs/DeveloperGuide.md Outdated
* [**`WorkoutList`**](#workout-list-component): Stores all workouts.
* [**`Parser`**](#parser-component): Handles user input.
* [**`Data`**](#data-component): Holds the data of the app in memory.
* [**`Command`**](#command-component): The command executor.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Links do not work on the website

Comment thread docs/DeveloperGuide.md Outdated
### Core sequence
Core sequence of code is written in [`FitTrack`](../src/main/java/fittrack/FitTrack.java) class.

![Core structure](images/FitTrackOuter.svg "Outer Structure")

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Possible to remove the bottom object names with hide footbox

Comment thread docs/DeveloperGuide.md Outdated

![Core structure](images/FitTrackOuter.svg "Outer Structure")

![Inner structure](images/FitTrackCore.svg "Core Structure")

@NeoMinWei NeoMinWei Nov 2, 2023

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

For Core Structure, is "do-while" supposed to be "loop" instead?

Comment thread docs/DeveloperGuide.md
![Structure of Storage Load](images/StorageLoad.svg)
The sequence diagram of the code for loading the file contents into each class.

![Structure of Storage Save](images/StorageSave.svg)

@NeoMinWei NeoMinWei Nov 2, 2023

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

For Main Structure of Storage Save, the :FIleWriter on the right is hard to read, maybe choose a different colour?

Comment thread docs/DeveloperGuide.md Outdated
|v2.0|user|find a to-do item by name|locate a to-do without having to go through the entire list|
|Version| As a ... | I want to ... | So that I can ... |
|--------|----------|-------------------------------------------------------------|---------------------------------------------------------------|
|v1.0|new user| know how to use the product | use the product |

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Make the user comments more specific for the things that you want to implement. For example, a user knowing how to run your application doesn't really say much about what needs to be changed or updated

Comment thread docs/DeveloperGuide.md Outdated


### Architecture
{insert diagram to show architecture of code}

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Im not sure if I just missed it or its a work in progress but I didn't see the diagram in the initial DG

Comment thread docs/DeveloperGuide.md
### Value proposition

{Describe the value proposition: what problem does it solve?}
Fittrack is a health management application which allows users to record their diet and activity, and help them to reach the goal they have set.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

This is a really good value proposition, straight to the point

Comment thread docs/DeveloperGuide.md Outdated

## Non-Functional Requirements

{Give non-functional requirements}

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Is this supposed to be a diagram or are there no non-functional requirements?


main -> main ++: loopCommandExecution()

group do-while [!ExitCommand.isExit(command)]

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Is this representation of loop also acceptable? In our textbook the usual representation is "loop"

Comment thread docs/DeveloperGuide.md Outdated

<div markdown="span" class="alert alert-primary">

:bulb: **Tip:** The '.puml' files used to create the diagrams in this document can be found in [diagrams](./diagrams)

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 link to diagrams folder is not working

main -> ui ++: ui.printCR(commandResult: CR)
note left: Print the result of execution
note right: CR for CommandResult
return

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 generally clear and easy to read!

participant ":WorkoutListDecoder" as wDecoder STORAGE_COLOR_T3

main -> main ++: start()
activate main MODEL_COLOR

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 like the colored representation. It allows readers to differentiate each class more easily.

@yicheng-toh yicheng-toh left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Looks great!

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

image
Perhaps the footer box can be removed.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

image
Perhaps the word 'loop' can be used instead.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

image
Perhaps this could be 'elements in mealArr' instead.

ICubE01 and others added 25 commits November 4, 2023 17:37
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.

9 participants