Special appointments (#106)

* Add routes for special appointments
* Add special appointments flow
* Get summary list working in the special appointment callout
* Update content to include implanted medical devices
* Get banners working on page
* Make sure we use the right data for tags
* Clear temporary reasons list if none are temporary
---------

Co-authored-by: Colin Rotherham <[email protected]>
Co-authored-by: Ed Horsford <[email protected]>

Author: 3 people

app/assets/sass/_misc.scss

@@ -56,4 +56,5 @@
 
 .nhsuk-card--feature {
   @include nhsuk-responsive-margin(5, "top");
-}
+
+}

app/data/test-scenarios.js

@@ -19,12 +19,16 @@ module.exports = [
         ethnicGroup: null,
         ethnicBackground: null,
       },
-      extraNeeds: ['Wheelchair user'],
       config: {
         eventId: '5gpn41oi',
         defaultRiskLevel: 'routine',
         repeatViews: ['RMLO'],
         missingViews: [], // ensure all views are present
+        specialAppointment: {
+          supportTypes: ['Physical restriction'],
+          physicalRestrictionDetails: 'Uses wheelchair, needs accessible positioning and additional time for transfers',
+          temporaryReasons: 'no'
+        },
         scheduling: {
           whenRelativeToToday: 0,
           status: 'event_scheduled',
@@ -58,4 +62,4 @@ module.exports = [
       },
     },
   },
-]
+]

app/lib/generate-seed-data.js

@@ -147,6 +147,7 @@ const generateClinicsForDay = (date, allParticipants, unit, usedParticipantsInSn
         id: scenario?.participant?.config?.eventId,
         outcomeWeights: config.screening.outcomes[firstClinic.clinicType],
         forceStatus: scenario.participant.config.scheduling.status,
+        specialAppointmentOverride: scenario?.participant?.config?.specialAppointment,
       })
 
       events.push(event)

app/lib/generators/event-generator.js

@@ -8,6 +8,7 @@ const config = require('../../config')
 const { STATUS_GROUPS, isCompleted, isFinal } = require('../utils/status')
 const { generateMammogramImages } = require('./mammogram-generator')
 const { generateSymptoms } = require('./symptoms-generator')
+const { generateSpecialAppointment } = require('./special-appointment-generator')
 const { users } = require('../../data/users')
 
 const NOT_SCREENED_REASONS = [
@@ -60,18 +61,19 @@ const determineEventStatus = (slotDateTime, currentDateTime, attendanceWeights)
   }
 }
 
-const generateEvent = ({ slot, participant, clinic, outcomeWeights, forceStatus = null, id = null }) => {
+const generateEvent = ({ slot, participant, clinic, outcomeWeights, forceStatus = null, id = null, specialAppointmentOverride = null }) => {
   // Parse dates once
   const [hours, minutes] = config.clinics.simulatedTime.split(':')
   const simulatedDateTime = dayjs().hour(parseInt(hours)).minute(parseInt(minutes))
   const slotDateTime = dayjs(slot.dateTime)
   const isPast = slotDateTime.isBefore(simulatedDateTime)
 
-  // Check if this is a special event (participant has extra needs)
-  const isSpecialAppointment = Boolean(participant.extraNeeds?.length)
+  // Generate special appointment requirements for this event
+  const specialAppointment = specialAppointmentOverride || generateSpecialAppointment()
+  const hasSpecialAppointment = Boolean(specialAppointment?.supportTypes?.length)
 
-  // Double the duration for participants with extra needs
-  const duration = isSpecialAppointment ? slot.duration * 2 : slot.duration
+  // Double the duration for special appointments
+  const duration = hasSpecialAppointment ? slot.duration * 2 : slot.duration
   const endDateTime = dayjs(slot.dateTime).add(duration, 'minute')
 
   const attendanceWeights = clinic.clinicType === 'assessment'
@@ -96,8 +98,6 @@ const generateEvent = ({ slot, participant, clinic, outcomeWeights, forceStatus
     details: {
       screeningType: 'mammogram',
       machineId: generateId(),
-      isSpecialAppointment,
-      extraNeeds: participant.extraNeeds,
     },
     statusHistory: [
       {
@@ -107,6 +107,11 @@ const generateEvent = ({ slot, participant, clinic, outcomeWeights, forceStatus
     ],
   }
 
+  // Add special appointment data if present
+  if (specialAppointment) {
+    eventBase.specialAppointment = specialAppointment
+  }
+
   if (!isPast) {
     return eventBase
   }
@@ -123,12 +128,17 @@ const generateEvent = ({ slot, participant, clinic, outcomeWeights, forceStatus
       },
     }
 
+    // Add special appointment data if present
+    if (specialAppointment) {
+      event.specialAppointment = specialAppointment
+    }
+
     // Add timing details for completed appointments
     if (isCompleted(eventStatus)) {
 
       // if (eventStatus === 'event_complete' || eventStatus === 'event_partially_screened') {
       const actualStartOffset = faker.number.int({ min: -5, max: 5 })
-      const durationOffset = isSpecialAppointment
+      const durationOffset = hasSpecialAppointment
         ? faker.number.int({ min: -3, max: 10 })
         : faker.number.int({ min: -3, max: 5 })
 
@@ -212,4 +222,4 @@ const generateStatusHistory = (finalStatus, dateTime) => {
 
 module.exports = {
   generateEvent,
-}
+}

app/lib/generators/participant-generator.js

@@ -62,7 +62,6 @@ const generateEthnicity = (ethnicities) => {
   }
 }
 
-
 // Pick a random risk level based on configured weights
 const pickRiskLevel = () => {
   // Create weights object from risk levels
@@ -76,40 +75,6 @@ const pickRiskLevel = () => {
   return weighted.select(weights)
 }
 
-// List of possible extra needs
-const EXTRA_NEEDS = [
-  'Agoraphobia',
-  // 'Breast implants', // needs consent journey that isn't designed yet
-  'Learning difficulties',
-  'Physical restriction',
-  'Registered disabled',
-  'Social reasons',
-  'Wheelchair user',
-  'Transgender',
-  // 'Other' // need to come up with some free text replies before using this
-]
-
-// Generate extra needs for a participant
-const generateExtraNeeds = (config = { probability: 0.08 }) => {
-  // Check if they should have extra needs
-  if (Math.random() > config.probability) {
-    return null
-  }
-
-  // Use weighted to determine how many needs they should have
-  const needCount = weighted.select({
-    1: 0.7, // 70% chance of 1 need
-    2: 0.2, // 20% chance of 2 needs
-    3: 0.1, // 10% chance of 3 needs
-  })
-
-  // Select that many random needs
-  return faker.helpers.arrayElements(EXTRA_NEEDS, {
-    min: needCount,
-    max: needCount,
-  })
-}
-
 // Generate a UK mobile phone number
 const generateUKMobileNumber = () => {
   const suffix = faker.number.int({ min: 900000, max: 900999 })
@@ -280,7 +245,6 @@ const generateNonCancerousProcedures = () => {
 const generateParticipant = ({
   ethnicities,
   breastScreeningUnits,
-  extraNeedsConfig = { probability: 0.08 },
   riskLevel = null,
   overrides = null,
 }) => {
@@ -306,7 +270,6 @@ const generateParticipant = ({
     id: id,
     sxNumber: generateSXNumber(faker.helpers.arrayElement(breastScreeningUnits).abbreviation),
     assignedBSU: assignedBSU.id,
-    extraNeeds: generateExtraNeeds(extraNeedsConfig),
     hasRiskFactors: participantRiskLevel !== 'routine',
     seedRiskLevel: participantRiskLevel,
     demographicInformation: {
@@ -456,4 +419,4 @@ const generateMedications = () => {
 
 module.exports = {
   generateParticipant,
-}
+}