docs: Epic-001 v1.1 — Reordered stories + Golden Mission + Review + Dashboard

- Reordered stories to reach First Verified Decision faster:
  1. Mission Import (was 2) — proves we can receive real data
  2. Dataset Explorer (was 3) — makes data visible
  3. Annotation Workspace (was 4) — first human-in-the-loop
  4. Decision Case (was 5) — first verified decision
  5. Replay (was 6) — proves chain is reproducible
  6. Session Management (was 1) — organizes when core works

- Added Golden Mission concept:
  - Real mission that never changes, used as regression test
  - Every new model runs against same mission
  - See immediately if something got better or worse

- Added Review as first-class object:
  - Observation → AI → Human Review → Approved/Rejected/Needs More Evidence
  - Makes entire quality flow traceable

- Added Dashboard v1:
  - Sessions, Missions, Decision Cases, Pending Reviews, Verified Decisions
  - Big button: [Continue Reviewing]
  - Work tool, not BI system

- Added vertical user journey (demo script):
  - quiXzoom → photo → import → save → explore → AI observation →
    correction → Decision Case → full chain viewer
  - If this works, core is proven

- Added definition of 'First Verified Decision':
  - Built on real observation data
  - Reviewed by human
  - Complete evidence chain
  - Fully reproducible from raw data to recommendation

Rationale: Reach core proof faster, add organization later.
Golden Mission enables regression testing from day one.
Review object makes quality flow traceable.
This commit is contained in:
Bernt
2026-07-02 13:38:09 +00:00
parent c47a58f76b
commit 9e4ebeea1a
+131 -25
View File
@@ -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 ## Sprint Goal
**Every sprint must result in more verified Decision Cases from real pilot missions.** **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 ## Stories
### Story 1: Session Management ### Story 1: Mission Import
**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
**As a** field engineer **As a** field engineer
**I want to** upload mission data **I want to** upload mission data
@@ -83,9 +98,11 @@ Raw Dataset (immutable, versioned)
- [ ] Store raw data with checksum - [ ] Store raw data with checksum
- [ ] Show upload progress and confirmation - [ ] 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 **As a** field engineer
**I want to** browse and search missions **I want to** browse and search missions
@@ -105,9 +122,11 @@ Raw Dataset (immutable, versioned)
- [ ] Search by metadata - [ ] Search by metadata
- [ ] Open mission detail view - [ ] Open mission detail view
**Why second:** Makes data visible and searchable.
--- ---
### Story 4: Annotation Workspace ### Story 3: Annotation Workspace
**As a** field engineer **As a** field engineer
**I want to** review and correct AI suggestions **I want to** review and correct AI suggestions
@@ -132,9 +151,11 @@ Version History
- [ ] Save version history - [ ] Save version history
- [ ] Show before/after comparison - [ ] Show before/after comparison
**Why third:** First human-in-the-loop.
--- ---
### Story 5: Decision Case ### Story 4: Decision Case
**As a** field engineer **As a** field engineer
**I want to** see the full decision chain **I want to** see the full decision chain
@@ -161,9 +182,11 @@ Business Impact
- [ ] Allow approval or rejection - [ ] Allow approval or rejection
- [ ] Show explainability chain (clickable) - [ ] Show explainability chain (clickable)
**Why fourth:** First verified decision.
--- ---
### Story 6: Replay ### Story 5: Replay
**As a** field engineer **As a** field engineer
**I want to** replay a mission **I want to** replay a mission
@@ -188,8 +211,81 @@ Step 5: Business Impact
- [ ] Show data at each stage - [ ] Show data at each stage
- [ ] Navigate forward and backward - [ ] 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 ## Not in First Release
Intentionally postponed: 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) ## Definition of Done (Epic)
- [ ] A pilot can film a real object in quiXzoom - [ ] 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 - [ ] Approve Decision Case
- [ ] Everything saved versioned and traceable - [ ] Everything saved versioned and traceable
- [ ] At least 1 real Decision Case produced - [ ] 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 | | Version | Datum | Beskrivning |
|---------|-------|-------------| |---------|-------|-------------|
| 1.0 | 2026-07-02 | Initial Epic-001 specification | | 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 |
--- ---