bbchops/transcription
1
0
Fork 0
generated from john/python-template
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

UI update planning complete

Browse Source
This commit is contained in:
Jim Lancaster
2026-08-02 11:33:19 -05:00
parent 5946867ff3
commit ed6f9dfe25
11 changed files with 456 additions and 60 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/ui/entities/source/user-journey.md
+12 -12
View File
@@ -61,11 +61,11 @@ The user wants to attach one or more files to a Document so each page can be pro
### 5.2 Create from Job Context
1. user starts from a job-creation or job-configuration flow
2. user can upload one or more files, or upload a whole folder
3. system creates Source rows linked to the selected Document
4. system creates JobSource links for the active Job as part of this flow
5. source creation fails if required Document or Job linkage cannot be established
1. The user starts from a job-creation or job-configuration flow
2. The user can upload one or more files, or upload a whole folder
3. The system creates Source rows linked to the selected Document
4. The system creates JobSource links for the active Job as part of this flow
5. Source creation fails if required Document or Job linkage cannot be established
### 5.3 Source Create Inputs
@@ -106,7 +106,7 @@ After successful source create:
1. Source is linked to the Document
2. Source appears in page order derived from alphabetical upload filename ordering
3. Source is linked to the Job through JobSource at create time
4. user can open preview and revision workflow
4. The user can open preview and revision workflow
### 5.8 Source Creation Invariant
@@ -135,13 +135,13 @@ The UI should show:
### 6.3 Read Empty and Missing States
If source is missing:
1. show clear not found or no source available messaging
1. Show clear not found or no source available messaging
If source has no revision:
1. show empty-state guidance and create-revision action
1. Show empty-state guidance and create-revision action
If source metadata is partially unavailable:
1. show fallback labels and keep preview and revision actions available where possible
1. Show fallback labels and keep preview and revision actions available where possible
## 7. Update Source Journey
@@ -175,9 +175,9 @@ On save:
### 7.4 Revision Failure Behavior
If save fails:
1. show clear error feedback
1. Show clear error feedback
2. keep user input where possible
3. allow retry
3. Allow retry
## 8. Delete Source Journey
@@ -197,7 +197,7 @@ Delete is blocked when:
When blocked:
1. explain dependency constraints
2. show cleanup guidance
2. Show cleanup guidance
When allowed:
1. confirm permanent removal