User Stories & Acceptance Criteria

1. User Stories - Story: Text/Images

As a user, I want to have a story read to me.


Scenario 1: The logged-in user's selected story is opened, and the correct story text is displayed.
Given: The user is logged in.
When: The story is selected.
Then: The text for the story is pulled from the database and displayed on the left side of the screen.

Scenario 2: The logged-in user's selected story is open, and the correct images pertaining to the story are displayed.
Given: The user is logged in.
When: The story is opened and being read.
Then: The images corresponding to the story are displayed alongside the text.

Scenario 3: The logged-in user's selected story is open, and the text auto scrolls while the story is read.
Given: The user is logged in and selected a story.
When: The story is being read and current text reaches halfway down the screen.
Then: The text will auto-scroll to keep the current word centered in the screen, and remove the need to scroll while being read to.

2. User Stories - Quiz: Cue Words

As a logged-in user, I want to test my knowledge of cue words, so I can learn unknown cue words.

Scenario 1: The logged-in user accurately answers quiz questions over unknown cue words clicked by the user from the story.
Given: The user is logged-in and finished reading a story.
When: The user is quizzed over clicked cue words from a finished story and answers correctly.
Then: The user is rewarded gold coins and a gold star appears on the screen and mastery of the word is progressed by 1. If this was the user's 2nd attempt at a correct answer then a silver coin is awarded.

Scenario 2:The logged-in user inaccurately answers quiz questions over unknown cue words clicked by the user from the story.
Given:The user is logged-in and finished reading a story.
When:The user is quizzed over clicked cue words from a finished story and answers incorrectly.
Then:The quiz gives the user a 2nd attempt, and if there is a gold star on screen, then it turns into a silver star. Also, mastery of words has decreased by 1.

Scenario 3: The logged-in user fails a quiz over unknown cue words clicked by the user from the story.
Given: The user is logged-in and finished reading a story.
When: The user fails quiz over clicked cue words from a finished story.
Then: The story will be marked as incomplete. After the user has reread the story, the quiz will be open for students to retake.

3. User Stories - Quiz: Target Words

As a logged-in user, I want to understand target words, so I can excel in my quiz.

Scenario 1: The logged-in user accurately answers quiz question over randomly selected word from story.
Given: The user is logged-in and finished reading a story.
When: The user is quizzed over a randomly selected word from a finished story and answers correctly.
Then: The user is rewarded gold coins and a gold star appears on the screen and mastery of word is progressed by 1. If this was the user's 2nd attempt at a correct answer then a silver coin is awarded.

Scenario 2: The logged-in user inaccurately answers quiz question over randomly selected word from story.
Given: The user is logged-in and finished reading a story.
When: The user is quizzed over a randomly selected word from a finished story and answers incorrectly.
Then: The quiz gives the user a 2nd attempt, and if there is a gold star on screen, then it turns into a silver star. Also, mastery of word is decreased by 1.

Scenario 3: The logged-in user fails quiz over randomly selected target words.
Given:The user is logged-in and finished reading a story.
When:The user fails quiz over target words based on finished story.
Then:The story will be marked as incomplete. After the user rereads the story, the student has to try to pass the quiz again.

4. User Stories - Account: Class Performance

As a teacher I want to check my class' performance as a whole to make sure they understand the material.

Scenario 1: The teacher wants to view a page of the class' composite scores.
Given: The teacher is logged in and has assigned his/her students valid ID numbers.
When: The teacher clicks on the class performance tab of the app.
Then: The app will launch a page with a list of the students' names and pages available to view compiled data about works read and target quizzes.

Scenario 2: The teacher wants to see how many works his/her class has read.
Given: The teacher is logged in and has assigned his/her students valid ID numbers.
When: The teacher selects the works read page on the class performance tab.
Then: The app will show a page displaying an overall assessment of how the class as a whole is performing on works read. The students will be given a rating of either work mastered or work not mastered. The teacher will be able to see how many of the stories the class has mastered and track the class' progress.

Scenario 3: The teacher wants to see how his/her class is performing on target word quizzes.
Given: The teacher is logged in and has assigned his/her students valid ID numbers.
When: The teacher selects the Individual target word page on the class performance tab.
Then: The app will show a page displaying an overall assessment of how the class as a whole is performing on target word quizzes. The teacher will be able to see a report about how many consecutive correct, total correct, and total incorrect answers the class has earned as a group across their combined target word quizzes.

5. User Stories - Reward/Database: Zoo

As a student, I want to buy animal parts so I can make my own animal in my personal zoo.

Scenario 1: The student buys animal parts to combine them for zoo.
Given: The student has enough coin to purchase animal parts.
When: The user purchase desire animal parts to later combine to make their own animal.
Then: The program lets users purchase animal parts and make animal for the zoo. The chosen animal parts/animal is unlocked on their account.

Scenario 2: The student cannot buy animal parts to combine them for zoo.
Given: The student does not have enough coin to purchase animal parts.
When: The user tries to purchase animal parts but cannot due to lack of coin.
Then: The program does not allow users to purchase animal parts and make animals for the zoo. A message is displayed that tells users that they do not have enough coins to purchase the item.

Scenario 3: The student wants to create complete animals.
Given: The student has a collection of animal body parts.
When: The user tries to create a complete animal.
Then: The program lets users choose and pick the corresponding head, body, and legs to complete a full animal.

6. User Stories - Story: Audio

As a student, I want to hear the story read out loud so I can follow along.

Scenario 1: The student chooses a story to read.
Given: The student is logged in and on the home page.
When: The student clicks on the story of their choice.
Then: The virtual book will open showing a page of text and the audio version will begin playing automatically.

Scenario 2: The student comes across a word he/she does not know.
Given: The student is in the middle of listening to a story.
When: The student sees a word he/she doesn't know and clicks on that word to see the definition.
Then: The audio file will stop and a new page will pop up with a definition and example of that word being used. Once the student understands this new word and closes the pop-up definition, then the original story file will resume from where it previously stopped automatically.

Scenario 3: The student mutes the story to read independently.
Given: The student is already listening to a story.
When: The student decides to try and read the story on their own and clicks the mute button to turn off the audio file.
Then: The audio file will stop and the mute icon will be set to a flashing setting to remind the student he/she may resume the audio file by clicking the icon again.

7. User Stories - Story: Read Along- Highlight

As a logged-in user, I want to follow along with what is being read, so I can identify different words and those I do not know.

Scenario 1:The logged-in user, opens a story and the first word is highlighted.
Given:The logged-in user selects a story.
When:The story beings being read.
Then:The first word is highlighted to prompt following along with the highlight.

Scenario 2:The logged-in user, is read the story and the highlight follows the current word.
Given:The logged-in user is logged in.
When:The story is being read to the user.
Then:The currently read word will be highlighted and keep with the word currently spoken by the audio.

Scenario 3:The logged-in user, is read a story and all other words, other than the current word, are not highlighted.
Given:The user is logged-in and story is being read.
When:The currently read word is highlighted.
Then:All others words are not highlighted.

8. User Stories - Story: Click Unknown Words

As a logged-in user, I want to click unknown words, so I can learn new words from my story.

Scenario 1:The logged-in user reads a known word in the story.
Given:The user is logged-in.
When:The user reads a word that they know.
Then:The user will not click on the word and the story continues.

Scenario 2:The logged-in user reads an unknown word in the story.
Given:The user is logged-in.
When:The user reads a word that they do not know.
Then:A modal pops up to define the word and provides phonics and photos. The unknown word is stored in a database of their other unknown and missed words.

Scenario 3:The logged-in user forgets a previously quizzed word in the story.
Given:The user is logged-in.
When:The user reads a word that they have been quizzed over, but forgot the definition.
Then:A modal pops up to redefine the word and provides phonics and photos. The stored word drops down a level in the mastery progress.

9. User Stories - Quiz: Mastery Level

As a logged-in user, I want to test my mastery of words, so I can increase my mastery of words.

Scenario 1:The logged-in user accurately answers quiz questions over words from user's dictionary.
Given:The user is logged-in and finished reading a story.
When:The user is quizzed over words from user's dictionary and answers correctly.
Then:The user is rewarded gold coins and a gold star appears on the screen and mastery of word is progressed by 1. If this was the user's 2nd attempt at a correct answer then a silver coin is awarded.

Scenario 2:The logged-in user inaccurately answers quiz questions over words from user's dictionary.
Given:The user is logged-in and finished reading a story.
When:The user is quizzed over words from user's dictionary and answers incorrectly.
Then:The quiz gives the user a 2nd attempt. and if there is a gold star on screen, then it turns into a silver star. Also, mastery of word is decreased by 1.

Scenario 3:The logged-in user fails quiz over words from user's dictionary.
Given:The user is logged-in and finished reading a story.
When:The user fails quiz over words from user's dictionary.
Then:The quiz is marked as unmastered. After the user has reread the stories, the quiz will be open for students to retake.

10. User Stories - Reward/Database: Coin System

As a student, I want to earn coin so I can purchase animal parts.

Scenario 1:The student earns gold coin by getting any of the quiz question perfectly on first try.
Given:The student mastered a quiz question perfectly on first try
When:The user answered a question right on the first try. One correct answer on a first attempt earns a gold coin.
Then:The program gives the user gold coin.

Scenario 2:The student earns silver coin by getting any of the quiz question on second try.
Given:The student mastered a quiz question perfectly on second try
When:The user answered a question right on the second try. One correct answer on a second attempt earns a silver coin.
Then:The program gives the user earns silver coin.

Scenario 3:The student does not answer quiz question in the first two tries.
Given:The user failed to master a quiz.
When:The failed to answer the question correctly in the first two tries.
Then:The program does not give any coins.

11. User Stories - Reward/Database: Database Integration

As a teacher, I want to manage students through shared database.

Scenario 1:The teacher assigns student a unique login ID.
Given:The teacher has access to the database dashboard.
When:The teacher signs up a new student for Read-A-Story.
Then:The program lets teachers give a unique ID for new students.

Scenario 2:The teacher access student record.
Given:The teacher has access to the database dashboard.
When:The teacher pulls information on student's progress through unique ID.
Then:The program lets teachers see student's progress.

Scenario 3:The teacher edit student record.
Given:The teacher has access to the database dashboard.
When:The teacher pulls information on student's progress through unique ID to edit any information.
Then:The program lets teachers manage student's information or progress.

12. User Stories - Reward/Database: Stars and Checkmarks System

As a logged-in user, I want to earn stars and checkmarks, so I can showcase my mastery of words.

Scenario 1:The logged-in user consecutively answers with correct answers on first attempt.

Given:The user is logged-in and answers correctly on first attempt consecutively.

When:The user is quizzed over words from user's dictionary and answers correctly on first attempt.

Then:The user is rewarded gold coins and a gold star appears on the screen. If there is a silver star on screen, then it turns into a gold star.

Scenario 2:The logged-in user answers with correct answers on 2nd attempt.

Given:The user is logged-in and answers correctly on second attempt.

When:The user is quizzed over words from user's dictionary and answers correctly on second attempt.

Then:The user is rewarded silver coins and a silver star appears on the screen. If there is a gold star on screen, then it turns into silver star.

Scenario 3:The logged-in user has earned 5 gold stars.

Given:The user is logged-in and earned 5 gold stars.

When:The user is quizzed over words from user's dictionary and earned 5 gold stars.

Then:The quiz is marked with a white checkmark in a green ball to showcase mastery.

13. User Stories - Account: Login

As a new user, I want to login to my account, so I can use Hearatale's Read-a-Story app.

Scenario 1:The new user wants to sign up.
Given:The user is on the registration page and the user is not registered.
When:The user enters their email, username, and password.
Then:The user is added to the list of enrolled students.

Scenario 2:The user is a teacher or parent and wants to access student's progress.
Given:The user is a teacher or parent and has the access code.
When:The user enters the correct access code.
Then:The user is is brought to the dashboard that has the students' reading progress and quiz scores.

Scenario 3:The user is a student and successfully logged in.
Given:The user is a student and wants to use the app.
When:The user entered their correct login information.
Then:The user can select a story from the story collection to begin reading.

14. User Stories - Lexile Score

As a student, I want to be practicing stories that are the proper difficulty level, so I remain both challenged and engaged.

Scenario 1:The student wants to see how difficult the different stories are.
Given:The student is logged in and understands the lexile score rating system.
When:The user opens the app and goes to the main library page with all the stories.
Then:The page will display the difficulty levels of each story and its content based on the lexile system and scores preassigned and stored in a database by the Hearatale organization.

Scenario 2:The student perfects one of the stories.
Given:The student is logged in and has completed at least one of the stories.
When:The student achieves the rank of having "mastered" one of the stories.
Then:The student's lexile score will increase and the app will recommend he/she try higher level stories. The students will be encouraged to practice with increasingly difficult stories so they remain both engaged and challenged.

15. User Stories - Bouncing Animal

As a student, I want to follow the bouncing animal to know where in the story the audio is reading.

Scenario 1:The student cues an unknown word.
Given:The student is reading the story along with audio.
When:The student clicks on an unknown word.
Then:The bouncing animal would stop on top of the clicked word.

Scenario 2:The student does not cue any word.
Given:The student has access to a reading and audio.
When:the student continues to read without clicking any words.
Then:The bouncing animal would continue.

Scenario 3:The student changes animal.
Given:The student has bought animal skin.
When:The student click on the purchased skin.
Then:The bouncing animal would change.