Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description

The Trainee User Interface (UI) is the web application HEE Trainees use to interact with TIS. It will be designed to prioritise mobile use ('mobile first design') and will function on larger screens.

This component includes stories covering generic elements, but doesn't include UI functions which are specific to a single component, e.g. Menus and Navigation stories can be found here, but the FormR self assessment would be found in the Assessments component.


Summary Page 
N/A MVP

Details
Personal Details
Programmes & Curricula
Placements 
Assessment Reviews
Form R (A / B)



Since the scope of the Trainee View is limited to current functionality of Intrepid (and to a lesser extent Synapse), the scope relating to Trainee JIRA tickets should be as follows: 

  • TIS-540
  • TIS-684
  • TIS-681
  • TIS-539
  • TIS-683
  • TIS-92
  • TIS-682
  • TIS-278 << NOT REQUIRED, REMOVED FROM JIRA
  • NEW STORY REQUIRED - support 
  • NEW STORY REQUIRED - form R, part A

Out of Scope:

  • TIS-193
  • TIS-196
  • TIS-200
  • TIS-20
  • TIS-171
  • TIS-174
  • TIS-319


Process NameT-1 New RegistrationComments MVP - move to Admin UM
Description
User
Admin has the ability to register a user to use the TIS system
directlyIs this a necessary story? Do trainees have the ability to request Intrepid access? Do we need same/separate login details for new TIS, so migration consideration?ActorsTrainee

Trainees will not be requesting access we will send creds out as part of the onboarding process. We will have to consider how we migrate the current trainees onto TIS.

ActorsAdmin 
Pre-Conditions
TBCAlternative FlowUser is registered from <another system> RulesTBC

Format of username?

Validation of password?

What security should be implemented?

JIRA ReferenceNew story TBDWider discussion necessary on whether this is a valid story, before writing a JIRA ticketAudit LogTBC 
Trainee must have registered via Oriel to a particular region
Post-ConditionsTrainee has access to new TIS system - login / logout capability 
Process Steps
  1. user register a username
  2. user sets password
  3. user sets securiity
  4. user validates details
  5. system shares
What interaction should this have with Admin UI? What are the back end implications? 
  1. Import trainees from Oriel
  2. Trigger welcome message send -  inform trainees of what TIS is about, support, login details to follow
  3. Trigger credentials send

Admins should be able to trigger welcome message, credentials message, oriel manual upload

User able to change their password once logged in for the first time. User name will be email address.

Alternative Flow

Non-oriel import (Dentists / Other Academic Trainees)

 
Rules
  • Username format: valid email address
  • No account validation
  • Password to be autogenerated
  • All users given appropriate access for "Trainee" role

JIRA ReferenceTIS-629
Monitoring

No need to report on this

 Oriel upload to be considered separately


Process NameT-2 Trainee
Login
Login Comments MVP
DescriptionTrainee has the ability to login using the details they were registered for the service with
Will they be able to use their old details, or have to re-register?

I expect all trainees will require new login credentials but they will not have to 'register' as we will send out logins as and when we migrate trainees to TIS.

The process will be the same for Synapse users as they are transitioning from one system to another.

ActorsTrainee 
Pre-Conditions

Trainee has been registered on system

Trainee has validated their registered details


Post-ConditionsTrainee is able to view the login space 
Process Steps
Traine
  1. Trainee enters username
  2. Trainee enters password
  3. System validates details
  4. System presents logged in view of system
 
Alternative Flow

T-17 Forgotten Username

T-18 Forgotten Password

T-19 Username / Password Error

T-XX: update login details

 
Rules
  • Error
validation?
  • : Invalid email/password entered

JIRA Reference
TBD
N/A to be created 
Audit LogTBD
Usage Monitoring

No users logging in

Further discussion required

 



T-3 Trainee LogoutComments MVP
DescriptionTrainee has the ability to logout of the system
ActorsTrainee 
Pre-Conditions

Trainee has been registered on system

Trainee has validated their registered details


Post-ConditionsTrainee leaves logged in view of system securely 
Process Steps
  1. Trainee selects to logout
  2. System logs user out
  3. System presents logged out view
 
Alternative FlowN/A 
Rules
Error validation?
N/A 
JIRA Reference
TBD
N/A 
Audit Log
Usage MonitoringTBD 


Process NameT-4 View SummaryComments MVP
DescriptionTrainee has the ability to view the summary screen
Actors

Trainee

System

 
Pre-ConditionsTrainee is logged in
Post-Conditions

Summary details in view

Navigation menu available

 
Process Steps
  1. User logs in
  2. System presents summary
  3. User navigates through view
 

 Fields displayed

  • Current Placement End Date & Site (Steve to confirm)
  • Next Placement Start Date & Site (Steve to confirm)
Alternative FlowN/A 
Rules
Validation rules?
  • Read only
 
JIRA Reference
TBD
TIS-704 
Audit LogTBD 


Process NameT-5 View & Edit Personal DetailsComments MVP
DescriptionUser has the ability to view and update their own details
ActorsTrainee 
Pre-ConditionsTrainee is logged in to their own account
Post-Conditions

Trainee can see currently stored details in an editable format

Trainee can make and save changes to specified details

System updates personal details centrally

 Which fields should be editable?


Process Steps
  1. User navigates to Personal Details space
  2. System presents personal details in editable view
  3. User makes changes to relevant fields
  4. System validates changes
  5. System saves changes
  

Relevant Fields:

Surname
Forenames
Known As
Maiden Name
Title
Telephone
Mobile
Email Address
Address 1
Address 2
Address 3
Address 4
Post Code

Non-editable (editable by central admin team)
GMC / GDC Number
GMC / GDC Status
EEA Resident
Permit to Work
Settled
Visa Issued
Details/Number


Alternative FlowN/A 
Rules
Validation rules?
  • View & Edit select fields, see data table

JIRA Reference
TBD
TIS-540, TIS-278 
Audit LogTBD 


Process NameT-6 View Programme
Comments
Comments MVP
DescriptionUser has the ability to view their Programme details 
ActorsTrainee 
Pre-Conditions

User is logged in

Is there a need for detailed Programme view?
Not as such, the details of the Programme are the placements and assessments which we have considered.
Post-ConditionsSystem presents relevant detail 
Process Steps
  1. User navigates to
summary
  1. programme view
  • System presents summary information
  • User selects to view detail
  • System presents detail view
    1. User views Programme data
    2. User selects to leave Programme Detail view
    3. System presents summary view 

    What details are shown on summary v detail?

    Should user be presented with previous view or summary screen?View only

    Fields

    • Programme Name
    • Curriculum
    • Start Date
    • End Date
    • Managing Deanery


    Alternative FlowN/A 
    Rules

    Validation rules?

    • View only
    • View will show historical programmes, current and future programmes if applicable
     
    JIRA Reference
    TBD
    TIS-684 
    Audit LogTBD 


    Process NameT-7 View PlacementComments MVP
    DescriptionUser has the ability to view their Placement details 
    ActorsTrainee 
    Pre-ConditionsUser is logged in
    Post-ConditionsSystem presents relevant detail 
    Process Steps
    1. User navigates to summary view
  • System presents summary information
  • User selects to view detail
  • System presents detail view
    1. User views Placement data
    2. User selects to leave Placement Detail view
  • System presents summary view 
  •  

    Fields

    Start Date
    End Date
    Site
    Grade
    Specialty
    Placement type


    Alternative FlowN/A 
    Rules
    • View only
    • Detailed view should present historical, current and future placements
     
    JIRA Reference
    TBD
    TIS-681 
    Audit LogTBD 


    Process NameT-8 View AssessmentComments MVP
    DescriptionUser has the ability to view their Assessment details 
    ActorsTrainee 
    Pre-ConditionsUser is logged in
    Post-ConditionsSystem presents relevant detail 
    Process Steps
    1. User navigates to
    summary
    1. Assessment view
  • System presents summary information
  • User selects to view detail
  • System presents detail view
    1. User views assessment data 
    2. User selects to leave Assessment Detail view
  • System presents summary view 
  •  

    Fields

    Review (date)
    Curriculum Assessed
    Outcome
    Grade at Time
    Period From
    Period To


    Alternative FlowN/A 
    Rules
    • View only
    • Detailed view should present historical, current and future assessments
     
    JIRA Reference
    TBD
    TIS-705 
    Audit LogTBD 


    Process NameT-9 View CoursesComments
    DescriptionUser has the ability to view their Course details Do we need this as part of the MVP? Joanne Watson (Unlicensed)
    ActorsTrainee 
    Pre-ConditionsUser is logged in
    Post-ConditionsSystem presents relevant detail What details can be seen?
    Process Steps
    1. User navigates to summary view
    2. System presents summary information
    3. User selects to view detail
    4. System presents detail view
    5. User selects to leave Course Detail view
    6. System presents summary view 
     Should there be a summary view of courses?
    Alternative FlowT-19 Book Course 
    ?
    Is this necessary for MVP?
    RulesView Only 
    JIRA ReferenceTBD 
    Audit LogTBD 


    Process NameT-10 Submit Form-R (Part A)
    Comments
    Comments MVP
    DescriptionUser is able to submit the form that will update their personal details with the GMC
    ActorsTrainee 
    Pre-Conditions

    User is logged in

    Available to medical trainees only


    Post-Conditions

    User personal details are updated in TIS across all systems

    User personal details are updated with HEE Admins

     
    Process Steps
     Alternative Flow Rules JIRA Reference
    1. User navigates to Form R, Part A space
    2. System presents form in editable view
    3. System autopopulates relevant fields
    4. User makes changes to relevant fields
    5. System validates changes
    6. System saves changes
    7. User signs the form 
    8. User selects to submit Form-R (Part A)
    9. Form-R (Part A) is sent to HEE Admins
    10. Historical view of submissions is updated

    Manual Trigger perhaps more appropriate dependent on design.

    Fields

    • forename
    • GMC registered surname
    • GMC number
    • Deanery / HEE local team
    • DOB
    • gender
    • immigration status
    • primary quaification
    • date awarded
    • Medical Scool
    • Home Add
    • Contact Tel
    • Contact Mob
    • Preferred email
    • Prog Spec
    • Spc 1 for Award of CCT (non-mand)
    • Spec 2 for Award pf CCT (opt)
    • Royal College/Faculty assessing training for the award of CCT
    • Anticiapted completion date f curr prog if known
    • Options - confirmations x6 (see data table
    • declaration of programme
    Alternative FlowT-20 No submission of Form R (Part A)
    Rules
    • Autopopulation will be required from personal details and other sections, where appropriate
    • Must be submitted for new trainees
     What's the deadline for submission by new trainees? Alistair Pringle (Unlicensed)
    JIRA ReferenceN/A 
    Audit LogTBD 


    Process NameT-11 Submit Form-R (Part B)
    Comments
    Comments MVP
    DescriptionUser is able to submit the form to the Admins at the appropriate time annually
    Actors

    Trainee

    GMC

     
    Pre-Conditions

    User is logged in

    Form-R submission is imminent

    Cannot be submitted at anytime, it is usually requested by the local office prior to the ARCP, I think the timescales differ in different local offices.

    To be confirmed whether there is a trigger requirement in TIS for admins - IO

    Post-ConditionsForm-R (Part B) is submitted 
    Process Steps
     Alternative Flow Rules JIRA Reference
    1. User navigates to Form R Part B space
    2. System presents form details in editable view
    3. User completes relevant fields
    4. System validates fields
    5. System saves changes
    6. User signs form (tbc as with Part A)
    7. User selects to submit Form-R (Part B)
    8. Form-R (Part B) is sent to Admin UI
    9. Historical view of submitted Form's updated

    Unsure. May be best to keep both parts A&B together in their own space. Steve to confirm

    Alternative FlowT-16 Save as draft before submissionYes i think the trainee should be able to save the form as they go or autosave as with other areas of the system.
    Rules

    Validation as per data table

    • Error message: cannot be edited once submitted, as no longer a draft
    Rules around submission TBD - AP
    JIRA ReferenceTIS-539 & TIS-92, story for save drafts 
    Audit LogTBD 


    Process NameT-12 Submit OOPComments
    DescriptionUser is able to submit their OOP request digitally from end to end
    ActorsTrainee 
    Pre-ConditionsLogged in
    Post-ConditionsOOP form submitted

     Where is the result sent?

    Administrator will need to receive the form in order for it the details to be checked and the application either accepted or denied by the designated authority (Dean or deputy)

    Process Steps
    1. User navigates to XXX space
    2. System presents form details in editable view
    3. User completes relevant fields
    4. System validates fields
    5. System saves changes
    6. User selects to submit OOP request
    7. OOP request is sent to XXX
    8. Historical view of submitted Form's updated
     
    Alternative FlowSave draft

    Is this necessary? 

    Yes

    RulesTBD 
    JIRA ReferenceTBD 
    Audit LogTBD 


    Process NameT-13 Submit LTFTComments
    DescriptionUser is able to submit their LTFT request digitally from end to end
    ActorsTrainee 
    Pre-ConditionsLogged in
    Post-ConditionsLTFT request sent

    Where is the result sent? 

    Administrator will need to receive the form in order for it the details to be checked and the application either accepted or denied by the designated authority (Dean or deputy)

    Process Steps
    1. User navigates to XXX space
    2. System presents form details in editable view
    3. User completes relevant fields
    4. System validates fields
    5. System saves changes
    6. User selects to submit LTFT request
    7. LTFT is sent to XXX
    8. Historical view of submitted Forms updated
     
    Alternative FlowN/A 
    RulesTBD 
    JIRA ReferenceTBD 
    Audit LogTBD 


    Process NameT-14 Submit
    LTFT
    ExpensesComments
    DescriptionUser is able to submit their Expenses request digitally from end to end
    ActorsTraineeAny others? 
    Pre-ConditionsLogged in
    Post-ConditionsExpenses form submittedWhere do they receive outcome / follow up? 
    Process Steps
    1. User navigates to XXX space
    2. System presents form details in editable view
    3. User completes relevant fields
    4. System validates fields
    5. System saves changes
    6. User selects to submit expenses request
    7. Expenses are sent to XXX
    8. Historical view of submitted Forms updated
     
    Alternative FlowN/A 
    Rules
    • can be edited any number of times
    • Error message: cannot be edited once submitted, as no longer a draft
     
    JIRA ReferenceTBD 
    Audit LogTBD 


    Process NameT-15
    Submit ExpensesCommentsDescriptionActors
    Access Help & Support - TO BE DISCUSSED FURTHERComments MVP?
    DescriptionUser is able to access technical and administrative support for their journey through the application
    ActorsTrainee 
    Pre-ConditionsTBD
    Post-ConditionsTBD 
    Process Steps
     
    TBD Display phone number & email address
    Alternative FlowTBD 
    Rules
    • display contact details as per local office where they were registered OR
    • display central contact details (if available)
     
    JIRA ReferenceTBD 
    Audit LogTBD 


    Process NameT-
    16 Access Help & Support
    16 Save as draft before submissionComments MVP 
    DescriptionUser is able to draft and save the form, to come back to later
    ActorsTrainee 
    Pre-ConditionsLogged in
    Post-ConditionsDraft saved and accessible to be completed later 
    Process Steps
    1. User navigates to relevant form
    2. System presents form details in editable view
    3. User completes relevant fields
    4. System validates fields
    5. System saves changes
    6. User leaves relevant space without submitting the form
    7. System stores draft
     
    Alternative FlowT-11, T10 
    RulesTBD 
    JIRA ReferenceTIS-539 & TIS-92 
    Audit LogTBD 


    Process NameT-17 Forgotten Username
    Comments
    Comments Out of scope, manual process
    DescriptionUser has ability to login after they have forgotten their username
    ActorsTrainee 
    Pre-ConditionsUser is registered user
    Post-Conditions
     
    User has a reminder of their username Not secure
    Process Steps
     
    1. System User contacts HEE by telephone / email
    2. HEE provides username

    Alternative FlowN/A 
    RulesN/A 
    JIRA ReferenceTBD 
    Audit Log
     


    Process NameT-18 Forgotten Password
    Comments
    Comments MVP
    DescriptionUser has ability to
    navigate to "Posts" area within the UI from their current location on siteStory not neededActorsLocal Admin
    login after they have forgotten their password
    ActorsTrainee 
    Pre-Conditions
    Logged in
    HEE AdminAdmin is a permission applied by userPost-ConditionsView Posts landing page Process Steps1. View navigation
    2. Select "Posts"
    3. Present landing page Alternative FlowN/A Rules- Error: page unavailable
    Username recognised
    Post-ConditionsUser is able to login succesfullyNot secure
    Process Steps
    1. User selects password reminder
    2. New password is autogenerated
    3. New password is sent to registered email address
    4. User logs in using password sent
     
    Alternative FlowN/A 
    Rules
    • no validation
     
    JIRA ReferenceTBD - new story 
    Audit LogTBD 


    Process NameT-19 Book CoursesComments
    DescriptionUser has the ability to book new Courses Do we need this as part of the MVP? Joanne Watson (Unlicensed)
    ActorsTrainee 
    Pre-ConditionsUser is logged in
    Post-ConditionsSystem presents relevant detail What details can be seen?
    Process Steps
    1. User navigates to summary view
    2. System presents summary information
    3. User selects to view detail
    4. System presents detail view
    5. User selects to book Course
    6. System presents Booking view 
     
    Alternative FlowT-9 - View Course ??
    RulesValidation Rules? 
    JIRA Reference
    N/A
    TBD 
    Audit
    Log 
    log
    N/A
    TBD


    **New SCENARIO - manual completion & submission of form R**