Add support for MMRV specific consent link

murugapl · murugapl · commit 26e73981daf4 · 2026-02-20T14:34:19.000Z
This amends the consent link generation to include support for MMRV.
The only change to the consent journey questions is that we reference
MMRV instead of MMR.
The link in Notify request includes mmrv in the url (mmrv/start).
We then parse this URL to extract programme_types and in the case
mmr exists in the type, we set the variant appropriately. This variant
is used to create the consent form which is then used throughout the
flow to determine what text to show (MMR/MMRV).
diff --git a/app/controllers/parent_interface/consent_forms/base_controller.rb b/app/controllers/parent_interface/consent_forms/base_controller.rb
@@ -48,7 +48,10 @@ def set_programmes
           @consent_form.consent_form_programmes.map(&:programme)
         elsif @session.present? && params[:programme_types].present?
           types = params[:programme_types].split("-")
-          @session.programmes.select { it.type.in?(types) }
+
+          @session.programmes.flat_map do
+            it.variants.select { it.to_param.in?(types) }
+          end
         end
 
       raise ActiveRecord::RecordNotFound if @programmes.empty?
diff --git a/app/lib/govuk_notify_personalisation.rb b/app/lib/govuk_notify_personalisation.rb
@@ -130,10 +130,19 @@ def consent_deadline
   def consent_link
     return nil if session.nil? || programmes.empty?
 
+    programme_params =
+      programmes.map do |programme|
+        if programme.mmr? && patient
+          programme.variant_for(patient:).to_param
+        else
+          programme.to_param
+        end
+      end
+
     host +
       start_parent_interface_consent_forms_path(
         session,
-        programmes.map(&:to_param).join("-")
+        programme_params.join("-")
       )
   end
 
diff --git a/app/models/programme/variant.rb b/app/models/programme/variant.rb
@@ -27,6 +27,8 @@ def initialize(programme, variant_type:)
     @variant_type = variant_type
   end
 
+  def to_param = variant_type
+
   def mmr_variant? = variant_type == "mmr"
 
   def mmrv_variant? = variant_type == "mmrv"
diff --git a/app/views/parent_interface/consent_forms/confirm.html.erb b/app/views/parent_interface/consent_forms/confirm.html.erb
@@ -20,7 +20,7 @@
     <% programme = consent_form_programme.programme %>
 
     <%= render AppCardComponent.new do |card| %>
-      <% card.with_heading { t(programme.type, scope: %i[consent_forms confirm consent_card_title]) } %>
+      <% card.with_heading { t(programme.to_param, scope: %i[consent_forms confirm consent_card_title]) } %>
 
       <%= govuk_summary_list do |summary_list|
             summary_list.with_row do |row|
diff --git a/app/views/parent_interface/consent_forms/edit/reason_for_refusal_notes.html.erb b/app/views/parent_interface/consent_forms/edit/reason_for_refusal_notes.html.erb
@@ -7,8 +7,9 @@
 
   <%= h1 t(@consent_form.reason_for_refusal, scope: %i[consent_forms notes title]) %>
 
-  <% if @consent_form.refused_consent_form_programmes.any? { it.programme.mmr? } && @consent_form.reason_for_refusal == "already_vaccinated" %>
-    <p class="nhsuk-hint">Children need 2 doses of the MMR vaccine to be fully protected. If your child has had more than 1 dose, give details about both doses.</p>
+  <% programme = @consent_form.refused_consent_form_programmes.find { it.programme.mmr? }&.programme %>
+  <% if programme && @consent_form.reason_for_refusal == "already_vaccinated" %>
+    <p class="nhsuk-hint">Children need 2 doses of the #{programme.name} vaccine to be fully protected. If your child has had more than 1 dose, give details about both doses.</p>
   <% end %>
 
   <% label = "Give details" + (@consent_form.reason_for_refusal_requires_notes? ? "" : " (optional)") %>
diff --git a/app/views/parent_interface/consent_forms/edit/response_mmr.html.erb b/app/views/parent_interface/consent_forms/edit/response_mmr.html.erb
@@ -2,15 +2,16 @@
   <%= govuk_back_link(href: backlink_path) %>
 <% end %>
 
-<% legend = "Do you agree to your child having the MMR vaccination?" %>
+<% programme = @consent_form.consent_form_programmes.sole.programme %>
+<% legend = "Do you agree to your child having the #{programme.name} vaccination?" %>
 <% content_for :page_title, legend %>
 
 <%= form_with model: @consent_form, url: wizard_path, method: :put do |f| %>
   <%= f.govuk_error_summary %>
 
   <%= f.govuk_radio_buttons_fieldset :response,
                                      legend: { size: "l", text: legend, tag: "h1" },
-                                     hint: { text: "This is a catch-up vaccination for those who have not yet had 2 doses of the MMR vaccine. Children usually have these when they are 1 and 3 years old." } do %>
+                                     hint: { text: "This is a catch-up vaccination for those who have not yet had 2 doses of the #{programme.name} vaccine. Children usually have these when they are 1 and 3 years old." } do %>
     <%= f.govuk_radio_button :response, "given", label: { text: "Yes, I agree" }, link_errors: true %>
     <%= f.govuk_radio_button :response, "refused" %>
   <% end %>
diff --git a/app/views/parent_interface/consent_forms/edit/without_gelatine.erb b/app/views/parent_interface/consent_forms/edit/without_gelatine.erb
@@ -2,6 +2,7 @@
   <%= govuk_back_link(href: backlink_path) %>
 <% end %>
 
+<% programme = @consent_form.consent_form_programmes.sole.programme %>
 <% legend = "Do you want your child to have a vaccine without gelatine?" %>
 <% content_for :page_title, legend %>
 
@@ -10,7 +11,7 @@
 
   <%= f.govuk_radio_buttons_fieldset :without_gelatine,
                                      legend: { size: "l", text: legend, tag: "h1" },
-                                     hint: { text: "One type of MMR vaccine contains gelatine from pigs. An alternative MMR vaccine is available that does not contain gelatine." } do %>
+                                     hint: { text: "One type of #{programme.name} vaccine contains gelatine from pigs. An alternative #{programme.name} vaccine is available that does not contain gelatine." } do %>
     <%= f.govuk_radio_button :without_gelatine, :true, label: { text: "I want my child to have the vaccine that does not contain gelatine" }, link_errors: true %>
     <%= f.govuk_radio_button :without_gelatine, :false, label: { text: "My child can have either type of vaccine" } %>
   <% end %>
diff --git a/app/views/parent_interface/consent_forms/start.html.erb b/app/views/parent_interface/consent_forms/start.html.erb
@@ -1,14 +1,15 @@
-<%= h1 t(@programmes.map(&:type).join("-"), scope: %i[consent_forms start title]), size: "xl" %>
+<% programme_params = @programmes.map(&:to_param).join("-") %>
+<%= h1 t(programme_params, scope: %i[consent_forms start title]), size: "xl" %>
 
 <% @programmes.each do |programme| %>
-  <%= render "parent_interface/consent_forms/start/#{programme.type}" %>
+  <%= render "parent_interface/consent_forms/start/#{programme.to_param}" %>
 <% end %>
 
 <h2 class="nhsuk-heading-m">Give or refuse consent</h2>
 
 <%= form_with url: url_for(action: :create) do |f| %>
   <%= hidden_field_tag :session_slug, @session.slug %>
-  <%= hidden_field_tag :programme_types, @programmes.map(&:type).join("-") %>
+  <%= hidden_field_tag :programme_types, programme_params %>
   <%= f.govuk_submit "Start now", role: "link" %>
 <% end %>
 
diff --git a/app/views/parent_interface/consent_forms/start/_mmrv.html.erb b/app/views/parent_interface/consent_forms/start/_mmrv.html.erb
@@ -0,0 +1,24 @@
+<p>
+  The MMRV vaccine protects against measles, mumps, rubella and chickenpox 
+  (varicella). Having 2 doses gives lasting protection against all 4 illnesses. 
+</p>
+
+<p>MMRV has replaced the MMR vaccine, which protects against measles, mumps and rubella.</p>
+
+<p>
+  If your child has already had 2 doses of the MMR vaccine, they are fully vaccinated and 
+  do not need another dose. Let us know by completing the online form.
+</p>
+
+<p>
+  If your child has not had 2 doses of MMR, they will need an MMRV catch-up vaccination. 
+  If you’re not sure how many doses your child has had, having further doses will not cause 
+  any harm.
+</p>
+
+<p>Research has shown there is no link between the MMRV vaccine and autism.</p>
+
+<p>
+  <%= link_to "Find out more about the MMRV vaccine",
+              "https://www.nhs.uk/vaccinations/mmrv-vaccine/" %>
+</p>
diff --git a/config/locales/en.yml b/config/locales/en.yml
@@ -605,6 +605,7 @@ en:
         hpv: Consent for the HPV vaccination
         menacwy: Consent for the MenACWY vaccination
         mmr: Consent for the MMR vaccination
+        mmrv: Consent for the MMRV vaccination
         td_ipv: Consent for the Td/IPV vaccination
       i_agree: Consent given
     notes:
@@ -621,6 +622,7 @@ en:
         hpv: Give or refuse consent for the HPV vaccination
         menacwy-td_ipv: Give or refuse consent for the MenACWY and Td/IPV vaccinations
         mmr: Give or refuse consent for an MMR catch-up vaccination
+        mmrv: Give or refuse consent for an MMRV catch-up vaccination
   dashboard:
     index:
       title: Home
diff --git a/spec/features/parental_consent_mmrv_spec.rb b/spec/features/parental_consent_mmrv_spec.rb
@@ -0,0 +1,191 @@
+# frozen_string_literal: true
+
+describe "Parental consent" do
+  before { given_an_mmr_programme_is_underway }
+
+  scenario "MMRV - any vaccine" do
+    when_i_go_to_the_consent_form
+    then_i_see_the_consent_form
+
+    when_i_give_consent(without_gelatine: false)
+    then_i_see_the_first_health_question
+
+    when_i_answer_no_to_all_health_questions
+    then_i_see_the_check_and_confirm_page
+
+    when_i_submit_the_consent_form
+    and_i_refuse_to_answer_questions_on_ethnicity
+    then_i_see_the_confirmation_page
+  end
+
+  scenario "MMRV - without gelatine" do
+    when_i_go_to_the_consent_form
+    then_i_see_the_consent_form
+
+    when_i_give_consent(without_gelatine: true)
+    then_i_see_the_first_health_question
+
+    when_i_answer_no_to_all_health_questions
+    then_i_see_the_check_and_confirm_page
+
+    when_i_submit_the_consent_form
+    and_i_refuse_to_answer_questions_on_ethnicity
+    then_i_see_the_confirmation_page
+  end
+
+  scenario "MMRV - refusal" do
+    when_i_go_to_the_consent_form
+    then_i_see_the_consent_form
+
+    when_i_refuse_consent
+    then_i_see_the_check_and_confirm_page
+
+    when_i_submit_the_consent_form
+    and_i_refuse_to_answer_questions_on_ethnicity
+    then_i_see_the_confirmation_page_about_refusal
+  end
+
+  def given_an_mmr_programme_is_underway
+    @mmr_programme = Programme.mmr
+    @mmrv_programme =
+      Programme::Variant.new(@mmr_programme, variant_type: "mmrv")
+    @team = create(:team, :with_one_nurse, programmes: [@mmr_programme])
+    location =
+      create(:school, name: "Pilot School", programmes: [@mmr_programme])
+    @session =
+      create(:session, :scheduled, programmes: [@mmrv_programme], location:)
+    @child =
+      create(
+        :patient,
+        session: @session,
+        given_name: "River",
+        family_name: "Cartwright"
+      )
+  end
+
+  def when_i_go_to_the_consent_form
+    visit start_parent_interface_consent_forms_path(@session, @mmrv_programme)
+  end
+
+  def then_i_see_the_consent_form
+    expect(page).to have_content(
+      "Give or refuse consent for an MMRV catch-up vaccination"
+    )
+  end
+
+  def when_i_give_consent(without_gelatine:)
+    click_button "Start now"
+
+    # What is your child's name?
+    fill_in "First name", with: @child.given_name
+    fill_in "Last name", with: @child.family_name
+    choose "No"
+    click_button "Continue"
+
+    # What is your child's date of birth?
+    fill_in "Day", with: @child.date_of_birth.day
+    fill_in "Month", with: @child.date_of_birth.month
+    fill_in "Year", with: @child.date_of_birth.year
+    click_button "Continue"
+
+    # Confirm your child's school
+    choose "Yes"
+    click_button "Continue"
+
+    # About you
+    fill_in "Full name", with: "Jane #{@child.family_name}"
+    choose "Mum"
+    fill_in "Email address", with: "jane@example.com"
+    click_button "Continue"
+
+    # Do you agree?
+    choose "Yes, I agree"
+    click_button "Continue"
+
+    # Without gelatine
+    if without_gelatine
+      choose "I want my child to have the vaccine that does not contain gelatine"
+    else
+      choose "My child can have either type of vaccine"
+    end
+    click_button "Continue"
+
+    # Home address
+    fill_in "Address line 1", with: "1 High Street"
+    fill_in "Town or city", with: "London"
+    fill_in "Postcode", with: "SW1 1AA"
+    click_button "Continue"
+  end
+
+  def when_i_refuse_consent
+    click_button "Start now"
+
+    # What is your child's name?
+    fill_in "First name", with: @child.given_name
+    fill_in "Last name", with: @child.family_name
+    choose "No"
+    click_button "Continue"
+
+    # What is your child's date of birth?
+    fill_in "Day", with: @child.date_of_birth.day
+    fill_in "Month", with: @child.date_of_birth.month
+    fill_in "Year", with: @child.date_of_birth.year
+    click_button "Continue"
+
+    # Confirm your child's school
+    choose "Yes"
+    click_button "Continue"
+
+    # About you
+    fill_in "Full name", with: "Jane #{@child.family_name}"
+    choose "Mum"
+    fill_in "Email address", with: "jane@example.com"
+    click_button "Continue"
+
+    # Do you agree?
+    choose "No"
+    click_button "Continue"
+
+    # Resaon for refusal
+    choose "Personal choice"
+    click_button "Continue"
+  end
+
+  def then_i_see_the_first_health_question
+    expect(page).to have_content(
+      "Does your child have a bleeding disorder or another medical condition they receive treatment for?"
+    )
+  end
+
+  def when_i_answer_no_to_all_health_questions
+    3.times do
+      choose "No"
+      click_button "Continue"
+    end
+  end
+
+  def then_i_see_the_check_and_confirm_page
+    expect(page).to have_content("Check and confirm")
+  end
+
+  def when_i_submit_the_consent_form
+    click_on "Confirm"
+  end
+
+  def then_i_see_the_confirmation_page
+    expect(page).to have_content("is due to get the MMRV vaccination at school")
+  end
+
+  def then_i_see_the_confirmation_page_about_refusal
+    expect(page).to have_content(
+      "do not want River Cartwright to get the MMRV vaccination at school"
+    )
+  end
+
+  def and_i_refuse_to_answer_questions_on_ethnicity
+    return unless Flipper.enabled?(:ethnicity_capture)
+
+    choose "No, skip the ethnicity questions"
+    click_on "Continue"
+  end
+end
diff --git a/spec/lib/govuk_notify_personalisation_spec.rb b/spec/lib/govuk_notify_personalisation_spec.rb
@@ -136,6 +136,19 @@
 
       it { should include(vaccination_sms: "MMR vaccination") }
       it { should include(vaccination_and_dates_sms: "MMR vaccination") }
+
+      it "generates consent link with mmrv variant" do
+        expect(to_h[:consent_link]).to end_with("/mmrv/start")
+      end
+    end
+
+    context "when it's an MMR programme and patient is NOT eligible for MMRV" do
+      let(:programmes) { [Programme.mmr] }
+      let(:date_of_birth) { Programme::MIN_MMRV_ELIGIBILITY_DATE - 1.month }
+
+      it "generates consent link with mmr variant" do
+        expect(to_h[:consent_link]).to end_with("/mmr/start")
+      end
     end
   end
 
