feat(navigation): add prominent validation quickstart action

validation-suite/backend/mercury/tests/test_validation_workflow.py

@@ -20,10 +20,11 @@ from app.models.validation import Validation, ValidationStatus
 from app.services.validation_workflow import ValidationWorkflowService
 from app.services.auth_service import AuthService
 from app.services.reference_masterdata import ReferenceMasterdataImportService
+from app.services.quickstart_service import QuickStartService
 from app.api.v1.auth import login as auth_login
 from app.api.v1 import domain as domain_api
 from app.schemas.auth import LoginRequest
-from app.schemas.domain import UserCreate, UserUpdate, ValidationCreate
+from app.schemas.domain import QuickStartCreateRequest, UserCreate, UserUpdate, ValidationCreate
 from app.modules.orion.service import OrionReportService
 from app.modules.orion.assets import SCHUBAMED_LOGO_PATH, schubamed_logo_uri
 from app.modules.orion.template_service import REPORT_SECTIONS, ReportTemplateService
@@ -277,6 +278,36 @@ def test_user_list_pagination_and_filters_work():
     assert role_filtered["items"][0].role == UserRole.ADMIN.value
 
 
+def test_paginated_lists_expose_pages_for_masterdata_and_validations():
+    db = session()
+    customer, location, device = seed(db)
+    db.add(valid_validation(customer, location, device))
+    db.flush()
+
+    customers = domain_api.list_customers(params={"page": 1, "page_size": 20, "search": None}, session=db)
+    devices = domain_api.list_devices(params={"page": 1, "page_size": 20, "search": None}, session=db)
+    validations = domain_api.list_validations(
+        search=None,
+        page=1,
+        page_size=20,
+        sort_by="created_at",
+        sort_order="desc",
+        status=None,
+        customer_id=None,
+        device_id=None,
+        validation_type=None,
+        result=None,
+        date_from=None,
+        date_to=None,
+        overdue_only=False,
+        session=db,
+    )
+
+    assert customers["pages"] == 1
+    assert devices["pages"] == 1
+    assert validations["pages"] == 1
+
+
 def test_admin_can_create_users_with_supported_roles():
     db = session()
     admin = User(
@@ -636,6 +667,144 @@ def test_reference_masterdata_import_can_create_validation():
     assert validation.status == ValidationStatus.draft.value
 
 
+def test_quickstart_customer_data_and_validation_creation():
+    db = session()
+    reference = next(
+        candidate
+        for parent in Path(__file__).resolve().parents
+        if (candidate := parent / "docs/reference/reports/Erstvalidierung_Dr.Durmaz_Steri_12-25.docx").exists()
+    )
+    ReferenceMasterdataImportService(db).import_reference_docx(reference, create_validation=True)
+    customer = db.scalar(select(Customer).where(Customer.name == "Urologische Praxis Dr. Durmaz"))
+    assert customer is not None
+    customer_data = QuickStartService(db).customer_data(customer.id)
+    assert customer_data.locations
+    assert customer_data.contacts
+    assert customer_data.devices
+    assert customer_data.validations
+
+    admin = User(
+        email="quickstart-admin@schubamed.de",
+        first_name="Quickstart",
+        last_name="Admin",
+        role=UserRole.ADMIN.value,
+        password_hash="hash",
+        is_active=True,
+        must_change_password=False,
+    )
+    db.add(admin)
+    db.flush()
+    created = QuickStartService(db).create_validation(
+        QuickStartCreateRequest(
+            customer_id=customer.id,
+            location_id=customer_data.locations[0].id,
+            contact_id=customer_data.contacts[0].id,
+            device_id=customer_data.devices[0].id,
+            validation_type="Erstvalidierung",
+        ),
+        examiner=admin,
+    )
+    db.commit()
+    assert created.id is not None
+    assert created.status == ValidationStatus.draft.value
+    assert created.customer_id == customer.id
+    assert created.examiner_id == admin.id
+    assert created.documentation_checklist
+    assert created.programs
+    assert created.loading_patterns
+
+
+def test_quickstart_auto_selects_single_customer_masterdata():
+    db = session()
+    customer, location, device = seed(db)
+    contact = seed_contact(db, customer)
+    admin = User(
+        email="single-data-admin@schubamed.de",
+        first_name="Quickstart",
+        last_name="Admin",
+        role=UserRole.ADMIN.value,
+        password_hash="hash",
+        is_active=True,
+        must_change_password=False,
+    )
+    db.add(admin)
+    db.flush()
+
+    created = QuickStartService(db).create_validation(
+        QuickStartCreateRequest(
+            customer_id=customer.id,
+            validation_type="Erstvalidierung",
+        ),
+        examiner=admin,
+    )
+
+    assert created.customer_id == customer.id
+    assert created.location_id == location.id
+    assert created.contact_id == contact.id
+    assert created.device_id == device.id
+
+
+def test_quickstart_device_last_validation_returns_latest_completed_validation():
+    db = session()
+    customer, location, device = seed(db)
+    draft = valid_validation(customer, location, device)
+    draft.status = ValidationStatus.draft.value
+    completed = valid_validation(customer, location, device)
+    completed.report_number = "VAL-PAST"
+    completed.status = ValidationStatus.completed.value
+    completed.performed_on = date(2026, 1, 1)
+    db.add_all([draft, completed])
+    db.flush()
+
+    summary = QuickStartService(db).device_last_validation(device.id)
+
+    assert summary is not None
+    assert summary.report_number == "VAL-PAST"
+    assert summary.device_id == device.id
+
+
+def test_quickstart_revalidation_copies_structured_data_but_not_measurements():
+    db = session()
+    customer, location, device = seed(db)
+    admin = User(
+        email="revalidation-admin@schubamed.de",
+        first_name="Quickstart",
+        last_name="Admin",
+        role=UserRole.ADMIN.value,
+        password_hash="hash",
+        is_active=True,
+        must_change_password=False,
+    )
+    base = valid_validation(customer, location, device)
+    base.status = ValidationStatus.approved.value
+    base.documentation_checklist = [{"text": "Prüfung A", "value": "yes"}]
+    base.performance_checklist = [{"text": "Prüfung B", "value": "no"}]
+    base.programs = [{"name": "Vakuumtest", "selected": True}]
+    base.loading_patterns = [{"run": 1, "pattern": "Standard", "description": "Basis", "images": ["x"]}]
+    base.measurement_data = [{"field": "temperatur"}]
+    base.attachments = [{"filename": "bild.png"}]
+    db.add_all([admin, base])
+    db.flush()
+
+    created = QuickStartService(db).create_validation(
+        QuickStartCreateRequest(
+            customer_id=customer.id,
+            device_id=device.id,
+            validation_type="Revalidierung",
+        ),
+        examiner=admin,
+    )
+
+    assert created.previous_validation_id == base.id
+    assert created.version == 2
+    assert created.documentation_checklist == base.documentation_checklist
+    assert created.performance_checklist == base.performance_checklist
+    assert created.programs == base.programs
+    assert created.loading_patterns == base.loading_patterns
+    assert created.measurement_data == []
+    assert created.attachments == []
+
+
 def test_revalidation_date_uses_calendar_months():
     db = session()
     customer, location, device = seed(db)