Placement Planning Tool

As a TPD
I want to be able to see occupancy of posts and trainees in a programme within a given time window
So that I can assign easily assign trainees to vacant posts in a Plan

• Person detail should be forename, surname, GMC number
• Once a person is selected we should be able to see any past current or future placement details as well as Programme/curriculum membership detail (What is this. Is this the placement for person. We did not have this in the initial scope. We are looking at placements in a programme. So we are able to see on the timeline past/current and future. But not at the same level that we have for People/placements. Matt will discuss with Ashley). 

AP: At the time of searching the person, if we could have a link to the person>placements.

• Existing placements need to be visible within the UI

• Matt: GMC will be added as a pill by Panos. Matt will supply an example

Given I am a TPD user or Admin User
When I specify a date/time window on the planner
Then I should be able to see trainees with their forename, surname and GMC number details

Given there are trainees records returned for the time frame specified
When I select a person record
Then I should be able to see any past, current or future placement details 
And also see their Programme/Curriculum membership details 
(As discussed with James if we could have a link to the person>placements.)

Given there are Inactive/Deleted posts against the selected Programme
When the Planner is rendered
Then the Inactive posts should not be visible on the Planner
And the specialty dropdown should not be populated with specialties that are attached to inactive posts or placements

As a TDP
I want to be able to see occupancy of posts and trainees in a programme within a given time window - Done
So that I can efficiently assign posts to multiple less than full time trainees 

• Ensure WTE is visible in the UI

• Matt: WTE will be in the ’Tooltip rollover’ and also in the modal once you select the trainee

Ashley:

• Considerations for the design/display when there are 1 programme with 50 posts for e.g. at same specialty.
• Considerations for the design/display 'Dr Vacant' placements.

Given there are Whole Time Equivalent (WTE) placements against the selected Programme on  TIS
When those records are rendered on the Planner
Then I should be able to see the WTE information on those records within the Planner

• Matt: That is per speciality/post. Otherwise you will need to expand everything. Keep a note on that to discuss further in the meeting. I believe the way it is currently implemented works for that but better double check  with Ashley

  
  

• Ashley: We are able to see at Post level all the placements on the plan, I believe this is sufficient. We can check with James.

Given there are posts with more with multiple placements for the default or adjusted timeline
When the plan is rendered with placements
Then I should be able to see one row for the Post number with multiple placements

Given the timeline is then adjusted with a time period where for the same Post there are either more or less placements 
When the plan is rendered
Then the Posts should automatically render the placements available for that period

Given the timeline is then adjusted with a time period where for the same Post there are no placements
When the plan is rendered
Then the post should be visible with no placements

As a TPD 
I want to be able to search for and filter posts and people for a large programme -(We do not require a filter as far as we can determine as we have the ability to search across multiple areas of data. Filtering would require a table of results).
So that I can arrange the placements in a Plan format

• Ability to filter a list of trainees who have no placement within a specified time range. (Matt to talk to Ashley, where is the value in this? We have search but do not think we need filters, lets discuss, I think value if the results are large, but need to establish this with Ashley)
• Ability to filter a list of posts who have no trainees within a given time range. (Matt to discuss with Ashley as to value of filtering. We have the ability to search, would the user need to filter those searches. We would expect the user to understand what data they were looking for. Ie. A Trainee or a Post).
• Ability to search for trainees by name/GMC number within the UI 

• Matt to talk to Ashley, where is the value in this? We have search but do not think we need filters, lets discuss, I think value if the results are large, but need to establish this with Ashley)
• JH/AP: Post MVP

As a TPD
I want to be able to create/edit/delete placements with the searched vacant posts and trainees
So that I can include them in the plan

• When creating the placement we need to be able to access all the fields associated with a placement on TIS.
• To be able to assign Educational and Clinical supervisors against placements
• Warning when attempting to create a placement against an occupied post
• On creation the UI should save the placement and then take the user to the placement within the plan view

Given I am a Training Programme Director or Administrator
When I use the Planner to create placements
Then I should be able to search for and select a trainee that has a programme membership with the Programme
And create a placement for the trainee using one of the post associated with the programme 

Given I am a Training Programme Director or Administrator
When I use the Add Placement function within the Planner
Then I should be able to access the placement creation modal
And I should be able to access all the fields associated with a placement on TIS
And the specialty field should be pre-populated with the specialty selected from the Planner

Given there is a specialty filter to select from before rendering the planner
When I create a placement 
Then I should be able to select one of the 'Other specialties' of the Post to create a placement  with

Given Posts attached to the Programme can have 'Other sites'
When I create a placement from the Planner and select one of the Other site as to become the Main site of the placement
Then the planner should be rendered with those placements.

Given the placement creation modal has all the placement fields
When I enter values in the placement fields and save
Then the minimum placement mandatory fields should be validated for 
And all the fields in the modal should have the same validation as the Person Placement creation journey

Given the Placement modal has educational and clinical supervisor fields
When those fields are filled in along with the minimum mandatory fields for placement creation
Then the placement should be created with those supervisors associations

Given placements can be added from the Planner
When a placement is created and saved
Then the placement should be rendered on the Planner

Given there are placements on the Planner
When a placement is viewed from the modal 
Then I should be able to edit and make changes to the Placements fields
And the Planner should re-render with the changed placements details

Given ESR Notifications are currently tracked with existing endpoints for placements
When the same or new end points are available on the on the Placement Planning Tool to create/edit/delete placements
Then ESR Notifications should also be tracked in the same way

Given Placement added or amended date are recorded using existing Placement endpoints
When the same or new endpoints are available on the Placement Planning Tool to add or amend placement
Then the last amended or added date are still recorded in the same way

Given Placements are rendered on the Planner
When I select a placement and delete it
Then the placement record should be hard deleted in a consistent way as in the current Person Placement journey. (note there is ticket to move placement delete to soft delete - TISNEW-1427). 

And the planner should re-render without and not show the deleted placement

Given  there are different types of Placements (In Post, Parental leave, etc.)
When the placements are rendered on the Planner
Then I should be able to see and differentiate between the various types.

Given I am a Training Programme Director, Local Office Administrator with access to Programmes
When I navigate to a Programme on TIS
Then I should have access to the Placement Planning Tool

Given I am not one of the above roles, e.g. Trust admins roles
When I navigate to a Programme on TIS
Then I should not have access to the Placement Planning Tool

(tbd as to which roles should have access to the Planning Tool)

• Timeline to be at Programme/Plan level and not per per post as it is currently.

Given a Programme and a specialty is selected 

As a TPD

I want to be able to see the Post detail (National Post Number, Site, Specialty and Grade) on the planner

• Post detail should include Post No, Site, Specialty, Grade.

So that I have the site information of the post and easily assign trainees to vacant posts in a Plan.

• The suggestion from James is to show this under specialty from the current design

As a TPD

I want to see a warning pop up when allocating more than one trainee to a post number within the same time period

So that I manage placement

Survey feedback: Warning pop up when allocating more than 1 Trainee to a post number within the same time period (ideal would be to allocate each post an upper threshold for capacity based on the funding but appreciate this is probably not possible).

As a TPD

I want to be able to create/see/review the placement plan in draft

So that I can make changes before publishing

Survey feedback: Currently I can envisage that this is still going to be needed to be "planned" in an excel sheet, and then transposed, as there is no facility to drag and drop changes in this. the ability to drag and drop posts (i am working on the premise that only the npn could be changed, not the dates)

As a TPD

I want to see that unplaced trainees due to anesthetics sitting on 3 rotations flagged

So that I can manage rotation

Survey feedback: Risks for unplaced trainees due to anaesthetics sitting over 3 rotations. would this flag up?

As a Training Programme Director TPD

I want to be able to see all the posts and trainees in my programme as an overview

So that I can see trainee details, trainees already assigned to post and assign trainees to vacant posts in a plan

Survey feedback: Would like to be able to see all the posts and trainees(and their current placements ) as an overview with limited scrolling down and across When you scroll down and across, you lose the post site name, post number and dates. The screen is too large, and you are unable to see the whole programme at a glance without scrolling. You can't use the side scroll to scroll down

Survey feedback: Include other specialties alongside each post so you can tell which post you are picking Would like to see the specific post specialty showing as well as the post number

As a TPD

I want to see sites, trainee name in alphabetical order

So that I can easily find trainee or post

Survey feedback: The sites don’t show in alphabetical order. Trainee name, is this in alphabetical order via forename, should be surname and GMC. Specialty drop down to be in alphabetical order

Survey feedback: Specialty drop down is not in alphabetical order, making it difficult to use

As a TPD

I want to clearly see which trainees or posts have no placement or vacant

So that I can make sure I do not miss any trainee or posts

Survey feedback: Need a list of trainees not placed, posts free etc as discussed. Would be easier for the plan to select a Trust rather than showing all placements and Trusts.

As a TPD

I want the detail of the post and the site to persist when I scroll across the screen

So that I do not loose the detail of the post I’m working on.

Survey feedback: You have to use your mouse, unless you scroll right across to the other end of the page and then you loose all of the info (site name, post).

Survey feedback: It would be helpful to freeze the top date line and the post number on the left hand side. It would be useful to have an improved layout so more trainees/ programmes can be seen on screen at one time. Visually it isn't easy to absorb the information. A freeze pane on the left column would be good when scrolling sideways. Fixing the row and column heading to always visible [AA1]

As a TPD

I want each post to only take up one line unless they are in a slot share

So that I can maximise my views.

Survey feedback: A new line for every trainee on the placement takes up a lot of room, would look easier if they were only on separate lines if an overlap. NPN taking 2 lines, would like to have the option of making it one line, meaning up to twice as many lines per screen can be displayed. I have noticed there is scrolling on the list, then sub scrolling in the sites on the list, I fear this will cause confusion or lines being missed. Further, upon reexamination, it is the location of the mouse at the start of the scroll that impacts on this. EXAMPLE: in my current view, Coventry Teaching PCT is showing 3 lines, (all empty) with my mouse over that, rolling the wheel to go down the page, it jumps over BIRMINGHAM COMMUNITY CHILDREN'S CENTRE after only showing 2 NPN's. then goes straight to Shropshire Community Health NHS Trust HQ. If I start with the mouse hovering over BIRMINGHAM COMMUNITY CHILDREN'S CENTRE and roll the mouse wheel to scroll down, it does not move the page, by scrolls the specific sub section for BIRMINGHAM COMMUNITY CHILDREN'S CENTRE within the list.

Survey feedback: The ability to see more lines of NPNs at one time

As a TPD (Training Programme Director)

I want to be able to see and distinguish between the different types of placements (Parental leave, In Post, etc.)

So that I can efficiently manage the plan

A ticket already exists in the MVP

Survey feedback: I want to be able to differentiate trainees ‘in post’, ‘not in post’, ‘maternity leave’, SPL, acting up and paternity using different colours etc. Needs to identify if the trainee is on maternity leave. So that I can see trainee details, assigned trainees and assign trainees to vacant

Given  there are different types of Placements (In Post, Parental leave, etc.)
When the placements are rendered on the Planner
Then I should be able to see and differentiate between the various types.

As a TDP

I want to be able to see occupancy of posts and trainees in a programme within a given time window

So that I can efficiently assign posts to multiple less-than-full-time trainees

A ticket already exist in the MVP

Survey feedback: Show the Trainee's WTE next to their name if LTFT. Needs to highlight if they are LTFT and the percentage, this would be useful to be able identify available slot shares[AA1]

Given there are Whole Time Equivalent (WTE) placements against the selected Programme on  TIS
When those records are rendered on the Planner
Then I should be able to see the WTE information on those records within the Planner

As a TPD

I want to see GMC number next to the trainee names in the drop-downs when locating placement for the trainee or/and adding placement

So that I can quickly locate the exact trainee.

Survey Feedback: Would like to see the trainees GMC number

Survey Feedback: When creating a new placement, could GMC number also be shown (for cases where a common name may occur)