# 🧩 Functioneel Ontwerp (FO) — Swift Medical Scribe Chatbot

**Projectnaam:** Swift — Medical Scribe Chatbot Interface  
**Versie:** v3.0  
**Datum:** 27-12-2024  
**Auteur:** Colin Lit

---

## 1. Doel en relatie met het PRD

🎯 **Doel van dit document:**
Dit Functioneel Ontwerp beschrijft het **redesign** van Swift naar een medical scribe chatbot interface. De gebruiker voert een natuurlijke conversatie met een AI-assistent die intents herkent, acties uitvoert, en relevante UI-componenten toont in een split-screen layout.

📘 **Relatie met andere documenten:**
- **PRD:** `nextgen-epd-prd-ephemeral-ui-epd.md` — Ephemeral UI visie
- **UX/UI:** `swift-ux-v2.1.md` — Visuele specificaties (wordt herzien)
- **UX Research:** `nextgen-epd-onderzoeksverslag-ux-ui-patterns.md` — Marktanalyse
- **Bouwplan:** `bouwplan-swift-v2.md` — Development roadmap

**Kernprincipe:**
> De gebruiker voert een natuurlijke conversatie met een medical scribe assistent. De assistent herkent intents, voert acties uit, en toont relevante UI-componenten (artifacts) rechts in beeld. De conversatie blijft zichtbaar en doorlopend — zoals ChatGPT Canvas of Claude Artifacts.

**Belangrijkste wijzigingen t.o.v. v2.0:**

| Aspect | v2.0 (Command Center) | v3.0 (Medical Scribe) |
|--------|----------------------|----------------------|
| Input model | Command-line stijl | Natuurlijke conversatie |
| UI paradigma | Blocks die verschijnen/verdwijnen | Chat links, artifacts rechts |
| Context | Per commando | Doorlopende conversatiegeschiedenis |
| AI rol | Intent classifier | Converserende medical scribe |
| Interactie | Transactioneel | Relationeel, follow-up mogelijk |

---

## 2. Overzicht van de belangrijkste onderdelen

🎯 **Doel:** Overzicht van alle modules en hun relaties.

### 2.1 Systeemcomponenten

| # | Component | Beschrijving | Type |
|---|-----------|--------------|------|
| 1 | **Command Center** | Hoofdscherm met split-screen layout | Scherm |
| 2 | **Context Bar** | Dienst, actieve patiënt, user info | UI Zone |
| 3 | **Chat Panel** | Doorlopende conversatie (links, 40%) | UI Zone |
| 4 | **Artifact Area** | Waar blocks verschijnen (rechts, 60%) | UI Zone |
| 5 | **Chat Input** | Tekst + voice input (onderaan chat) | UI Zone |
| 6 | **Chat API** | Medical scribe chatbot endpoint | Backend |
| 7 | **Intent Engine** | Herkent intents in conversatie (hybrid) | Backend |
| 8 | **Context Manager** | Beheert sessie context + chat history | Backend |

### 2.2 Artifacts (Bouwblokken)

| Prio | Artifact | Functie | Trigger voorbeelden |
|------|----------|---------|---------------------|
| P1 | **DagnotatieBlock** | Snelle notitie invoer | "medicatie gegeven aan jan" |
| P1 | **ZoekenBlock** | Patiënt zoeken | "wie is jan de vries" |
| P1 | **PatientContextCard** | Patiënt overzicht | Na zoeken / selectie |
| P1 | **OverdrachtBlock** | Dienst overdracht met AI-filtering | "maak overdracht" |
| P2 | **RapportageBlock** | Behandelrapportage | "gesprek gehad met jan" |
| P2 | **AgendaBlock** | Afspraken | "mijn afspraken vandaag" |
| P2 | **MetingenBlock** | Vitale functies | "bloeddruk invoeren" |

**Belangrijk:** Artifacts blijven functioneel hetzelfde als v2.0 blocks, maar verschijnen nu rechts in een persistent panel.

### 2.3 Rol-specifieke Views

| Rol | Primaire workflow | Artifact focus |
|-----|-------------------|----------------|
| **Verpleegkundige** | Notities maken tijdens dienst | DagnotatieBlock, RapportageBlock |
| **Psychiater** | Gefilterde overdracht lezen | OverdrachtBlock met AI-samenvatting |

---

## 3. User Stories

🎯 **Doel:** Beschrijven wat gebruikers moeten kunnen doen, vanuit hun perspectief.

### 3.1 Nieuwe Stories (v3.0)

| ID | Rol | Doel / Actie | Verwachte waarde | Prio |
|----|-----|--------------|------------------|------|
| US-15 | Alle gebruikers | Natuurlijke conversatie voeren met assistent | Voelt als praten met collega | 🔴 P1 |
| US-16 | Alle gebruikers | Conversatiegeschiedenis zien | Context behouden tijdens werk | 🔴 P1 |
| US-17 | Alle gebruikers | Doorvragen zonder opnieuw te beginnen | Flexibele workflow | 🔴 P1 |
| US-18 | Alle gebruikers | Assistent stelt verduidelijkingsvragen | Minder fouten, betere data | 🟡 P2 |
| US-19 | Alle gebruikers | Meerdere acties in één conversatie | Efficiënte workflow | 🟡 P2 |
| US-20 | Verpleegkundige | Notities maken via spraak of typen | Hands-free documentatie | 🔴 P1 |
| US-21 | Verpleegkundige | Zien welke notities relevant zijn voor psychiater | Transparantie in filtering | 🟡 P2 |
| US-22 | Psychiater | Alleen behandelrelevante info zien | Geen ruis, focus op behandeling | 🔴 P1 |
| US-23 | Psychiater | Doorklikken naar originele bron | Verificatie en context | 🔴 P1 |

### 3.2 Bestaande Stories (herzien)

| ID | Rol | Doel / Actie | Wijziging v3.0 |
|----|-----|--------------|----------------|
| US-01 | Verpleegkundige | Dagnotitie maken | Via conversatie: "Ik heb medicatie gegeven aan Jan" |
| US-02 | Verpleegkundige | Patiënt zoeken | Via conversatie: "Wie is Jan de Vries?" |
| US-04 | Verpleegkundige | Overdracht maken | Via conversatie: "Maak overdracht voor deze dienst" |

---

## 4. Functionele werking per onderdeel

🎯 **Doel:** Per component beschrijven wat de gebruiker kan doen en wat het systeem doet.

### 4.1 Command Center (Hoofdscherm)

**Beschrijving:**
Split-screen layout met chat links (40%) en artifacts rechts (60%). De gebruiker voert een natuurlijke conversatie met de medical scribe assistent.

**Layout:**

```
┌─────────────────────────────────────────────────────────────────┐
│  🕐 Ochtend | 8 ptn              Jan de Vries ▼        👤 SV   │
│                           CONTEXT BAR                           │
├──────────────────────────────┬──────────────────────────────────┤
│                              │                                  │
│  CHAT PANEL (40%)            │  ARTIFACT AREA (60%)             │
│                              │                                  │
│  👤 "Ik heb net medicatie    │  ┌────────────────────────────┐ │
│     gegeven aan Jan"         │  │ 📝 Dagnotitie              │ │
│                              │  │                            │ │
│  🤖 Ik maak een dagnotitie   │  │ Patiënt: Jan de Vries ✓   │ │
│     voor Jan de Vries.       │  │ Categorie: Medicatie ✓    │ │
│     Categorie: Medicatie.    │  │                            │ │
│                              │  │ Notitie:                   │ │
│     Wil je nog iets          │  │ ┌────────────────────────┐│ │
│     toevoegen?               │  │ │ medicatie gegeven      ││ │
│                              │  │ └────────────────────────┘│ │
│  👤 "Nee, opslaan"           │  │                            │ │
│                              │  │ ☐ Relevant voor psychiater │ │
│  🤖 ✓ Notitie opgeslagen     │  │                            │ │
│     voor Jan de Vries.       │  │ [Annuleren]  [💾 Opslaan]  │ │
│                              │  └────────────────────────────┘ │
│                              │                                  │
├──────────────────────────────┤                                  │
│ 💬 Typ of spreek...     🎤   │                                  │
└──────────────────────────────┴──────────────────────────────────┘
```

**Gedrag:**
- Bij laden: Chat input heeft focus, artifact area toont placeholder
- Keyboard shortcut `⌘K` focust chat input vanaf elke plek
- Artifacts verschijnen rechts met slide-in animatie (200ms)
- Chat blijft zichtbaar en scrollbaar tijdens werk met artifacts
- Meerdere artifacts mogelijk via tabs (max 3 tegelijk)

**States:**

| State | Chat Panel | Artifact Area |
|-------|------------|---------------|
| Initial | Welcome message | Placeholder: "Artifacts verschijnen hier" |
| Conversing | Chat history + streaming response | Ongewijzigd of artifact |
| Action triggered | Chat continues | Artifact slide-in |
| Working | Chat beschikbaar | Artifact actief |
| Completed | Success message in chat | Artifact sluit of blijft |

---

### 4.2 Context Bar

**Functie:** Toont essentiële context: dienst, actieve patiënt, gebruiker.

**Elementen:**

| Element | Beschrijving | Interactie |
|---------|--------------|------------|
| Dienst indicator | 🕐 Ochtend / Middag / Nacht + patiëntentelling | Geen |
| Actieve patiënt | Dropdown met recent geselecteerde patiënten | Klik opent selector |
| User info | Avatar + initialen | Klik opent menu |

**Dienst kleuren:**

| Dienst | Tijd | Kleur |
|--------|------|-------|
| Ochtend | 07:00-15:00 | Amber (#F59E0B) |
| Middag | 15:00-23:00 | Blue (#3B82F6) |
| Nacht | 23:00-07:00 | Indigo (#6366F1) |

---

### 4.3 Chat Panel

**Functie:** Toont doorlopende conversatie met medical scribe assistent.

**Elementen:**

| Element | Beschrijving |
|---------|--------------|
| Chat Messages | Scrollbare lijst van user en assistant messages |
| Message Bubbles | User: rechts, amber bg / Assistant: links, slate bg |
| Streaming Indicator | Pulsating dots tijdens AI response |
| Action Links | Klikbare links naar gerelateerde artifacts |
| Timestamps | Optioneel, alleen bij pauzes >5 minuten |

**Message Types:**

| Type | Weergave | Voorbeeld |
|------|----------|-----------|
| User message | Rechts, amber | "medicatie gegeven aan jan" |
| Assistant text | Links, slate | "Ik maak een dagnotitie..." |
| Assistant action | Links, met icon | "📝 Dagnotitie geopend" (klikbaar) |
| System message | Centered, subtle | "✓ Notitie opgeslagen" |
| Error message | Links, red border | "Er ging iets mis. Probeer opnieuw." |

**Gedrag:**
- Auto-scroll naar laatste message
- Scroll-lock wanneer gebruiker omhoog scrollt
- "Scroll to bottom" knop bij nieuwe messages
- Max 100 messages in view (pagination voor oudere)

---

### 4.4 Chat Input

**Functie:** Tekst + voice input voor conversatie met medical scribe.

**States:**

| State | Weergave | Trigger |
|-------|----------|---------|
| Default | "Typ of spreek..." + mic icon | — |
| Typing | Cursor + getypte tekst | Keyboard input |
| Listening | 🔴 + waveform + live transcript | Mic click of spatie |
| Processing | Disabled, "Denkt na..." | Na submit |
| Streaming | Disabled, streaming in chat | Tijdens AI response |

**Keyboard Shortcuts:**

| Key | Actie |
|-----|-------|
| `Enter` | Submit message |
| `⌘Enter` / `Ctrl+Enter` | Force submit (ook tijdens streaming) |
| `Escape` | Clear input / cancel voice |
| `↑` | Vorige message (edit history) |
| `Space` (leeg) | Start voice recording |
| `⌘K` | Focus input |

**Voice Flow:**
1. User klikt mic of drukt spatie (bij lege input)
2. Deepgram start streaming transcription
3. Live transcript verschijnt in input field
4. Pauze detectie (1.5 sec stilte) → auto-submit
5. Of user klikt "Stop" → submit

---

### 4.5 Artifact Area

**Functie:** Toont actieve artifacts (blocks) rechts van de chat.

**Layout opties:**

| Situatie | Weergave |
|----------|----------|
| Geen artifact | Placeholder met voorbeelden |
| Eén artifact | Full width, centered |
| Meerdere artifacts | Tabs bovenaan (max 3) |

**Artifact Lifecycle:**

```
┌─────────────────────────────────────────────────────────────┐
│  1. Intent detected in chat                                 │
│     → AI response: "Ik maak een dagnotitie..."             │
│     → Action object attached to response                    │
├─────────────────────────────────────────────────────────────┤
│  2. Artifact appears                                        │
│     → Slide-in animation (200ms, from right)               │
│     → Pre-filled with extracted entities                   │
│     → Focus moves to first editable field                  │
├─────────────────────────────────────────────────────────────┤
│  3. User interacts                                          │
│     → Edits fields in artifact                             │
│     → Can continue chatting (e.g., "voeg toe: sliep goed") │
│     → Chat updates artifact in real-time                   │
├─────────────────────────────────────────────────────────────┤
│  4. User saves or cancels                                   │
│     → Success: toast + chat confirmation + artifact closes │
│     → Cancel: artifact closes, no confirmation             │
└─────────────────────────────────────────────────────────────┘
```

**Placeholder State:**

```
┌────────────────────────────────────────────────────────────┐
│                                                            │
│                    💬 Artifacts verschijnen hier           │
│                                                            │
│     Vraag me iets, bijvoorbeeld:                          │
│     • "Notitie voor Jan: medicatie gegeven"               │
│     • "Zoek Marie van den Berg"                           │
│     • "Maak overdracht voor deze dienst"                  │
│                                                            │
└────────────────────────────────────────────────────────────┘
```

---

### 4.6 Medical Scribe Chat API

**Functie:** Chatbot endpoint die conversatie voert en intents herkent.

**Endpoint:** `POST /api/swift/chat`

**Request:**

```typescript
interface ChatRequest {
  message: string;                    // User message
  messages: ChatMessage[];            // Conversation history (max 20)
  context: {
    activePatient?: Patient;          // Currently selected patient
    shift: 'ochtend' | 'middag' | 'nacht';
    userId: string;
    recentActions: RecentAction[];    // Last 5 actions
  };
}
```

**Response (Server-Sent Events):**

```typescript
// Text chunk (streaming)
{ type: 'text', content: string }

// Action detected (end of response)
{ 
  type: 'action',
  intent: Intent,
  entities: ExtractedEntities,
  confidence: number,
  artifact?: {
    type: ArtifactType,
    prefill: PrefillData
  }
}

// Done
{ type: 'done' }
```

**System Prompt (samenvatting):**

```
Je bent een medische assistent (medical scribe) voor Swift, een Nederlands GGZ EPD.

Je rol:
- Help zorgmedewerkers met documentatie en administratie
- Voer natuurlijke gesprekken in het Nederlands
- Herken intents en voer acties uit wanneer nodig
- Stel verduidelijkingsvragen bij onduidelijkheid
- Wees vriendelijk maar professioneel

Intents die je herkent:
- dagnotitie: notitie maken voor patiënt
- zoeken: patiënt zoeken
- rapportage: behandelrapportage schrijven
- overdracht: dienst overdracht maken
- metingen: vitale functies invoeren
- agenda: afspraken bekijken

Wanneer je een intent herkent, voeg een JSON action object toe aan je response.

Huidige context:
- Actieve patiënt: {activePatient}
- Dienst: {shift}
- Recente acties: {recentActions}
```

---

### 4.7 Intent Engine (Hybrid)

**Functie:** Herkent intents in conversatie met two-tier approach.

**Tier 1: Local Pattern Matching (<50ms)**

| Pattern | Intent | Entities |
|---------|--------|----------|
| "notitie [naam]" | dagnotitie | patient: naam |
| "zoek [naam]" | zoeken | query: naam |
| "overdracht" | overdracht | — |
| "bloeddruk [naam]" | metingen | patient: naam, type: bloeddruk |

**Tier 2: AI Classification (via Chat API)**

Wanneer local patterns geen match geven of confidence <0.8, bepaalt de Chat API het intent op basis van conversatie-context.

**Voorbeelden:**

| Conversatie | Intent | Methode |
|-------------|--------|---------|
| "notitie jan medicatie" | dagnotitie | Local (direct match) |
| "Ik heb net een gesprek gehad" | rapportage | AI (context needed) |
| "Hij geeft aan zich beter te voelen" | (context) | AI (follow-up) |
| "Wie was die mevrouw van kamer 12?" | zoeken | AI (indirect) |

---

### 4.8 AI-Filtering voor Psychiater (Overdracht)

**Functie:** Filtert verpleegkundige rapportages naar behandelrelevante informatie.

**Wat WEL naar psychiater gaat:**

| Categorie | Voorbeelden |
|-----------|-------------|
| Medicatie-issues | Weigering, bijwerkingen, therapierespons |
| Stemming/gedrag verandering | t.o.v. baseline, significante shifts |
| Risico-signalen | Suïcidale uitingen, zelfbeschadiging, agressie |
| Signaleringsplan triggers | Oranje/rood fase signalen |
| Psychotische symptomen | Hallucinaties, wanen |
| Behandelplan stagnatie | Geen voortgang op doelen |

**Wat NIET naar psychiater gaat:**

| Categorie | Voorbeelden |
|-----------|-------------|
| Routine medicatie | "Medicatie volgens schema ingenomen" |
| ADL activiteiten | "Heeft gedoucht", "Ontbijt genuttigd" |
| Standaard observaties | "Rustige dag", "Goed geslapen" |
| Sociale activiteiten | "Bezoek gehad", "Mee naar dagactiviteit" |

**Linked Evidence:**
Elke zin in de AI-samenvatting linkt naar de originele verpleegkundige notitie. De psychiater kan hover-to-preview of click-to-expand gebruiken.

**UI in OverdrachtBlock:**

```
┌────────────────────────────────────────────────────────────┐
│ 🔄 Overdracht Ochtend → Middag                    [×]     │
│    07:00 - 15:00 | 8 patiënten                            │
├────────────────────────────────────────────────────────────┤
│                                                            │
│  Behandelrelevant (3 patiënten)                           │
│  ───────────────────────────────────────────────────────  │
│                                                            │
│  ▼ Jan de Vries                              ⚠️ Alert     │
│    Weigerde ochtendmedicatie. Geeft aan last te hebben   │
│    van bijwerkingen (duizeligheid). Stemming somberder   │
│    dan gisteren.                                          │
│    📎 3 bronnotities  [Bekijk bronnen]                    │
│                                                            │
│  ▶ Marie van den Berg                                     │
│  ▶ Piet Jansen                                            │
│                                                            │
│  ─────────────────────────────────────────────────────── │
│  Geen bijzonderheden (5 patiënten)                        │
│  [Toon allen ▼]                                           │
│                                                            │
├────────────────────────────────────────────────────────────┤
│  [📋 Kopieer] [📤 Naar EPD] [✓ Gezien]                    │
└────────────────────────────────────────────────────────────┘
```

---

## 5. User Flows

🎯 **Doel:** Laten zien hoe de gebruiker stap-voor-stap door het systeem gaat.

### Flow 1: Dagnotitie via Conversatie

```
┌─────────────────────────────────────────────────────────────┐
│ 1. Verpleegkundige opent Swift                              │
│    → Chat: welcome message                                  │
│    → Artifact: placeholder                                  │
├─────────────────────────────────────────────────────────────┤
│ 2. Verpleegkundige typt: "Medicatie gegeven aan Jan"       │
│    → Message verschijnt in chat                             │
├─────────────────────────────────────────────────────────────┤
│ 3. AI Response (streaming):                                 │
│    "Ik maak een dagnotitie voor Jan de Vries.              │
│     Categorie: Medicatie. Wil je nog iets toevoegen?"      │
│    → Action: intent=dagnotitie, patient=Jan, cat=Medicatie │
├─────────────────────────────────────────────────────────────┤
│ 4. DagnotatieBlock verschijnt rechts:                      │
│    → Patient: Jan de Vries ✓ (pre-filled)                  │
│    → Categorie: Medicatie ✓ (pre-filled)                   │
│    → Text: "Medicatie gegeven" (pre-filled)                │
├─────────────────────────────────────────────────────────────┤
│ 5. Verpleegkundige: "Nee, opslaan"                         │
│    → Of: klikt direct op Opslaan knop                       │
├─────────────────────────────────────────────────────────────┤
│ 6. Resultaat:                                               │
│    → Toast: "✓ Notitie opgeslagen"                         │
│    → Chat: "Notitie opgeslagen voor Jan de Vries."         │
│    → Artifact sluit (of blijft voor volgende)              │
├─────────────────────────────────────────────────────────────┤
│ TIJD: ~15 seconden                                          │
└─────────────────────────────────────────────────────────────┘
```

### Flow 2: Overdracht met AI-Filtering (Psychiater)

```
┌─────────────────────────────────────────────────────────────┐
│ 1. Psychiater opent Swift                                   │
│    → Chat: "Goedemorgen! Wil je de overdracht bekijken?"   │
├─────────────────────────────────────────────────────────────┤
│ 2. Psychiater: "Ja, laat zien"                             │
│    → Of: "Overdracht ochtend"                               │
├─────────────────────────────────────────────────────────────┤
│ 3. AI Response:                                             │
│    "Ik haal de overdracht op. 3 patiënten hebben           │
│     behandelrelevante updates."                             │
│    → OverdrachtBlock verschijnt rechts                      │
├─────────────────────────────────────────────────────────────┤
│ 4. OverdrachtBlock toont:                                   │
│    → Gefilterde samenvatting (alleen behandelrelevant)     │
│    → Patiënten gesorteerd op urgentie                       │
│    → "Geen bijzonderheden" sectie ingeklapt                │
├─────────────────────────────────────────────────────────────┤
│ 5. Psychiater klikt op "📎 3 bronnotities" bij Jan         │
│    → Slide-in panel met originele verpleegkundige notities │
│    → Timestamps en auteurs zichtbaar                        │
├─────────────────────────────────────────────────────────────┤
│ 6. Psychiater in chat: "Wat was er gisteren met Jan?"      │
│    → AI antwoordt met context uit eerdere notities         │
│    → Geen nieuw artifact nodig                              │
├─────────────────────────────────────────────────────────────┤
│ 7. Psychiater klikt "✓ Gezien"                             │
│    → Overdracht gemarkeerd als gelezen                      │
│    → Chat: "Overdracht gemarkeerd als gezien."             │
└─────────────────────────────────────────────────────────────┘
```

### Flow 3: Rapportage met Verduidelijkingsvragen

```
┌─────────────────────────────────────────────────────────────┐
│ 1. Verpleegkundige: "Ik heb een gesprek gehad"             │
├─────────────────────────────────────────────────────────────┤
│ 2. AI: "Met welke patiënt had je het gesprek?"             │
│    → Geen artifact (verduidelijking nodig)                  │
├─────────────────────────────────────────────────────────────┤
│ 3. Verpleegkundige: "Jan"                                   │
├─────────────────────────────────────────────────────────────┤
│ 4. AI: "Ik maak een rapportage voor Jan de Vries.          │
│     Wat wil je vastleggen?"                                 │
│    → RapportageBlock verschijnt rechts (leeg)              │
├─────────────────────────────────────────────────────────────┤
│ 5. Verpleegkundige: "Hij voelt zich beter, minder angstig" │
│    → Tekst verschijnt in RapportageBlock                   │
├─────────────────────────────────────────────────────────────┤
│ 6. AI: "Genoteerd. Wil je dit als voortgangsgesprek        │
│     opslaan of is er meer?"                                 │
├─────────────────────────────────────────────────────────────┤
│ 7. Verpleegkundige: "Opslaan als voortgang"                │
│    → Rapportage opgeslagen met tag "Voortgangsgesprek"     │
│    → Toast + chat confirmation                              │
└─────────────────────────────────────────────────────────────┘
```

---

## 6. Interacties met AI

🎯 **Doel:** Uitleggen waar AI in de flow voorkomt en wat de gebruiker ziet.

| Locatie | AI-actie | Trigger | Output |
|---------|----------|---------|--------|
| Chat | Conversatie + intent detection | Elke user message | Streaming text + action object |
| Chat | Verduidelijkingsvraag | Onduidelijke intent | Vraag in chat (geen artifact) |
| Chat | Follow-up verwerking | User antwoord op vraag | Update artifact of nieuwe info |
| OverdrachtBlock | Relevantie-filtering | "overdracht" intent | Gefilterde samenvatting |
| OverdrachtBlock | Samenvatting generatie | Per patiënt | Behandelrelevante bullets |
| RapportageBlock | Tekst structureren | "Structureer" knop | Gestructureerde tekst |
| RapportageBlock | B1-niveau herschrijven | "Vereenvoudig" knop | Herschreven tekst |

**Confidence Thresholds:**

| Confidence | Actie |
|------------|-------|
| >0.9 | Direct artifact openen met prefill |
| 0.7-0.9 | Artifact openen + bevestigingsvraag in chat |
| 0.5-0.7 | Verduidelijkingsvraag in chat, geen artifact |
| <0.5 | Fallback: "Ik begrijp je niet helemaal. Kun je het anders formuleren?" |

---

## 7. Gebruikersrollen en rechten

🎯 **Doel:** Beschrijven welke rollen toegang hebben tot welke onderdelen.

| Rol | Toegang | Artifacts | AI-filtering |
|-----|---------|-----------|--------------|
| **Verpleegkundige** | Eigen dienst patiënten | Alle P1/P2 artifacts | Input: alle notities |
| **Psychiater** | Alle patiënten in behandeling | OverdrachtBlock (read), PatientContextCard | Output: gefilterde samenvatting |
| **Behandelaar** | Eigen caseload | Alle artifacts | Beide views beschikbaar |

**Permissies per Artifact:**

| Artifact | Verpleegkundige | Psychiater | Behandelaar |
|----------|-----------------|------------|-------------|
| DagnotatieBlock | ✅ Create | ❌ | ✅ Create |
| RapportageBlock | ✅ Create | 👁️ Read | ✅ Create |
| OverdrachtBlock | ✅ Create | 👁️ Read (filtered) | ✅ Both |
| PatientContextCard | 👁️ Read | 👁️ Read | 👁️ Read |

---

## 8. Technische Specificaties

### 8.1 API Routes

| Route | Method | Functie | Status |
|-------|--------|---------|--------|
| `/api/swift/chat` | POST | Medical scribe chatbot | 🆕 Nieuw |
| `/api/swift/overdracht/generate` | POST | AI-gefilterde overdracht | 🔄 Herzien |
| `/api/intent/classify` | POST | Intent classification | ✅ Bestaat |
| `/api/patients/search` | GET | Patient search | ✅ Bestaat |
| `/api/reports` | POST | Report opslaan | ✅ Bestaat |

### 8.2 Store Uitbreiding

```typescript
interface SwiftStore {
  // Bestaande state
  activePatient: Patient | null;
  activeBlock: BlockType | null;
  shift: 'ochtend' | 'middag' | 'nacht';
  
  // Chat state (nieuw)
  chatMessages: ChatMessage[];
  isStreaming: boolean;
  pendingAction: Action | null;
  
  // Artifact state (nieuw)
  openArtifacts: Artifact[];  // Max 3
  activeArtifactId: string | null;
  
  // Actions
  addChatMessage: (message: ChatMessage) => void;
  processAction: (action: Action) => void;
  openArtifact: (artifact: Artifact) => void;
  closeArtifact: (id: string) => void;
}
```

### 8.3 Component Structuur

```
components/swift/
├── command-center/
│   ├── command-center.tsx       # Split-screen container
│   ├── context-bar.tsx          # Header met dienst/patient
│   ├── chat-panel.tsx           # 🆕 Chat messages
│   ├── chat-input.tsx           # Herzien: conversational
│   └── artifact-area.tsx        # 🆕 Artifact container
├── chat/
│   ├── chat-message.tsx         # 🆕 Individual message
│   ├── chat-action-link.tsx     # 🆕 Clickable action
│   └── streaming-indicator.tsx  # 🆕 Typing dots
├── artifacts/
│   ├── artifact-container.tsx   # 🆕 Wrapper met tabs
│   ├── dagnotitie-block.tsx     # Bestaand
│   ├── zoeken-block.tsx         # Bestaand
│   ├── overdracht-block.tsx     # Herzien: met filtering UI
│   ├── rapportage-block.tsx     # Bestaand
│   └── patient-context-card.tsx # Bestaand
└── shared/
    ├── linked-evidence.tsx      # 🆕 Bron-verwijzing component
    └── relevance-badge.tsx      # 🆕 "Behandelrelevant" indicator
```

---

## 9. UI Specificaties

### 9.1 Layout Breakpoints

| Viewport | Chat Panel | Artifact Area |
|----------|------------|---------------|
| Desktop (>1200px) | 40% | 60% |
| Tablet (768-1200px) | 45% | 55% |
| Mobile (<768px) | Full screen toggle | Full screen toggle |

### 9.2 Chat Message Styling

| Element | User Message | Assistant Message |
|---------|--------------|-------------------|
| Alignment | Right | Left |
| Background | Amber-50 (#FFFBEB) | Slate-100 (#F1F5F9) |
| Border | Amber-200 | Slate-200 |
| Max width | 80% | 80% |
| Border radius | 16px (top-right: 4px) | 16px (top-left: 4px) |

### 9.3 Artifact Animation

```css
/* Slide-in from right */
@keyframes artifact-enter {
  from {
    transform: translateX(100%);
    opacity: 0;
  }
  to {
    transform: translateX(0);
    opacity: 1;
  }
}

.artifact-enter {
  animation: artifact-enter 200ms ease-out;
}
```

---

## 10. Bijlagen & Referenties

🎯 **Doel:** Linken naar overige documenten.

### Project Documentatie
- PRD Ephemeral UI: `nextgen-epd-prd-ephemeral-ui-epd.md`
- UX/UI Specs: `swift-ux-v2.1.md`
- UX Research: `nextgen-epd-onderzoeksverslag-ux-ui-patterns.md`
- Bouwplan: `bouwplan-swift-v2.md`
- Project Status: `PROJECT-STATUS-2024-12-27.md`

### Externe Referenties
- [ChatGPT Canvas UX Analysis](https://altar.io/next-gen-of-human-ai-collaboration/)
- [Claude Artifacts Documentation](https://docs.anthropic.com)
- [Abridge Linked Evidence](https://www.abridge.com/product)
- [GGZ Zorgstandaarden](https://www.ggzstandaarden.nl)

---

## Wijzigingslog

| Versie | Datum | Wijzigingen |
|--------|-------|-------------|
| v2.0 | 23-12-2024 | Command Center met ephemeral blocks |
| v2.1 | 23-12-2024 | Prioriteitenlijst, intent mapping, P3 blocks |
| v3.0 | 27-12-2024 | **Redesign:** Chat + Artifact interface, Medical Scribe conversatie, AI-filtering voor psychiater |