UI updates, changes sync'd to UI docs

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

@@ -31,8 +31,8 @@ This document uses three lenses:
 | upload_name | str | No | None | Shown read-only after upload | Original user-provided name |
 | 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 read-only | Immutable machine output context |
-| revised_text | str | Yes | None | Shown editable | Human-authored correction |
+| 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 |
 | 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 |
 
@@ -59,9 +59,9 @@ Success destination: source preview or revision flow in job detail context
 
 ### 4.2 Current Implementation
 
-Current entry point: upload page through create_upload_job()  
-Current user action: upload one file through upload flow  
-Current backend path: upload submit -> create_upload_job -> _create_upload_records
+Current entry point: Jobs page create flow  
+Current user action: upload one or more files or a folder through a single upload widget  
+Current backend path: job create submit -> create_job_for_document()
 
 | Field | Current Value at Create | Source | Visible to User | Evidence |
 |---|---|---|---|---|
@@ -96,34 +96,33 @@ On Source detail/list surfaces, users should be able to see:
 
 ### 5.2 Current Implementation
 
-Current Source reading is primarily embedded in job detail.
+Current Source reading is primarily embedded in a document-scoped source list and job create/navigation flow.
 
 | Field | Current Rendering | Visible to User | Notes | Evidence |
 |---|---|---|---|---|
-| upload_name | Shown in source-related UI | Yes | Displayed in job detail source context | src/transcription/ui/components/job_detail.py |
-| filename | Indirectly shown in jobs list/detail | Yes | Via Job.filename and source metadata | src/transcription/ui/components/table/jobs.py, src/transcription/ui/pages/jobs_page.py |
-| file_path | Used for preview rendering | Indirectly | Source preview in job detail page | src/transcription/ui/pages/jobs_page.py |
-| page_number | Not explicitly rendered in current jobs page flow | Limited | Ordering implicit via selected source | jobs page flow |
-| raw_transcription | Rendered from JobSource context | Yes | Original transcription card | src/transcription/ui/components/transcript.py |
-| revised_text | Rendered/editable in revision editor | Yes | Revision editor in job detail page | src/transcription/ui/pages/jobs_page.py |
-| date_uploaded | Limited visibility | Partial | Shown in some source metadata components | src/transcription/ui/components/job_detail.py |
-| date_revised | Indirect via revision row timestamp | Partial | Used in revision caption | src/transcription/ui/components/transcript.py |
+| 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 |
 
 ### 5.3 Gap to Target
 
 To satisfy intended Read flow, implementation must add:
-1. dedicated Source list and detail surfaces under Document context
-2. explicit page_number presentation and navigation
-3. clearer source metadata display independent of Job-centric pages
+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
 
 ## 6. UPDATE Mapping
 
 ### 6.1 Intended Update Behavior
 
-Primary user update for Source is revised_text maintenance.
+Primary user update for Source is revised_text maintenance in the service layer; the current UI does not expose this flow.
 
 Intended editable fields (first release):
-- revised_text
+- revised_text, if the revision UI is restored later
 
 Intended read-only fields (first release):
 - document_id
@@ -139,13 +138,13 @@ Intended read-only fields (first release):
 
 | Field | Updatable via UI | Updatable via Service | Notes |
 |---|---|---|---|
-| revised_text | Yes | Yes | Saved via TranscriptionService.upsert_revision_for_source() |
+| revised_text | No | Yes | Saved via TranscriptionService.upsert_revision_for_source(), but not exposed in current UI |
 | 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:
+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
@@ -154,7 +153,7 @@ Implementation should add:
 
 ### 7.1 Intended Delete Behavior
 
-Source deletion should include dependency-aware guardrails.
+Source deletion is deferred in the current UI.
 
 Rules:
 1. Deletion can proceed when policy allows cleanup of related JobSource records.
@@ -168,7 +167,7 @@ Rules:
 
 ### 7.3 Gap to Target
 
-Implementation must add:
+Implementation should add in a future revision:
 1. source delete controls in source/document context UI
 2. dependency checks for JobSource links
 3. blocked-delete messaging and cleanup path guidance