transcription/docs/ver1/traceability_v1.md

V1 Traceability Matrix

This matrix provides implementation and validation evidence for V1 requirements (REQ-0 through REQ-13).

Status values:

• done: implemented and evidence recorded
• in progress: partially implemented or evidence incomplete
• not started: no implementation/evidence yet

Requirement Evidence Table

Requirement	Status	Implementation Evidence	Validation Evidence
REQ-0	done	End-to-end upload + worker pipeline in src/transcription/services/store.py, src/transcription/worker.py, src/transcription/services/workflows.py	tests/integration/test_pipeline_flow.py
REQ-1	done	Upload UI/page flow in src/transcription/ui/pages/upload_page.py, src/transcription/ui/components/upload.py	tests/ui/test_upload_page.py, tests/integration/test_pipeline_flow.py
REQ-2	done	Async worker execution and provider call orchestration in src/transcription/worker.py, src/transcription/services/workflows.py	tests/integration/test_pipeline_flow.py, tests/services/test_workflows_reliability.py
REQ-3	done	Job lifecycle state model + transitions in src/transcription/models.py, src/transcription/services/jobs.py, src/transcription/services/workflows.py	tests/services/test_job_service.py, tests/ui/test_jobs_page.py
REQ-4	done	Persistence of original output and failure detail in src/transcription/services/transcription.py, src/transcription/services/workflows.py	tests/integration/test_pipeline_flow.py, tests/services/test_workflows_reliability.py
REQ-5	done	Status/result inspection via UI pages and API health route in src/transcription/ui/pages/jobs_page.py, src/transcription/api/health.py	tests/ui/test_jobs_page.py, tests/ui/test_pages_registration.py, tests/api/test_health.py
REQ-6	done	Background processing trigger/worker notifier and non-blocking workflow in src/transcription/ui/components/upload.py, src/transcription/worker.py	tests/test_app.py, tests/services/test_workflows_reliability.py
REQ-7	done	Lifespan-owned runtime resources in src/transcription/app.py, src/transcription/db/runtime.py	tests/test_app.py, tests/test_db.py
REQ-8	done	Centralized settings/logging initialization in src/transcription/config.py, src/transcription/app.py	tests/test_config.py, tests/test_app.py
REQ-9	done	Containerized runtime baseline in docker-compose.yml, Dockerfile	release_checklist_v1.md (Ops checklist), manual demonstration step
REQ-10	done	Explicit schema bootstrap policy + runtime controls in src/transcription/config.py, src/transcription/app.py, src/transcription/db/operations.py	tests/test_db.py, tests/test_config.py
REQ-11	done	Service/workflow persistence boundaries in src/transcription/services/*.py, src/transcription/services/workflows.py	tests/services/test_job_service.py, tests/services/test_transcription_service.py
REQ-12	done	Prompt artifacts in prompts/ and loading/validation in src/transcription/services/transcription.py	tests/test_prompts.py
REQ-13	done	Optional single revision create/update/view/delete in src/transcription/services/transcription.py, src/transcription/ui/pages/jobs_page.py	tests/services/test_transcription_service.py, tests/ui/test_jobs_page.py

Operational Evidence (Step 3 Artifacts)

• Runbook: runbook_v1.md
• Migration/backfill/rollback guidance: migration_v1.md
• Release readiness checklist: release_checklist_v1.md

Verification Cadence

• Per change: maintain tests/test_traceability.py mappings for touched requirements.
• Per milestone: update this table status and evidence links.
• Pre-release: confirm all rows are done and non-external suite is green.