Goals
Define the features and functionalities of the patient mobile app
Background and strategic fit
Assumptions
Requirements
User Story Title
User Story Description
Priority
Release
Patient Mobile App
1
Splash Screen
2
Feature | Comments |
---|---|
1 |
As a patient, I want to login to the system for the first time, so that I can manage my activities and treatment |
Acceptance Criteria
When I open the app and after the splash screen it load the patient login form
In the Login screen, I will be able to login by using my mobile phone number.
Mobile Phone Number: Textbox (only digits)
Language - Dropdown (changes the apps UI language)
Login button
Tapping the login button
If user input the correct mobile phone number, it opens the phone number verification page
Else, an error message is displayed "This number is not from a created account. Please contact your therapist to create an account for you”.
Must have
2
3
Notes
Additional Improvements
| |
2 | Login Page - Phone Number Verification As a patient, I want to verify my account's phone number so that I can confirm my |
account |
Acceptance Criteria
When patient logs into the app for the first time, an SMS is received to verify the phone number used to login to the app
User can enter the received code in the phone number verification page and taps the verify button
If code matches user proceeds to the consent Term of Service page
Else, an error message is displayed "Incorrect code, please enter the correct code or resend a new code."
User can tap the "Resend Code" link to resend a new code to the number
Must have
2
4
Login Page - Terms and Condition Consent
Notes
Additional Improvements
| |
3 | Login Page - Terms and Conditions and Privacy Policy Consent As the app owner, I need the patients to agree and consent to the apps terms and conditions and |
privacy policy, so that |
they can continue to use the app |
Acceptance Criteria
The page is shown when:
Patient logs into the app for the first time, and successfully verifies the phone number,
As the app owner, I want to the patient to see a re-consent page when the terms and conditions and privacy policy of the app is updated, so that they can re-consent to the new terms and |
The pages displays the terms and condition and a check box "I agree to the Terms and Conditions"
When the check box is ticker, the Next button is enabled and when tap:
If first login, loads the pin setup page
Else, loads the home page
Must have
2
5
Re-consent
6
conditions and privacy policy and continue using the app | Notes
Additional Improvements
|
4 | Login Page - PIN Setup Screen As a patient, I |
want to be able to setup |
my initial PIN code, so that I can |
Acceptance Criteria
When patient logs into the app for the first time, verifies the phone number and agrees to the terms and condition, the pin setup page is loaded
User can set a pin code to login to app
User needs to confirm the code
User taps the confirm button
If pin matches, saves the pin and shows notification of successful pin setup
Else, shows an error message "PIN does not match."
Must have
2
secure my account and use the PIN code in my succeeding login | Notes
Additional Improvements
|
5 | Login Page - Succeeding Login As a patient, I want to be login using a pin for my succeeding login, so that I don't need to verify my phone every time I login to the app |
Acceptance Criteria
When patient logs into the app for after phone number verification, user can login using the pin code that was setup in the first login
User can enter the pin code to login to app
User taps the login button
If pin matches, app loads the home page
Else, shows an error message "Login Failed. Wrong Pin"
User can tap the "Login with other number" or "I forgot my pin" link to launch the first time login screen and verify the phone number
Must have
2
8
Notes
| |
6 | Navigation Bar As a patient, I want to have a navigation bar, so that I can quickly access the other functions of the app |
Acceptance Criteria
On all screens, a navigation bar is found at the bottom with the following itemsNotes
|
|
Has a red dot if patient has uncompleted activities
Goals -
Appointments -
Has a red dot if patient has an upcoming appointment or new appointments added
Messages -
Has a red dot if patient has unread messages or missed calls
Tapping on the navigation icons loads their respective screens
Must have
2
9
Additional Improvements
| |
7 | Home Page As a patient, I want to view my Home Page after I successfully login, so that I can quickly view the activities and |
10
Burger Menu
User profile
About the App
Logout button - when tapped, logouts the the user and returns to the login screen
11
About the App
Rich text content pulled from Backend Admin App
12
User Profile
As a patient, I want to have a see my profile, so that I can update my information
Acceptance Criteria
When user taps on the user profile item in the burger menu, opens the profile page
User profile page displays the following fields
Name - read only (set by Therapist in the therapist app)
Gender - editable, dropdown
Date of birth - editable, date picker
Age - Calculated
Mobile number - editable
Language - editable, dropdown
Edit button - when tapped shows the editable form
Save button - to save changes
Launch pin confirmation screen to continue saving
If mobile number is changed, launch phone number verification screen
Change pin link to set/update the pin code
Must have
2/3
13
Edit Profile
14
Change Pin
Launch change pin screen
15
appointments for the current day |
Acceptance Criteria
After successful login, the app loads the home page
The home page displays the activities and appointments of the day
Name of patient
Activities today - Changes to "No activities for today" if no activities assigned today
Progress graphic displaying number of completed activities and total activities
Appointment card of the latest upcoming appointment which displays
Date/Time of Appointment
Name of Therapist
Navigation bar at the bottom
Settings icon at the top right corner - opens the user profile page
Must have
2
Notes
Additional Improvements
| ||
8 | User Settings Menu As a patient, I have a user settings menu, so that I can access my user profile, logout and other pages | Notes
|
9 | About the App As a backend-admin, I want the patients to see an About the App page, so that they can find out more information about the app and its donors/partners | Notes
|
10 | User Profile Page As a patient, I want to have a see my profile, so that I can update my information | Notes
Additional Improvements
|
11 | Change Pin Page As a patient, I want to be able to |
change my pin, so that I can |
Acceptance Criteria
When user taps the Activities icon in the navigation bar, it loads the Activities screenIf patient has more than 1 treatment plan, display a list of treatment plans, else loads the activities list screen of the only treatment planTreatment plan listList of treatment plan cards that can be scrolled horizontallyTapping treatment card opens activities list screen of the treatment plan
16
Treatment Plan Cards
As a patient, I want to have treatment plan cards so that I can quickly see treatment plan information
Acceptance Criteria
The cars should display the following:Treatment plan nameTherapist nameStart dateDurationTreatment descriptionDisplay the same activities progress chart in the home page
17
18
keep my account secured | Notes
| |
12 | Logout As a patient, I want to be able to logout from the system | Notes
|
13 | Activities List As a patient, I want to be able to see a list of my activities, so that I can view and complete them |
Acceptance Criteria
If user has only one treatment plan, when user opens the Activities page, it will display the activities list screen for that treatment plan
Else, when user taps on a treatment plan card in the Activities page, it will display the activities list screen of that treatment plan
The activities list will display
Treatment name
Scrollable horizontal calendar (to be discussed)
Month/Year label - changes when user choose different date
Date buttons
7 day buttons with selected day in the middle
Previous days have light background
Today has white background
Upcoming days have dark background
A white '^' icon is displayed if day has activities
Back to Today button
Can appear on the left/right of the date buttons depending where today is
When tapped automatically selects current day
Completed activities progress bar
Gets filled in when more activities are completed
Has number of completed activities label (# of total-#) (might not be needed)
Activities strip
Strip of activities cards (exercises, education materials or questionnaire)
Follows order set by therapist in the treatment plan
Displays one card at a time
Can scroll to the left or right
Tapping the card displays card detail
Must have
2/3
Notes
| |
14 | Exercise Card As a patient, I want to have exercise cards so that I can quickly see information of my exercise activities |
Acceptance Criteria
Cards will have the following:
Media thumbnail
Name of exercise
Number of reps and sets - hidden if not specified by therapist
Completion Status
To Do
Completed
When completed, the card will be grayed out
When tapped it will display the exercise details screen
Must have
2/3
20
Notes
| |
15 | Exercise Details As a patient, I want to see the details of an exercise, so that I can read detailed instructions, videos and images about the exercise and also mark the exercise as completed. |
Acceptance Criteria
When user taps on the exercise card, it will display the exercise details screen
The details screen has the following information:
Activity number - when completed will show a check icon
Close button - when tapped will close the details page and return the the activities list screen
Media slider:
User can scroll through the different media of the exercise
User can tap on each slide to view the media in full screen
If media is video/audio, it can be played on the slider or full screen mode
Exercise Name
Number of reps and sets - hidden if not specified by therapist
Exercise Details
Label
Instructions/Notes/Description
If exercise is not completed:
A complete exercise button (bottom of the screen)
Clicking the complete button will open the assessment screen
If exercise is completed it will show two tabs on the top for:
Task Details - same content above but the complete button disabled and labeled as completed
Results - will display the exercise assessment of the patient
Scrolls vertically
Must have
2/3
Notes
| ||
16 | Exercise Assessment/Feedback As a patient, I want to have an exercise assessment page so that I can give my feedback on the exercise. | Notes
|
17 | Education Material Card As a patient, I want to have |
education material information cards, so that I can |
Acceptance Criteria
When user taps on the Complete button on the exercise details page it will open the Exercise Assessment screen
The screen will have:
How did it feel? - Slider to measure pain (No Pain → Worst Pain)
Completed Reps - Number slider
Completed Sets - Number slider
Submit button to submit assessment
Must have
3
21
quickly see information about the education material | Notes
|
18 | Education Material Details As a patient, I want to |
see the details of an education material |
, so that I can |
Acceptance Criteria
Cards will have the following:
Default icon for educational material
Title of educational material
File type (to be discussed)
Clicking on the card will open education material details page
Must have
3
22
read detailed instructions, download the material and mark the activity as completed | Notes
|
19 | Questionnaire Card As a patient, I want to |
have the questionnaire cards, so that I can |
Acceptance Criteria
When user taps on the education material card, it will display the details screen
The details screen has the following information:
Activity number - when completed will show a check icon
Close button - when tapped will close the details page and return the the activities list screen
Title of educational material
Download button
If activity is not completed, a complete activity button (bottom of the screen)
Must have
3
23
quickly see information about the questionnaire. | Notes
|
20 | Questionnaire Details As a patient, I want to |
see the details of a questionnaire |
, so that I can |
Acceptance Criteria
Cards will have the following:
Default icon for questionnaire
Title of questionnaire
Clicking on the card will open questionnaire details page
Must have
3
24
Questionnaire Details
As a patient, I want to see the details of a questionnaire, so that I can read detailed instructions, answer the questionnaire and mark the activity as completed.
Acceptance Criteria
When user taps on the questionnaire card, it will display the details screen
The details screen has the following information:
Activity number - when completed will show a check icon
Close button - when tapped will close the details page and return the the activities list screen
Title of questionnaire
Progress bar - tracks each question
Progress bar label - Question # of total # of questions
Question and Answer screen
One for each question
Question and Answer form
Question text
Question image
Answer options/checkboxes/textbox
If activity is not completed, a submit answers button
Navigation buttons (Previous & Next)
If first question, hide previous button
If last question, hide next button
Scrolls horizontally
Must have
3
25
Goals Cards
26
Goals Details
27
Goals Tracking - Treatment Plan List
As a patient, I want to be able to access my assigned treatment plan goals, so that I can quickly manage them
Acceptance Criteria
When user taps the Goals icon in the navigation bar, it loads the Activities screenIf patient has more than 1 treatment plan, display a list of treatment plans, else loads the goal tracking list screen of the only treatment planTreatment plan listList of treatment plan cards that can be scrolled horizontallyTapping treatment card opens goal tracking list screen of the treatment plan
Must have
2/3
28
Goals Tracking List
As a patient, I want to be able to see a goals tracking chart, so I can see and add my weekly goal and satisfaction ratings.
Acceptance Criteria
If user has only one treatment plan, when user opens the Goals page, it will display the goals tracking list screen for that treatment plan
Else, when user taps on a treatment plan card in the Goals page, it will display the goals tracking list screen of that treatment plan
The goals tracking screen will have:
Tabs for each goal, each tab will have
Goal title/sentence
Weekly satisfaction chart
Line chart (level of satisfaction vs week #)
An "Add Weekly Satisfaction" button for adding satisfaction rating for the current week - opens the weekly satisfaction form
Must have
2/3
29
Weekly Satisfaction Form
As a patient, I wan to have a weekly satisfaction form, so that I can submit my weekly satisfaction rating for each goal.
Acceptance Criteria
When I tap on the "Add Weekly Satisfaction" button in the goal tracking list, it will open the weekly satisfaction formThe form will have the following:Week # - labelFor each goal:Satisfaction slider - No satisfaction → Extremely Satisfied
Cancel/Do Later button - goes back to the goal tracking list and does not submit scoresSubmit button - saves the scores, goes back to the goal tracking list and update chart
Must have
2/3
30
Appointment Lists
As a patient I want to see my appointment list so that I can see my upcoming appointments and manage them
Acceptance Criteria
When user taps the Appointment icon in the navigation bar, it loads the Appointment list screen
The screen will list appointment cards grouped by month
Request Appointment button
When tap, opens a pop-up dialog
Appointment card will show:
Appointment date: Month/Date
Appointment time: hh:mm - hh:mm AM/PM
Therapist Name
Appointment can be cancelled by swiping left and tapping the Cancel Appointment button
Must have
2/3
31
Appointment Requests
Must have
2/3
32
Appointment Cancellation Request
33
Messages History
As a patient I want to be able to access my messages and contact list, so that I can arrange online consultations with my therapists
Acceptance Criteria
If user has only one therapist, and user taps the Messages icon in the navigation bar, it loads the Message/Chat history screen
If user has more than one therapist, and user taps the Messages icon in the navigation bar, it loads the Therapist contact list
Therapist contact list displays the names of the therapist and user can click on the name to open the Message/Chat history screen for that therapist
Therapist name will have unread messages indicator
Must have
2/3
34
Contact List
read detailed instructions, answer the questionnaire and mark the activity as completed. | Notes
| |
21 | Goals Cards As a patient, I want to have the goals cards, so that I can quickly see information my treatment plan goals. | Notes
|
22 | Goals Details As a patient, I want to see the details of a goal, so that I can read detailed instructions and fill-in my daily/weekly satisfaction rating As a patient, I want to be able to see a goals tracking chart, so I can see my daily/weekly goal and satisfaction ratings. | Notes
|
23 | Appointment Lists As a patient I want to see my appointment list so that I can see my upcoming appointments and manage them | Notes
|
24 | Appointment Requests As a patient I want to request appointments to my therapists so that they can see my requests and schedule the appointments |
Acceptance Criteria
When user taps on the Request Appointment button, it opens a screen that has:
Therapist Name - drop down, required list of patient's therapists
Send button - If user taps, a request will be sent to selected therapist. Then a popup will
opened, and I tap on OK to confirmCancel - If user taps request is not sent and closes the pop-up
Notes
| ||
25 | Accept/Reject Appointments As a patient, I want to be able to accept or reject appointment requests from my therapist, so that my therapist can see that I'm not available on that schedule | Notes
|
26 | Messages History As a patient I want to be able to access my messages and contact list, so that I can arrange online consultations with my therapists | Notes
|
27 | Sending Messages As a patient I want to be able to send messages to my therapist |
Acceptance Criteria
The message screen will show:
Back button - when tapped it will load back to therapist contact list
Chat/message history area - displays the past messages with time stamp
Text box and send message button - for entering and sending messages
Add attachment button - attaching photo/video files (max 25MB)
Notification “Your therapist can’t reply instantly now. Will get back to you soon.”
This notification will hide when the therapist reply
Must have
2/3
Notes
| |
28 | Receiving Voice/Video Calls As a patient, I want to be able to answer my therapists calls |
Notes |
|
Video icon:
tap to share video with therapist and turn on video
tap again to turn off video
Speaker icon:
tap to turn speaker on
tap to turn speaker off
Mic icon:
tap to turn microphone on
tap to turn microphone off
Decline button: tap to reject the call from therapist
Accept button: tap to receive the call from therapist
Must have
2/3
37
| |
29 | Download Printable Treatment Plan As a patient, I want to be |
Acceptance Criteria
When user accepts the call from the therapist the call screen will display:
Therapist video/avatar - if voice call it shows avatar, else it shows therapist's video
Video icon - tapping on this icon turns on/off my video
Speaker icon - tapping on this icon will turn on/off the speakers
Mic icon - tapping on this icon will mute/unmute my audio
Hang up icon - tapping on this icon ends the call
Message icon - tapping on this icon to opens the chat/message panel
If I have unread messages from the therapist, then a red dot is shown on this icon
Patient's video/avatar - if voice call it shows avatar, else it shows my video
Can be moved/dragged to different position/area in the call panel
Must have
2/3
38
Chat while on going call
User interaction and design
First Time Login
Patient opens app, enters mobile phone number and selects language
If selected language is not the default, app displays the translated app
Patient taps on the login button
If mobile number entered does not match the number registered by therapist, then displays error message and patient can re-enter correct number
If mobile number entered matches the number registered by therapist, then displays phone verification screen
Patient receives SMS that contains the verification code and enters the code in the verification screen
If patient did not receive the SMS, patient clicks on the resend code link
Patient taps on the Confirm button
If verification code matches, app will display the Terms and Conditions screen
Patient can read the terms and conditions
Patient needs to toggle that they consent/agree to the terms and conditions to proceed to the PIN settings screen
If patient agrees to terms and condition, they can set the PIN for the app
Patient chooses 4-digit PIN
Patient confirm 4-digit PIN
Patient taps on the confirm button, if PIN matches, opens the app home page
Succeeding Login
Patient opens app
Patient enters 4-digit PIN
Patient taps on the login button, if PIN matches, opens the app home page
Change PIN
Patient taps on the settings > user profile
Patient can tap the change pin link to set/update the pin code
Logout
Patient taps on the settings > user profile
Patient taps the logout button returns to the login screen
Viewing/Editing Patient Profile
Patient taps on the settings > user profile
Patient can tap on the edit button to edit profile information
Patient taps the save button to save changes
Launch pin confirmation screen to continue saving
If mobile number is changed, launch phone number verification screen
Viewing the Home Page
After successful login, patient can see their activities for the day
The home page will display a donut chart that shows the number of activities for the day and the number of completed activities
If there is no activities for the day, it will show a message that there is no activities for today
If the patient has an incoming appointment for the day, it will display the appointment card
Managing Activities
Questions
Below is a list of questions to be addressed as a result of this requirements document:
...
Question
...
Outcome
...
able to download my treatment plan, so that I can print them and access them offline | Notes
| |
30 | Offline Mode As a patient, I want to be able to access the app even without an internet connection, so that I can view/update my treatment plan | Notes
|