Add the page to invite to clinic from the children list

Author: malross

app/controllers/patient.js

@@ -6,6 +6,7 @@ import {
   PatientStatus,
   ProgrammeType,
   SessionPresetName,
+  SessionStatus,
   SessionType,
   VaccinationOutcome
 } from '../enums.js'
@@ -19,6 +20,11 @@ import {
 } from '../models.js'
 import { today } from '../utils/date.js'
 import { getResults, getPagination } from '../utils/pagination.js'
+import {
+  ConjunctionType,
+  programmeNamesListForSentence
+} from '../utils/programme.js'
+import { queryToQueryString } from '../utils/querystring.js'
 import { formatYearGroup, stringToArray } from '../utils/string.js'
 
 export const patientController = {
@@ -122,12 +128,12 @@ export const patientController = {
     }
 
     // Filter by programme clinic status
+    let showingClinicReady = false
     if (filters.clinicStatus && filters.clinicStatus !== 'none') {
-      response.locals.showingClinicReady =
-        filters.clinicStatus === PatientClinicStatus.Ready
+      showingClinicReady = filters.clinicStatus === PatientClinicStatus.Ready
+      // Patient must have the selected clinic status for any of the selected programmes (if
+      // there's a selected programme), or for *any* programme if not
       if (programme_id) {
-        // Patient must have the selected clinic status for any of the selected programmes (if
-        // there's a selected programme), or for *any* programme if not
         results = results.filter((patient) =>
           programme_ids.some(
             (programme_id) =>
@@ -202,8 +208,13 @@ export const patientController = {
 
     // Results
     response.locals.patients = patients
+    response.locals.showingClinicReady = showingClinicReady
+    if (showingClinicReady) {
+      data.clinicPatient_ids = results.map(({ uuid }) => uuid)
+    }
     response.locals.results = getResults(results, request.query)
     response.locals.pages = getPagination(results, request.query)
+    response.locals.query = request.query
 
     // Programme filter options
     response.locals.programmeItems = programmes.map((programme) => ({
@@ -412,7 +423,7 @@ export const patientController = {
     response.render(`patient/programme`)
   },
 
-  inviteToClinic(request, response) {
+  inviteOneToClinic(request, response) {
     const { patient_uuid } = request.params
     const { data } = request.session
     const { __ } = response.locals
@@ -425,21 +436,16 @@ export const patientController = {
       clinicProgramme_ids = stringToArray(clinicProgramme_ids)
     }
 
-    // Update the record of programmes for which the patient's been invited to clinic
-    const patient = Patient.update(patient_uuid, { clinicProgramme_ids }, data)
-
     // Send comms to parents and record in audit trail
+    const patient = Patient.findOne(patient_uuid, data)
     patient.inviteToClinic(clinicProgramme_ids)
+    Patient.update(patient.uuid, patient, data)
 
     // Report the success
-    const formatter = new Intl.ListFormat('en', {
-      style: 'long',
-      type: 'conjunction'
-    })
-    const selectedProgrammeNames = formatter.format(
-      clinicProgramme_ids.map((programme_id) =>
-        Programme.findOne(programme_id, data)?.name?.replace('Flu', 'flu')
-      )
+    const selectedProgrammeNames = programmeNamesListForSentence(
+      clinicProgramme_ids,
+      ConjunctionType.and,
+      data
     )
     request.flash(
       'success',
@@ -452,6 +458,148 @@ export const patientController = {
     response.redirect(patient.uri)
   },
 
+  showInviteManyToClinic(request, response) {
+    const { __, __mf } = response.locals
+    const { data } = request.session
+    const { clinicPatient_ids } = data
+    const { programme_id } = request.query
+
+    const programmes = Programme.findAll(data)
+      .filter((programme) => !programme.hidden)
+      .sort((a, b) => a.name.localeCompare(b.name))
+
+    let programme_ids
+    if (programme_id) {
+      programme_ids = Array.isArray(programme_id)
+        ? programme_id
+        : [programme_id]
+    } else {
+      programme_ids = programmes.map(({ id }) => id)
+    }
+
+    // e.g. 271 children can be invited to clinic for HPV, MenACWY, or Td/IPV programmes.
+    const childrenFragment = __mf(
+      'patient.bulkInviteToClinic.childrenFragment',
+      { count: clinicPatient_ids.length }
+    )
+    const programmesFragment = programme_id
+      ? __mf('patient.bulkInviteToClinic.programmesFragment', {
+          count: programme_ids.length,
+          programmeNames: programmeNamesListForSentence(
+            programme_ids,
+            ConjunctionType.or,
+            data
+          )
+        })
+      : __('patient.bulkInviteToClinic.anyProgrammesFragment')
+    response.locals.cohortSummary = __(
+      'patient.bulkInviteToClinic.cohortSummary',
+      { children: childrenFragment, programmes: programmesFragment }
+    )
+
+    // Create the programme checkboxes and their patient and clinic counts
+    const checkboxItems = []
+    const scheduledSessions = Session.findAll(data)
+      .filter(({ type }) => type === SessionType.Clinic)
+      .filter(({ status }) => status === SessionStatus.Planned)
+    const invitableProgrammes = programmes.filter((programme) =>
+      programme_ids.includes(programme.id)
+    )
+    for (const programme of invitableProgrammes) {
+      const clinicReadyChildrenCount = clinicPatient_ids
+        .map((id) => Patient.findOne(id, data))
+        .filter(
+          (patient) =>
+            patient.programmes[programme.id].clinicStatus ===
+            PatientClinicStatus.Ready
+        ).length
+      if (clinicReadyChildrenCount > 0) {
+        const scheduledClinicCount = scheduledSessions.filter((session) =>
+          session.programme_ids.includes(programme.id)
+        ).length
+
+        const childrenHint = __mf(
+          'patient.bulkInviteToClinic.programme.hint.children',
+          {
+            count: clinicReadyChildrenCount,
+            programmeName: programme.name
+          }
+        )
+        const clinicsHint = __mf(
+          'patient.bulkInviteToClinic.programme.hint.clinics',
+          {
+            count: scheduledClinicCount,
+            programmeName: programme.name
+          }
+        )
+        checkboxItems.push({
+          text: programme.name,
+          value: programme.id,
+          hint: {
+            html: __('patient.bulkInviteToClinic.programme.hint.combined', {
+              childrenHint,
+              clinicsHint
+            })
+          }
+        })
+      }
+    }
+
+    response.locals.checkboxItems = checkboxItems
+
+    response.render('patient/bulk-invite-to-clinic')
+  },
+
+  inviteManyToClinic(request, response) {
+    let { clinicProgramme_ids } = request.body
+    const { __mf } = response.locals
+    const { data } = request.session
+    const { clinicPatient_ids } = data
+
+    // Tidy up any _unchecked values
+    if (typeof clinicProgramme_ids === 'string') {
+      clinicProgramme_ids = [clinicProgramme_ids]
+    } else {
+      clinicProgramme_ids = stringToArray(clinicProgramme_ids)
+    }
+
+    // Invite each of the children to clinic for the subset of the selected programmes
+    // that make sense for that child
+    let invitedChildrenCount = 0
+    for (const patient of clinicPatient_ids.map((id) =>
+      Patient.findOne(id, data)
+    )) {
+      // Work out which of the selected programmes this patient was clinic-ready for
+      const { clinicReadyProgramme_ids } = patient
+      const invitedProgramme_ids = [
+        ...new Set(clinicReadyProgramme_ids).intersection(
+          new Set(clinicProgramme_ids)
+        )
+      ]
+
+      if (invitedProgramme_ids.length) {
+        // Send comms to parents and record in audit trail
+        patient.inviteToClinic(invitedProgramme_ids)
+        Patient.update(patient.uuid, patient, data)
+
+        invitedChildrenCount++
+      }
+    }
+
+    request.flash(
+      'success',
+      __mf('patient.bulkInviteToClinic.success', {
+        count: invitedChildrenCount
+      })
+    )
+
+    // Reset the cohort
+    delete data.clinicPatient_ids
+
+    // Get back to the filter page as we left it
+    response.redirect(`/patients${queryToQueryString(request.query)}`)
+  },
+
   archive(request, response) {
     const { account } = request.app.locals
     const { patient_uuid } = request.params

app/controllers/school.js

@@ -485,7 +485,9 @@ export const schoolController = {
       (item) => item !== '_unchecked'
     )
     for (const patient_uuid of patient_uuids) {
-      Patient.update(patient_uuid, { clinicProgramme_ids }, data)
+      const patient = Patient.findOne(patient_uuid, data)
+      patient.inviteToClinic(clinicProgramme_ids)
+      Patient.update(patient_uuid, patient, data)
     }
 
     request.flash(

app/controllers/session.js

@@ -845,11 +845,9 @@ export const sessionController = {
           clinicPatientSession = new PatientSession(clinicPatientSession, data)
           patientSession.patient.addToSession(clinicPatientSession)
 
-          Patient.update(
-            patientSession.patient_uuid,
-            { clinicProgramme_ids: clinic.programme_ids },
-            data
-          )
+          const patient = Patient.findOne(patientSession.patient_uuid, data)
+          patient.inviteToClinic(clinic.programme_ids)
+          Patient.update(patient.uuid, patient, data)
         }
       }
     }

app/filters.js

@@ -2,6 +2,7 @@ import prototypeFilters from '@x-govuk/govuk-prototype-filters'
 import _ from 'lodash'
 
 import { ordinal } from './utils/number.js'
+import { queryToQueryString } from './utils/querystring.js'
 import {
   formatHighlight,
   formatList,
@@ -183,5 +184,15 @@ export default (env) => {
     return array.filter((item) => item !== '')
   }
 
+  /**
+   * Rebuild the querystring from the request.query object
+   *
+   * @param {object} query - the request.query object
+   * @returns {string} - the rebuilt query string
+   */
+  filters.asQueryString = function (query) {
+    return queryToQueryString(query)
+  }
+
   return filters
 }

app/locales/en.js

@@ -1358,6 +1358,31 @@ export const en = {
       success:
         '{{patientName}} has been invited to attend a clinic for {{selectedProgrammes}} vaccination'
     },
+    bulkInviteToClinic: {
+      title: 'Invite parents to book a clinic appointment',
+      caption:
+        '{count, plural, one {1 child selected} other {{count} children selected}}',
+      childrenFragment:
+        '{count, plural, =0 {No children} one {1 child} other {{count} children}}',
+      programmesFragment:
+        '{count, plural, one {the {programmeNames} programme} other {the {programmeNames} programmes}}',
+      anyProgrammesFragment: 'at least one programme',
+      cohortSummary:
+        '{{children}} can be invited to clinic for {{programmes}}.',
+      programme: {
+        label: 'Which programmes do you want to send invitations for?',
+        hint: {
+          children:
+            '{count, plural, one {1 child can be invited for {programmeName}} other {{count} children can be invited for {programmeName}}}',
+          clinics:
+            '{count, plural, =0 {No clinics are scheduled for {programmeName}} one {1 clinic is scheduled for {programmeName}} other {{count} clinics are scheduled for {programmeName}}}',
+          combined: '{{childrenHint}}<br>{{clinicsHint}}'
+        }
+      },
+      confirm: 'Send clinic invitations',
+      success:
+        '{count, plural, one {1 child has been invited to clinic} other {{count} children have been invited to clinic}}'
+    },
     auditEvents: {
       label: 'Activity log'
     },

app/models/patient.js

@@ -10,6 +10,7 @@ import {
   Impairment,
   NoticeType,
   NotifyEmailStatus,
+  PatientClinicStatus,
   VaccinationOutcome
 } from '../enums.js'
 import {
@@ -349,6 +350,17 @@ export class Patient extends Child {
     return programmes
   }
 
+  /**
+   * Get the IDs of programmes for which this patient can be invited to clinic
+   *
+   * @returns {Array<string>} the IDs of programmes for which this patient is clinic-ready
+   */
+  get clinicReadyProgramme_ids() {
+    return Object.values(this.programmes)
+      .filter(({ clinicStatus }) => clinicStatus === PatientClinicStatus.Ready)
+      .map(({ programme_id }) => programme_id)
+  }
+
   /**
    * Get replies
    *
@@ -668,6 +680,10 @@ export class Patient extends Child {
    * @param {Array<string>} programme_ids - The programmes for which the child's invited
    */
   inviteToClinic(programme_ids) {
+    this.clinicProgramme_ids = [
+      ...new Set(this.clinicProgramme_ids.concat(programme_ids))
+    ]
+
     for (const parent of this.parents) {
       this.addEvent({
         name: activity.notify['invite-clinic'](parent),

app/routes/patient.js

@@ -7,6 +7,9 @@ const router = express.Router({ strict: true, mergeParams: true })
 router.get('/', patient.readAll, patient.list)
 router.post('/', patient.filterList)
 
+router.get('/invite-to-clinic', patient.readAll, patient.showInviteManyToClinic)
+router.post('/invite-to-clinic', patient.inviteManyToClinic)
+
 router.param('patient_uuid', patient.read)
 
 router.get('/:patient_uuid/edit', patient.edit)
@@ -19,7 +22,7 @@ router.post('/:patient_uuid/edit/:view', patient.updateForm)
 router.post('/:patient_uuid/new/note', patient.note)
 
 router.post('/:patient_uuid/archive', patient.archive)
-router.post('/:patient_uuid/invite-to-clinic', patient.inviteToClinic)
+router.post('/:patient_uuid/invite-to-clinic', patient.inviteOneToClinic)
 
 router.all('/:patient_uuid/programmes{/:programme_id}', patient.readProgramme)
 router.get('/:patient_uuid/programmes{/:programme_id}', patient.showProgramme)