Allow HCAs to administer nasal flu using PSD

This adds support for healthcare assistants to administer the nasal
flu vaccine under PSD, requiring the session to have the PSD enabled.

Note: when PSD is enabled, the HCA is not required to provide the
supplier of the vaccine for nasal flu.

Author: jhenderson

app/forms/vaccinate_form.rb

@@ -74,8 +74,15 @@ def delivery_site
   end
 
   def protocol
-    if current_user.is_nurse? || vaccine_method == "nasal"
+    if current_user.is_nurse? && !session.national_protocol_enabled? &&
+         !session.psd_enabled?
       "pgd"
+    elsif current_user.is_healthcare_assistant? && !session.psd_enabled? &&
+          vaccine_method == "nasal"
+      "pgd"
+    elsif current_user.is_healthcare_assistant? && session.psd_enabled? &&
+          vaccine_method == "nasal"
+      "psd"
     else
       "national"
     end
@@ -85,7 +92,21 @@ def supplied_by_users
     current_user.selected_team.users.show_in_suppliers
   end
 
-  def requires_supplied_by_user_id? = !current_user.show_in_suppliers
+  def requires_supplied_by_user_id?
+    if session.psd_enabled? && current_user.is_healthcare_assistant?
+      return false
+    end
+
+    user_not_designated_as_supplier?
+  end
+
+  def operating_under_national_protocol?
+    session.national_protocol_enabled? && !session.psd_enabled?
+  end
+
+  def user_not_designated_as_supplier?
+    !current_user.show_in_suppliers
+  end
 
   def save(draft_vaccination_record:)
     return nil if invalid?

app/models/draft_vaccination_record.rb

@@ -28,7 +28,6 @@ class DraftVaccinationRecord
   attribute :protocol, :string
   attribute :performed_ods_code, :string
   attribute :programme_id, :integer
-  attribute :protocol, :string
   attribute :session_id, :integer
   attribute :supplied_by_user_id, :integer
 

spec/features/flu_vaccination_hca_psd_spec.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
-describe "Patient Specific Directions" do
+describe "Flu vaccination" do
   before { given_delegation_feature_flag_is_enabled }
 
-  scenario "Prescriber can bulk add PSDs to patients that don't require triage" do
+  scenario "Prescriber bulk add PSDs to patients that don't require triage" do
     given_a_flu_session_exists(user_type: :with_one_nurse)
     and_patients_exist
     and_i_am_signed_in(role: :prescriber)
@@ -58,6 +58,17 @@
     then_i_should_not_see_the_record_vaccination_section
   end
 
+  scenario "Nasal flu administered by HCA under PSD" do
+    given_a_flu_session_exists(user_type: :with_one_healthcare_assistant)
+    and_patients_exist
+    and_the_nasal_only_patient_has_a_psd
+    and_i_am_signed_in(role: :healthcare_assistant)
+
+    when_i_visit_the_session_patient_programme_page
+    and_i_record_that_the_patient_has_been_vaccinated_with_nasal_spray
+    and_the_vaccination_record_has_psd_as_the_protocol
+  end
+
   def given_delegation_feature_flag_is_enabled
     Flipper.enable(:delegation)
   end
@@ -68,9 +79,22 @@ def given_a_flu_session_exists(user_type:)
     @team = create(:team, user_type, programmes: @programmes)
 
     @batch =
-      create(:batch, team: @team, vaccine: @programmes.first.vaccines.first)
+      create(
+        :batch,
+        :not_expired,
+        team: @team,
+        vaccine: @programme.vaccines.nasal.first
+      )
 
-    @session = create(:session, team: @team, programmes: @programmes)
+    @session =
+      create(
+        :session,
+        :today,
+        :requires_no_registration,
+        :psd_enabled,
+        team: @team,
+        programmes: @programmes
+      )
   end
 
   def and_patients_exist
@@ -88,6 +112,14 @@ def and_patients_exist
       )
   end
 
+  def and_the_nasal_only_patient_has_a_psd
+    create(
+      :patient_specific_direction,
+      patient: @patient_nasal_only,
+      programme: @programme
+    )
+  end
+
   def and_i_am_signed_in(role:)
     sign_in @team.users.first, role:
   end
@@ -164,4 +196,25 @@ def then_i_should_not_see_the_patient
   def then_i_should_not_see_the_record_vaccination_section
     expect(page).not_to have_text("Record flu vaccination with injection")
   end
+
+  def and_i_record_that_the_patient_has_been_vaccinated_with_nasal_spray
+    within all("section")[0] do
+      check "I have checked that the above statements are true"
+    end
+
+    within all("section")[1] do
+      choose "Yes"
+      click_button "Continue"
+    end
+
+    choose @batch.name
+    click_button "Continue"
+    click_on "Confirm"
+
+    expect(page).to have_text("Vaccination outcome recorded for flu")
+  end
+
+  def and_the_vaccination_record_has_psd_as_the_protocol
+    expect(@patient_nasal_only.vaccination_records.first.protocol).to eq("psd")
+  end
 end

spec/forms/vaccinate_form_spec.rb

@@ -1,10 +1,20 @@
 # frozen_string_literal: true
 
 describe VaccinateForm do
-  subject(:form) { described_class.new(programme:, current_user:) }
+  subject(:form) do
+    described_class.new(programme:, current_user:, session_date:)
+  end
+
+  let(:programme) { build(:programme) }
+  let(:current_user) do
+    build(:user, show_in_suppliers: user_designated_as_supplier)
+  end
+  let(:session) { build(:session, psd_enabled:, national_protocol_enabled:) }
+  let(:session_date) { session.session_dates.first }
 
-  let(:programme) { create(:programme) }
-  let(:current_user) { create(:user) }
+  let(:psd_enabled) { false }
+  let(:national_protocol_enabled) { false }
+  let(:user_designated_as_supplier) { true }
 
   describe "validations" do
     it do
@@ -30,7 +40,8 @@
         described_class.new(
           identity_check_confirmed_by_patient: false,
           programme:,
-          current_user:
+          current_user:,
+          session_date:
         )
       end
 
@@ -49,4 +60,38 @@
 
     it { should validate_length_of(:pre_screening_notes).is_at_most(1000) }
   end
+
+  describe "#requires_supplied_by_user_id?" do
+    subject(:requires_supplied_by_user_id?) do
+      form.requires_supplied_by_user_id?
+    end
+
+    context "when operating under national protocol" do
+      let(:psd_enabled) { false }
+      let(:national_protocol_enabled) { true }
+      let(:user_designated_as_supplier) { false }
+
+      it "requires supplier ID" do
+        expect(requires_supplied_by_user_id?).to be(true)
+      end
+    end
+
+    context "when user is designated as a supplier" do
+      let(:psd_enabled) { false }
+      let(:user_designated_as_supplier) { true }
+
+      it "does not require supplier ID" do
+        expect(requires_supplied_by_user_id?).to be(false)
+      end
+    end
+
+    context "when PSD is enabled and user is designated as a supplier" do
+      let(:psd_enabled) { true }
+      let(:user_designated_as_supplier) { true }
+
+      it "does not require supplier ID" do
+        expect(requires_supplied_by_user_id?).to be(false)
+      end
+    end
+  end
 end