Merge branch 'session-engine' of https://gitea.john-stream.com/bbchops/transcription into session-engine

docs/architecture_v2.md

@@ -59,7 +59,7 @@ Responsibilities:
 
 ### Domain & Service Layer
 
-* `src/transcription/models/*.py` (Pydantic V2 schemas and entity definitions)
+* `src/transcription/db/models.py` (SQLModel/Pydantic V2 schema definitions for the current implementation)
 * `src/transcription/services/*.py` (Transactional operations for `Document`, `Person`, `Source`, `Job`, and `JobSource`)
 
 ### Infrastructure Layer
@@ -121,14 +121,14 @@ Responsibilities:
 
 ## Related Local References
 
-- [System Overview](index_v1.md)
-- [System Design Intent](intent.md)
-- [Transcription Methodology](transcription_methodology.md)
+- [System Overview](index_v2.md)
+- [System Design Intent](invariant/intent.md)
+- [Transcription Methodology](invariant/transcription_methodology.md)
 - System Architecture (this document)
-- [System Requirements](requirements_v1.md)
-- [Data model](schema_v1.md)
-- [Error Handling Policy](error_handling_v1.md)
-- [Implementation Plan](implementation_plan_v1.md)
+- [System Requirements](requirements_v2.md)
+- [Data model](schema_v2.md)
+- [Error Handling Policy](error_handling_v2.md)
+- [Implementation Plan](implementation_plan_v2.md)
 
 
 

docs/error_handling_v2.md

@@ -79,8 +79,8 @@ HTTP Status Mappings:
 ## Related Local References
 
 - [System Overview](index_v2.md)
-- [System Design Intent](intent.md)
-- [Transcription Methodology](transcription_methodology.md)
+- [System Design Intent](invariant/intent.md)
+- [Transcription Methodology](invariant/transcription_methodology.md)
 - [System Architecture](architecture_v2.md)
 - [System Requirements](requirements_v2.md)
 - [Data model](schema_v2.md)

docs/implementation_plan_v2.md

@@ -22,7 +22,7 @@ Use a fresh database. There will be no migrations, data conversion, legacy compa
 - Remove `Revision`, `Source.job_id`, and the transcription fields that no longer belong on `Job`.
 - Keep `create_all()` as the schema bootstrap for a fresh database.
 - Delete `_ensure_sqlite_compat_columns()` and all schema patching from `src/transcription/db/operations.py`.
-- Keep the Python models, `docs/schema_v2.md`, and `docs/ddl_v2.sql` consistent.
+- Keep the Python models and `docs/schema_v2.md` consistent.
 
 ### 2. Align the async CRUD methods
 

docs/index_v2.md

@@ -38,8 +38,8 @@ Read [architecture_v2.md](architecture_v2.md) first for technical overview and s
 ## Documentation Index
 
 - System Overview (this document)
-- [System Design Intent](intent.md)
-- [Transcription Methodology](transcription_methodology.md)
+- [System Design Intent](invariant/intent.md)
+- [Transcription Methodology](invariant/transcription_methodology.md)
 - [System Architecture](architecture_v2.md)
 - [System Requirements](requirements_v2.md)
 - [Data model](schema_v2.md)

docs/requirements_v2.md

@@ -31,8 +31,8 @@ This document captures the **Version 2 baseline requirements** for the productio
 ## Related Local References
 
 - [System Overview](index_v2.md)
-- [System Design Intent](intent.md)
-- [Transcription Methodology](transcription_methodology.md)
+- [System Design Intent](invariant/intent.md)
+- [Transcription Methodology](invariant/transcription_methodology.md)
 - [System Architecture](architecture_v2.md)
 - System Requirements (this document)
 - [Data model](schema_v2.md)

docs/schema_v2.md

@@ -126,8 +126,8 @@ erDiagram
 ## Related Local References
 
 - [System Overview](index_v2.md)
-- [System Design Intent](intent.md)
-- [Transcription Methodology](transcription_methodology.md)
+- [System Design Intent](invariant/intent.md)
+- [Transcription Methodology](invariant/transcription_methodology.md)
 - [System Architecture](architecture_v2.md)
 - [System Requirements](requirements_v2.md)
 - Data model (this document)