-
Notifications
You must be signed in to change notification settings - Fork 263
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-W16-3] StudyBuddy #55
base: master
Are you sure you want to change the base?
Changes from 51 commits
44a4afc
9c1e5f0
7a9a277
69095a2
46f2828
7ac3e09
2c2818b
8e20ecf
3e5e6de
fccac91
c73564c
1f8ab86
9703e78
939715a
1482abf
c97064b
920f06c
7f24c21
d8b0d4b
9ae80e7
f138147
05a4ae9
8f7c3a6
5e98b48
de66df9
6bbef82
62d6307
86269d8
bcda652
d9f1f91
e5badc4
61c7eeb
1cb56d5
3a1e534
c5cf958
d650997
84c2fa1
42a8b9d
4498978
a9a000b
35fbbb1
7fbb569
7c820d4
7d634f4
571f165
9291e24
5fb1082
3c9e3f6
161d208
6496401
4c73ad0
a4dd125
18161a2
09eef62
d8a2439
889dce6
5237b4a
199bedc
68062a0
f04bde3
96cbe92
00cfe78
fda7e79
a846bb5
06d13fd
6a35404
e3c7c0b
ae3508b
0466b40
061772d
563fba7
ce40a9e
bc62586
48a2c3c
6330da0
f0e9f9d
7f3a068
a95c346
2256853
4dff026
d1ba7bc
1772b3a
0d609cc
873fd8c
8ce759b
2c6a43a
0264871
256048a
66edb9f
a97d3ce
d833415
e9422b1
43aacbe
7d9e1bb
d308427
e58c6d4
5b079d5
933521f
f72a5b3
e046157
2b0d509
0fa83a7
9156c0b
ccff9a5
ec3d87c
983b44f
346fec3
d6b598f
03674e2
486ec84
ae3173a
2b98f1d
5069671
65fd87f
59f98bb
ec32a66
6372c2f
6a618d4
3aeaa8b
1e18e48
c429900
ecf87f3
db2fae1
78096ae
0fef243
b79fc7d
f1270e6
b0e900b
b022ecd
7e8e34b
acb2636
9442e2a
8d9b41f
f0d0ee4
495d302
456ad4c
f8df9b1
29040fc
a332f53
02e6cf4
e06ae0b
cae9d6d
cd80890
be790ce
016ec63
c3401d8
46fd1f4
3a0c37c
0ec2d15
3e396e6
96b7548
9617e5a
ee85f16
96cf544
806bf2e
56598d3
1ac2a61
688b183
565630a
b171106
d676d6c
e048835
6adf0b7
7377e9f
7578d27
f011b0d
afd2cc8
0c9b7a2
09963a7
d9d752e
b49d150
5e9fc03
85b2796
0f905b5
0af11b9
0c18041
f461b4f
2ed56ff
36b38b2
4cb265f
7fc01f4
86e925a
c01e278
bd7de6d
c6c967b
1408500
d76eb13
4c37685
ce30e24
9d2442e
f8d7054
8815034
c3ba388
fd53772
e332d85
dc27f33
9d4bdb4
8c71b01
2d3eea7
64c91c3
9f9c604
789b4ca
8385666
a0b71aa
f937d39
3807a18
72fea11
ab41630
f24de1f
43ef62a
d3cd6f5
442491b
7492d22
2385c73
cc00003
1a84450
6611e4e
cd26c74
110a0a9
cff6341
c21dcfe
b6a422d
0120dac
cbd46d6
eecf83f
c6700d7
d0b11bb
616a71b
459e961
6611e5c
1e009be
15e82e8
6c9ca36
557c047
afd016e
3441af0
f20f731
a031001
18b62bd
0790da1
77aa9b9
fd9305f
bf462cc
9f03f6e
a2b2866
e4b4700
6195e36
ddddb6f
e89284d
60421f0
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,36 +1,54 @@ | ||
= Address Book (Level 3) | ||
ifdef::env-github,env-browser[:relfileprefix: docs/] | ||
= Study Buddy | ||
======= | ||
|
||
== Introduction | ||
|
||
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]] | ||
ifdef::env-github,env-browser[:relfileprefix: docs/] | ||
|
||
https://github.com/AY1920S2-CS2103T-W16-3/main[image:https://travis-ci.org/AY1920S2-CS2103T-W16-3/main.svg?branch=master[Build Status]] | ||
|
||
ifdef::env-github[] | ||
image::docs/images/Ui.png[width="600"] | ||
endif::[] | ||
|
||
ifndef::env-github[] | ||
image::images/Ui.png[width="600"] | ||
image::images/Ui.png[width="600", title="UI Sample Picture, will be updated in ther future"] | ||
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). | ||
* 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. | ||
|
||
==== What is Study Buddy ? | ||
|
||
* Study Buddy is a task management tool for students who wish to organise their tasks more efficiently. | ||
* With the help of Study Buddy, students can easily view and manage their module related tasks. | ||
* Sort, filter and search commands are also provided to make the interaction more useful. | ||
* It also provides services to show the statistics for time, grades breakdown and workload comparison between different | ||
modules in Pie charts. This visualisation of data helps students become more aware of their pending work and which tasks to spend more time on. | ||
|
||
|
||
==== Who can benefit most from Study Buddy? | ||
======= | ||
|
||
* It is designed for students who can type fast and are comfortable with `Command-Line Interface(CLI)`. | ||
======= | ||
==== What is CLI? | ||
* CLI is a command line program that accepts text input to execute operating system functions. | ||
* Compare with graphical user interfaces(GUI), CLI performs interaction with user by keyboard input instead of | ||
mouse clicking, such as command window. | ||
|
||
== Site Map | ||
To browse more information, please check our site map: | ||
|
||
* <<UserGuide#, User Guide>> | ||
* <<DeveloperGuide#, Developer Guide>> | ||
* <<LearningOutcomes#, Learning Outcomes>> | ||
* <<AboutUs#, About Us>> | ||
* <<ContactUs#, Contact Us>> | ||
|
||
== Acknowledgements | ||
|
||
* Some parts of this sample application were inspired by the excellent http://code.makery.ch/library/javafx-8-tutorial/[Java FX tutorial] by | ||
* Some parts of this 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] | ||
* Libraries used: https://openjfx.io/[JavaFX], | ||
https://github.com/FasterXML/jackson[Jackson], https://github.com/junit-team/junit5[JUnit5] | ||
|
||
|
||
== Licence : link:LICENSE[MIT] |
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,4 +1,4 @@ | ||
= AddressBook Level 3 - Developer Guide | ||
= Study Buddy - Developer Guide | ||
:site-section: DeveloperGuide | ||
:toc: | ||
:toc-title: | ||
|
@@ -12,9 +12,9 @@ ifdef::env-github[] | |
:note-caption: :information_source: | ||
:warning-caption: :warning: | ||
endif::[] | ||
:repoURL: https://github.com/se-edu/addressbook-level3/tree/master | ||
:repoURL: https://github.com/AY1920S2-CS2103T-W16-3/main | ||
|
||
By: `Team SE-EDU` Since: `Jun 2016` Licence: `MIT` | ||
By: `Team Drag&Drop` Since: `Jan 2020` | ||
|
||
== Setting up | ||
|
||
|
@@ -297,33 +297,32 @@ Priorities: High (must have) - `* * \*`, Medium (nice to have) - `* \*`, Low (un | |
|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 person | | ||
|`* * *` |user |add a new task | | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. By removing persons object from your project, does this mean that there's no longer a address book functionality at all? |
||
|
||
|`* * *` |user |delete a person |remove entries that I no longer need | ||
|`* * *` |user |delete a task |remove entries 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 keyword |locate details of a task without having to go through the entire list | ||
|
||
|`* *` |user |hide <<private-contact-detail,private contact details>> by default |minimize chance of someone else seeing them by accident | ||
|`* *` |user with many deadlines |sort tasks in order of deadlines |organise my list by priority | ||
|
||
|`*` |user with many persons in the address book |sort persons by name |locate a person easily | ||
|======================================================================= | ||
|
||
_{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 `Study Buddy` and the *Actor* is the `user`, unless specified otherwise) | ||
|
||
[discrete] | ||
=== Use case: Delete person | ||
=== Use case: Delete task | ||
|
||
*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 requests to list tasks | ||
2. Study Buddy shows a list of tasks | ||
3. User requests to delete a specific task in the list | ||
4. Study Buddy deletes the task | ||
+ | ||
Use case ends. | ||
|
||
|
@@ -337,7 +336,7 @@ Use case ends. | |
* 3a. The given index is invalid. | ||
+ | ||
[none] | ||
** 3a1. AddressBook shows an error message. | ||
** 3a1. Study Buddy shows an error message. | ||
+ | ||
Use case resumes at step 2. | ||
|
||
|
@@ -347,7 +346,7 @@ _{More to be added}_ | |
== Non Functional Requirements | ||
|
||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Any more NFRs to add? e.g. should be NUS student, response time of system |
||
. Should work on any <<mainstream-os,mainstream OS>> as long as it has Java `11` or above installed. | ||
. Should be able to hold up to 1000 persons without a noticeable sluggishness in performance for typical usage. | ||
. Should be able to hold up to 1000 tasks without a noticeable sluggishness in performance for typical usage. | ||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. noticeable sluggishness should be quantified (e.g 300ms or smth) There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. need to be more specific about what is a noticeable sluggishness |
||
. A user with above average typing speed for regular English text (i.e. not code, not system admin commands) should be able to accomplish most of the tasks faster using commands than using the mouse. | ||
|
||
_{More to be added}_ | ||
|
@@ -358,9 +357,6 @@ _{More to be added}_ | |
[[mainstream-os]] Mainstream OS:: | ||
Windows, Linux, Unix, OS-X | ||
|
||
[[private-contact-detail]] Private contact detail:: | ||
A contact detail that is not meant to be shared with others | ||
|
||
[appendix] | ||
== Product Survey | ||
|
||
|
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.
Can filtering searches be added as a user story?