Connections Logic - Discussions with Users
- Adewale Adekoya
- Andy Nash (Unlicensed)
- Rob Pink
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)
Connection Functional specification
Flow diagram of data:
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:
|
| 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 |
|
| If doctor current connection is YES
| 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
| 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
| >> When TIS is not updated >> Into discrepancy as prompt to fix data |
|
|
30 | 16 | INACTIVE Doctors in TIS |
|
| If doctor current connection is YES
| >> Could be inactive “in error”, or issue with programme membership. >> Only inactive who are connected https://hee-tis.atlassian.net/browse/TIS21-4195 is not required, because the trainingstatus in TCS is totally populated from current programme membership and we only export current programme membership from tcs to Reval. | Done | |
31 | 17 | Hide doctor with current connection | Admin should be able to hide connected doctor though the doctor stays connected |
|
| >> |
|
|
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 |
| 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
|
| If doctor current connection is YES
| 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 doctor current connection is YES
| 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 doctor current connection is YES
| 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 doctor current connection is YES
| 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
|
| For Joint programme If doctor current connection is YES
For Dual curriculum << not applicable>> If doctor current connection is YES
| Expired programme membership for the two scenarios? If doctor current connection is NO:
>> 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. |
|
|
Slack: https://hee-nhs-tis.slack.com/
Jira issues: https://hee-tis.atlassian.net/issues/?filter=14213