WIP - completed some scenarios and added scaffolding for others. Test env is down so will need to verify these next week.

Author: Andyg79

pages/call_and_recall/generate_invitations_page.py

@@ -2,6 +2,10 @@
 from pages.base_page import BasePage
 import pytest
 import logging
+from utils.oracle.oracle import OracleDB
+from utils.oracle.subject_selection_query_builder import SubjectSelectionQueryBuilder
+from classes.user import User
+from classes.subject import Subject
 
 
 class GenerateInvitationsPage(BasePage):
@@ -17,7 +21,7 @@ def __init__(self, page: Page):
         self.display_rs = self.page.locator("#displayRS")
         self.refresh_button = self.page.get_by_role("button", name="Refresh")
         self.planned_invitations_total = self.page.locator("#col8_total")
-        self.self_referrals_total = self.page.locator("#col9_total")
+        self.self_referrals_total = self.page.locator("#col5_total")
 
     def click_generate_invitations_button(self) -> None:
         """This function is used to click the Generate Invitations button."""
@@ -103,3 +107,67 @@ def wait_for_invitation_generation_complete(
         else:
             logging.warning("No S1 Digital Leaflet batch will be generated")
             return False
+
+    def check_self_referral_subjects_ready(
+        self, search_scope: str, volume: str
+    ) -> None:
+        """
+        Asserts whether self-referral subjects are ready to invite.
+
+        Args:
+            search_scope (str): Either "currently" or "now" to determine when to assert
+            volume (str): Either "some" or "no" — expected number of self-referrals
+
+        Raises:
+            AssertionError if the count doesn't match expectation and search_scope is "now"
+        """
+        assert search_scope in (
+            "currently",
+            "now",
+        ), f"Invalid search_scope: '{search_scope}'"
+        assert volume in ("some", "no"), f"Invalid volume: '{volume}'"
+
+        # Confirm we're on the Generate Invitations page
+        self.verify_generate_invitations_title()
+
+        # Extract and clean the count
+        self_referrals_text = self.self_referrals_total.text_content()
+        if self_referrals_text is None:
+            pytest.fail("Failed to read self-referrals total")
+        self_referrals_count = int(self_referrals_text.strip())
+
+        # Determine if condition is met
+        condition_met = (
+            self_referrals_count > 0 if volume == "some" else self_referrals_count == 0
+        )
+
+        logging.debug(f"[DEBUG] Self-referral subject count = {self_referrals_count}")
+
+        if search_scope == "now":
+            assert (
+                condition_met
+            ), f"Expected {volume.upper()} self-referral subjects, but got {self_referrals_count}"
+        logging.info(
+            f"[SELF-REFERRAL CHECK] scope='{search_scope}' | expected='{volume}' | actual={self_referrals_count}"
+        )
+
+    def get_self_referral_eligible_subject(self, user: User, subject: Subject) -> str:
+        criteria = {
+            "screening status": "Inactive",
+            "subject age": ">= 75",
+            "has GP practice": "Yes - active",
+            "subject hub code": "BCS02",
+        }
+
+        builder = SubjectSelectionQueryBuilder()
+        query, bind_vars = builder.build_subject_selection_query(
+            criteria, user, subject
+        )
+
+        oracle = OracleDB()
+        result = oracle.execute_query(query, bind_vars)
+
+        if result.empty:
+            raise RuntimeError("No eligible subject found")
+
+        return result.iloc[0]["subject_nhs_number"]

pages/communication_production/batch_list_page.py

@@ -3,6 +3,7 @@
 from datetime import datetime
 from utils.calendar_picker import CalendarPicker
 from utils.table_util import TableUtils
+import logging
 
 
 class BatchListPage(BasePage):
@@ -218,6 +219,16 @@ def get_open_original_batch_row(self) -> Locator | None:
                 return row
         return None
 
+    def assert_s83f_batch_present(self) -> None:
+        self.enter_type_filter("Original")
+        self.enter_event_code_filter("S83")
+        self.enter_description_filter("Invitation & Test Kit (Self-referral) (FIT)")
+        expect(
+            self.table_data.filter(
+                has_text="Invitation & Test Kit (Self-referral) (FIT)"
+            )
+        ).to_be_visible()
+
 
 class ArchivedBatchListPage(BatchListPage):
     """Archived Batch List Page-specific setup."""
@@ -274,3 +285,57 @@ def get_archived_batch_row(
                     return row
             except IndexError:
                 return None
+
+
+class LetterBatchDetailsPage(BasePage):
+    """Page object for the Letter Batch Details view."""
+
+    def __init__(self, page: Page):
+        super().__init__(page)
+        self.page = page
+        self.letter_table = self.page.locator("table#letterBatchDetails")
+
+    def assert_letter_component_present(self, letter_type: str, format: str) -> None:
+        """
+        Asserts that a letter component with the given type and format is listed.
+
+        Args:
+            letter_type (str): The letter type (e.g. "Invitation & Test Kit (Self-referral) (FIT)")
+            format (str): The file format (e.g. "PDF-A4-V03")
+        """
+        row_locator = self.letter_table.locator("tbody tr")
+        match_found = False
+
+        for i in range(row_locator.count()):
+            row = row_locator.nth(i)
+            type_cell = row.locator("td").nth(1)
+            format_cell = row.locator("td").nth(2)
+
+            if (
+                letter_type.lower() in type_cell.inner_text().lower()
+                and format.lower() in format_cell.inner_text().lower()
+            ):
+                match_found = True
+                break
+
+        assert (
+            match_found
+        ), f"Letter type '{letter_type}' with format '{format}' not found"
+
+    def get_first_subject_nhs_number(self) -> str:
+        """
+        Retrieves the NHS number of the first subject listed in the letter batch details table.
+
+        Returns:
+            str: The NHS number of the subject.
+        """
+        table_utils = TableUtils(self.page, "table#letterBatchDetails")
+        row_data = table_utils.get_row_data_with_headers(0)  # First row (0-based index)
+        
+        nhs_number = row_data.get("NHS Number")
+        if not nhs_number:
+            raise RuntimeError("NHS Number not found in the first row of the letter batch table")
+
+        logging.info(f"Retrieved NHS number from batch: {nhs_number}")
+        return nhs_number
+

pages/screening_subject_search/subject_screening_search_page.py

@@ -1,3 +1,4 @@
+import logging
 from playwright.sync_api import Page, expect
 from pages.base_page import BasePage
 from enum import Enum
@@ -154,6 +155,71 @@ def verify_date_of_birth_filter_input(self, expected_text: str) -> None:
         """Verifies that the Date of Birth filter input field has the expected value."""
         expect(self.date_of_birth_filter).to_have_value(expected_text)
 
+    def search_by_nhs_number(self, nhs_number: str) -> None:
+        """
+        Searches for a subject using NHS number.
+        Selects 'Whole Database' to bypass modal dialogs triggered by limited search scopes.
+        """
+        # Step 1: Clear any existing filters
+        self.click_clear_filters_button()
+
+        # Step 2: Enter NHS number
+        self.nhs_number_filter.fill(nhs_number)
+        self.nhs_number_filter.press("Tab")
+
+        # Step 3: Select 'Whole Database' to avoid confirmation modal
+        self.select_search_area_option(
+            SearchAreaSearchOptions.SEARCH_AREA_WHOLE_DATABASE.value
+        )
+
+        # Step 4: Run search
+        self.click_search_button()
+
+    def click_send_kit_button(self) -> None:
+        """
+        Clicks the 'Send a kit' button for self-referral.
+        Verifies the transition to the 'Send a kit' page and logs errors if that check fails.
+        """
+        send_kit_button = self.page.locator("#self_ref_button")
+        expect(send_kit_button).to_be_visible()
+        send_kit_button.click()
+
+        try:
+            expect(self.page.locator("h1")).to_contain_text("Send a kit")
+            logging.info("[PAGE TRANSITION] Successfully landed on Send a kit page")
+        except Exception as e:
+            logging.error(
+                f"[PAGE TRANSITION FAILED] Did not reach Send a kit page: {e}"
+            )
+            raise
+    
+    def complete_send_kit_form(self, request_from: str = "Subject", previous_kit_status: str = "Lost", note_text: str = "Test") -> None:
+        """
+        Completes the 'Send a kit' form by:
+        - Selecting who requested the kit
+        - Selecting previous kit status
+        - Entering reason text
+        - Clicking the 'Send a kit' button
+
+        Args:
+            request_from (str): Option to select for who requested the kit.
+            previous_kit_status (str): Reason for replacing or requesting the kit.
+            note_text (str): Free-text note to include with the request.
+        """
+        # Fill dropdowns
+        self.page.locator("#kitRequestFrom").select_option(request_from)
+        self.page.locator("#previousKit").select_option(previous_kit_status)
+
+        # Fill note text
+        self.page.locator("textarea[data-testid='reasonNote']").fill(note_text)
+
+        # Wait for button to become enabled before clicking
+        send_button = self.page.locator("button[data-testid='sendKitButton']")
+        expect(send_button).to_be_enabled()
+        send_button.click()
+
+        logging.info("[KIT REQUEST] 'Send a kit' form submitted successfully")
+
 
 class ScreeningStatusSearchOptions(Enum):
     """Enum for Screening Status Search Options"""

pages/screening_subject_search/subject_screening_summary_page.py

@@ -227,6 +227,37 @@ def click_close_button(self) -> None:
         """Click on the close button in the temporary address popup."""
         self.click(self.close_button)
 
+    def assert_view_letter_links_for_event(
+        self, event_name: str, expected_count: int
+    ) -> None:
+        """
+        Asserts that the specified event row contains the expected number of 'View Letter' links.
+
+        Args:
+            event_name (str): The name of the event to locate (e.g. "S84 - Invitation and Test Kit Sent (Self-referral)")
+            expected_count (int): The expected number of 'View Letter' links in that row
+        """
+        # Locate the event row by its name
+        event_row = (
+            self.page.locator("table#subjectEvents tbody tr")
+            .filter(has=self.page.locator("td", has_text=event_name))
+            .first
+        )
+
+        if event_row.count() == 0:
+            raise RuntimeError(f"Event row for '{event_name}' not found")
+
+        # Count the 'View Letter' links in that row
+        view_links = event_row.locator("a", has_text="View Letter")
+        actual_count = view_links.count()
+
+        logging.info(
+            f"Found {actual_count} 'View Letter' links for event '{event_name}'"
+        )
+        assert (
+            actual_count == expected_count
+        ), f"Expected {expected_count} 'View Letter' links for event '{event_name}', but found {actual_count}"
+
 
 class ChangeScreeningStatusOptions(Enum):
     """Enum for Change Screening Status options."""

tests/regression/communications_production/test_basic_archived_batch_list_functionality.py

@@ -87,4 +87,4 @@ def test_navigation_to_manage_archived_batch_screen(select_user) -> None:
 
     # Step 3: Assert navigation to the Manage Archived Batch page
     manage_batch_page = ManageArchivedBatchPage(page)
-    manage_batch_page.assert_batch_details_visible()
+    manage_batch_page.assert_archived_batch_details_visible()