transcription/docs/index.md

Document Transcription System Overview (Current Baseline: V6.1)

This directory is the single source of truth for current V6.1 behavior and architecture.

Canonical Reading Order

1. System Architecture for runtime topology, boundaries, and lifecycle ownership.
2. System Requirements for verifiable current-state requirements.
3. Data Model for entities, constraints, and evidence persistence rules.
4. Error Handling Policy for category, translation, and retry behavior.

Cross-Version Invariants

• Historical Document Transcription Design Intent
• Transcription Methodology
• Error Handling
• Digital Evidence and AI Processing Provenance
• UI Style Guide

Deployment and Operations

• Production Runbook for deploy, rollback, and recovery.
• Backup and Restore for backup configuration and restore procedure.
• Data Migration for the SQLite to PostgreSQL migration path.
• Cloudflare Tunnel and Access for remote exposure and access control.

Baseline Statement

The current V6.1 baseline includes behavior delivered through the architectural cleanup phases and person-schema redesign (through V5.1), the V6.0 hosting migration to a containerized PostgreSQL deployment, and the V6.1 navigation, Document Detail, and worker-backed maintenance refinements. Use this docs/* canonical set for active design and implementation decisions.

Every canonical document above states this same baseline; tests/test_meta_contract_guards.py fails if one of them falls behind. Forward-looking work is tracked in roadmap_plan.md and is not part of the baseline.