Login Screen (sample requirements document)

Owned by Jennifer Bessette (Unlicensed)
Last updated: Dec 16, 2022
5 min read

The purpose of this screen is to allow educators and students to manually log into the platform. All users regardless of role will visit the same login screen. Users with an integrated account may log in manually or via SSO through their district portal. The steps below detail how users will manually log into the Rethink Ed platform.

Login Screen

User Story

  • As a user, I want to log into the Rethink Ed platform, so I can complete a task.

UI

 

  • The user will click in the top box and enter their username.

  • The user will click in the lower box and enter their password.

  • After entering a username and password, the user will click the Sign in button to access the platform.

  • If the user clicks the Sign in button without providing a username or password, they will see the error message

  • If the login fails, the user will see a statement that reads “Your login attempt was not successful. Please try again.”

Acceptance Criteria

  • Given I am a user who has typed at least 1 character in the password box, the characters will be hidden

  • Given I am a user attempting to log into Rethink Ed, I will be required to enter a username and password.

  • Given I am a user who has clicked the Sign in button without entering a username, I will see an error message under the user name field

  • Given I am a user who has clicked the Sign in button without entering a password, I will see an error message under the password field

  • Given I am a user who has entered valid login credentials, I will be logged into Rethink Ed

  • Given I am a user who has entered invalid login credentials, I will see the login not successful message and will not be logged into Rethink Ed

  • Given I am a user who has failed to enter valid credentials, I will not be limited in terms of the number of login attempts I can make

Retrieve Username

User Story

  • As a user who does not know their username, I want to retrieve my username, so I can log into Rethink Ed

UI

  • Below the Sign in button, the user will see the statement “I forgot my username or password”

  • If the user clicks the username hyperlink, they will see a screen asking them to enter their email address.

  • If the user clicks the Cancel button, they will return to the main login screen.

  • If the user clicks “Submit” without entering an email address, they will see an error message.

  • Once the user enters a valid email address and clicks “Submit,” they will see a message indicating that the username was sent via email.

  • If the user clicks “Back to login” or “Cancel”, they will return to the main login screen.

Acceptance Criteria

  • Given I am a user who has typed in an email address and clicked the submit button, I will be required to enter a valid email address.

  • Given I am a user who has entered an email address that exists in the Rethink Ed database, I will receive an email containing the username associated with that email.

  • Given I am a user who has entered an email address that DOES NOT exist in the Rethink Ed database, I will NOT receive an email.

Retrieve Password

User Story

  • As a user who does not know their password, I want to reset my password, so I can log into Rethink Ed

UI

  • If the user clicks the password hyperlink on the main login screen, they will see a screen asking them to enter their email address.

  • If the user clicks the Cancel button, they will return to the main login screen

  • If the user clicks “Submit” without entering an email address, they will see an error message.

  • Once the user enters a valid email address and clicks “Submit,” they will see a message indicating that the password reset instructions were sent via email.

  • If the user clicks “Back to login” or “Cancel”, they will return to the main login screen.

 

Acceptance Criteria

  • Given I am a user who has typed in an email address and clicked the submit button, I will be required to enter a valid email address.

  • Given I am a user who has entered an email address that exists in the Rethink Ed database, I will receive an email with instructions on how to reset my password.

  • Given I am a user who has entered an email address that DOES NOT exist in the Rethink Ed database, I will NOT receive an email.