Skip to content
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

[CS2103T-T10-3] ELISA #3

Closed
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
36 commits
Select commit Hold shift + click to select a range
a4b9d3d
Update README.adoc
cholmes899 Sep 8, 2019
bc6e074
Update UserGuide.adoc
Icesiolz Sep 19, 2019
6de457a
Update UserGuide.adoc
Icesiolz Sep 19, 2019
7613e5f
Update README.adoc
sianghwee Sep 19, 2019
65401dc
Update README.adoc
sianghwee Sep 19, 2019
c5b9c33
Update README.adoc
sianghwee Sep 19, 2019
bacdef8
Update UserGuide.adoc
Icesiolz Sep 20, 2019
4a19dcc
Walk through tutorial tracing code
mannggoo Sep 25, 2019
1ea0611
Add files via upload
cholmes899 Oct 1, 2019
d3d4fee
Update AboutUs.adoc
cholmes899 Oct 1, 2019
b0a0a23
Merge branch 'master' into HEAD
mannggoo Oct 1, 2019
00d7345
Update AboutUs and ContactUs
mannggoo Oct 1, 2019
65dfe55
Set theme jekyll-theme-slate
mannggoo Oct 1, 2019
d74d261
Update README.adoc
cholmes899 Oct 2, 2019
78cf7e0
Edit _config.yml
mannggoo Oct 2, 2019
ba6468f
Merge branch 'master' of https://github.com/mannggoo/main
mannggoo Oct 2, 2019
5047479
Merge branch 'master' of https://github.com/AY1920S1-CS2103T-T10-3/main
mannggoo Oct 2, 2019
9fe37ae
Add newline at EOF _config.yml
mannggoo Oct 2, 2019
13370a5
Modify EOF _config.yml
mannggoo Oct 2, 2019
d5a437f
Edit EOF for _config.yml
mannggoo Oct 2, 2019
a23b89e
Merge pull request #40 from mannggoo/master
blimyj Oct 2, 2019
f7e3e13
Update User Guide
mannggoo Oct 2, 2019
45e8653
Update README.adoc
mannggoo Oct 2, 2019
504d38d
Merge pull request #43 from mannggoo/master
blimyj Oct 2, 2019
459a190
Update DeveloperGuide.adoc
sianghwee Oct 2, 2019
0b0d15e
Update DeveloperGuide.adoc
sianghwee Oct 2, 2019
e3c4604
Merge pull request #44 from sianghwee/sianghwee-patch-1
sianghwee Oct 2, 2019
bc96022
Changed header to fit project name
sianghwee Oct 2, 2019
4b0cdfc
Merge pull request #46 from sianghwee/sianghwee-patch-2
sianghwee Oct 2, 2019
3eb8281
Update user stories
sianghwee Oct 2, 2019
ebf8f58
Merge pull request #47 from sianghwee/sianghwee-patch-3
sianghwee Oct 2, 2019
eba31a0
Changed MainWindow.fxml to split-screen view.
Icesiolz Oct 3, 2019
7f38d16
MainWindow: Included tabs and removed unnecessary elements like menu.
Icesiolz Oct 3, 2019
940b0b2
MainWindow: Included tabs and removed unnecessary elements like menu.
Icesiolz Oct 3, 2019
334ee8d
Merge pull request #49 from Icesiolz/master
Icesiolz Oct 3, 2019
d5f26ad
Edit the URL of Travis to point to the right webpage
sianghwee Oct 3, 2019
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 6 additions & 7 deletions README.adoc
Original file line number Diff line number Diff line change
@@ -1,11 +1,7 @@
= Address Book (Level 3)
= ELISA
ifdef::env-github,env-browser[:relfileprefix: docs/]

https://travis-ci.org/se-edu/addressbook-level3[image:https://travis-ci.org/se-edu/addressbook-level3.svg?branch=master[Build Status]]
https://ci.appveyor.com/project/damithc/addressbook-level3[image:https://ci.appveyor.com/api/projects/status/3boko2x2vr5cc3w2?svg=true[Build status]]
https://coveralls.io/github/se-edu/addressbook-level3?branch=master[image:https://coveralls.io/repos/github/se-edu/addressbook-level3/badge.svg?branch=master[Coverage Status]]
https://www.codacy.com/app/damith/addressbook-level3?utm_source=github.com&utm_medium=referral&utm_content=se-edu/addressbook-level3&utm_campaign=Badge_Grade[image:https://api.codacy.com/project/badge/Grade/fc0b7775cf7f4fdeaf08776f3d8e364a[Codacy Badge]]
https://gitter.im/se-edu/Lobby[image:https://badges.gitter.im/se-edu/Lobby.svg[Gitter chat]]
https://travis-ci.org/AY1920S1-CS2103T-T10-3/main[image:https://travis-ci.org/AY1920S1-CS2103T-T10-3/main.svg?branch=master[Build Status]]

ifdef::env-github[]
image::docs/images/Ui.png[width="600"]
Expand All @@ -15,9 +11,11 @@ ifndef::env-github[]
image::images/Ui.png[width="600"]
endif::[]

* This is a desktop Address Book application. It has a GUI but most of the user interactions happen using a CLI (Command Line Interface).
* Extremely Loud and Intelligent Student Assistant (ELISA) is for students who *want to have an intelligent companion that keeps track of tasks and give friendly reminders on when to take breaks*.
* More importantly, ELISA is *optimized for those who prefer to work with a Command Line Interface* (CLI) while still having the benefits of a Graphical User Interface (GUI). If you can type fast, ELISA can get your tasks done faster than traditional GUI apps.
* It is a Java sample application intended for students learning Software Engineering while using Java as the main programming language.
* It is *written in OOP fashion*. It provides a *reasonably well-written* code example that is *significantly bigger* (around 6 KLoC)than what students usually write in beginner-level SE modules.
* Interested? Jump to the <<Quick Start>> to get started. Enjoy!

== Site Map

Expand All @@ -29,6 +27,7 @@ endif::[]

== Acknowledgements

* Built on AddressBook-Level3 project created by SE-EDU initiative at https://se-education.org
* Some parts of this sample application were inspired by the excellent http://code.makery.ch/library/javafx-8-tutorial/[Java FX tutorial] by
_Marco Jakob_.
* Libraries used: https://openjfx.io/[JavaFX], https://github.com/FasterXML/jackson[Jackson], https://github.com/junit-team/junit5[JUnit5]
Expand Down
50 changes: 25 additions & 25 deletions docs/AboutUs.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -4,53 +4,53 @@
:imagesDir: images
:stylesDir: stylesheets

AddressBook - Level 3 was developed by the https://se-edu.github.io/docs/Team.html[se-edu] team. +
_{The dummy content given below serves as a placeholder to be used by future forks of the project.}_ +
ELISA _(Exceptionally Loud and Intelligent Student Assistant)_ - Was developed by the https://github.com/AY1920S1-CS2103T-T10-3[T10-3] team. +
ELISA is a student assistant made for college students who need constant reminders to complete their daily tasks. More importantly, ELISA is optimized for those who prefer to work with a Command Line Interface (CLI) while still having the benefits of a Graphical User Interface (GUI). +
{empty} +
We are a team based in the http://www.comp.nus.edu.sg[School of Computing, National University of Singapore].
We are a student team based in the http://www.comp.nus.edu.sg[School of Computing, National University of Singapore].

== Project Team

=== John Doe
image::damithc.jpg[width="150", align="left"]
{empty}[http://www.comp.nus.edu.sg/~damithch[homepage]] [https://github.com/damithc[github]] [<<johndoe#, portfolio>>]
=== Bryan Lim
image::blimyj.png[width="150", align="left"]
{empty}[http://github.com/blimyj[github]] [<<johndoe#, portfolio>>]

Role: Project Advisor
Role: Developer +
Responsibilities: Commons

'''

=== John Roe
image::lejolly.jpg[width="150", align="left"]
{empty}[http://github.com/lejolly[github]] [<<johndoe#, portfolio>>]
=== Hema
image::lrchema.png[width="150", align="left"]
{empty}[http://github.com/lrchema[github]] [<<johndoe#, portfolio>>]

Role: Team Lead +
Responsibilities: UI
Role: Developer +
Responsibilities: Functionality

'''

=== Johnny Doe
image::yijinl.jpg[width="150", align="left"]
{empty}[http://github.com/yijinl[github]] [<<johndoe#, portfolio>>]
=== Lim Yu Hui
image::mannggoo.png[width="150", align="left"]
{empty}[http://github.com/mannggoo[github]] [<<johndoe#, portfolio>>]

Role: Developer +
Responsibilities: Data
Responsibilities: Logic

'''

=== Johnny Roe
image::m133225.jpg[width="150", align="left"]
{empty}[http://github.com/m133225[github]] [<<johndoe#, portfolio>>]
=== Low Cheng Yi
image::Icesiolz.png[width="150", align="left"]
{empty}[http://github.com/Icesiolz[github]] [<<johndoe#, portfolio>>]

Role: Developer +
Responsibilities: Dev Ops + Threading

Responsibilities: UI
'''

=== Benson Meier
image::yl_coder.jpg[width="150", align="left"]
{empty}[http://github.com/yl-coder[github]] [<<johndoe#, portfolio>>]
=== Ng Siang Hwee
image::sianghwee.png[width="150", align="left"]
{empty}[http://github.com/sianghwee[github]] [<<johndoe#, portfolio>>]

Role: Developer +
Responsibilities: UI
Responsibilities: Model

'''
5 changes: 3 additions & 2 deletions docs/ContactUs.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
:site-section: ContactUs
:stylesDir: stylesheets

* *Bug reports, Suggestions* : Post in our https://github.com/se-edu/addressbook-level3/issues[issue tracker] if you noticed bugs or have suggestions on how to improve.
* *Bug reports, Suggestions* : Post in our https://github.com/AY1920S1-CS2103T-T10-3/main/issues[issue tracker] if you noticed bugs or have suggestions on how to improve.
* *Contributing* : We welcome pull requests. Follow the process described https://github.com/oss-generic/process[here]
* *Email us* : You can also reach us at `damith [at] comp.nus.edu.sg`
* *Email us* : You can also reach us at `holmescordelia8 [at] gmail.com`

112 changes: 92 additions & 20 deletions docs/DeveloperGuide.adoc
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
= AddressBook Level 3 - Developer Guide
= ELISA - Developer Guide
:site-section: DeveloperGuide
:toc:
:toc-title:
Expand All @@ -14,7 +14,7 @@ ifdef::env-github[]
endif::[]
:repoURL: https://github.com/se-edu/addressbook-level3/tree/master

By: `Team SE-EDU`      Since: `Jun 2016`      Licence: `MIT`
By: `AY1920S1-CS2103T-T10-3`      Since: `Sep 2019`      Licence: `MIT`

== Setting up

Expand Down Expand Up @@ -279,13 +279,15 @@ Refer to the guide <<DevOps#, here>>.

*Target user profile*:

* has a need to manage a significant number of contacts
* has a need to manage a significant number of tasks
* needs reminders to take breaks or move on to cover all their work
* prefers to be more organized with their time and tasks
* prefer desktop apps over other types
* can type fast
* prefers typing over mouse input
* is reasonably comfortable using CLI apps

*Value proposition*: manage contacts faster than a typical mouse/GUI driven app
*Value proposition*: manage time and tasks more efficiently than a typical mouse/GUI driven app

[appendix]
== User Stories
Expand All @@ -295,52 +297,122 @@ Priorities: High (must have) - `* * \*`, Medium (nice to have) - `* \*`, Low (un
[width="59%",cols="22%,<23%,<25%,<30%",options="header",]
|=======================================================================
|Priority |As a ... |I want to ... |So that I can...
|`* * *` |new user |see usage instructions |refer to instructions when I forget how to use the App
|`* * *` |user |add a new task |

|`* * *` |user |add a new person |
|`* * *` |user |mark a task as done | keep track of my remaining tasks

|`* * *` |user |delete a person |remove entries that I no longer need
|`* * *` |user |delete a task |remove tasks that I no longer need

|`* * *` |user |find a person by name |locate details of persons without having to go through the entire list
|`* * *` |user |find a task by description |find only the tasks that are relevant to me at that point in time

|`* *` |user |hide <<private-contact-detail,private contact details>> by default |minimize chance of someone else seeing them by accident
|`* *` |busy student |see my reminders as notifications|be reminded of them even in other applications

|`*` |user with many persons in the address book |sort persons by name |locate a person easily
|`* *` |user with many tasks |sort tasks by priority |identify which tasks require my immediate attention
|=======================================================================

_{More to be added}_

[appendix]
== Use Cases

(For all use cases below, the *System* is the `AddressBook` and the *Actor* is the `user`, unless specified otherwise)
(For all use cases below, the *System* is `ELISA` and the *Actor* is the `user`, unless specified otherwise)

[discrete]
=== Use case: Delete person

=== Use Case 001: Marking a task as done
*MSS*

1. User requests to list persons
2. AddressBook shows a list of persons
3. User requests to delete a specific person in the list
4. AddressBook deletes the person
1. User enters the command to show the task list.
2. ELISA shows the task list to the user.
3. User marks the task as done by using the index of the task.
4. ELISA updates the task list.
5. ELISA shows the updated task list to the user.
+
Use case ends.

*Extensions*

[none]
* 2a. The list is empty.
* 2a. The task list is empty.
+
Use case ends.

* 3a. The given index is invalid.
+
[none]
** 3a1. AddressBook shows an error message.
** 3a1. ELISA shows an error message.
+
Use case resumes at step 2.

[discrete]
=== Use Case 002: Adding a task
*MSS*

1. User creates a new task with a description.
2. ELISA informs the user that the task has been added.
+
Use case ends.

*Extensions*

* 1a. User can add deadline.
+
** 1a1. ELISA informs the user that a deadline has been added to that task.
+
Use case ends

* 1b. User can add a reminder date.
+
** 1b1. ELISA informs the user that a reminder has been added to that task.
+
Use case ends

* 1c. User enters an empty description.
+
** 1c1. ELISA informs the user that the description cannot be empty.
+
** 1c2. User enters a non-empty description
+
Use case resumes at step 2

* a. At any time, User can view the task from the task list or the calendar view.
* b. At any time, User can add a deadline to the task
* c. At any time, User can add a reminder to the task

[discrete]
=== Use Case 003: Deleting a task

*MSS*

1. User enters the command to show the task list.
2. ELISA shows the task list.
3. User request to delete a task based on its index.
4. ELISA deletes the task from the task list.
5. ELISA shows the updated task list.

+
Use case ends.

*Extensions*

* 2a. The task list is empty.
+
Use case ends.

* 3a. The given index is invalid.
+
** 3a1. ELISA shows an error message.
+
Use case resumes at step 2.

[discrete]
=== Use Case 004: Find upcoming reminders.

*MSS*

1. User enters the command to show the reminder list.
2. ELISA shows the reminder list.
3. User enters command to sort reminders by date and time.
4. ELISA shows the updated list of reminders sorted by date and time.

_{More to be added}_

[appendix]
Expand Down
Loading