diff --git a/docs/design/EPIC-001-First-Verified-Decision.md b/docs/design/EPIC-001-First-Verified-Decision.md index 4f0b9d274..4ab8c7b5a 100644 --- a/docs/design/EPIC-001-First-Verified-Decision.md +++ b/docs/design/EPIC-001-First-Verified-Decision.md @@ -35,6 +35,41 @@ If **no** on most questions — the feature waits. --- +## Vertical User Journey (Demo) + +The complete journey that can be demonstrated in minutes: + +``` +quiXzoom +↓ +Take photo or video +↓ +Mission Import +↓ +Raw Dataset saved +↓ +Dataset Explorer shows mission +↓ +AI creates Observation +↓ +User corrects if needed +↓ +Decision Case created +↓ +Decision Viewer shows: + Observation + ↓ + Evidence + ↓ + Finding + ↓ + Decision + ↓ + Business Impact +``` + +If this journey works, the core is proven. + ## Sprint Goal **Every sprint must result in more verified Decision Cases from real pilot missions.** @@ -45,27 +80,7 @@ Keep development close to user reality. Intelligence Lab grows from actual needs ## Stories -### Story 1: Session Management - -**As a** field engineer -**I want to** create and manage field sessions -**So that** missions are organized by location and date - -``` -Field Session -├── Location: Huddinge -├── Date: 2026-08-14 -└── Missions: [Mission-001, Mission-002, ...] -``` - -**Acceptance:** -- [ ] Create session with location and date -- [ ] List all sessions -- [ ] Open session to see missions - ---- - -### Story 2: Mission Import +### Story 1: Mission Import **As a** field engineer **I want to** upload mission data @@ -83,9 +98,11 @@ Raw Dataset (immutable, versioned) - [ ] Store raw data with checksum - [ ] Show upload progress and confirmation +**Why first:** Proves we can receive real data. + --- -### Story 3: Dataset Explorer +### Story 2: Dataset Explorer **As a** field engineer **I want to** browse and search missions @@ -105,9 +122,11 @@ Raw Dataset (immutable, versioned) - [ ] Search by metadata - [ ] Open mission detail view +**Why second:** Makes data visible and searchable. + --- -### Story 4: Annotation Workspace +### Story 3: Annotation Workspace **As a** field engineer **I want to** review and correct AI suggestions @@ -132,9 +151,11 @@ Version History - [ ] Save version history - [ ] Show before/after comparison +**Why third:** First human-in-the-loop. + --- -### Story 5: Decision Case +### Story 4: Decision Case **As a** field engineer **I want to** see the full decision chain @@ -161,9 +182,11 @@ Business Impact - [ ] Allow approval or rejection - [ ] Show explainability chain (clickable) +**Why fourth:** First verified decision. + --- -### Story 6: Replay +### Story 5: Replay **As a** field engineer **I want to** replay a mission @@ -188,8 +211,81 @@ Step 5: Business Impact - [ ] Show data at each stage - [ ] Navigate forward and backward +**Why fifth:** Proves the chain is reproducible. + --- +### Story 6: Session Management + +**As a** field engineer +**I want to** create and manage field sessions +**So that** missions are organized by location and date + +``` +Field Session +├── Location: Huddinge +├── Date: 2026-08-14 +└── Missions: [Mission-001, Mission-002, ...] +``` + +**Acceptance:** +- [ ] Create session with location and date +- [ ] List all sessions +- [ ] Open session to see missions + +**Why last:** Organizational layer on top of working core. + +--- + +## Golden Mission + +**A real mission that never changes, used as regression test.** + +``` +Golden Mission 001 +├── Location: Huddinge +├── Images: 52 +├── Videos: 4 +├── Observations: 31 +└── Verified Decision Cases: 8 +``` + +Every new model runs against the same mission. See immediately if something got better or worse. + +## Review (First-Class Object) + +Not just Annotation. Full quality flow: + +``` +Observation +↓ +AI +↓ +Human Review +↓ +Approved / Rejected / Needs More Evidence +``` + +Makes the entire quality flow traceable. + +## Dashboard v1 + +Extremely simple: + +``` +FIELD STATUS + +Sessions: 3 +Missions: 27 +Decision Cases: 11 +Pending Reviews: 6 +Verified Decisions: 8 + +[Continue Reviewing] +``` + +Should feel like a work tool, not a BI system. + ## Not in First Release Intentionally postponed: @@ -209,6 +305,14 @@ These are important but don't help reach the first verified workflow. --- +## Definition of "First Verified Decision" + +**A First Verified Decision is a Decision Case that:** +- Is built on real observation data +- Has been reviewed by a human +- Has a complete evidence chain +- Is fully reproducible from raw data to recommendation + ## Definition of Done (Epic) - [ ] A pilot can film a real object in quiXzoom @@ -220,6 +324,7 @@ These are important but don't help reach the first verified workflow. - [ ] Approve Decision Case - [ ] Everything saved versioned and traceable - [ ] At least 1 real Decision Case produced +- [ ] Meets "First Verified Decision" definition --- @@ -262,6 +367,7 @@ These are important but don't help reach the first verified workflow. | Version | Datum | Beskrivning | |---------|-------|-------------| | 1.0 | 2026-07-02 | Initial Epic-001 specification | +| 1.1 | 2026-07-02 | Reordered stories (Mission Import first, Session Management last), added Golden Mission, Review object, Dashboard v1, vertical user journey, First Verified Decision definition | ---