Skip to content

Commit

Permalink
Merge pull request #157 from flxffy/v1.3
Browse files Browse the repository at this point in the history
PPP first draft
  • Loading branch information
JonathanLeeWH authored Apr 2, 2019
2 parents 04b42c4 + 4a7d354 commit a3bd6ef
Show file tree
Hide file tree
Showing 4 changed files with 76 additions and 74 deletions.
7 changes: 6 additions & 1 deletion docs/DeveloperGuide.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -179,11 +179,13 @@ image::SDforDeleteMedicine.png[width="800"]

The sections below give more details of each component.

// tag::uicomponent[]
[[Design-Ui]]
=== UI component

.Structure of the UI Component
image::UiClassDiagram.png[width="800"]
// end::uicomponent[]

*API* : link:{repoURL}/src/main/java/seedu/address/ui/Ui.java[`Ui.java`]

Expand Down Expand Up @@ -857,6 +859,7 @@ A project often depends on third-party libraries. For example, MediTabs depends
. Require developers to download those libraries manually (this creates extra work for developers)

[appendix]
// tag::userstories[]
== User Stories

Priorities: High (must have) - `* * \*`, Medium (nice to have) - `* \*`, Low (unlikely to have) - `*`
Expand Down Expand Up @@ -899,6 +902,7 @@ Priorities: High (must have) - `* * \*`, Medium (nice to have) - `* \*`, Low (un
|`*` |pharmacist |save information on medicine's usage |remind myself of its usage

|=======================================================================
// end::userstories[]

[appendix]
// tag::usecase[]
Expand Down Expand Up @@ -995,6 +999,7 @@ Use case resume at step 2.
// end::usecase[]

[appendix]
// tag::nonfunctionalreq[]
== Non Functional Requirements

. User Constraints
Expand All @@ -1015,7 +1020,7 @@ Use case resume at step 2.
. Testability
.. Avoid implementing features that are difficult to test manually and automatically. i.e, avoid dependence on remote APIs as their behaviours are beyond our control.
.. Due to the project's constraints, audio related features were not taken into consideration. Avoid any features using audio indicators.

// end::nonfunctionalreq[]


[appendix]
Expand Down
7 changes: 6 additions & 1 deletion docs/UserGuide.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -83,10 +83,12 @@ image::UserGuide_ApplicationInterface.png[width="1000"]
* The list of medicine running low on stock or expiring soon medicine will be displayed in the warning panel to notify the user.
* Warnings will be logged in the warnings panel until action has been taken to either remove or update the medicine.

// tag:featureintro[]
[[Features]]
== Features

As an inventory management application, MediTabs supports basic functionalities (add, edit, delete, list). On top of these basic functions, MediTabs also boasts several features tailored to your needs. These features aim to streamline your inventory management process, thereby enhancing your user experience.
// end:featureintro[]

=== Information Panel
.Information panel
Expand All @@ -100,7 +102,7 @@ You can easily refer to the batch table provided in the information panel while

You can also sort the table by any of its columns with the `sort` command to suit your needs and preference. You may refer to <<SortCommand>> for more details.


// tag::warningpanelfeature[]
=== Warning Panel

.Warning panel
Expand All @@ -113,6 +115,7 @@ The warning panel provides an overview of the most pressing issues that have to
On top of that, the panel features flexible thresholds to determine what is expiring and what is low in stock. These thresholds can be changed according your own preferences and needs with a simple command.

You can learn about related commands related in <<WarningPanel>>.
// end::warningpanelfeature[]

// tag::exportingascsvfileformat[]
=== Exporting as CSV file format
Expand Down Expand Up @@ -353,6 +356,7 @@ Updates quantity and expiry date of batch `s9c4x9532` in batch records of the 2n
Updates quantity of batch `8937v1x7` in batch records of the 1st medicine in the results of the `find` command to `500`.
//end::update[]

// tag::warningpanelcommand[]
[[WarningPanel]]
=== Managing the warning panel : `warning`

Expand All @@ -376,6 +380,7 @@ Medicines with expiry dates within 10 days to expiry from today will be displaye
Medicines with quanities of less than or equal to 20 will be displayed in the warning panel.
* `warning show` +
Current thresholds used for the warning panel will be shown.
// end::warningpanelcommand[]

// tag::exportcommand[]
[[ExportCommand]]
Expand Down
64 changes: 64 additions & 0 deletions docs/team/flxffy.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
= Ong Ai Hui - Project Portfolio
:site-section: AboutUs
:imagesDir: ../images
:stylesDir: ../stylesheets

== PROJECT: MediTabs

---

== Overview

MediTabs is a desktop inventory management application used by pharmacists to keep track of medicines in a clinic. The user interacts with it using a CLI, and it has a GUI created with JavaFX. It is written in Java, and has about 10 kLoC.

== Summary of contributions

* *Major enhancement*: Added a warning panel and its related commands
** What it does: Gives users an overview of what medicines are expiring, expired and low in stock. Thresholds used for the determination of what medicines are considered expiring and what are low in stock can be set by the user via the command line.
** Justification: Simplifies the process of sieving through an inventory to take stock of expiring or expired medicines that need to be disposed of, and medicines that require replenishing. The flexible threholds add customisability to the feature.
** Highlights: Offers users a way to get the information they need quickly, while also providing customisability by allowing users to set their own thresholds. To achieve this, an additional column had to be rendered in the application's user interface to accomodate the warning panel. Furthermore, to add on to the user experience, the thresholds set by the user in previous session are saved and reused for later sessions.

* *Minor enhancement*: -

* *Code contributed*: [https://github.com[Functional code]] [https://github.com[Test code]] _{give links to collated code files}_

* *Other contributions*:

** Project management:
*** Updated the GUI colour scheme (Pull request https://github.com/CS2103-AY1819S2-T12-3/main/pull/134[#134])
*** Wrote additional tests for existing features to increase coverage from 88% to 92% (Pull requests https://github.com/CS2103-AY1819S2-T12-3/main/pull/139[#139], https://github.com[#38])
** Documentation:
*** Restructured existing contents of the User Guide: https://github.com/CS2103-AY1819S2-T12-3/main/pull/151[#151]

== Contributions to the User Guide


|===
|_Given below are sections I contributed to the User Guide. They showcase my ability to write documentation targeting end-users._
|===

include::../UserGuide.adoc[tag=featureintro]

include::../UserGuide.adoc[tag=warningpanelfeature]

include::../UserGuide.adoc[tag=warningpanelcommand]

include::../UserGuide.adoc[tag=dataencryption]

== Contributions to the Developer Guide

|===
|_Given below are sections I contributed to the Developer Guide. They showcase my ability to write technical documentation and the technical depth of my contributions to the project._
|===

include::../DeveloperGuide.adoc[tag=uicomponent]

include::../DeveloperGuide.adoc[tag=warningpanel]

include::../DeveloperGuide.adoc[tag=dataencryption]

include::../DeveloperGuide.adoc[tag=userstories]

include::../DeveloperGuide.adoc[tag=usecase]

include::../DeveloperGuide.adoc[tag=nonfunctionalreq]
72 changes: 0 additions & 72 deletions docs/team/johndoe.adoc

This file was deleted.

0 comments on commit a3bd6ef

Please sign in to comment.