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 Name | T-1 New Registration | Comments 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? | Actors | Trainee | 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. |
Actors | Admin | |
Pre-Conditions |
TBCAlternative Flow | User is registered from <another system> | |
Rules | TBC | Format of username? Validation of password? What security should be implemented? |
JIRA Reference | New story TBD | Wider discussion necessary on whether this is a valid story, before writing a JIRA ticket |
Audit Log | TBC | |
Trainee must have registered via Oriel to a particular region |
|
Post-Conditions | Trainee has access to new TIS system - login / logout capability | |
Process Steps |
- user register a username
- user sets password
- user sets securiity
- user validates details
- system shares
| What interaction should this have with Admin UI? What are the back end implications? | - Import trainees from Oriel
- Trigger welcome message send - inform trainees of what TIS is about, support, login details to follow
- 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 Reference | TIS-629 |
|
Monitoring | No need to report on this | Oriel upload to be considered separately |
LoginLogin | Comments MVP |
Description | Trainee 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. |
Actors | Trainee | |
Pre-Conditions | Trainee has been registered on system |
Trainee has validated their registered details
|
Post-Conditions | Trainee is able to view the login space | |
Process Steps |
Traine - Trainee enters username
- Trainee enters password
- System validates details
- 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 | |
validation?- : Invalid email/password entered
|
|
JIRA Reference |
TBDAudit Log | TBD |
Usage Monitoring | No users logging in Further discussion required | |
| T-3 Trainee Logout | Comments MVP |
Description | Trainee has the ability to logout of the system |
|
Actors | Trainee | |
Pre-Conditions | Trainee has been registered on system Trainee has validated their registered details |
|
Post-Conditions | Trainee leaves logged in view of system securely | |
Process Steps | - Trainee selects to logout
- System logs user out
- System presents logged out view
| |
Alternative Flow | N/A | |
Rules |
Error validation?TBDAudit Log
Process Name | T-4 View Summary | Comments MVP |
Description | Trainee has the ability to view the summary screen |
|
Actors | Trainee System | |
Pre-Conditions | Trainee is logged in |
|
Post-Conditions | Summary details in view Navigation menu available | |
Process Steps | - User logs in
- System presents summary
- User navigates through view
|
Fields displayed - Current Placement End Date & Site (Steve to confirm)
- Next Placement Start Date & Site (Steve to confirm)
|
Alternative Flow | N/A | |
Rules |
Validation rules?TBD
Process Name | T-5 View & Edit Personal Details | Comments MVP |
Description | User has the ability to view and update their own details |
|
Actors | Trainee | |
Pre-Conditions | Trainee 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 | - User navigates to Personal Details space
- System presents personal details in editable view
- User makes changes to relevant fields
- System validates changes
- 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 Flow | N/A | |
Rules |
Validation rules? | - View & Edit select fields, see data table
|
|
JIRA Reference |
TBDTIS-540, TIS-278 | |
Audit Log | TBD | |
Process Name | T-6 View Programme |
CommentsComments MVP |
Description | User has the ability to view their Programme details |
|
Actors | Trainee | |
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-Conditions | System presents relevant detail | |
Process Steps | - User navigates to
|
summary System presents summary informationUser selects to view detailSystem presents detail view- User views Programme data
- User selects to leave Programme Detail view
- 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 Flow | N/A | |
Rules |
Validation rules?
- View only
- View will show historical programmes, current and future programmes if applicable
| |
JIRA Reference |
TBD
Process Name | T-7 View Placement | Comments MVP |
Description | User has the ability to view their Placement details |
|
Actors | Trainee | |
Pre-Conditions | User is logged in |
|
Post-Conditions | System presents relevant detail | |
Process Steps | - User navigates to summary view
|
System presents summary informationUser selects to view detailSystem presents detail view- User views Placement data
- User selects to leave Placement Detail view
|
System presents summary view Fields Start Date End Date Site Grade Specialty Placement type
|
Alternative Flow | N/A | |
Rules | - View only
- Detailed view should present historical, current and future placements
| |
JIRA Reference |
TBD
Process Name | T-8 View Assessment | Comments MVP |
Description | User has the ability to view their Assessment details |
|
Actors | Trainee | |
Pre-Conditions | User is logged in |
|
Post-Conditions | System presents relevant detail | |
Process Steps | - User navigates to
|
summary System presents summary informationUser selects to view detailSystem presents detail view- User views assessment data
- 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 Flow | N/A | |
Rules | - View only
- Detailed view should present historical, current and future assessments
| |
JIRA Reference |
TBD
Process Name | T-9 View Courses | Comments |
Description | User has the ability to view their Course details | Do we need this as part of the MVP? Joanne Watson (Unlicensed) |
Actors | Trainee | |
Pre-Conditions | User is logged in |
|
Post-Conditions | System presents relevant detail | What details can be seen? |
Process Steps | - User navigates to summary view
- System presents summary information
- User selects to view detail
- System presents detail view
- User selects to leave Course Detail view
- System presents summary view
| Should there be a summary view of courses? |
Alternative Flow | T-19 Book Course | |
?Is this necessary for MVP? |
Rules | View Only | |
JIRA Reference | TBD | |
Audit Log | TBD | |
Process Name | T-10 Submit Form-R (Part A) |
CommentsComments MVP |
Description | User is able to submit the form that will update their personal details with the GMC |
|
Actors | Trainee | |
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 | - User navigates to Form R, Part A space
- System presents form in editable view
- System autopopulates relevant fields
- User makes changes to relevant fields
- System validates changes
- System saves changes
- User signs the form
- User selects to submit Form-R (Part A)
- Form-R (Part A) is sent to HEE Admins
- 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 Flow | T-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 Reference | N/A | |
Audit Log | TBD | |
Process Name | T-11 Submit Form-R (Part B) |
CommentsComments MVP |
Description | User 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-Conditions | Form-R (Part B) is submitted | |
Process Steps |
| Alternative Flow | | Rules | | JIRA Reference | | - User navigates to Form R Part B space
- System presents form details in editable view
- User completes relevant fields
- System validates fields
- System saves changes
- User signs form (tbc as with Part A)
- User selects to submit Form-R (Part B)
- Form-R (Part B) is sent to Admin UI
- 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 Flow | T-16 Save as draft before submission | Yes 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 Reference | TIS-539 & TIS-92, story for save drafts | |
Audit Log | TBD | |
Process Name | T-12 Submit OOP | Comments |
Description | User is able to submit their OOP request digitally from end to end |
|
Actors | Trainee | |
Pre-Conditions | Logged in |
|
Post-Conditions | OOP 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 | - User navigates to XXX space
- System presents form details in editable view
- User completes relevant fields
- System validates fields
- System saves changes
- User selects to submit OOP request
- OOP request is sent to XXX
- Historical view of submitted Form's updated
| |
Alternative Flow | Save draft | Is this necessary? Yes |
Rules | TBD | |
JIRA Reference | TBD | |
Audit Log | TBD | |
Process Name | T-13 Submit LTFT | Comments |
Description | User is able to submit their LTFT request digitally from end to end |
|
Actors | Trainee | |
Pre-Conditions | Logged in |
|
Post-Conditions | LTFT 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 | - User navigates to XXX space
- System presents form details in editable view
- User completes relevant fields
- System validates fields
- System saves changes
- User selects to submit LTFT request
- LTFT is sent to XXX
- Historical view of submitted Forms updated
| |
Alternative Flow | N/A | |
Rules | TBD | |
JIRA Reference | TBD | |
Audit Log | TBD | |
LTFTExpenses | Comments |
Description | User is able to submit their Expenses request digitally from end to end |
|
Actors | Trainee | Any others? |
Pre-Conditions | Logged in |
|
Post-Conditions | Expenses form submitted | Where do they receive outcome / follow up? |
Process Steps | - User navigates to XXX space
- System presents form details in editable view
- User completes relevant fields
- System validates fields
- System saves changes
- User selects to submit expenses request
- Expenses are sent to XXX
- Historical view of submitted Forms updated
| |
Alternative Flow | N/A | |
Rules | - can be edited any number of times
- Error message: cannot be edited once submitted, as no longer a draft
| |
JIRA Reference | TBD | |
Audit Log | TBD | |
Submit ExpensesComments | Description | Actors | Access Help & Support - TO BE DISCUSSED FURTHER | Comments MVP? |
Description | User is able to access technical and administrative support for their journey through the application |
|
Actors | Trainee | |
Pre-Conditions | TBD |
|
Post-Conditions | TBD | |
Process Steps |
| TBD | Display phone number & email address |
Alternative Flow | TBD | |
Rules | - display contact details as per local office where they were registered OR
- display central contact details (if available)
| |
JIRA Reference | TBD | |
Audit Log | TBD | |
16 Access Help & Support16 Save as draft before submission | Comments MVP |
Description | User is able to draft and save the form, to come back to later |
|
Actors | Trainee | |
Pre-Conditions | Logged in |
|
Post-Conditions | Draft saved and accessible to be completed later | |
Process Steps | - User navigates to relevant form
- System presents form details in editable view
- User completes relevant fields
- System validates fields
- System saves changes
- User leaves relevant space without submitting the form
- System stores draft
| |
Alternative Flow | T-11, T10 | |
Rules | TBD | |
JIRA Reference | TIS-539 & TIS-92 | |
Audit Log | TBD | |
Process Name | T-17 Forgotten Username |
CommentsComments Out of scope, manual process |
Description | User has ability to login after they have forgotten their username |
|
Actors | Trainee | |
Pre-Conditions | User is registered user |
|
Post-Conditions |
User has a reminder of their username | Not secure |
Process Steps |
- System User contacts HEE by telephone / email
- HEE provides username
|
|
Alternative Flow | N/A | |
Rules | N/A | |
JIRA Reference | TBD | |
Audit Log |
| |
Process Name | T-18 Forgotten Password |
CommentsComments MVP |
Description | User has ability to |
navigate to "Posts" area within the UI from their current location on siteStory not needed | Actors | Local Adminlogin after they have forgotten their password |
|
Actors | Trainee | |
Pre-Conditions |
Logged in HEE Admin | Admin is a permission applied by user | Post-Conditions | View Posts landing page | |
Process Steps | 1. View navigation 2. Select "Posts" 3. Present landing page | |
Alternative Flow | N/A | |
Rules | - Error: page unavailable | Username recognised |
|
Post-Conditions | User is able to login succesfully | Not secure |
Process Steps | - User selects password reminder
- New password is autogenerated
- New password is sent to registered email address
- User logs in using password sent
| |
Alternative Flow | N/A | |
Rules | | |
JIRA Reference | TBD - new story | |
Audit Log | TBD | |
Process Name | T-19 Book Courses | Comments |
Description | User has the ability to book new Courses | Do we need this as part of the MVP? Joanne Watson (Unlicensed) |
Actors | Trainee | |
Pre-Conditions | User is logged in |
|
Post-Conditions | System presents relevant detail | What details can be seen? |
Process Steps | - User navigates to summary view
- System presents summary information
- User selects to view detail
- System presents detail view
- User selects to book Course
- System presents Booking view
| |
Alternative Flow | T-9 - View Course | ?? |
Rules | Validation Rules? | |
JIRA Reference |
N/A Log N/A |
**New SCENARIO - manual completion & submission of form R**