conorep / adviseitstarter Goto Github PK

Narrative
As a user
I want to be able to print the plan when needed so I can have a hard copy.

All data should be shown!

Narrative
As a student
I want to look up my advisor
So that I know I have an advisor assigned to me and can go to them for advising.

Narrative
As a system administrator
I want to be able to log in and see a list/table of all created plans (linked by token), when a plan was created and which advisor

Each plan should have separate ID's/Hash and the Hashes should all be different from each other

Narrative:
As an advisor
I want to click/use an existing link containing a six-character identifier (token)
So that I can view the data previously saved (classes and comments) in a plan (F, W, Sp, Su quarters) in their respective
locations
Acceptance Criteria:
When I navigate to a plan page with an invalid or unused identifier/token
Then I should be redirected to the home page
When I navigate to a plan page with a valid identifier/token
Then I should see the plan with my previously saved text in the F, W, Sp, Su fields
And I should be able to edit the previously saved text on the field
Given I navigate to a plan page with a valid identifier/token
And the previously saved plan had text in one or more of the fields
When I edit previously saved text in the F, W, Sp, Su fields
And I click on the Save button
Then I should see a confirmation that the plan has been saved
And I should see a Last Updated field on the plan that shows the date and time when the save occurred
Given I navigate to a plan page with a valid identifier/token
And the previously saved plan had text in one or more of the fields
When I do NOT edit previously saved text in the F, W, Sp, Su fields
And I click on the Save button
Then I should see a confirmation that the plan has been saved
And I should see a Last Updated field on the plan that shows the date and time when the save occurred
Given I navigate to a plan page with a valid identifier/token
And the previously saved plan had text in one or more of the fields
When I remove text from the field (clearing the field)
And I click on the Save button
Then I should see a confirmation that the plan has been saved
And I should see a Last Updated field on the plan that shows the date and time when the save occurred
Given I navigate to a plan page with a valid identifier/token
And the previously saved plan had NO text in any of the fields
When I add new text in the F, W, Sp, Su fields
And I click on the Save button
Then I should see a confirmation that the plan has been saved
And I should see a Last Updated field on the plan that shows the date and time when the save occurred

Narrative
As an advisee
I want the URL that is visible during the construction/editing of my academic plan to contain my unique 6-character token
So I can use this URL to directly return to my edited plan.

Possible example:
https://adviseit.com/plan.php?id=9MUPX4
Another possible example:
https://adviseit.com/plan/9MUPX4

URL should be the same while the plan is being edited.
The token should be in the URL (and can also be visible on the page).

URL should be visible when a new plan is being created or when it is re-visited.

Narrative:
As an advisor
I want to add classes and comments into an plan (F, W, Sp, Su quarters) and save my additions
So that I can keep a record of the plan and later retrieve it in the future.

Acceptance Criteria:
Given I have created a new plan
When I enter text into the Fall, Winter, Spring, and Summer fields
And I click Save
Then I should see a confirmation that the plan has been saved
And I should see a Last Updated field on the plan that shows the date and time when the save occurred
Given I have created a new plan
When I add text to the Fall, Winter, Spring fields
And I leave the Summer field blank
And I click Save
Then I should see a confirmation that the plan has been saved
And I should see a Last Updated field on the plan that shows the date and time when the save occurred
Given I have created a new plan
When I leave the Fall, Winter, Spring, and Summer fields blank
And I click Save
Then I should see a confirmation that the plan has been saved
And I should see a Last Updated field on the plan that shows the date and time when the save occurred
Given I have a plan that I previously completed and saved
When I modify text in any of the text fields (Fall, Winter, Spring, and Summer)
And I click Save
Then I should see a confirmation that the plan has been saved
And I should see a Last Updated field on the plan that shows the date and time when the save occurred
Given I have a plan that I previously completed and saved
When I do NOT modify text in any of the text fields (Fall, Winter, Spring, and Summer)
And I click Save
Then I should see a confirmation that the plan has been saved
And I should see a Last Updated field on the plan that shows the date and time when the save occurred
Notes:
Content for a sample education plan may look like the following...
Fall Winter
CS 108 SDEV 121
SDEV 101 SDEV 106
MATH 097 MATH& 141
Fill out Advisor Change Form Apply for Foundation Scholarship
Spring Summer
SDEV 117
SDEV 201
ENGL& 101
Submit Intent to Graduate Form

Narrative:
As an advisor
I want to create a new education plan
So that I can have a starting place to work with an individual student and eventually save their plan
Acceptance Criteria:
Given I am on the home page
When I click on the button to create a new plan
Then I should see a new blank plan page appear
And that blank plan should have a visible unique six-character identifier (token)
And that blank plan should have 4 fields for me to type classes and notes for 4 quarters (F, W, Sp, Su)
Given I am on the home page
And I have previously created one or more plans
When I click on the button to create a new plan
Then I should see a new blank plan page appear
And that blank plan should have a visible unique six-character identifier (token)
And that identifier (token) should be different from any of the previously created plan identifiers
Given I am on a plan page
When I click the browser back button to return to the homepage
And I click on the button to create a new plan
Then I should see a new blank plan page appear
And that blank plan should have a visible unique six-character identifier (token)
And that identifier (token) should be different from any of the previously created plan identifiers

Narrative
As an Advisor,
Every quarter should have a unique label to indicate its quarter and year.
Every School Year starts in Fall, then Winter/Spring/Summer quarters are in the next calendar year.

Narrative
As an Advisor,
If I am creating a plan in June or before,
I should be shown the previous school year's F/W/Sp/Su Quarters.
If I am creating a plan in July or after,
I should be shown the next School year's F/W/Sp/Su Quarters.

Narrative
As an Advisor,
I want to add the correct School years before and/or after the current year
So that everyone can differentiate year vs year
And have a plan that matches their AAS Data and Software class plan over 2-4 total years.

Narrative
As an Advisee,
When I open my plan,
I should see all of the school years where I have classes listed.
If I have no classes listed,
I should see the current school year.

NOTES

    9                   10                      11                       12

Fall 2022 -> Winter 2023 -> Spring 2023 -> Summer 2023 ->
Fall 2023 -> Winter 2024 -> Spring 2024 -> Summer 2024 ..
13 14 15 16

We know what school year we are in right now, but we don't always want to start with this school year in the future.

If I make a plan in June or before, show this academic year. If I make a plan in July or after, it should show me the next academic year.
Before June of this year: show Fall 2022 -> Winter 2023 -> Spring 2023 -> Summer 2023
Starting in July of this year: show Fall 2023 -> Winter 2024 -> Spring 2024 -> Summer 2024
4 quarters always visible, it's going to be one of the above, depending on today's date
(Don't lose plans from previous years - keep those and then add on 4 more blocks)
(Will not go more than 2 years back from the current date - Fall 2020)
(Will not go more than beyond 2040, Summer 2040 is the last recognized field)

Maybe a lookup table like this:
Term -> Label
1 -> Fall 2020
2 -> Winter 2021
3 -> Spring 2021
4 -> Summer 2021
5 -> Fall 2021
6 -> Winter 2022
7 -> Spring 2022
8 -> Summer 2022
9 -> Fall 2022