Add tests for follow-up journey

Verifies both parent side and nurse side

MAV-3378 and MAV-526

Author: murugapl

mavis/test/constants.py

@@ -430,6 +430,13 @@ def requires_details(self) -> bool:
             ConsentRefusalReason.CONTAINS_GELATINE,
         )
 
+    @property
+    def has_follow_up_option(self) -> bool:
+        return self not in (
+            ConsentRefusalReason.VACCINE_ALREADY_RECEIVED,
+            ConsentRefusalReason.VACCINE_WILL_BE_GIVEN_ELSEWHERE,
+        )
+
 
 class ConsentMethod(StrEnum):
     PHONE = "By phone"

mavis/test/pages/online_consent_wizard_page.py

@@ -10,6 +10,7 @@
     Programme,
 )
 from mavis.test.data_models import Child, Parent, School
+from mavis.test.utils import expect_details
 
 
 class OnlineConsentWizardPage:
@@ -124,6 +125,12 @@ def __init__(self, page: Page) -> None:
             "radio",
             name="No",
         )
+        self.change_discuss_options_link = self.page.get_by_role(
+            "link", name="Change  follow-up request"
+        )
+        self.change_reason_for_refusal_link = self.page.get_by_role(
+            "link", name="Change  reason for refusal"
+        )
 
     @step("Click Continue")
     def click_continue(self) -> None:
@@ -326,7 +333,7 @@ def select_consent_not_given_reason(
 
         self.click_continue()
 
-    def answer_follow_up_question(self, yes_to_follow_up_request: bool) -> None:
+    def answer_follow_up_question(self, *, yes_to_follow_up_request: bool) -> None:
         if yes_to_follow_up_request:
             self.follow_up_question_yes_radio.check()
         else:
@@ -337,6 +344,44 @@ def expect_confirmation_text(self, text: str) -> None:
         confirmation = self.page.locator(".nhsuk-panel.nhsuk-panel--confirmation")
         expect(confirmation).to_contain_text(text)
 
+    @step("Verify check and confirm refusal details")
+    def verify_check_and_confirm_refusal_details(
+        self, refusal_reason: ConsentRefusalReason, *, follow_up_requested: bool
+    ) -> None:
+        expect_details(self.page, "Reason", str(refusal_reason))
+        expected_discuss_value = "Yes" if follow_up_requested else "No"
+        expect_details(self.page, "Discuss options", expected_discuss_value)
+
+    @step("Verify follow-up hint text")
+    def verify_follow_up_hint_text(self, refusal_reason: ConsentRefusalReason) -> None:
+        hint_text_medical = (
+            "We understand alternatives might not be suitable in some cases."
+        )
+        hint_text_gelatine = (
+            "For example, it may be possible to use a vaccine that "
+            "does not contain gelatine"
+        )
+
+        if refusal_reason == ConsentRefusalReason.MEDICAL_REASONS:
+            expect(self.page.get_by_text(hint_text_medical)).to_be_visible()
+        elif refusal_reason == ConsentRefusalReason.CONTAINS_GELATINE:
+            expect(self.page.get_by_text(hint_text_gelatine)).to_be_visible()
+        else:
+            expect(self.page.get_by_text(hint_text_medical)).not_to_be_visible()
+            expect(self.page.get_by_text(hint_text_gelatine)).not_to_be_visible()
+
+    @step("Click Change link for discuss options")
+    def click_change_discuss_options(self) -> None:
+        self.change_discuss_options_link.click()
+
+    @step("Click Change link for refusal reason")
+    def click_change_refusal_reason(self) -> None:
+        self.change_reason_for_refusal_link.click()
+
+    @step("Verify Discuss options is not shown")
+    def verify_discuss_options_not_shown(self) -> None:
+        expect(self.page.get_by_text("Discuss options")).not_to_be_visible()
+
     def go_to_url(self, url: str) -> None:
         self.page.goto(url)
 
@@ -358,6 +403,46 @@ def fill_details(
 
         self.fill_parent_details(parent)
 
+    @step("Submit refused consent, follow-up requested: {follow_up_requested}")
+    def submit_refusal(
+        self,
+        reason: ConsentRefusalReason = ConsentRefusalReason.PERSONAL_CHOICE,
+        *,
+        follow_up_requested: bool = False,
+        details: str | None = None,
+    ) -> None:
+        self.dont_agree_to_vaccination()
+        self.select_consent_not_given_reason(reason, details)
+        if reason.has_follow_up_option:
+            self.answer_follow_up_question(follow_up_requested)
+        self.click_confirm()
+
+    @step("Submit given consent")
+    def submit_positive_consent(
+        self,
+        child: Child,
+        programme: Programme,
+        consent_option: ConsentOption,
+        *,
+        yes_to_health_questions: bool = False,
+    ) -> None:
+        if programme is Programme.MMR:
+            self.agree_to_mmr_vaccination(consent_option)
+        elif programme is Programme.HPV:
+            self.agree_to_hpv_vaccination()
+        elif programme is Programme.FLU:
+            self.agree_to_flu_vaccination(consent_option)
+        elif programme in (Programme.MENACWY, Programme.TD_IPV):
+            programmes = [programme]
+            self.agree_to_doubles_vaccinations(*programmes)
+
+        self.fill_address_details(*child.address)
+        number_of_questions = len(programme.health_questions(consent_option))
+        self.answer_health_questions(
+            number_of_questions, yes_to_health_questions=yes_to_health_questions
+        )
+        self.click_confirm()
+
     def answer_health_questions(
         self, number_of_questions: int, *, yes_to_health_questions: bool
     ) -> None:

mavis/test/pages/search_components/patient_status_search_component.py

@@ -32,6 +32,10 @@ def __init__(
             "checkbox",
             name="Conflicting consent",
         )
+        self.follow_up_requested_checkbox = self.page.get_by_role(
+            "checkbox",
+            name="Follow-up requested",
+        )
 
     @step("Select Needs consent")
     def select_needs_consent(self) -> None:
@@ -53,6 +57,10 @@ def select_due_vaccination(self) -> None:
     def select_conflicting_consent(self) -> None:
         self.conflicting_consent_checkbox.check()
 
+    @step("Select Follow-up requested")
+    def select_follow_up_requested(self) -> None:
+        self.follow_up_requested_checkbox.check()
+
     @step("Expect Has a refusal to be selected")
     def expect_has_a_refusal_to_be_selected(self) -> None:
         expect(self.has_a_refusal_radio).to_be_checked()

mavis/test/pages/sessions/sessions_children_page.py

@@ -33,6 +33,10 @@ def register_child_as_attending(self, child: Child) -> None:
     def click_on_attending(self) -> None:
         self.attending_button.click()
 
+    @step("Click on child to view patient session page")
+    def click_child(self, child: Child) -> None:
+        self.page.get_by_role("link", name=str(child)).last.click()
+
     def verify_child_shows_correct_flu_consent_method(
         self,
         child: Child,
@@ -60,3 +64,22 @@ def check_note_appears_in_search(self, child: Child, note: str) -> None:
         heading = self.page.get_by_role("heading", name=str(child))
         next_element = heading.locator("xpath=following-sibling::*[1]")
         expect(next_element.get_by_role("blockquote")).to_have_text(note)
+
+    @step("Verify child programme status is {2} {3}")
+    def expect_child_programme_status(
+        self,
+        child: Child,
+        programme: str,
+        status: str,
+        additional_text: str | None = None,
+    ) -> None:
+        child_locator = self.search.get_patient_card_locator(child)
+        programme_status_section = child_locator.locator(f"p:has-text('{programme}')")
+        reload_until_element_is_visible(self.page, programme_status_section)
+
+        expect(programme_status_section).to_contain_text(status)
+        if additional_text:
+            additional_text_locator = programme_status_section.get_by_text(
+                additional_text
+            )
+            reload_until_element_is_visible(self.page, additional_text_locator)

mavis/test/pages/sessions/sessions_patient_page.py

@@ -258,6 +258,9 @@ def expect_conflicting_consent_text(self) -> None:
     def expect_consent_status(self, programme: Programme, status: str) -> None:
         expect(self.page.get_by_text(f"{programme}: {status}")).to_be_visible()
 
+    def expect_consent_recorded_success(self) -> None:
+        expect_alert_text(self.page, "Consent recorded")
+
     def expect_child_safe_to_vaccinate(self, child: Child) -> None:
         expect(
             self.page.get_by_text(

mavis/test/pages/sessions/sessions_patient_session_activity_page.py

@@ -1,6 +1,7 @@
 from playwright.sync_api import Page, expect
 
 from mavis.test.annotations import step
+from mavis.test.data_models import Location
 from mavis.test.pages.header_component import HeaderComponent
 from mavis.test.utils import (
     expect_alert_text,
@@ -45,3 +46,7 @@ def add_note(self, note: str) -> None:
 
     def check_session_activity_entry(self, text: str) -> None:
         expect(self.page.get_by_role("heading", name=text).first).to_be_visible()
+
+    @step("Go back to Session")
+    def click_back_to_session(self, location: Location) -> None:
+        self.page.get_by_role("link", name=location.name).click()

mavis/test/pages/unmatched_responses/consent_response_page.py

@@ -1,4 +1,4 @@
-from playwright.sync_api import Page
+from playwright.sync_api import Page, expect
 
 from mavis.test.annotations import step
 from mavis.test.pages.header_component import HeaderComponent
@@ -16,6 +16,7 @@ def __init__(self, page: Page) -> None:
             exact=True,
         )
         self.match_link = page.get_by_role("link", name="Match", exact=True)
+        self.follow_up_link = page.get_by_role("link", name="Follow up", exact=True)
 
     @step("Click on Archive")
     def click_archive(self) -> None:
@@ -28,3 +29,14 @@ def click_create_new_record(self) -> None:
     @step("Click on Match")
     def click_match(self) -> None:
         self.match_link.click()
+
+    @step("Click on Follow up")
+    def click_follow_up(self) -> None:
+        self.follow_up_link.click()
+
+    def expect_follow_up_available(self) -> None:
+        expect(self.follow_up_link).to_be_visible()
+
+    @step("Verify Follow up link is not available")
+    def expect_follow_up_not_available(self) -> None:
+        expect(self.follow_up_link).not_to_be_visible()