feat: complete E2.S5 Input → Block wiring

- Implementeer handleSubmit met API call naar /api/intent/classify - Voeg error handling en fallback naar dagnotitie toe - Integreer openBlock en addRecentAction - Update bouwplan: Epic 2 compleet (33 SP done, 46%)
2025-12-24 08:44:40 +01:00
parent db036a3d92
commit 3e94271827
7 changed files with 3449 additions and 5 deletions
--- a/docs/swift/bouwplan-swift-v2.md
+++ b/docs/swift/bouwplan-swift-v2.md
@@ -0,0 +1,658 @@
+# Mission Control — Bouwplan Swift v2.0
+
+**Projectnaam:** Swift — Contextual UI EPD
+**Versie:** v2.0
+**Datum:** 24-12-2024
+**Auteur:** Colin Lit / Development Team
+
+---
+
+## Changelog v2.0
+
+> **Belangrijke wijzigingen t.o.v. v1.5:**
+> - E3.S0 toegevoegd: CanvasArea block rendering (kritieke blokkade)
+> - Technische debt sectie toegevoegd (type duplicatie, keyboard shortcuts)
+> - Diagnostiek Workflow als uitbreiding opgenomen
+> - Sprint planning aangepast aan huidige voortgang
+> - Totalen bijgewerkt: 29 stories, 72 SP
+
+---
+
+## 1. Doel en context
+
+### 1.1 Projectdoel
+
+Swift is een **Contextual UI** interface voor het Mini-EPD systeem. In plaats van navigatie door menu's spreekt of typt de gebruiker een intentie — en het juiste UI-blok verschijnt voorgevuld met relevante data.
+
+**Kernbelofte:**
+> Van 12 klikken en 3 minuten naar 1 zin en 15 seconden.
+
+### 1.2 Business Case
+
+| Metric | Huidig | Met Swift | Besparing |
+|--------|--------|-----------|-----------|
+| Dagnotitie maken | 3-5 min | 15 sec | 95% |
+| Patiënt zoeken | 1-2 min | 5 sec | 95% |
+| Overdracht maken | 20-30 min | 5 min | 80% |
+| Rapportage schrijven | 8-15 min | 2-3 min | 75% |
+
+**Per verpleegkundige per dag: ~4 uur terug naar zorg**
+
+### 1.3 Relatie met Documentatie
+
+| Document | Beschrijft | Locatie |
+|----------|------------|---------|
+| PRD | Product visie, requirements | `swift-prd.md` |
+| FO | Functionele flows, blocks | `swift-fo-ai.md` |
+| TO | Technische architectuur | `to-swift-v1.md` |
+| UX | Visuele specificaties | `swift-ux-v2.1.md` |
+| **Diagnostiek FO** | Behandelaar workflow | `swift-fo-diagnostiek-workflow.md` |
+| **Diagnostiek Bouwplan** | Uitbreiding voor behandelaars | `bouwplan-swift-diagnostiek-workflow.md` |
+
+---
+
+## 2. Uitgangspunten
+
+### 2.1 Technische Stack
+
+**Bestaand (hergebruiken):**
+| Component | Technologie | Versie |
+|-----------|-------------|--------|
+| Framework | Next.js | 14.2.18 |
+| UI Library | React | 18.3.1 |
+| Styling | TailwindCSS | 3.4.18 |
+| Components | shadcn/ui | - |
+| Command Palette | cmdk | 1.1.1 |
+| Animations | framer-motion | 12.23.24 |
+| Database | Supabase | 2.81.1 |
+| Speech-to-Text | Deepgram | 4.11.2 |
+| AI | Claude API | - |
+| Validation | Zod | 4.1.12 |
+| Forms | react-hook-form | 7.66.1 |
+
+**Nieuw toegevoegd:**
+| Component | Technologie | Versie | Status |
+|-----------|-------------|--------|--------|
+| State Management | Zustand | 5.0.9 | ✅ Geïnstalleerd |
+
+### 2.2 Projectkaders
+
+| Kader | Waarde |
+|-------|--------|
+| **Bouwtijd** | 4 weken (4 sprints) |
+| **Team** | 1 developer |
+| **Scope** | MVP: P1 blocks (dagnotitie, zoeken, overdracht) |
+| **Uitbreiding** | Diagnostiek workflow (optioneel, +22 SP) |
+| **Data** | Bestaande Supabase database |
+| **Doel** | Werkende demo + user testing |
+
+### 2.3 Programmeer Uitgangspunten
+
+**Code Quality Principles:**
+
+- **DRY (Don't Repeat Yourself)**
+  - Herbruikbare block componenten
+  - Centrale intent classificatie logica
+  - Shared hooks voor common patterns
+  - **Let op:** Types importeren uit `lib/swift/types.ts`, niet dupliceren
+
+- **KISS (Keep It Simple, Stupid)**
+  - Local-first intent classificatie (regex)
+  - AI alleen als fallback
+  - Minimale state complexity
+
+- **SOC (Separation of Concerns)**
+  - UI blocks gescheiden van intent logic
+  - API routes gescheiden van business logic
+  - Store slices per domein
+
+- **YAGNI (You Aren't Gonna Need It)**
+  - Alleen P1 blocks in MVP
+  - Geen toggle tussen interfaces
+  - Geen advanced analytics in v1
+
+**Development Practices:**
+
+```typescript
+// ✅ Goede structuur voor Swift components
+components/
+├── swift/
+│   ├── command-center/
+│   │   ├── command-center.tsx      // Main container
+│   │   ├── command-input.tsx       // Input component
+│   │   ├── canvas-area.tsx         // Block rendering ← KRITIEK
+│   │   └── index.ts                // Barrel export
+│   └── blocks/
+│       ├── block-container.tsx     // Wrapper met animaties
+│       ├── dagnotitie-block.tsx
+│       ├── zoeken-block.tsx
+│       ├── overdracht-block.tsx
+│       └── index.ts
+
+// ✅ Store importeert types (geen duplicatie)
+stores/
+└── swift-store.ts                   // Importeert uit lib/swift/types.ts
+
+// ✅ Intent classification
+lib/
+└── swift/
+    ├── types.ts                     // SINGLE SOURCE OF TRUTH voor types
+    ├── intent-classifier.ts         // Local classification
+    ├── intent-classifier-ai.ts      // AI fallback
+    └── entity-extractor.ts          // Entity parsing
+```
+
+---
+
+## 3. Epics & Stories Overzicht
+
+| Epic ID | Titel | Doel | Status | Stories | Effort |
+|---------|-------|------|--------|---------|--------|
+| E0 | Setup & Foundation | Zustand, routing, base layout | ✅ Done | 4 | 8 SP |
+| E1 | Command Center | Input, voice, context bar | ✅ Done | 5 | 13 SP |
+| E2 | Intent Classification | Local + AI fallback + wiring | ✅ Done | 5 | 12 SP |
+| E3 | P1 Blocks | Dagnotitie, Zoeken, Overdracht | ⏳ To Do | 7 | 23 SP |
+| E4 | Navigation & Auth | Login keuze, routing, preferences | ⏳ To Do | 4 | 8 SP |
+| E5 | Polish & Testing | Animaties, error handling, tests | ⏳ To Do | 4 | 8 SP |
+
+**Totaal: 29 stories, 72 story points**
+
+| Categorie | SP |
+|-----------|----:|
+| ✅ Done (E0 + E1 + E2) | 33 |
+| ⏳ Remaining | 39 |
+
+**Belangrijk:**
+- Bouw per epic en per story, niet alles tegelijk
+- Dependencies installeren: eerst aan Colin melden
+- Database migraties: eerst aan Colin melden
+
+---
+
+## 4. Epics & Stories (Uitwerking)
+
+### Epic 0 — Setup & Foundation ✅ DONE
+**Epic Doel:** Werkende development omgeving met Zustand store en Swift routing.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afh. | SP |
+|----------|--------------|---------------------|--------|------|----|
+| E0.S1 | Zustand installeren | `pnpm add zustand` succesvol, import werkt | ✅ | — | 1 |
+| E0.S2 | Swift store opzetten | `stores/swift-store.ts` met basis state | ✅ | E0.S1 | 2 |
+| E0.S3 | Swift route aanmaken | `/epd/swift` route met eigen layout | ✅ | E0.S2 | 2 |
+| E0.S4 | Swift folder structuur | `components/swift/`, `lib/swift/` aangemaakt | ✅ | E0.S3 | 3 |
+
+---
+
+### Epic 1 — Command Center ✅ DONE
+**Epic Doel:** Werkende command center met tekst en voice input.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afh. | SP |
+|----------|--------------|---------------------|--------|------|----|
+| E1.S1 | Command Center layout | 4-zone layout (context, canvas, recent, input), keyboard shortcuts (⌘K, Escape) | ✅ | E0.S4 | 3 |
+| E1.S2 | Context Bar | Dienst indicator, patiënt chip, user info | ✅ | E1.S1 | 2 |
+| E1.S3 | Command Input | Tekst input met placeholder, focus state, send button | ✅ | E1.S1 | 2 |
+| E1.S4 | Voice Input integratie | Deepgram streaming, waveform visualisatie | ✅ | E1.S3 | 3 |
+| E1.S5 | Recent Strip | Laatste 5 acties als chips, click-to-repeat | ✅ | E1.S1 | 3 |
+
+**Technical Notes:**
+```
+Command Center Layout:
+┌─────────────────────────────────────────┐
+│ Context Bar (48px)                       │
+├─────────────────────────────────────────┤
+│                                         │
+│ Canvas Area (flex) ← Blocks hier        │
+│                                         │
+├─────────────────────────────────────────┤
+│ Recent Strip (48px)                     │
+├─────────────────────────────────────────┤
+│ Command Input (64px, fixed bottom)      │
+└─────────────────────────────────────────┘
+```
+
+---
+
+### Epic 2 — Intent Classification ✅ DONE
+**Epic Doel:** Two-tier intent classificatie (local + AI fallback) + wiring naar blocks.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afh. | SP |
+|----------|--------------|---------------------|--------|------|----|
+| E2.S1 | Local classifier | Regex patterns voor P1 intents, <50ms | ✅ | E0.S4 | 3 |
+| E2.S2 | Entity extraction | Patient naam, categorie uit input | ✅ | E2.S1 | 3 |
+| E2.S3 | AI fallback | Claude Haiku bij confidence <0.8 | ✅ | E2.S2 | 2 |
+| E2.S4 | Intent API route | POST /api/intent/classify met logging | ✅ | E2.S3 | 2 |
+| E2.S5 | Input → Block wiring | CommandInput.handleSubmit → API → openBlock | ✅ | E2.S4 | 2 |
+
+**E2.S5 Technical Notes (✅ GEÏMPLEMENTEERD):**
+```typescript
+// components/swift/command-center/command-input.tsx
+// IMPLEMENTATIE:
+const handleSubmit = async (e: React.FormEvent) => {
+  e.preventDefault();
+  if (!hasValue || isProcessing) return;
+  
+  const inputText = inputValue.trim();
+  setIsProcessing(true);
+  
+  try {
+    const response = await fetch('/api/intent/classify', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ input: inputText }),
+    });
+    
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({ error: 'Onbekende fout' }));
+      throw new Error(errorData.error || `HTTP ${response.status}`);
+    }
+    
+    const { intent, confidence, entities } = await response.json();
+    
+    if (intent !== 'unknown' && confidence >= 0.5) {
+      openBlock(intent as BlockType, entities);
+      addRecentAction({ intent, label: inputText.slice(0, 50), patientName: entities.patientName });
+      clearInput();
+    } else {
+      // Tijdelijke fallback naar dagnotitie (wordt vervangen door FallbackPicker in E4.S4)
+      openBlock('dagnotitie', { content: inputText });
+      addRecentAction({ intent: 'dagnotitie', label: inputText.slice(0, 50) });
+      clearInput();
+    }
+  } catch (error) {
+    // Error handling met fallback naar dagnotitie
+    openBlock('dagnotitie', { content: inputText });
+    addRecentAction({ intent: 'dagnotitie', label: inputText.slice(0, 50) });
+    clearInput();
+  } finally {
+    setIsProcessing(false);
+  }
+};
+```
+
+---
+
+### Epic 3 — P1 Blocks ⏳ TO DO
+**Epic Doel:** Werkende DagnotatieBlock, ZoekenBlock en OverdrachtBlock.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afh. | SP |
+|----------|--------------|---------------------|--------|------|----|
+| E3.S0 | CanvasArea block rendering | Switch/case voor block types, prefill doorgeven | ⏳ | E2.S5 | 2 |
+| E3.S1 | Block Container | Animatie wrapper, close button, sizes | ⏳ | E1.S1 | 2 |
+| E3.S2 | DagnotatieBlock | Patient, categorie, tekst, opslaan naar /api/reports | ⏳ | E3.S0, E3.S1 | 5 |
+| E3.S3 | Patient search API | GET /api/patients/search?q= fuzzy search | ⏳ | E0.S4 | 3 |
+| E3.S4 | ZoekenBlock | Input, resultaten, selectie → store | ⏳ | E3.S0, E3.S3 | 3 |
+| E3.S5 | PatientContextCard | Na selectie: notities, vitals, diagnose | ⏳ | E3.S4 | 5 |
+| E3.S6 | OverdrachtBlock | AI samenvatting per patiënt (bestaande API) | ⏳ | E3.S0 | 3 |
+
+**E3.S0 Technical Notes (KRITIEK - NIEUW):**
+```typescript
+// components/swift/command-center/canvas-area.tsx
+// HUIDIGE SITUATIE (placeholder):
+{activeBlock ? (
+  <div className="text-slate-400">Block: {activeBlock}</div>
+) : (
+  <EmptyState />
+)}
+
+// MOET WORDEN:
+import { DagnotatieBlock } from '../blocks/dagnotitie-block';
+import { ZoekenBlock } from '../blocks/zoeken-block';
+import { OverdrachtBlock } from '../blocks/overdracht-block';
+
+function renderBlock(activeBlock: BlockType, prefillData: BlockPrefillData) {
+  switch (activeBlock) {
+    case 'dagnotitie':
+      return <DagnotatieBlock prefill={prefillData} />;
+    case 'zoeken':
+      return <ZoekenBlock prefill={prefillData} />;
+    case 'overdracht':
+      return <OverdrachtBlock prefill={prefillData} />;
+    default:
+      return <EmptyState />;
+  }
+}
+
+// In CanvasArea:
+{activeBlock ? (
+  <AnimatePresence mode="wait">
+    <motion.div key={activeBlock} {...blockAnimations}>
+      {renderBlock(activeBlock, prefillData)}
+    </motion.div>
+  </AnimatePresence>
+) : (
+  <EmptyState />
+)}
+```
+
+**E3.S2 Technical Notes:**
+```typescript
+// components/swift/blocks/dagnotitie-block.tsx
+interface DagnotitieBlockProps {
+  prefill?: {
+    patientId?: string;
+    patientName?: string;
+    category?: VerpleegkundigCategory;
+    content?: string;
+  };
+}
+
+// 1. Patient lookup: patientName → patientId via E3.S3 API
+// 2. Category selector: medicatie | adl | gedrag | incident | observatie
+// 3. Tekst input: textarea of rich editor
+// 4. Opslaan: POST /api/reports met type 'verpleegkundig'
+```
+
+---
+
+### Epic 4 — Navigation & Auth ⏳ TO DO
+**Epic Doel:** Login pagina met interface keuze, routing naar Swift/Klassiek.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afh. | SP |
+|----------|--------------|---------------------|--------|------|----|
+| E4.S1 | Login form uitbreiden | Interface selector (Swift/Klassiek) | ⏳ | E0.S3 | 2 |
+| E4.S2 | Preference opslag | user_metadata.preferred_interface | ⏳ | E4.S1 | 2 |
+| E4.S3 | Redirect middleware | /epd → preference route | ⏳ | E4.S2 | 2 |
+| E4.S4 | Fallback Picker | Visuele keuze bij lage confidence | ⏳ | E3.S0 | 2 |
+
+---
+
+### Epic 5 — Polish & Testing ⏳ TO DO
+**Epic Doel:** Gepolijste UX met animaties, error handling en tests.
+
+| Story ID | Beschrijving | Acceptatiecriteria | Status | Afh. | SP |
+|----------|--------------|---------------------|--------|------|----|
+| E5.S1 | Block animaties | Slide up/down met framer-motion | ⏳ | E3.S0 | 2 |
+| E5.S2 | Error handling | Network errors, validation, toasts | ⏳ | E3.S6 | 2 |
+| E5.S3 | Keyboard shortcuts | Verificatie bestaande shortcuts werken | ⏳ | E1.S1 | 2 |
+| E5.S4 | Smoke tests | Happy flow tests voor alle P1 blocks | ⏳ | E5.S2 | 2 |
+
+**Nota:** Keyboard shortcuts (⌘K focus, Escape close) zijn al geïmplementeerd in E1.S1.
+E5.S3 is nu verificatie + eventuele uitbreiding (Enter submit, etc.).
+
+---
+
+## 5. Technische Debt & Bekende Issues
+
+### 5.1 Type Duplicatie (Medium Priority)
+
+**Probleem:**
+```typescript
+// lib/swift/types.ts - BRON
+export type SwiftIntent = 'dagnotitie' | 'zoeken' | 'overdracht' | 'unknown';
+
+// stores/swift-store.ts - DUPLICAAT (moet verwijderd worden)
+export type SwiftIntent = 'dagnotitie' | 'zoeken' | 'overdracht' | 'unknown';
+```
+
+**Impact:** Bij uitbreiding intents (diagnostiek workflow) moet op twee plekken gewijzigd worden.
+
+**Oplossing:** Verwijder duplicaat uit `swift-store.ts`, importeer uit `lib/swift/types.ts`:
+```typescript
+// stores/swift-store.ts
+import type { SwiftIntent, BlockType, ShiftType } from '@/lib/swift/types';
+```
+
+**Wanneer:** Voorafgaand aan E-D1.S1 (diagnostiek intent patterns).
+
+### 5.2 BlockContainer Animaties (Low Priority)
+
+**Probleem:** BlockContainer bestaat maar heeft nog geen framer-motion animaties.
+
+**Huidige situatie:**
+```typescript
+// components/swift/blocks/block-container.tsx
+// Geen AnimatePresence of motion.div
+```
+
+**Oplossing:** Implementeren in E5.S1 of integreren in E3.S0.
+
+### 5.3 CanvasArea Placeholder (High Priority - RESOLVED)
+
+**Probleem:** CanvasArea toont placeholder tekst i.p.v. blocks.
+
+**Oplossing:** Story E3.S0 toegevoegd. Dit is de hoogste prioriteit na E2.S5.
+
+---
+
+## 6. Kwaliteit & Testplan
+
+### 6.1 Test Types
+
+| Test Type | Scope | Tools | Wanneer |
+|-----------|-------|-------|---------|
+| Unit Tests | Intent classifier, entity extraction | Vitest | E2 |
+| Integration Tests | API endpoints | Vitest + MSW | E2, E3 |
+| Component Tests | Blocks, Command Center | React Testing Library | E3, E5 |
+| E2E Tests | Complete flows | Playwright (optioneel) | E5 |
+| Manual Tests | Demo scenarios | Checklist | E5 |
+
+### 6.2 Test Coverage Targets
+
+| Area | Target | Reden |
+|------|--------|-------|
+| Intent classifier | 90%+ | Kritiek voor UX |
+| API routes | 80%+ | Data integrity |
+| UI components | 60%+ | Belangrijkste flows |
+
+### 6.3 Manual Test Checklist (MVP Demo)
+
+**Happy Flows:**
+- [ ] User kan inloggen en Swift kiezen
+- [ ] Command input krijgt focus met Cmd+K
+- [ ] "notitie jan medicatie" → DagnotatieBlock opent met prefill
+- [ ] Dagnotitie opslaan → toast + block sluit
+- [ ] "zoek marie" → ZoekenBlock met resultaten
+- [ ] Patiënt selecteren → PatientContextCard
+- [ ] "overdracht" → OverdrachtBlock met AI samenvatting
+- [ ] Voice input → transcript in command input
+
+**Error Scenarios:**
+- [ ] Onbekende intent → FallbackPicker
+- [ ] Network error → toast met retry
+- [ ] Lege notitie → validation error
+- [ ] Geen zoekresultaten → "Geen patiënten gevonden"
+
+---
+
+## 7. Demo & Presentatieplan
+
+### 7.1 Demo Scenario
+
+**Duur:** 10 minuten
+**Doelgroep:** Zorgprofessionals, management
+**Locatie:** Live op Vercel
+
+**Flow:**
+
+```
+1. INTRO (1 min)
+   "40% van je tijd gaat naar administratie.
+    Wat als je gewoon kon zeggen wat je wilt?"
+
+2. CONTRAST (2 min)
+   Klassiek EPD: Dashboard → Patiënten → Jan → Rapportages →
+                 Nieuwe → Type → Tekst → Opslaan
+   Swift: "notitie jan medicatie gegeven" → Opslaan
+
+3. DAGNOTITIE FLOW (2 min)
+   - Typ: "notitie jan medicatie uitgereikt"
+   - Block verschijnt voorgevuld
+   - Één klik: opgeslagen
+
+4. VOICE DEMO (2 min)
+   - Klik microfoon
+   - Spreek: "marie had een rustige nacht, goed geslapen"
+   - Block verschijnt met transcript
+
+5. OVERDRACHT (2 min)
+   - "overdracht"
+   - AI genereert samenvatting per patiënt
+   - Toon bronverwijzingen
+
+6. AFSLUITING (1 min)
+   - Tijdsbesparing recap
+   - Vragen
+```
+
+### 7.2 Backup Plan
+
+| Probleem | Oplossing |
+|----------|-----------|
+| Internet issues | Localhost met demo data |
+| Voice niet werkt | Type-only demo |
+| AI API down | Pre-cached responses |
+| Complete failure | Video recording |
+
+---
+
+## 8. Risico's & Mitigatie
+
+| Risico | Kans | Impact | Mitigatie | Owner |
+|--------|------|--------|-----------|-------|
+| Voice accuracy NL | Middel | Hoog | Deepgram NL model, fallback naar tekst | Dev |
+| Intent misclassificatie | Middel | Hoog | Two-tier systeem, FallbackPicker | Dev |
+| AI latency | Laag | Middel | Local-first, Haiku model | Dev |
+| User adoption | Middel | Middel | Keuze behouden, geen dwang | Product |
+| Scope creep | Hoog | Hoog | Strict P1-only, backlog voor rest | Dev |
+| Performance | Laag | Middel | Code splitting, lazy loading | Dev |
+| **CanvasArea blocking** | Hoog | Hoog | E3.S0 prioriteit na E2.S5 | Dev |
+
+---
+
+## 9. Sprint Planning (Aangepast)
+
+### Huidige Status (24-12-2024)
+- ✅ E0: Setup & Foundation (8 SP) — DONE
+- ✅ E1: Command Center (13 SP) — DONE
+- ✅ E2: Intent Classification (12 SP) — DONE
+- ⏳ E3-E5: Remaining (39 SP) — TO DO
+
+**Totaal Done: 33 SP / 72 SP (46%)**
+
+### Sprint 3 (Huidige Sprint): Core Wiring + First Block
+- ✅ E2.S5: Input → Block wiring (2 SP) — DONE
+- E3.S0: CanvasArea block rendering (2 SP) ← **KRITIEK**
+- E3.S1: Block Container (2 SP)
+- E3.S2: DagnotatieBlock (5 SP)
+- **Deliverable:** "notitie jan" → DagnotatieBlock werkt end-to-end
+
+### Sprint 4: Remaining Blocks
+- E3.S3: Patient search API (3 SP)
+- E3.S4: ZoekenBlock (3 SP)
+- E3.S5: PatientContextCard (5 SP)
+- E3.S6: OverdrachtBlock (3 SP)
+- **Deliverable:** Alle P1 blocks werken
+
+### Sprint 5: Polish & Ship
+- E4: Navigation & Auth (8 SP)
+- E5: Polish & Testing (8 SP)
+- Technische debt opruimen
+- **Deliverable:** Demo-ready MVP
+
+---
+
+## 10. Uitbreidingen (Backlog)
+
+### Diagnostiek Workflow (22 SP)
+
+**Status:** Gepland na MVP
+**Documentatie:** `bouwplan-swift-diagnostiek-workflow.md`
+
+| Epic | Stories | SP | Vereisten |
+|------|---------|----:|-----------|
+| E-D1 | Afspraak & Rapportage | 12 | E3 compleet |
+| E-D2 | Diagnose Beheer | 10 | E3 compleet |
+
+**Pre-requisites:**
+1. Swift MVP compleet (E0-E5)
+2. Report type "diagnostiek" toevoegen aan REPORT_TYPES
+3. SwiftIntent uitbreiden met nieuwe types
+4. Entity extraction voor datum/tijd
+
+**Zie:** `bouwplan-swift-diagnostiek-workflow-beoordeling.md` voor details.
+
+---
+
+## 11. Definition of Done
+
+Een story is **Done** wanneer:
+- [ ] Code geschreven en werkend
+- [ ] TypeScript types correct (geen duplicaten)
+- [ ] Component responsive (mobile + desktop)
+- [ ] Error states afgehandeld
+- [ ] Toegankelijkheid basics (focus, labels)
+- [ ] Getest in Chrome + Safari
+- [ ] PR reviewed (indien team)
+- [ ] Gemerged naar main
+
+Een epic is **Done** wanneer:
+- [ ] Alle stories Done
+- [ ] Integration test passed
+- [ ] Demo scenario werkt
+
+---
+
+## 12. Referenties
+
+### Project Documenten
+- PRD: `docs/swift/swift-prd.md`
+- FO: `docs/swift/swift-fo-ai.md`
+- TO: `docs/swift/to-swift-v1.md`
+- UX: `docs/swift/swift-ux-v2.1.md`
+- Diagnostiek FO: `docs/swift/swift-fo-diagnostiek-workflow.md`
+- Diagnostiek Bouwplan: `docs/swift/bouwplan-swift-diagnostiek-workflow.md`
+- Beoordeling: `docs/swift/bouwplan-swift-diagnostiek-workflow-beoordeling.md`
+
+### Bestaande Code Referenties
+- Swift Store: `stores/swift-store.ts`
+- Swift Types: `lib/swift/types.ts` (SINGLE SOURCE)
+- Intent Classifier: `lib/swift/intent-classifier.ts`
+- Intent API: `app/api/intent/classify/route.ts`
+- Command Center: `components/swift/command-center/`
+- Block Container: `components/swift/blocks/block-container.tsx`
+
+### Bestaande EPD Code (Hergebruik)
+- Command component: `components/ui/command.tsx`
+- Speech streaming: `components/speech-recorder-streaming.tsx`
+- Overdracht API: `app/api/overdracht/generate/route.ts`
+- Report types: `lib/types/report.ts`
+- Reports API: `app/api/reports/route.ts`
+
+### External
+- Zustand: https://zustand-demo.pmnd.rs/
+- cmdk: https://cmdk.paco.me/
+- Deepgram: https://developers.deepgram.com/docs
+- Claude API: https://docs.anthropic.com/
+- Framer Motion: https://www.framer.com/motion/
+
+---
+
+## 13. Glossary
+
+| Term | Betekenis |
+|------|-----------|
+| Swift | Projectnaam voor Contextual UI EPD |
+| Command Center | Hoofdscherm met één input |
+| Block | Ephemeral UI component (dagnotitie, zoeken, etc.) |
+| Intent | Gebruikersintentie (dagnotitie, zoeken, overdracht) |
+| Entity | Geëxtraheerde data (patiëntnaam, categorie) |
+| Prefill | Vooraf ingevulde data in block |
+| Klassiek EPD | Traditionele menu-gebaseerde interface |
+| P1 | Prioriteit 1 (MVP scope) |
+| SP | Story Points (Fibonacci: 1, 2, 3, 5, 8) |
+| Wiring | Koppeling tussen componenten (input → API → block) |
+
+---
+
+**Versiehistorie:**
+
+| Versie | Datum | Auteur | Wijziging |
+|--------|-------|--------|-----------|
+| v1.0 | 23-12-2024 | Colin Lit | Initiële versie |
+| v1.1 | 23-12-2024 | Claude | E0 + E1 voltooid (21 SP) |
+| v1.2 | 23-12-2024 | Claude | E2.S1 + E2.S2 voltooid (27 SP) |
+| v1.3 | 23-12-2024 | Claude | E2.S3 AI fallback voltooid (29 SP) |
+| v1.4 | 23-12-2024 | Claude | E2.S1-S4 voltooid (31 SP) |
+| v1.5 | 24-12-2024 | Claude | E2.S5 toegevoegd: Input → Block wiring (+2 SP) |
+| **v2.0** | **24-12-2024** | **Claude** | **Major update: E3.S0 toegevoegd, technische debt sectie, diagnostiek workflow referentie, sprint planning aangepast (29 stories, 72 SP)** |
+| **v2.1** | **24-12-2024** | **Claude** | **E2.S5 voltooid: Input → Block wiring geïmplementeerd, Epic 2 compleet (33 SP done, 46%)** |