IS480 Team wiki: 2015T1 Vulcan Scope

From IS480
Revision as of 15:37, 22 November 2015 by Weiting.low.2013 (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
Vulcan home icon2.png
Vulcan aboutus icon2.png
Vulcan projectoverview icon2.png
Vulcan projectmanagement icon2.png
Vulcan documentation icon2.png



Vulcan Scope legend.PNG
Functional Requirements Overview

Core Functions

Account Module [M]

  • Participant is able to register an account using their e-mail address, a password of at least 8 characters, gender, date of birth or age group, country currently located in
  • An unique identification number will be generated for each account upon successful sign up
  • Participant is able to login using their registered e-mail address and password
  • Participant is able to update details such as e-mail address and password
  • Participant is able to avoid retyping their login credentials in the future by checking on “Remember Me”
  • Besides Registration and Login, all other modules are only accessible after logging in
  • During account registration, a demographic survey will be prompted

Admin Module (Web Based) [W]

  • Administrator is able to manually delete a participant’s account
  • Administrator will be able to create, update and delete researcher’s account

Researcher Module (Web Based) [W]

  • Researcher/Collaborator will be able to login into the portal using their registered e-mail address and password (administrated by portal administrator)
  • Researcher is able to create, update and delete studies/programs of certain interest, but collaborator can only update studies/programs
  • A program includes description, number of sessions, post-session survey, beeper survey and feedback URL
  • Researcher will be able to create, update and delete podcast, random survey and beeper survey tagged to a program, but collaborator can only update
  • Only program owner (the researcher) and collaborator are allowed to modify the programs created by him/her, but collaborator are not allowed to delete the programs
  • Researcher/collaborator is able to retrieve all data collected in .csv format
  • CSV for participant’s demographics should consist of an unique id of the participant, the questions set by researcher/collaborator and responses by the participants
  • CSV for participant’s post-session survey should consist of participant’s unique id, program name, session number and id, start and end time of the session, whether smart wearable was involved, response for the number of questions
  • CSV for participant’s beeper survey should consist of participant’s unique id, timestamp, response for the number of questions
  • CSV for participant’s session details should consist of participant’s unique id, program name, session number and id, pause and resume time, pause id (in the case if it was paused more than once)
  • CSV for participant who uses smart wearable should consist of participant’s unique id, program name, session number and id, timestamp, heartrate
  • To ensure participant’s data remains confidential between the research team and the participant, password protection is needed for CSV file downloads which contains participant’s e-mail address

Participant Module [M]
Podcast Sub-module

  • Participant can view all programs available but can only sign up for 1 till he/she completes all sessions in the selected program or dropout of the current program
  • Participant can opt-out of the program halfway through it, but a warning message will pop up and participant will have to restart the program if he/she choose to re-attempt the program
  • Participant is able to pre-download one podcast in advance before the next session and play it later on
  • Each program consists of multiple sessions (up to 14) with 1 podcast each, ETA 10 minutes to MAX 20 minutes
  • Downloaded podcast will automatically be deleted upon session completion

Account Sub-module

  • Participant who uninstall/reinstall the mobile application for whatever reason will have to restart all program and sessions
  • Demographic survey during account registration consist a list of optional default questions relating to
    • Gender
    • Age
    • Country
    • Meditation History
    • Exercise Status
    • Uses Smart Wearable?

Refer to application mockup for detailed illustration

Post-session Survey Sub-module

  • The post-session survey will be prompted immediately after the podcast has ended
  • If the survey has not been completed yet, it will prompt again at the 30th minute mark after the podcast has ended and when participant decides to proceed to the next session
  • It is mandatory for participant to complete every post-session survey

Random/Beeper Survey Sub-module

  • A random survey will be prompted 3 times per day to the participant on top of the post-session survey (eg. 3 random + 1 post-session survey)
  • Participant must complete 1 session/podcast after starting the program in order for random survey to be prompted 3 times per day
  • Post-session and random survey includes questions such as (as of now, but researcher can revise the questions via the researcher portal):
    • How difficult was it for you to stay focused during this session? (Range: Not at all, Moderate, Extremely)
    • How are you feeling right now? (Range: Very Unhappy, Neither, Very Happy) and (Range: Very Claim, Neither, Very Stressed)
    • I currently feel aware of my… … (Range: Strongly Disagree, Neutral, Strongly Agree)
      • Mental activities such as my thoughts and judgments
      • Feelings such as my emotions, moods, and likes/dislikes
      • Environment such as physical surroundings and other people
  • Participant is able to set the timing to be prompted with random surveys with at least 6-hours of awake time
  • All survey uses slider for rating and an indication of eg. 1, 2, 3, 4, 5 from point to point to improve user experience
  • Random survey will expire after 1 hour and will not be available to participant
  • Only 3 random surveys will be prompted to participant within the day even if participant chooses not to attempt to any
  • Based on the wake/start time and sleep/end time entered by the user, 3 blocks of equal duration will be created. A random timing will be picked within each block to prompt user with the beeper survey
  • However, a minimum of 6 hours awake time is needed for random/beeper survey as a beeper survey can only occur 2 hours after another beeper survey
  • Beeper survey should be prompted only after at least 30 minutes from the completed post session survey
  • However, if the participant were to complete a post-session survey in-between 2 beeper surveys, the application will compute whether there is at least 30 minutes left in the block for the next beeper survey or the sleep/end time before prompting the next beeper survey.
  • If there is less than 30 minutes left in the current block, the next beeper survey will be missed. It will then move on to the next block if there are any after the current block.
  • If the participant were to change their awake and sleep timing halfway through the day, the application will compute the 3 new blocks and check how many beeper surveys were completed. If there is still sufficient time to prompt random surveys in the remaining blocks, the change of timing and new blocks will take immediate effect.
  • Else, the change of timing will only take effect in the following day.
  • Upon the completion of the last session podcast, a mandatory final post-session and beeper survey will be prompted (with same duration rules) before the analytics feedback is available to participant

The term “random survey” and “beeper survey” is being used interchangeably.
For the beeper/random surveys, all items except the difficulty question would be administered.

Feedback Sub-module

  • Participant will be able to view their responses based on the questions set by the researcher/collaborator. Following are some examples
    • Number of days taken to complete the program
    • Focus difficulty for each session
    • Mood during random/beeper survey
    • Mood during post-session survey
    • Comparison of mood between random and post-session in average throughout the entire program
    • Heart rate for each session
    • Min, Max and Avg for each session and throughout the entire program
  • Participant will be promoted with a program specified final message together with the analytics feedback; upon the completion of last post-session and beeper survey

Refer to application mockup for detailed illustration

Secondary Functions

Feedback Module (for Participant) [M]

  • Participant is able review his/her progress in simplified graphical and statistical view at the end of the entire program
  • The graphical and statistical view is based on participant’s past feedback; simply a different representation of their feedback
  • However, the progress module will not be available to participant who did not complete their selected program

Smart Wearable Module [SW]

  • Participant is able to pair and unpair his/her Android Wear with ReFokus
  • The application will be able to monitor and collect data such as heart rate and ambient light (in lux), and consolidate it together with other data collected before sending it over to researcher’s server at the end of each session
  • Integrate with ambient light (in lux) sensor to track whether participant’s surrounding plays a part in the overall result
  • Heart rate readings will be recorded down on a 30 seconds interval
  • Assuming each podcast is 10 minutes, the heart rate record for the 1st minute will be ignored (due to calibration and inaccuracy)
  • Heart rate data collected should be presented to participant in Min, Max, Avg at the end of the entire programme as detailed as for each session

Uninstall Module [M]

  • As part of IRB’s requirement, an option to uninstall and withdraw from the mobile application and research should be made available within the mobile application

Tertiary Functions

Analytics Module [W]

  • Researcher/Collaborator is able to compare the active sessions of 2 different programs in the past 7 days

Schedule Module [M]

  • Participant is able to schedule his/her next meditation session
  • The schedule module will produce a pop-up notification at the time the participant schedule to be reminded

Good To Have Functions

Additional Smart Wearable Module [SW]

  • A heart rate test will be available to participant before each session begins, showing their current heart rate. However, the reading will go off since the session begins but being monitored stealthy

Self Practice Module [M]

  • Participant will be allowed to practice beyond the scheduled sessions on their own without the podcast
  • Participant is able to set a countdown timer (eg. 10 minutes) for his/her self-practice session
  • Participant should not be prompted with any form of survey during the self practice session