• SRS-001

  reviewed 1. First-launch database initialisation UID: SRS-001 RELATIONS (Child):

  • IT-001 First-launch DB initialisation (verifies)
  • ST-001 Local clinic visible in Patients menu (verifies)

  STATEMENT:

  On first launch, when no database file exists at the configured application data path, the system shall create the local database, apply the current schema version, and create a default local clinic record that serves as the container for locally-created patient records.

  RATIONALE:

  The initialisation establishes the minimum persistent state required for any subsequent clinical operation — without it, patient records cannot be stored and recording sessions cannot be attached to a patient.

  TYPE:

  functional

  ACTIVE:

  true

  REVIEWED_HASH:

  73a53a6ea2b4546ac329d96363bd39c5485b220a390076754e0ecc52644acf7b

  REVIEWED_BY:

  @DougYoungberg

  NOTES:

  coverage-plan: ST on clean install — fresh workstation, first launch, verify the database file exists at the expected path.

ST-001

reviewedPassed 1. Local clinic visible in Patients menu UID: ST-001 RELATIONS (Parent):

• SRS-001 First-launch database initialisation (verifies)

STATEMENT:

With the application launched on a workstation that has no pre-existing BioFlow data directory, navigate to the Patients menu and open the clinics dropdown. The local clinic entry shall be visible in the dropdown.

TEST_METHOD:

automated

TEST_TOOL:

VisionTrace

ACCEPTANCE_CRITERIA:

Preconditions: application is launched on a clean workstation (no prior data directory); the main screen is visible. Steps: navigate to the Patients menu; open the clinics dropdown. Verification: a VisionTrace AI agent.verify(...) call confirms the local clinic is visible in the dropdown. No error dialog appears during launch or navigation.

ACTIVE:

true

REVIEWED_HASH:

e9d48e5587c7b709d4a995e682d3054cf55a5cab9240ad3b468778b91a742eec

REVIEWED_BY:

@DougYoungberg

NOTES:

Launching the application on a clean workstation is a test precondition handled by the VisionTrace app_session fixture, not a step in the test body. Test code lives in this repo at visiontrace_tests/bioflow/st001/, decorated with @visiontrace_test_case("ST-001"). The agent.verify(...) call takes a screenshot of the current UI and asks an AI model to confirm the described condition — for this test, that the local clinic is present in the dropdown. Running this test in CI requires VisionTrace to be installed in the CI environment and a Windows runner with a usable desktop session.