Add ability to send clinic invitations in bulk

This adds a new page when viewing unknown or home-schooled patients,
allowing users to send clinic invitations to any of those patients who
have not yet received one.

Jira-Issue: MAV-3886
Jira-Issue: MAV-3428

Author: thomasleese

app/controllers/schools/invite_to_clinic_controller.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+class Schools::InviteToClinicController < Schools::BaseController
+  before_action :check_can_send_clinic_invitations
+  before_action :set_back_link_path
+  before_action :set_programme_statuses
+  before_action :set_eligible_patients_not_vaccinated
+  before_action :set_invitations_count_by_programme_type
+
+  layout "two_thirds"
+
+  def edit
+    @form = SchoolInviteToClinicForm.new
+  end
+
+  def update
+    @form =
+      SchoolInviteToClinicForm.new(
+        programme_types:
+          params.dig(:school_invite_to_clinic_form, :programme_types)
+      )
+
+    if @form.valid?
+      clinic_notifcations =
+        @eligible_patients_not_vaccinated.filter_map do |patient|
+          patient.notifier.send_clinic_invitation(
+            Programme.find_all(@form.programme_types),
+            team: current_team,
+            academic_year: @academic_year,
+            sent_by: current_user,
+            include_already_invited_programmes: false
+          )
+        end
+
+      flash[
+        :success
+      ] = "#{I18n.t("children", count: clinic_notifcations.count)} invited to the clinic"
+
+      redirect_to @back_link_path
+    else
+      render :edit, status: :unprocessable_entity
+    end
+  end
+
+  private
+
+  def check_can_send_clinic_invitations
+    render status: :not_found unless @location.generic_clinic?
+  end
+
+  def set_back_link_path
+    @back_link_path = school_patients_path(Location::URN_UNKNOWN)
+  end
+
+  def set_programme_statuses
+    @programme_statuses =
+      Patient::ProgrammeStatus.statuses.keys -
+        Patient::ProgrammeStatus::NOT_ELIGIBLE_STATUSES.keys -
+        Patient::ProgrammeStatus::HAS_REFUSAL_STATUSES.keys -
+        Patient::ProgrammeStatus::VACCINATED_STATUSES.keys
+  end
+
+  def set_eligible_patients_not_vaccinated
+    @eligible_patients_not_vaccinated =
+      Patient
+        .joins(:patient_locations)
+        .where(
+          patient_locations: {
+            location: @location,
+            academic_year: @academic_year
+          }
+        )
+        .where(school_id: @location.school_id)
+        .includes_statuses
+        .has_programme_status(
+          @programme_statuses,
+          programme: current_team.programmes,
+          academic_year: @academic_year
+        )
+  end
+
+  def set_invitations_count_by_programme_type
+    @invitations_count_by_programme_type =
+      current_team.programmes.index_with do |programme|
+        @eligible_patients_not_vaccinated
+          .includes(:clinic_notifications)
+          .has_programme_status(
+            @programme_statuses,
+            programme:,
+            academic_year: @academic_year
+          )
+          .count do |patient|
+            !patient.invited_to_clinic?(
+              [programme],
+              team: current_team,
+              academic_year: @academic_year
+            )
+          end
+      end
+  end
+end

app/views/schools/invite_to_clinic/edit.html.erb

@@ -0,0 +1,33 @@
+<% content_for :before_main do %>
+  <%= govuk_back_link(href: @back_link_path) %>
+<% end %>
+
+<%= h1 "Invite parents to book a clinic appointment" do %>
+  <span class="nhsuk-caption-l"><%= @location.alternative_name %></span>
+  Invite parents to book a clinic appointment
+<% end %>
+
+<% if @invitations_count_by_programme_type.values.all?(&:zero?) %>
+  <p>You do not need to send any clinic invitations. The parents of any children who were not vaccinated have already received clinic invitations.</p>
+
+  <p><%= link_to "Return to school", school_patients_path(Location::URN_UNKNOWN) %></p>
+<% else %>
+  <p><%= I18n.t("children_be", count: @eligible_patients_not_vaccinated.count) %> due a vaccination for at least 1 programme.</p>
+
+  <p>You can now send clinic booking invitations to their parents.</p>
+
+  <%= form_with model: @form, url: school_invite_to_clinic_path(Location::URN_UNKNOWN), method: :put do |f| %>
+    <%= f.govuk_check_boxes_fieldset :programme_types, legend: nil do %>
+      <% current_team.programmes.each do |programme| %>
+        <% if (count = @invitations_count_by_programme_type[programme]) > 0 %>
+          <%= f.govuk_check_box :programme_types,
+                                programme.type,
+                                label: { text: programme.name },
+                                hint: { text: "#{I18n.t("children_have", count:)} not been invited to a clinic yet" } %>
+        <% end %>
+      <% end %>
+    <% end %>
+
+    <%= f.govuk_submit "Send clinic invitations" %>
+  <% end %>
+<% end %>

app/views/schools/patients/index.html.erb

@@ -9,6 +9,8 @@
 
 <% if @location.school? %>
   <%= govuk_button_link_to "Import class lists", new_school_import_path(@location), secondary: true %>
+<% elsif @location.generic_clinic? %>
+  <%= govuk_button_link_to "Send clinic invitations", edit_school_invite_to_clinic_path(Location::URN_UNKNOWN), secondary: true %>
 <% end %>
 
 <div class="nhsuk-grid-row">

config/locales/countables.en.yml

@@ -3,6 +3,14 @@ en:
     zero: No children
     one: 1 child
     other: "%{count} children"
+  children_be:
+    zero: No children are
+    one: 1 child is
+    other: "%{count} children are"
+  children_have:
+    zero: No children have
+    one: 1 child has
+    other: "%{count} children have"
   children_for_programme:
     zero: No children for %{programme}
     one: 1 child for %{programme}

config/routes.rb

@@ -268,6 +268,11 @@
   end
 
   resources :schools, only: :index, param: :urn_and_site do
+    resource :invite_to_clinic,
+             only: %i[edit update],
+             path: "invite-to-clinic",
+             controller: "schools/invite_to_clinic"
+
     resources :import, only: :new, controller: "schools/import"
     resources :patients, only: :index, controller: "schools/patients"
     resources :sessions, only: :index, controller: "schools/sessions"

spec/features/schools_spec.rb

@@ -29,6 +29,23 @@
     then_i_see_the_secondary_sessions
   end
 
+  scenario "Sending clinic invitations to children in no known school" do
+    given_a_team_with_no_known_school_children
+    and_i_am_signed_in
+
+    when_i_visit_the_schools_page
+    and_i_click_on_no_known_school
+    then_i_see_the_send_invitations_button
+
+    when_i_click_send_clinic_invitations
+    and_i_select_programmes_and_send
+    then_i_see_the_invitation_confirmation
+    and_the_parents_receive_invitations
+
+    when_i_click_send_clinic_invitations
+    then_i_see_no_invitations_need_to_be_sent
+  end
+
   def given_a_team_exists_with_a_few_schools
     programmes = [Programme.flu, Programme.hpv]
 
@@ -134,4 +151,88 @@ def when_i_click_on_edit_session
   def and_i_click_on_back
     click_on "Back"
   end
+
+  def given_a_team_with_no_known_school_children
+    programmes = [Programme.hpv]
+    @team = create(:team, :with_generic_clinic, programmes:)
+    @generic_clinic = @team.generic_clinic
+
+    @patients =
+      10.times.map do
+        create(
+          :patient,
+          :consent_no_response,
+          school: nil,
+          parents: [build(:parent)],
+          programmes:,
+          location: @generic_clinic,
+          academic_year: AcademicYear.pending
+        )
+      end
+
+    # We create these to ensure these children aren't invited.
+    create(
+      :patient,
+      :consent_refused,
+      school: nil,
+      parents: [build(:parent)],
+      programmes:,
+      location: @generic_clinic,
+      academic_year: AcademicYear.pending
+    )
+    create(
+      :patient,
+      :consent_conflicting,
+      school: nil,
+      parents: [build(:parent)],
+      programmes:,
+      location: @generic_clinic,
+      academic_year: AcademicYear.pending
+    )
+
+    @nurse = create(:nurse, team: @team)
+  end
+
+  def when_i_visit_the_schools_page
+    visit schools_path
+  end
+
+  def and_i_click_on_no_known_school
+    click_on "No known school"
+  end
+
+  def then_i_see_the_send_invitations_button
+    expect(page).to have_content("Send clinic invitations")
+  end
+
+  def when_i_click_send_clinic_invitations
+    click_on "Send clinic invitations"
+  end
+
+  def and_i_select_programmes_and_send
+    check "HPV"
+    click_on "Send clinic invitations"
+  end
+
+  def then_i_see_the_invitation_confirmation
+    expect(page).to have_content("10 children invited to the clinic")
+  end
+
+  def and_the_parents_receive_invitations
+    perform_enqueued_jobs
+
+    expect(email_deliveries.count).to eq(@patients.count)
+
+    @patients.each do |patient|
+      patient.parents.each do |parent|
+        expect_email_to parent.email, :clinic_initial_invitation, :any
+      end
+    end
+  end
+
+  def then_i_see_no_invitations_need_to_be_sent
+    expect(page).to have_content(
+      "You do not need to send any clinic invitations."
+    )
+  end
 end