Add AppPatientSessionProgrammeComponent

Shows the programme status (heading with colour, contextual detail text, vaccination outcomes table, and action link) for a patient on the session patient show page. This card  links to the respective programme tab in the child’s record. Eventually this will be the only card on the page with a coloured heading so various statuses (consent, triage, etc) do not compete for attention and the programme status for the child is reflected right at the top.

MAV-4846

Author: murugapl

app/components/app_patient_session_programme_component.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+class AppPatientSessionProgrammeComponent < ViewComponent::Base
+  erb_template <<-ERB
+    <%= render AppCardComponent.new(feature: true) do |card| %>
+      <% card.with_heading(level: 4, colour:) { heading } %>
+      <% if details.present? %>
+        <p><%= details %></p>
+      <% end %>
+      <% if programme_status.vaccinated? || programme_status.cannot_vaccinate? %>
+        <%= render AppPatientVaccinationTableComponent.new(
+              patient,
+              programme:,
+              academic_year:,
+              show_caption: true,
+              show_details: false
+            ) %>
+      <% end %>
+      <%= render AppActionLinkComponent.new(
+            text: action_link_text,
+            href: patient_programme_path(patient, programme.type)
+          ) %>
+    <% end %>
+  ERB
+
+  def initialize(patient:, session:, programme:)
+    @patient = patient
+    @session = session
+    @programme = programme
+  end
+
+  private
+
+  attr_reader :patient, :session, :programme
+
+  delegate :academic_year, to: :session
+
+  def heading
+    "#{resolver[:prefix]}: #{resolver[:text]}"
+  end
+
+  def colour
+    resolver[:colour]
+  end
+
+  def details
+    if programme_status.due?
+      criteria_label =
+        I18n.t(
+          programme_status.vaccine_criteria.to_param,
+          scope: :vaccine_criteria
+        )
+      if criteria_label.present?
+        "#{patient.given_name} is ready to vaccinate (#{criteria_label.downcase})."
+      else
+        "#{patient.given_name} is ready to vaccinate."
+      end
+    elsif programme_status.vaccinated?
+      record =
+        patient
+          .vaccination_records
+          .for_programme(programme)
+          .order_by_performed_at
+          .first
+      nurse = [
+        record&.performed_by_given_name,
+        record&.performed_by_family_name
+      ].compact_blank.join(" ")
+      if nurse.present?
+        "#{patient.given_name} was vaccinated by #{nurse} on #{record&.performed_at&.to_fs(:long)}."
+      else
+        "#{patient.given_name} was vaccinated on #{record&.performed_at&.to_fs(:long)}."
+      end
+    elsif programme_status.needs_triage?
+      "You need to decide if it’s safe to vaccinate."
+    else
+      resolver[:details_text]
+    end
+  end
+
+  def programme_status
+    @programme_status ||= patient.programme_status(programme, academic_year:)
+  end
+
+  def action_link_text
+    "View child’s #{programme.name} record"
+  end
+
+  def resolver
+    @resolver ||=
+      PatientProgrammeStatusResolver.call(
+        patient,
+        programme_type: programme.type,
+        academic_year:
+      )
+  end
+end

app/components/app_patient_session_vaccination_component.rb

@@ -154,6 +154,10 @@ def has_refusal? = status.in?(HAS_REFUSAL_STATUSES.keys)
 
   def cannot_vaccinate? = status.in?(CANNOT_VACCINATE_STATUSES.keys)
 
+  def needs_triage? = status.in?(NEEDS_TRIAGE_STATUSES.keys)
+
+  def due? = status.in?(DUE_STATUSES.keys)
+
   def vaccinated? = status.in?(VACCINATED_STATUSES.keys)
 
   def group = GROUPS.find { status.starts_with?(it) }

app/models/patient/programme_status.rb

@@ -6,12 +6,12 @@
   </div>
 
   <div class="app-grid-column-patient-session">
+    <%= render AppPatientSessionProgrammeComponent.new(patient: @patient, session: @session, programme: @programme) %>
+
     <%= render AppPatientSessionConsentComponent.new(patient: @patient, session: @session, programme: @programme) %>
 
     <%= render AppPatientSessionTriageComponent.new(patient: @patient, session: @session, programme: @programme, current_user:, triage_form: @triage_form) %>
 
     <%= render AppPatientSessionRecordComponent.new(patient: @patient, session: @session, programme: @programme, current_user:, vaccinate_form: @vaccinate_form) %>
-
-    <%= render AppPatientSessionVaccinationComponent.new(patient: @patient, session: @session, programme: @programme) %>
   </div>
 </div>

app/views/patient_sessions/programmes/show.html.erb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+describe AppPatientSessionProgrammeComponent do
+  subject(:rendered) { render_inline(component) }
+
+  let(:component) { described_class.new(patient:, session:, programme:) }
+
+  let(:programme) { Programme.flu }
+  let(:session) { create(:session, programmes: [programme]) }
+  let(:patient) { create(:patient, session:) }
+
+  it { should have_css("a.nhsuk-action-link", text: "View child’s Flu record") }
+
+  context "when due (nasal)" do
+    before do
+      create(:patient_programme_status, :due_nasal, patient:, programme:)
+    end
+
+    it { should have_css("h4", text: "Flu:") }
+    it { should_not have_css("table") }
+
+    it "shows ready to vaccinate details" do
+      expect(rendered).to have_text(
+        "#{patient.given_name} is ready to vaccinate (nasal spray only)."
+      )
+    end
+  end
+
+  context "when due (injection)" do
+    before do
+      create(:patient_programme_status, :due_injection, patient:, programme:)
+    end
+
+    it "shows ready to vaccinate details without criteria label for flu injection" do
+      expect(rendered).to have_text(
+        "#{patient.given_name} is ready to vaccinate"
+      )
+    end
+  end
+
+  context "when vaccinated" do
+    before do
+      create(:patient_programme_status, :vaccinated_fully, patient:, programme:)
+    end
+
+    context "with a known nurse" do
+      let!(:vaccination_record) do
+        create(
+          :vaccination_record,
+          :performed_by_not_user,
+          patient:,
+          programme:,
+          session:
+        )
+      end
+
+      it { should have_css("table") }
+
+      it "shows vaccinated by nurse details" do
+        nurse = [
+          vaccination_record.performed_by_given_name,
+          vaccination_record.performed_by_family_name
+        ].join(" ")
+
+        expect(rendered).to have_text(
+          "#{patient.given_name} was vaccinated by #{nurse} on"
+        )
+      end
+    end
+
+    context "without a known nurse" do
+      before do
+        create(
+          :vaccination_record,
+          patient:,
+          programme:,
+          session:,
+          performed_by_given_name: nil,
+          performed_by_family_name: nil
+        )
+        PatientStatusUpdater.call(patient:)
+      end
+
+      it { should have_css("table") }
+
+      it "shows vaccinated without nurse details" do
+        expect(rendered).to have_text("#{patient.given_name} was vaccinated on")
+        expect(rendered).not_to have_text("vaccinated by")
+      end
+    end
+  end
+
+  context "when the child could not be vaccinated" do
+    before do
+      create(
+        :vaccination_record,
+        :not_administered,
+        patient:,
+        programme:,
+        session:
+      )
+      PatientStatusUpdater.call(patient:)
+    end
+
+    it { should have_css("table") }
+
+    it "shows child unwell details" do
+      expect(rendered).to have_text("Child unwell on")
+    end
+  end
+
+  context "when needs triage" do
+    before do
+      create(:patient_programme_status, :needs_triage, patient:, programme:)
+    end
+
+    it { should have_css("h4", text: "Flu:") }
+    it { should_not have_css("table") }
+
+    it "shows safe to vaccinate decision details" do
+      expect(rendered).to have_text(
+        "You need to decide if it’s safe to vaccinate."
+      )
+    end
+  end
+end

spec/components/app_patient_session_programme_component_spec.rb

@@ -35,7 +35,8 @@
     then_i_see_the_successful_import
     when_i_navigate_to_the_clinic_page
     then_i_see_the_uploaded_vaccination_outcomes_reflected_in_the_session
-    and_the_clinic_location_is_displayed
+    when_i_click_on_the_vaccination
+    then_the_clinic_location_is_displayed
 
     when_vaccination_confirmations_are_sent
     then_an_email_is_sent_to_the_parent_confirming_the_vaccination
@@ -577,7 +578,15 @@ def then_i_see_the_uploaded_vaccination_outcomes_reflected_in_the_session
     expect(page).to have_content("Vaccinated")
   end
 
-  def and_the_clinic_location_is_displayed
+  def when_i_click_on_the_vaccination
+    click_on VaccinationRecord
+               .where(patient: @restricted_vaccinated_patient)
+               .sole
+               .performed_at
+               .to_fs(:long)
+  end
+
+  def then_the_clinic_location_is_displayed
     expect(page).to have_content("Westfield Shopping Centre")
   end