finished the scenario: basic active batch list functionality

Author: Andyg79

pages/communication_production/batch_list_page.py

@@ -153,7 +153,9 @@ def assert_column_sortable(self, column_name: str) -> None:
     def assert_column_filterable(self, column_name: str) -> None:
         """Asserts that the specified column has a filter control in the second header row."""
         table = TableUtils(self.page, "table#batchList")
-        column_index = table.get_column_index(column_name) - 1  # Convert 1-based to 0-based
+        column_index = (
+            table.get_column_index(column_name) - 1
+        )  # Convert 1-based to 0-based
 
         filter_locator = (
             self.page.locator("table#batchList thead tr:nth-child(2) th")
@@ -164,6 +166,35 @@ def assert_column_filterable(self, column_name: str) -> None:
             filter_locator.count() > 0
         ), f"Filter control not found for column '{column_name}'"
 
+    def assert_batch_table_visible(self) -> None:
+        """Asserts that the batch list table is present and rendered."""
+        expect(self.page.locator("table#batchList")).to_be_visible()
+
+    def select_first_active_batch(self) -> None:
+        """Clicks the first batch ID link in the active batch list."""
+        first_batch_link = self.page.locator("table#batchList tbody tr td.id a").first
+        assert first_batch_link.count() > 0, "No active batch links found"
+        first_batch_link.click()
+
+    def is_batch_present(self, batch_type: str) -> bool:
+        """Checks if a batch of the given type exists in the active batch list."""
+        locator = self.page.locator(f"table#batchList tbody tr td", has_text=batch_type)
+        return locator.count() > 0
+
+    def prepare_batch(self, batch_type: str) -> None:
+        """Finds and clicks the Prepare button for the specified batch type."""
+        row = (
+            self.page.locator("table#batchList tbody tr")
+            .filter(has=self.page.locator("td", has_text=batch_type))
+            .first
+        )
+
+        prepare_button = row.locator("a", has_text="Prepare").first
+        expect(prepare_button).to_be_visible()
+        prepare_button.click()
+
+        # Optional: wait for row to disappear
+        expect(row).not_to_be_visible(timeout=5000)
 
 
 class ArchivedBatchListPage(BatchListPage):

pages/communication_production/manage_active_batch_page.py

@@ -1,5 +1,6 @@
 from playwright.sync_api import Page
 from pages.base_page import BasePage
+from playwright.sync_api import expect
 
 
 class ManageActiveBatchPage(BasePage):
@@ -29,3 +30,9 @@ def click_retrieve_button(self) -> None:
     def click_confirm_button(self) -> None:
         """Click the Confirm Printed button"""
         self.click(self.confirm_button)
+
+    def assert_batch_details_visible(self) -> None:
+        """Asserts that the Manage Active Batch screen has loaded by checking the page title."""
+        page_title = self.page.locator("#page-title")
+        expect(page_title).to_have_text("Manage Active Batch")
+

pytest.ini

@@ -41,3 +41,4 @@ markers =
     call_and_recall: tests that are part of the call and recall test suite
     subject_tests: tests that are part of the subject tests suite
     subject_search: tests that are part of the subject search test suite
+    letters_tests: tests that are part of the letters test suite

tests/regression/communications_production/test_basic_active_batch_list_functionality.py

@@ -0,0 +1,85 @@
+import pytest
+from playwright.sync_api import Page
+from pages.base_page import BasePage
+from pages.communication_production.communications_production_page import (
+    CommunicationsProductionPage,
+)
+from pages.communication_production.batch_list_page import ActiveBatchListPage
+from utils.user_tools import UserTools
+from pages.communication_production.manage_active_batch_page import (
+    ManageActiveBatchPage,
+)
+
+
+@pytest.fixture
+def select_user(page: Page):
+    def _login_as(user_role: str):
+        # Log in with the specified user
+        UserTools.user_login(page, user_role)
+        # Navigate to Active Batch List
+        BasePage(page).go_to_communications_production_page()
+        CommunicationsProductionPage(page).go_to_active_batch_list_page()
+        return page
+
+    return _login_as
+
+
+@pytest.mark.letters_tests
+@pytest.mark.regression
+def test_headings_on_active_batch_list_screen(select_user) -> None:
+    """
+    Scenario: Check headings on Active Batch List Screen
+    Given I log in to BCSS "England" as user role "HubManager"
+    When I view the active batch list
+    Then the table contains a sortable and filterable column for "<Column Name>"
+    """
+    page = select_user("Hub Manager at BCS01")
+    batch_list_page = ActiveBatchListPage(page)
+
+    expected_columns = [
+        "ID",
+        "Type",
+        "Original",
+        "Event Code",
+        "Description",
+        "Batch Split By",
+        "Screening Centre",
+        "Status",
+        "Priority",
+        "Deadline",
+        "Count",
+    ]
+
+    for column in expected_columns:
+        # Step 1: Ensure the column is present
+        batch_list_page.assert_column_present(column)
+
+        # Step 2: Assert sortable UI attribute is present
+        batch_list_page.assert_column_sortable(column)
+
+        # Step 3: Assert filterable control is rendered
+        batch_list_page.assert_column_filterable(column)
+
+
+@pytest.mark.letters_tests
+@pytest.mark.regression
+def test_navigation_to_manage_active_batch_screen(select_user) -> None:
+    """
+    Scenario: Check navigation from Active Batch List Screen to Manage Active Batch Screen
+    Given I log in to BCSS "England" as user role "HubManager"
+    When I view the active batch list
+    And I select an active batch
+    Then I view the details of an active batch
+    """
+    page = select_user("Hub Manager at BCS01")
+    batch_list_page = ActiveBatchListPage(page)
+
+    # Step 1: Ensure the batch list table is visible
+    batch_list_page.assert_batch_table_visible()
+
+    # Step 2: Click into the first available batch link (usually ID column)
+    batch_list_page.select_first_active_batch()
+
+    # Step 3: Assert navigation to the Manage Active Batch page
+    manage_batch_page = ManageActiveBatchPage(page)
+    manage_batch_page.assert_batch_details_visible()