UI slog grinds on

docs/ui/entities/source/schema-mapping.md

@@ -32,7 +32,7 @@ This document uses three lenses:
 | filename | str | No | None | Shown read-only | Stored filename |
 | file_path | str | No | None | Usually hidden; preview uses path internally | Filesystem path |
 | raw_transcription | str | Yes | None | Shown indirectly or hidden | Immutable machine output context |
-| revised_text | str | Yes | None | Hidden in current simplified UI | Human-authored correction |
+| revised_text | str | Yes | None | Editable in Source detail | Human-authored correction |
 | date_uploaded | datetime | No | datetime.now(UTC) | Shown read-only | System-managed timestamp |
 | date_revised | datetime | Yes | None | Shown read-only | Set when revision is saved |
 
@@ -66,8 +66,8 @@ Current backend path: job create submit -> create_job_for_document()
 | Field | Current Value at Create | Source | Visible to User | Evidence |
 |---|---|---|---|---|
 | id | Generated UUID | System | No | Source model default in src/transcription/db/models.py |
-| document_id | Created Document id | Service | Indirectly | src/transcription/services/store.py |
-| page_number | 1 | Service default in upload flow | No | src/transcription/services/store.py |
+| document_id | Selected existing Document id | Job create selection + service write | Indirectly | src/transcription/ui/pages/jobs_page.py, src/transcription/services/store.py |
+| page_number | Sequential assignment based on existing max and alphabetical upload order | Service | No | src/transcription/services/store.py |
 | upload_name | original filename basename | User file name transformed by service | Indirectly | src/transcription/services/store.py |
 | filename | stored generated filename | Service | Indirectly | src/transcription/services/store.py |
 | file_path | stored path | Service | Indirectly | src/transcription/services/store.py |
@@ -78,11 +78,11 @@ Current backend path: job create submit -> create_job_for_document()
 
 ### 4.3 Gap to Target
 
-To satisfy intended Create flow, implementation must add:
+To satisfy intended Create flow, implementation now includes:
 1. multi-source and folder upload support in job create/configure flows
 2. deterministic page_number assignment from alphabetical original filename ordering
 3. enforced create-time Source-to-Document and Source-to-Job linkage invariants
-4. complete filename storage policy migration to UUID.extension only
+4. filename storage policy using UUID.extension
 
 ## 5. READ Mapping
 
@@ -96,33 +96,33 @@ On Source detail/list surfaces, users should be able to see:
 
 ### 5.2 Current Implementation
 
-Current Source reading is primarily embedded in a document-scoped source list and job create/navigation flow.
+Current Source reading is centered on dedicated Sources list/detail routes with optional document/job filtering.
 
 | Field | Current Rendering | Visible to User | Notes | Evidence |
 |---|---|---|---|---|
-| upload_name | Shown in document-scoped source list | Yes | Displayed in source list context | src/transcription/ui/pages/documents_page.py |
-| filename | Shown in document-scoped source list | Yes | Source metadata shown in list | src/transcription/ui/pages/documents_page.py |
-| file_path | Hidden from current simplified UI | No | Operational path remains internal | current UI pages |
-| page_number | Shown in document-scoped source list | Yes | Ordering visible in document source list | src/transcription/ui/pages/documents_page.py |
-| raw_transcription | Not shown in current simplified UI | No | Source preview/revision UI deferred | current UI pages |
-| revised_text | Not shown in current simplified UI | No | Source revision UI deferred | current UI pages |
-| date_uploaded | Not shown in current simplified UI | No | Operational metadata only | current UI pages |
-| date_revised | Not shown in current simplified UI | No | Operational metadata only | current UI pages |
+| upload_name | Shown in Sources list and Source detail | Yes | Displayed in source context | src/transcription/ui/pages/sources_page.py |
+| filename | Shown in Sources list and Source detail | Yes | Source metadata shown in list/detail | src/transcription/ui/pages/sources_page.py |
+| file_path | Hidden from direct text rendering | No | Used internally for preview rendering | src/transcription/ui/components/document_panzoom.py |
+| page_number | Shown in Sources list and Source detail | Yes | Ordering visible in filtered/global list | src/transcription/ui/pages/sources_page.py |
+| raw_transcription | Shown read-only in Source detail | Yes | Read from latest linked JobSource context | src/transcription/ui/pages/sources_page.py |
+| revised_text | Shown and editable in Source detail | Yes | Saved through revision action | src/transcription/ui/pages/sources_page.py |
+| date_uploaded | Shown in Source detail | Yes | Read-only metadata | src/transcription/ui/pages/sources_page.py |
+| date_revised | Shown in Source detail | Yes | Read-only metadata after revision save | src/transcription/ui/pages/sources_page.py |
 
 ### 5.3 Gap to Target
 
 To satisfy intended Read flow, implementation must add:
-1. richer source detail and revision surfaces if the review workflow returns later
-2. optional page-specific navigation if needed beyond the document-scoped list
+1. optional list filtering controls in-page (current filtering is URL/context based)
+2. optional page-specific navigation enhancements beyond current list/detail pattern
 
 ## 6. UPDATE Mapping
 
 ### 6.1 Intended Update Behavior
 
-Primary user update for Source is revised_text maintenance in the service layer; the current UI does not expose this flow.
+Primary user update for Source is revised_text maintenance in Source detail.
 
 Intended editable fields (first release):
-- revised_text, if the revision UI is restored later
+- revised_text
 
 Intended read-only fields (first release):
 - document_id
@@ -138,16 +138,15 @@ Intended read-only fields (first release):
 
 | Field | Updatable via UI | Updatable via Service | Notes |
 |---|---|---|---|
-| revised_text | No | Yes | Saved via TranscriptionService.upsert_revision_for_source(), but not exposed in current UI |
+| revised_text | Yes | Yes | Saved via TranscriptionService.upsert_revision_for_source() from Source detail |
 | date_revised | No | Yes | Set automatically on revision save |
 | other fields | No | Technically yes in service layer | No first-class UI editing flow |
 
 ### 6.3 Gap to Target
 
 Implementation should add in a later revision:
-1. explicit Source edit boundaries in dedicated Source UI
-2. validation and save UX for revisions in document-scoped source views
-3. optional future controls for page ordering and metadata corrections
+1. optional future controls for page ordering and metadata corrections
+2. revision history and conflict-resolution UX beyond single revised_text updates
 
 ## 7. DELETE Mapping
 
@@ -192,9 +191,10 @@ Schema and models:
 Current implementation:
 - src/transcription/services/store.py
 - src/transcription/services/transcription.py
+- src/transcription/ui/pages/sources_page.py
 - src/transcription/ui/pages/jobs_page.py
-- src/transcription/ui/components/transcript.py
-- src/transcription/ui/components/job_detail.py
+- src/transcription/ui/pages/documents_page.py
+- src/transcription/ui/components/document_panzoom.py
 
 Companion UX spec:
 - docs/ui/entities/source/user-journey.md
@@ -207,6 +207,6 @@ Acceptance checklist:
 - Every Source schema field appears in the field inventory.
 - Intended Create behavior matches the companion user journey.
 - Source create invariant requires both Document linkage and Job linkage at create time.
-- Current behavior reflects upload-centric and job-detail-centric implementation.
+- Current behavior reflects upload-centric create flow and dedicated Sources list/detail review flow.
 - Gaps between intended and current behavior are explicit.
 - Read, Update, and Delete sections distinguish target behavior from current code.