Prescribers can create PSD instructions in bulk

This PR implements a new feature that allows prescribers (nurses,
pharmacists) to bulk create Patient Specific Directions (PSDs) for
patients who have given consent and don't require individual triage
assessment. This significantly reduces manual work by enabling batch
processing of PSDs instead of creating them one by one.

What's changed?
- New (basic) controller and page for the PSDs tab (no filters yet)
  - PSDs tab only appears if delegation feature is enabled
- New controller to manage the bulk add PSDs

Author: jhenderson

app/assets/stylesheets/components/_action-list.scss

@@ -33,3 +33,59 @@
   margin-right: 0;
   padding-right: 0;
 }
+
+.nhsuk-action-link {
+  @include nhsuk-responsive-margin(6, "bottom");
+}
+
+.nhsuk-action-link__link {
+  display: inline-block; // [1]
+  padding-left: 38px; // [2]
+  position: relative; // [3]
+  text-decoration: none; // [4]
+
+  @include nhsuk-font(22, $weight: bold);
+
+  &:not(:focus):hover {
+    .nhsuk-action-link__text {
+      text-decoration: underline; // [6]
+    }
+  }
+
+  @include nhsuk-media-query($until: tablet) {
+    padding-left: 26px; // [2]
+  }
+
+  @include nhsuk-media-query($media-type: print) {
+    color: $nhsuk-print-text-color;
+
+    &:visited {
+      color: $nhsuk-print-text-color;
+    }
+  }
+
+  .nhsuk-icon__arrow-right-circle {
+    // stylelint-disable-next-line declaration-no-important
+    fill: $color_nhsuk-green !important;
+    height: 36px;
+    left: -3px;
+    position: absolute;
+    top: -3px;
+    width: 36px;
+
+    @include nhsuk-print-color($nhsuk-print-text-color);
+
+    @include nhsuk-media-query($until: tablet) {
+      height: 24px;
+      left: -2px;
+      margin-bottom: 0;
+      top: 1px;
+      width: 24px;
+    }
+  }
+
+  &:focus .nhsuk-icon__arrow-right-circle {
+    // stylelint-disable-next-line declaration-no-important
+    fill: $color_nhsuk-black !important;
+  }
+}

app/components/app_patient_session_psd_search_result_card_component.rb

@@ -0,0 +1,69 @@
+# frozen_string_literal: true
+
+class AppPatientSessionPsdSearchResultCardComponent < ViewComponent::Base
+  erb_template <<-ERB
+    <%= render AppCardComponent.new(heading_level: 4, compact: true) do |card| %>
+      <% card.with_heading { link_to(patient.full_name_with_known_as, patient_path) } %>
+
+      <%= govuk_summary_list do |summary_list|
+        summary_list.with_row do |row|
+          row.with_key { "Date of birth" }
+          row.with_value { helpers.patient_date_of_birth(patient) }
+        end
+  
+        summary_list.with_row do |row|
+          row.with_key { "Year group" }
+          row.with_value { helpers.patient_year_group(patient, academic_year:) }
+        end
+        
+        summary_list.with_row do |row|
+          row.with_key { "PSD status" }
+          row.with_value { psd_status_tag }
+        end
+      end %>
+    <% end %>
+  ERB
+
+  def initialize(patient_session)
+    super
+
+    @patient_session = patient_session
+    @patient = patient_session.patient
+    @session = patient_session.session
+    @programmes = patient_session.programmes
+  end
+
+  private
+
+  attr_reader :patient_session, :patient, :session, :programmes
+
+  delegate :academic_year, to: :session
+
+  def patient_path
+    session_patient_programme_path(
+      session,
+      patient,
+      programmes.first,
+      return_to: :patient_specific_directions
+    )
+  end
+
+  def psd_status_tag
+    status = psd_status_for_programme(programmes.first)
+    text = t(status, scope: %i[status psd label])
+    colour = t(status, scope: %i[status psd colour])
+
+    tag.strong(text, class: ["nhsuk-tag nhsuk-tag--#{colour}"])
+  end
+
+  def psd_status_for_programme(programme)
+    if patient
+         .patient_specific_directions
+         .where(programme:, academic_year:)
+         .exists?
+      :added
+    else
+      :not_added
+    end
+  end
+end

app/components/app_search_results_component.rb

@@ -2,7 +2,7 @@
 
 class AppSearchResultsComponent < ViewComponent::Base
   erb_template <<-ERB
-    <h3 class="nhsuk-heading-m nhsuk-u-margin-bottom-2">Search results</h3>
+    <h3 class="nhsuk-heading-m nhsuk-u-margin-bottom-2"><%= heading %></h3>
 
     <p class="nhsuk-caption-m nhsuk-u-margin-bottom-4">
       <% if has_results? %>
@@ -19,16 +19,17 @@ class AppSearchResultsComponent < ViewComponent::Base
     <% end %>
   ERB
 
-  def initialize(pagy, label:)
+  def initialize(pagy, label:, heading: "Search results")
     super
 
     @pagy = pagy
     @label = label
+    @heading = heading
   end
 
   private
 
-  attr_reader :pagy, :label
+  attr_reader :pagy, :label, :heading
 
   def has_results? = pagy.count.positive?
 end

app/controllers/concerns/patient_specific_direction_concern.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module PatientSpecificDirectionConcern
+  extend ActiveSupport::Concern
+
+  def patient_sessions_allowed_psd
+    @patient_sessions_allowed_psd ||=
+      @session
+        .patient_sessions
+        .has_consent_status(:given, programme:)
+        .without_patient_specific_direction(programme:)
+  end
+end

app/controllers/sessions/bulk_patient_specific_directions_controller.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+class Sessions::BulkPatientSpecificDirectionsController < ApplicationController
+  include PatientSpecificDirectionConcern
+
+  before_action :set_session
+
+  def show
+    @eligible_for_bulk_psd_count = patient_sessions_allowed_psd.count
+  end
+
+  def create
+    ActiveRecord::Base.transaction do
+      PatientSpecificDirection.import!(
+        psds_to_create,
+        on_duplicate_key_ignore: true
+      )
+    end
+
+    redirect_to session_patient_specific_directions_path(@session),
+                flash: {
+                  success: "PSDs added"
+                }
+  end
+
+  private
+
+  def set_session
+    @session = policy_scope(Session).find_by!(slug: params[:session_slug])
+  end
+
+  def psds_to_create
+    patient_sessions_allowed_psd.map do |patient_session|
+      PatientSpecificDirection.new(
+        academic_year: @session.academic_year,
+        patient_id: patient_session.patient_id,
+        programme_id: programme.id,
+        vaccine_id: programme.vaccines.first.id,
+        created_by_user_id: current_user.id,
+        vaccine_method: :nasal,
+        delivery_site: :nose,
+        full_dose: true
+      )
+    end
+  end
+
+  def programme
+    @session.programmes.includes(:vaccines).first
+  end
+end

app/controllers/sessions/patient_specific_directions_controller.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+class Sessions::PatientSpecificDirectionsController < ApplicationController
+  include PatientSearchFormConcern
+  include PatientSpecificDirectionConcern
+
+  before_action :set_session
+  before_action :set_patient_search_form
+
+  layout "full"
+
+  def show
+    scope = @session.patient_sessions.includes_programmes.includes(:latest_note)
+    @eligible_for_bulk_psd_count = patient_sessions_allowed_psd.count
+    patient_sessions = @form.apply(scope)
+    @pagy, @patient_sessions = pagy(patient_sessions)
+  end
+
+  private
+
+  def set_session
+    @session = policy_scope(Session).find_by!(slug: params[:session_slug])
+  end
+
+  def programme
+    @session.programmes.first
+  end
+end

app/models/patient_session.rb

@@ -254,6 +254,18 @@ class PatientSession < ApplicationRecord
           end
         end
 
+  scope :without_patient_specific_direction,
+        ->(programme:) do
+          joins(:session).where.not(
+            PatientSpecificDirection
+              .where("patient_id = patient_sessions.patient_id")
+              .where("academic_year = sessions.academic_year")
+              .where(programme:)
+              .arel
+              .exists
+          )
+        end
+
   scope :destroy_all_if_safe,
         -> do
           includes(

app/views/sessions/_header.html.erb

@@ -24,6 +24,14 @@
         selected: request.path == session_consent_path(@session),
       )
 
+      if Flipper.enabled?(:delegation) && @session.programmes.first.flu?
+        nav.with_item(
+          href: session_patient_specific_directions_path(@session),
+          text: t("sessions.tabs.patient_specific_directions"),
+          selected: request.path == session_patient_specific_directions_path(@session),
+        )
+      end
+    
       nav.with_item(
         href: session_triage_path(@session),
         text: t("sessions.tabs.triage"),

app/views/sessions/bulk_patient_specific_directions/show.html.erb

@@ -0,0 +1,22 @@
+<% content_for :before_main do %>
+  <%= render AppBreadcrumbComponent.new(items: [
+                                          { text: t("dashboard.index.title"), href: dashboard_path },
+                                          { text: t("sessions.index.title"), href: sessions_path },
+                                          { text: @session.location.name, href: session_path(@session) },
+                                        ]) %>
+<% end %>
+
+<%= h1 "Are you sure you want to add #{@eligible_for_bulk_psd_count} new PSDs?" %>
+
+<div class="nhsuk-grid-row">
+  <div class="nhsuk-grid-column-two-thirds">
+    <p class="nhsuk-body">This cannot be undone.</p>
+    <div class="app-button-group">
+      <%= govuk_button_to "Yes, add PSDs", session_bulk_patient_specific_directions_path(@session) %>
+      <%= govuk_link_to "No, return to session",
+                        session_bulk_patient_specific_directions_path(@session),
+                        method: :post,
+                        prevent_double_click: true %>
+    </div>
+  </div>
+</div>

app/views/sessions/patient_specific_directions/show.html.erb

@@ -0,0 +1,39 @@
+<% content_for :before_main do %>
+  <%= render AppBreadcrumbComponent.new(items: [
+                                          { text: t("dashboard.index.title"), href: dashboard_path },
+                                          { text: t("sessions.index.title"), href: sessions_path },
+                                          { text: @session.location.name, href: session_path(@session) },
+                                        ]) %>
+<% end %>
+
+<%= render "sessions/header" %>
+
+<%= govuk_inset_text do %>
+  <span class="nhsuk-u-visually-hidden">Information: </span>
+  <p class="nhsuk-body">
+    There are <%= @eligible_for_bulk_psd_count %> children with consent for the nasal flu vaccine
+    who do not require triage and do not yet have a PSD in place.
+  </p>
+  <div class="nhsuk-action-link">
+    <%= link_to session_bulk_patient_specific_directions_path(@session), class: "nhsuk-action-link__link" do %>
+      <svg class="nhsuk-icon nhsuk-icon__arrow-right-circle" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" aria-hidden="true" width="36" height="36">
+        <path d="M0 0h24v24H0z" fill="none"></path>
+        <path d="M12 2a10 10 0 0 0-9.95 9h11.64L9.74 7.05a1 1 0 0 1 1.41-1.41l5.66 5.65a1 1 0 0 1 0 1.42l-5.66 5.65a1 1 0 0 1-1.41 0 1 1 0 0 1 0-1.41L13.69 13H2.05A10 10 0 1 0 12 2z"></path>
+      </svg>
+      <span class="nhsuk-action-link__text">Add new PSDs</span>
+    <% end %>
+  </div>
+<% end %>
+
+<div class="nhsuk-grid-row">
+  <div class="app-grid-column-filters"></div>
+
+  <div class="app-grid-column-results">
+    <%= render AppSessionNeedsReviewWarningComponent.new(session: @session) %>
+    <%= render AppSearchResultsComponent.new(@pagy, label: "children", heading: "Review PSDs") do %>
+      <% @patient_sessions.each do |patient_session| %>
+        <%= render AppPatientSessionPsdSearchResultCardComponent.new(patient_session) %>
+      <% end %>
+    <% end %>
+  </div>
+</div>