...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Scenario description
...
Rules
...
Actions
...
Tab
...
Comments
...
MVP?
...
F1 Doctor
...
Trigger: Placement grade = F1
...
Hide Doctor
...
Hidden Tab only
Doctor appear in All Doctors Tab? Do we really need the All doctor tab?
...
Y
...
Military Doctor
...
Trigger: Programme membership type = Military
...
Hide Doctor
...
Hidden Tab only
...
Doctor appear in All Doctors Tab?
...
Y
...
Reval Admin manual hide current connected Doctor
...
Trigger: Manually hide doctor
...
Hide Doctor
...
Hidden Tab only?
...
Should the Doctor still appear in connected? I want to think ‘No’.
Doctor appear in All Doctors Tab?
...
Not Required at all
...
Visitors
...
Add to Discrepancies Tab (Exception Queue) (also need to be able to add/remove connections and add comment reason manually)
...
Logic context
Page 1 shows the functional Specifications and page 2 is the Connection logic and Connection tabs, (Pages 3 and 4 are for Post funding not for Reval)
Inc drawio | ||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Connection Functional specification
Flow diagram of data:
Drawio | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
MVP
Cross-reference (original row number) | Priority | Scenario description | Rules | Actions | Appear in which tab? Y/N | Questions and Comments | Status (Done, In progress, To do) | Related tickets | ||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | 1 | F1 Doctor | Trigger: Placement grade = F1 |
| Hidden Tab only - Y | Doctor appear in All Doctors Tab? All tab logic is complex to implement, we want to suggest Post MVP is required. F1 Drs to be hidden (as happens with F1 Drs from TIS) Question - do Reval Admins want to manually hide? | Parked pending further investigation |
| ||||||||
2 | 2 | Military Doctor | Trigger: Programme membership type = Military |
| Hidden Tab only Y | Doctor appear in All Doctors Tab? How many (clustered) military Drs are there? Do we get these Drs via GMC? If so, needs to go to discrepancies and the manually assigned ID Are they associated with a Designated Body? Yes - always will be the Defence Deanery (not in the current list of Designated Bodies) - implies hidden automatically - check with Reval Admins Auto hidden (to confirm with Reval Admins) | Done |
| ||||||||
5 | 3 | Update made via GMC Connect Doctor is Connected to a DBC (Add connection) | Should these update be reflected within TIS-Revalidation-Connection Discrepancies within 24 hours? |
| If doctor current connection is NO:
| Doctor appear in All Doctors Tab? No This is overnight sync
| Not required |
| ||||||||
6 | 4 | Update made via GMC Connect Doctor is disconnected from a DBC (Remove connection) | Should these update be reflected within TIS-Revalidation-Connection Discrepancies within 24 hours? |
| If doctor current connection is YES
| Doctor appear in All Doctors Tab? No This is overnight sync
| Not required |
| ||||||||
7 | 5 | DBC removed/remove connection | They should be added to a designated body if they have a programme membership and today is within the start/end date; Both must be true in relation to programme membership in this scenario
|
| If doctor current connection is YES
| If a doctor/Admin mistakenly remove DBC or disconnect a doctor either from TIS- Reval or GMC Connect. | Done |
| ||||||||
8 | 6 | DBC not matching for both TIS and GMC | If GMC Connect updates a connection, but it clashes with TIS DBC, should this update be reflected within TIS-Revalidation-Connection Discrepancies within 24 hours? | <<Current connection according to GMC>> | If doctor current connection is YES
| Done |
| |||||||||
9 | 7 | Programme membership not matching | If GMC Connect updates a connection, but it clashes with TIS programme membership detail, should this update be reflected within TIS-Revalidation-Connection Discrepancies within 24 hours | If doctor current connection is YES
| Done |
| ||||||||||
10 | 8 | GMC number not matching | If GMC Connect updates a connection, but it clashes with TIS GMC Number, should this update be reflected within TIS-Revalidation-Connection Discrepancies within 24 hours | If doctor current connection is YES
| GMC never changes. ? Assumption that a changed GMC No on TIS will lead to that doctor being “unmatched” - thus move doc to discrepancy. | Take out of MVP Not required | ||||||||||
11 | 9 | No GMC number in TIS GMC send a GMC number for a doctor who had no GMC number in TIS |
| If doctor current connection is YES
| This also should cover if GMC Number is removed in error. No GMC number in TIS but GMC number in GMC Is it possible to have a doctor without GMC number in GMC? If yes, should we also send to discrepancies? ? Assumption that if NO GMC No on TIS will lead to that doctor being “unmatched” - thus move doc to discrepancy (how can users tell what the specific discrepancy is?!?!). ? How is GMC recorded when unknown or null. Perceived edge case
| Done |
| |||||||||
16 | 10 | GMC provide doctor not in TIS |
| If doctor current connection is YES
| Can TIS- Reval app capture such doctors from GMC? Is All Doctor tab populated from GMC or TIS (Question for the devs)? | Not required |
| |||||||||
17 | 11 | Doctor has current programme membership in TIS, not connected to DBC & programme end date is today or in the future | They should be added to a designated body if they have a programme membership and today is within the start/end date. Both must be true in relation to programme membership in this scenario
|
|
...
| If doctor current connection is NO:
|
...
|
...
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
How will notifying GMC and doctor work? Nothing to do from our end - Admin will contact doctor
Doctor appear in All Doctors Tab?
Visitors in TIS- need to know how to deal with them.
Stop: 20/04/2022
...
Y
...
Update made via GMC Connect - add/remove connections;
During GMC update, if
Doctor is Connected to BDC
Doctor is disconnected from DBC
DBC not matching
Programme membership not matching
GMC number not matching
Programme Owner removed or changed
Programme Membership removed or changed
This should be reflected within TIS-Revalidation-Connection Discrepancies within 24 hours
Trigger: GMC refresh (nightly??)
If GMC Connect updates a connection, but it clashes with TIS programme membership detail
...
| Done |
| ||||||||||||||
22 | 12 | Doctor Connected to a DBC and Programme Membership not expired |
| If doctor current connection is YES
| Done |
| ||||||||||
23 | 13 | Doctor Connected to a DBC and Programme membership Expired |
|
GMC update
Doctor is disconnected from DBC:
...
If doctor current connection is YES
|
...
|
...
3. DBC not matching
If disconnected;
Historic Connections tab (Disconnections) only? should the update appears in Discrepancies Tab (Exception Queue)?
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
4. Programme Membership not Matching
If disconnected;
...
| Admin allowed to manually to disconnect | Done | |||
26 | 14 | TIS to GMC API failure | The last updated date should be displayed across revalidation; resend should be made available |
| If doctor current connection is YES
|
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
5. GMC number not matching
If disconnected;
Historic Connections tab (Disconnections) only? should the update appears in Discrepancies Tab (Exception Queue)?
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
6. Programme Owner removed or changed
If disconnected;
Historic Connections tab (Disconnections) only? should the update appears in Discrepancies Tab (Exception Queue)?
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
7. Programme Membership removed or changed
If disconnected;
Historic Connections tab (Disconnections) only? should the update appears in Discrepancies Tab (Exception Queue)?
| For individual doctor connection/disconnection using API >> if API failure then visual notification for specific trainee. GMC - green = OK, red = fail with info on why error (internal / external) |
| |||||||||
29 | 15 | Overlapping programmes in 2 regions | Trigger: start date of one programme is before end date of the next + programme in 2 regions |
| If doctor current connection is YES
|
...
|
...
Doctor appear in All Doctors Tab?
...
GMC provide trainee not in TIS
...
Add to Discrepancies Tab (Exception Queue)
Visible to Local Office associated with the connected designated body only
...
| >> When TIS is not updated >> Into discrepancy as prompt to fix data | ||||
30 | 16 | INACTIVE Doctors in TIS | If doctor current connection is YES
|
...
|
...
Doctor has current programme membership in TIS, but no designated body connected
...
They should be added to a designated body if they have a programme membership and today is within the start/end date; only the local office who own the programme should see this
Trigger: current programme membership + no designated body linked
...
Add to Discrepancies Tab (Exception Queue) (also need to be able to add/remove connections and add comment reason manually)
Flag to add connection < can this be automated based on programme membership owner? Do we need flag?
When change is made, send to GMC and notify doctor
If disconnected;
Historic Connections tab (Disconnections) only
...
| >> Could be inactive “in error”, or issue with programme membership. >> Only inactive who are connected
| Done |
| ||||||||||||||||
31 | 17 | Hide doctor with current connection | Admin should be able to hide connected doctor though the doctor stays connected |
|
...
How will notifying doctor work?
...
Doctor has current programme membership in TIS, but no designated body connected & programme information out of date
...
They should be added to a designated body if they have a programme membership and today is within the start/end date; only the local office who own the programme should see this. It’s not possible for the system to know their programme membership details are out of date.
Trigger: current programme membership + no designated body linked
Both must be true in relation to programme membership in this scenario
start date = today or older than today
end date = tomorrow and all future dates
...
Add to Discrepancies Tab (Exception Queue) (also need to be able to add/remove connections and add comment reason manually)
Flag to add connection < can this be automated based on programme membership owner? Do we need flag?
When change is made, send to GMC and notify doctor
...
If disconnected;
Historic Connections tab (Disconnections) only
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
How will notifying doctor work?
...
Doctor has no current programme membership in TIS, no designated body
...
They should be hidden
Trigger: No programme membership + no designted body
At least one of the below must be true in relation to programme membership in this scenario
start date = future or no date
end date = past, future or no date
...
Hide Doctor
Visible to all local offices. is it for that associated DB or all DBs?
When change is made, send to GMC and notify doctor
...
If disconnected;
Historic Connections tab (Disconnections) only
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
...
How will notifying doctor work?
...
Trainee has no current programme membership in TIS, has designated body
They should be moved to an exception queue
Trigger: No programme membership + designted body
At least one of the below must be true in relation to programme membership in this scenario
...
start date = future or no date
...
| >> | |||||||
32 | 18 | NEW: License to Practice removed due to suspension | Remove connection |
| How do we no this in TIS Reval? >> GMC will remove so doc., so will need to be hidden by LO. How can we determine that the licence has been removed? | |||
33 | 19 | Sanity check data on Prod | Been a long time since working on this - would be useful to double check (perhaps with Phil Skeldon)? |
Post-MVP
Cross reference (original row number) | Priority | Scenario description | Rules | Actions | Appear in which tab? Y/N | Questions and Comments | Status (Done, In progress, To do) | Related tickets |
---|---|---|---|---|---|---|---|---|
3 | 1 | Reval Admin manually hide current connected Doctor. | Trigger: Manually hide doctor |
| Hidden Tab only? N/R | Should the Doctor still appear in connected? I want to think ‘No’. Doctor appear in All Doctors Tab? 29/06/2022: Hide connection should only be in Exception Cross-reference with Ade’s flow diagram | ||
4 | 2 | Visitors | Trigger: Programme membership type = Visitor |
| If doctor current connection is YES
| Doctor appear in All Doctors Tab? No Stop: 20/04/2022 Number of visitors thought to be low, so post-MVP task | ||
12 | 3 | GMC number against 2+ doctors | Two doctors having the same GMC number |
|
...
|
...
|
...
When change is made, send to GMC and notify doctor
...
If disconnected;
Historic Connections tab (Disconnections) only
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
...
How will notifying doctor work?
...
TIS to GMC API failure
...
The last updated date should be displayed across revalidation; resend should be made available
Trigger: failed GMC update notification ??
...
Add to Discrepancies Tab (Exception Queue)
Visible to Local Office associated with the connected designated body only
...
If disconnected;
Historic Connections tab (Disconnections) only? should the update appears in Discrepancies Tab (Exception Queue)?
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
...
Doctor appear in All Doctors Tab?
...
Designated body removed
...
They should be added to a designated body if they have a programme membership and today is within the start/end date; only the local office who own the programme should see this
Trigger: current programme membership + no designated body linked
Both must be true in relation to programme membership in this scenario
start date = today or older than today
end date = tomorrow and all future dates
...
Add to Discrepancies Tab (Exception Queue) (also need to be able to add/remove connections and add comment reason manually)
Flag to add connection < can this be automated based on programme membership owner? Do we need flag?
When change is made, send to GMC and notify doctor
...
If disconnected;
Historic Connections tab (Disconnections) only
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
...
How will notifying doctor work?
...
Programme Membership not expired
...
Add to Discrepancies Tab (Exception Queue)
Remove any connection
Visible to all Local Offices. is it for that associated DB or all DBs?
...
If disconnected;
Historic Connections tab (Disconnections) and in Discrepancies Tab (Exception Queue) only
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
...
Programme membership Expired
...
Add to Discrepancies Tab (Exception Queue)
Remove any connection
Visible to all Local Offices. is it for that associated DB or all DBs?
...
If disconnected;
Historic Connections tab (Disconnections) only
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
...
Should it be automatic move to Discrepancies and disconnection or Admin must be allowed manually to disconnect?
...
No programme membership in TIS (today <Curriculum end date)
...
They will need to either (i) have a programme membership added and be connected, or (ii) ignored
Trigger: today <programme membership date
...
Add to Discrepancies Tab (Exception Queue)
Remove any connection
Visible to all Local Offices. is it for that associated DB or all DBs?
...
If disconnected;
Historic Connections tab (Disconnections) only
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
...
No programme membership in TIS (today > Curriculum end date)
...
They will need to be removed
Trigger: today >programme membership date
...
Add to Discrepancies Tab (Exception Queue)
Remove any connection
Archive. Should this be hidden rather than archive?
...
If disconnected;
Historic Connections tab (Disconnections) only
If Connected:
Discrepancies Tab (Exception Queue) & Current Connections tab ( Connections) only
...
Programme membership and local office changes in TIS
Their connection should be updated
Trigger: programme membership changes and owning local office changes
...
| If doctor current connection is YES
| There’re existing GMC numbers against 2+ doctors in TIS (see https://build.tis.nhs.uk/metabase/question/461) Not required as not possible to duplicate GMC No as this is flagged and record cannot be saved (but do the ticket 👉 ) |
| |||||||||
13 | 4 | No training pathway in TIS |
| If doctor current connection is YES
| If there is no training pathway in TIS, should the doctor be moved to discrepancies tab? Any update to the Training Pathway should move to discrepancies? This refers to the programme training pathway CCT, CESR, NA etc… Not required | |||||||
14 | 5 | Programme Owner removed or changed in TIS | Their connection should be updated Trigger: owning local office changes |
| If doctor current connection is YES
| No auto update | ||||||
15 | 6 | Programme Membership removed or changed in TIS | Their connection should be updated Trigger: programme membership changes Both must be true in relation to programme membership in this scenario
Optional programme membership change
|
| If doctor current connection is YES
| |||||||
18 | 7 | Doctor has no current programme membership in TIS, and not connected to DBC | They should be hidden At least one of the below must be true in relation to programme membership in this scenario
|
| Historic tab | If have a previous connection then historic. | ||||||
19 | 8 | Doctor has no current programme membership in TIS, but connected to a DBC | They should be moved to an exception queue At least one of the below must be true in relation to programme membership in this scenario
|
...
|
...
Optional programme membership change
programme name change
...
|
|
...
If disconnected;
Historic Connections tab (Disconnections) only
...
| If doctor current connection is YES
|
...
|
...
How will notifying doctor and Admin work?
...
Joint programme membership if programme membership not expired
Possibilities?
No DB
one DB?
More than one DBs?
2. Programme end date not expired but dual curriculum
Any of the local offices should be able to determine which designated body and there should be no further action required; all should be able to view/edit
Trigger: no designated body + shared programme membership
Both must be true in relation to programme membership in this scenario
...
start date = today or older than today
...
end date = tomorrow and all future dates
...
| Is this even possible? Discrepancy? | |||
20 | 9 | No programme membership in TIS but with curriculum (today <Curriculum end date) | They will need to either (i) have a programme membership added and be connected, or (ii) Hidden Trigger: today <programme membership end date |
|
...
|
...
|
...
If disconnected;
...
| If |
...
doctor current connection is YES
|
...
All trainees
...
Display full list of trainees associated with admin's local office
Trigger: trainee programme membership owning local office = same as admin’s
...
Read only
...
What is the meaning of this?
...
No GMC number
GMC send a GMC number for a doctor who had no GMC number in TIS
...
| We don’t think this possible in TIS Not required | |||
21 | 10 | No programme membership in TIS but with curriculum (today > Curriculum end date) | They will need to either (i) have a programme membership added and be connected, or (ii) Hidden Trigger: today >programme membership end date |
|
...
|
...
If disconnected;
Historic Connections tab (Disconnections) only
...
| If doctor current connection is YES
|
...
|
...
If there is no training pathway, should the doctor be moved to discrepancies tab?
...
Overlapping programmes in 2 regions
The record should be moved to Discrepancies Tab (Exception Queue)
...
| We don’t think this possible in TIS Not req | ||||
24 | 11 | Manually add connection in TIS-Reval to Programme Membership and there is discrepancy with TIS programme membership | If manual change (add connection) and there is conflicts with TIS programme membership |
| If |
...
Historic Connections tab (Disconnections) only
...
doctor current connection is YES
|
...
|
...
Stop
...
No current placement
...
Related to 20 and 23?
...
GMC number against 2+ trainees
...
Is it more more than one doctor having the same GMC number?
...
INACTIVE Doctors in TIS
...
Related to 18 and 23?
...
Hide doctor with current connection
...
Admin should be able to hide connected doctor though the doctor stays connected
...
NEW: Manual add connection in TIS-Reval to Programme Membership discrepancy
...
If manual change (add connection) conflicts with TIS programme membership
Flag for review
...
Flag for remove
...
| When adding a Connection we shouldn’t need to cross-check Programme Membership with TIS | |||||||
25 | 12 | No current placement Scenarios
| ? Not expected to be flagged as not with current programme. | |||||
27 | 13 |
Possibilities?
| Trigger: no designated body + shared programme membership Both must be true in relation to programme membership in this scenario
|
|
...
NEW: remove list should contain any Doctor whose programme membership end date is < today
...
programme membership expires
For Joint programme If doctor current connection is YES
For Dual curriculum << not applicable>> If doctor current connection is YES
|
...
Visible to all Local Offices associated with the connected programme membership
...
Related to 18 and 20?
...
NEW: GMC Number removed in error
...
No GMC number in TIS but GMC number in GMC
...
| Expired programme membership for the two scenarios? If doctor current connection is NO:
|
...
Visible to all Local Offices associated with the connected programme membership
...
Is it possible to have a doctor without GMC number in GMC?
...
NEW: License to Practice removed due to suspension
...
Remove connection
...
How do we no this in TIS Reval?
...
“All” filter: requires all trainees who have been connected currently and in the past
...
>> joint programme inc. across LO >> One of the LO will hide trainee so they are not constantly flagged in discrepancy. What should we do with joint Programme and Dual Curriculum - send to discrepancies? If “Yes”, it’s MVP - one LO to process it and the other to ignore it How do the LOs know when Drs are in Joint Programmes Dual Curriculums? | ||||||||
28 | 14 | All trainees | Display full list of trainees associated with admin's local office Trigger: trainee programme membership owning local office = same as admin’s |
| What is the meaning of this? >> ? All Trainee list, which is not required. |