generated from john/python-template
gpt-5.3-codex review phase 1 - Flatten the documentation
Quality Gate / gate (push) Successful in 33s
Quality Gate / gate (push) Successful in 33s
This commit is contained in:
+10
-18
@@ -1,13 +1,14 @@
|
||||
# Document Transcription System Overview (Version 4)
|
||||
|
||||
Version 4 is the architecture baseline for the personal-scale application used to transcribe, organize, and preserve historical documents, source images, and related people records.
|
||||
This directory is the single source of truth for current V4 behavior and architecture.
|
||||
|
||||
## Recommended Reading Order
|
||||
## Canonical Reading Order
|
||||
|
||||
1. [System Architecture](architecture_v4.md) for capabilities, technical stack, runtime structure, workflows, and component ownership.
|
||||
2. [System Requirements](requirements_v4.md) for the verifiable V4 contract.
|
||||
3. [Data Model](schema_v4.md) for entities, relationships, constraints, and persistence rules.
|
||||
4. [Error Handling Policy](error_handling_v4.md) for the V4 taxonomy and boundary contracts.
|
||||
1. [System Architecture](architecture_v4.md) for runtime topology, boundaries, and lifecycle ownership.
|
||||
2. [System Requirements](requirements_v4.md) for verifiable current-state requirements.
|
||||
3. [Data Model](schema_v4.md) for entities, constraints, and evidence persistence rules.
|
||||
4. [Error Handling Policy](error_handling_v4.md) for category, translation, and retry behavior.
|
||||
5. [V4 Revision History](history.md) for superseded scope and implementation documents.
|
||||
|
||||
## Cross-Version Invariants
|
||||
|
||||
@@ -17,16 +18,7 @@ Version 4 is the architecture baseline for the personal-scale application used t
|
||||
- [Digital Evidence and AI Processing Provenance](../invariant/ai_evidence_and_provenance.md)
|
||||
- [UI Style Guide](../invariant/ui_style_guide.md)
|
||||
|
||||
## V4 Transition Documents
|
||||
## Baseline Statement
|
||||
|
||||
- [Scope Boundary](scope_boundary_v4.md)
|
||||
- [Implementation Plan](implementation_plan_v4.md)
|
||||
|
||||
## Incremental Revisions
|
||||
|
||||
- [V4.1 Scope](../ver4.1/scope_boundary_v4_1.md) and [Implementation Plan](../ver4.1/implementation_plan_v4_1.md)
|
||||
- [V4.2 Evidence and Provenance Scope](../ver4.2/scope_boundary_v4_2.md) and [Implementation Plan](../ver4.2/implementation_plan_v4_2.md)
|
||||
- [V4.3 Settings Scope](../ver4.3/scope_boundary_v4_3.md) and [Implementation Plan](../ver4.3/implementation_plan_v4_3.md)
|
||||
- [V4.4 Semantic Registries, Linked People, and Printing Scope](../ver4.4/scope_boundary_v4_4.md) and [Implementation Plan](../ver4.4/implementation_plan_v4_4.md)
|
||||
- [V4.5 Transcription Input Normalization and Quality Scope](../ver4.5/scope_boundary_v4_5.md) and [Implementation Plan](../ver4.5/implementation_plan_v4_5.md)
|
||||
- [V4.6 Architecture Conformance and Reliability Scope](../ver4.6/scope_boundary_v4_6.md) and [Implementation Plan](../ver4.6/implementation_plan_v4_6.md)
|
||||
The current V4 baseline includes behavior delivered through V4.7 architectural cleanup.
|
||||
Versioned V4.x scope and implementation documents are retained as historical records only at git tag `docs-v4x-archive` and do not define active contracts.
|
||||
|
||||
Reference in New Issue
Block a user