triqura-ecd/docs/swift/bouwplan-swift-diagnostiek-workflow.md

🚀 Mission Control — Bouwplan Swift: Diagnostiek Workflow

Projectnaam: Swift — Diagnostiek Workflow
Versie: v1.0
Datum: 23-12-2024
Auteur: Colin Lit / Development Team

---

1. Doel en context

🎯 Doel:
Implementeren van de complete diagnostiek workflow in Swift: van het plannen van een diagnostiek-afspraak, via het schrijven van een rapportage, tot het bekijken en stellen van diagnoses. Deze workflow stelt behandelaars in staat om een volledig diagnostiek-traject door te lopen via natuurlijke taal zonder menu-navigatie.

Kernbelofte:

Een behandelaar kan een volledig diagnostiek-traject doorlopen: "afspraak diagnostiek jan morgen 10:00" → "rapportage diagnostiek gesprek met jan" → "diagnose toevoegen jan F41.1" — alles in één vloeiende flow.

📘 Context:
Dit bouwplan beschrijft de implementatie van de diagnostiek workflow als uitbreiding op Swift. Het bouwt voort op de Swift foundation (Command Center, Intent Classification) en voegt specifieke blocks toe voor behandelaars.

Relatie met documentatie:

• FO Diagnostiek: swift-fo-diagnostiek-workflow.md — Complete use case beschrijving
• FO Algemeen: swift-fo-ai.md — Algemene Swift functionaliteit
• Bouwplan Swift: bouwplan-swift-v1.md — Hoofd Swift bouwplan
• UX/UI: swift-ux-v2.1.md — Visuele specificaties

---

2. Uitgangspunten

2.1 Technische Stack

Bestaand (hergebruiken):

Component	Technologie	Status	Hergebruik
Swift Foundation	Command Center, Intent Classification	✅	Basis voor alle blocks
Appointment Modal	app/epd/agenda/components/appointment-modal.tsx	✅	80% hergebruik
Rapportage Composer	app/epd/patients/[id]/rapportage/components/report-composer.tsx	✅	80% hergebruik
Diagnose Form	app/epd/patients/[id]/diagnose/components/diagnosis-detail-form.tsx	✅	80% hergebruik
Diagnose Actions	app/epd/patients/[id]/diagnose/actions.ts	✅	90% hergebruik
FHIR Patient API	/api/fhir/Patient	✅	Patient search
Reports API	/api/reports	✅	Rapportage opslaan

Nieuw te bouwen:

Component	Technologie	Reden
AfspraakBlock	React component	Swift wrapper rond appointment modal
RapportageBlock	React component	Swift wrapper rond report composer
DiagnoseBlock	React component	Overzicht component
DiagnoseFormBlock	React component	Swift wrapper rond diagnose form
Appointments API	Next.js API route	Encounter CRUD voor Swift
Diagnoses API	Next.js API route	Diagnose CRUD voor Swift

2.2 Projectkaders

Kader	Waarde
Bouwtijd	2 weken (2 sprints)
Team	1 developer
Scope	Diagnostiek workflow: Afspraak → Rapportage → Diagnose
Data	Bestaande Supabase database (encounters, conditions, reports)
Doel	Werkende behandelaar workflow voor demo

2.3 Programmeer Uitgangspunten

Code Quality Principles:

• DRY (Don't Repeat Yourself)

  • Hergebruik bestaande componenten (appointment-modal, report-composer, diagnose-form)
  • Centrale API routes voor encounters en diagnoses
  • Shared hooks voor common patterns

• KISS (Keep It Simple, Stupid)

  • Swift blocks zijn wrappers rond bestaande componenten
  • Minimale aanpassingen aan bestaande code
  • Hergebruik bestaande validatie en error handling

• SOC (Separation of Concerns)

  • Swift blocks gescheiden van klassieke EPD componenten
  • API routes als wrapper rond bestaande actions
  • Business logic blijft in bestaande actions

• YAGNI (You Aren't Gonna Need It)

  • Alleen diagnostiek workflow in scope
  • Geen andere behandelaar workflows (intake, behandelplan, etc.)
  • Geen advanced features (herhalende afspraken, etc.)

Development Practices:

• Hergebruik Strategie

  // ✅ Hergebruik bestaande componenten
  // components/swift/blocks/afspraak-block.tsx
  import { AppointmentModal } from '@/app/epd/agenda/components/appointment-modal';
  
  // Aanpassen voor Swift context:
  // - Prefill vanuit intent
  // - Encounter_id teruggeven na opslaan
  // - Swift styling (dark theme)
  
  // ✅ Hergebruik bestaande actions
  // app/api/appointments/route.ts
  import { createEncounter, updateEncounter } from '@/app/epd/agenda/actions';
  
  // Wrapper rond bestaande logica met Swift-specifieke validatie
  

• Error Handling

  • Hergebruik bestaande error handling uit actions
  • Nederlandse foutmeldingen consistent met Swift
  • Toast notifications voor user feedback

• Security

  • Hergebruik Supabase RLS policies
  • Authenticatie via bestaande Supabase Auth
  • Input validation met Zod (bestaande schemas)

---

3. Epics & Stories Overzicht

Epic ID	Titel	Doel	Status	Stories	Effort	Opmerkingen
E-D1	Afspraak & Rapportage	Afspraak plannen + rapportage koppelen	⏳ To Do	3	11 SP	Hergebruik appointment modal
E-D2	Diagnose Beheer	Diagnose bekijken, toevoegen, bijstellen	⏳ To Do	3	10 SP	Hergebruik diagnose form

Totaal: 6 stories, 21 story points

Belangrijk:

• Bouw per epic en per story
• Hergebruik bestaande componenten waar mogelijk
• Minimale aanpassingen aan bestaande code
• Database migraties: eerst aan Colin melden

---

4. Epics & Stories (Uitwerking)

Epic D1 — Afspraak & Rapportage

Epic Doel: Werkende flow van diagnostiek-afspraak plannen tot rapportage schrijven met encounter koppeling.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afhankelijkheden	Story Points
E-D1.S1	Intent patterns uitbreiden	Afspraak en rapportage intents herkend	⏳ To Do	Swift foundation	2
E-D1.S2	AfspraakBlock	Patiënt, datum/tijd, type, encounter_id terug	⏳ To Do	E-D1.S1	5
E-D1.S3	RapportageBlock uitbreiden	Encounter_id koppeling, type "diagnostiek"	⏳ To Do	E-D1.S2	4

Technical Notes:

// E-D1.S1: Intent patterns toevoegen aan lib/swift/intent-classifier.ts
afspraak_maken: [
  /^afspraak\s+(diagnostiek|behandeling)\s+(\w+)/i,
  /^plan\s+(\w+)\s+(morgen|vandaag|volgende week)/i,
  /^afspraak\s+(\w+)\s+(morgen|vandaag)\s+(\d{1,2}:\d{2})/i,
],

rapportage: [
  /^rapportage\s+(diagnostiek|behandeling)\s+(\w+)/i,
  /^gesprek gehad met\s+(\w+)/i,
  /^verslag\s+(\w+)/i,
],

// E-D1.S2: AfspraakBlock
// components/swift/blocks/afspraak-block.tsx
// Hergebruik: app/epd/agenda/components/appointment-modal.tsx
// Aanpassingen:
// - Prefill vanuit intent (patient, date, time, type)
// - Dark theme styling (Swift context)
// - Encounter_id teruggeven via callback
// - Vereenvoudigde UI (geen linked reports sectie)

// E-D1.S3: RapportageBlock uitbreiden
// components/swift/blocks/rapportage-block.tsx
// Hergebruik: app/epd/patients/[id]/rapportage/components/report-composer.tsx
// Aanpassingen:
// - Encounter_id in prefill
// - Type "diagnostiek" toevoegen aan report types
// - Encounter link tonen indien gekoppeld

API Routes:

// E-D1.S2: Appointments API
// app/api/appointments/route.ts
export async function POST(request: NextRequest) {
  // Wrapper rond app/epd/agenda/actions.ts createEncounter
  // Retourneert encounter_id voor volgende stap
}

// E-D1.S3: Reports API uitbreiden
// app/api/reports/route.ts (bestaand)
// Uitbreiden met encounter_id parameter

---

Epic D2 — Diagnose Beheer

Epic Doel: Werkende diagnose overzicht en diagnose aanmaken/bijstellen met ICD-10 zoeker.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afhankelijkheden	Story Points
E-D2.S1	Intent patterns uitbreiden	Diagnose intents herkend	⏳ To Do	Swift foundation	2
E-D2.S2	DiagnoseBlock	Overzicht diagnoses, filter actief/inactief	⏳ To Do	E-D2.S1	3
E-D2.S3	DiagnoseFormBlock	ICD-10 zoeker, type, status, ernst	⏳ To Do	E-D2.S2	5

Technical Notes:

// E-D2.S1: Intent patterns toevoegen
diagnose_bekijken: [
  /^diagnose\s+(\w+)/i,
  /^diagnoses van\s+(\w+)/i,
  /^wat zijn de diagnoses/i,
],

diagnose_toevoegen: [
  /^diagnose toevoegen\s+(\w+)\s+([A-Z]\d+\.\d+)/i,
  /^(\w+)\s+heeft\s+([A-Z]\d+\.\d+)/i,
  /^diagnose\s+(\w+)\s+([A-Z]\d+\.\d+)/i,
],

diagnose_wijzigen: [
  /^diagnose wijzigen\s+(\w+)/i,
  /^diagnose bijstellen/i,
],

// E-D2.S2: DiagnoseBlock
// components/swift/blocks/diagnose-block.tsx
// Hergebruik logica van: app/epd/patients/[id]/diagnose/page.tsx
// Aanpassingen:
// - Swift styling (dark theme)
// - Filter tabs: Actief / Inactief / Alle
// - Klik op diagnose → DiagnoseFormBlock (edit mode)
// - "Nieuwe diagnose" knop → DiagnoseFormBlock (create mode)

// E-D2.S3: DiagnoseFormBlock
// components/swift/blocks/diagnose-form-block.tsx
// Hergebruik: app/epd/patients/[id]/diagnose/components/diagnosis-detail-form.tsx
// Aanpassingen:
// - ICD-10 zoeker met fuzzy search (verbeteren)
// - Swift styling
// - Prefill vanuit intent (ICD-10 code)
// - Encounter_id koppeling (optioneel)

API Routes:

// E-D2.S2 + E-D2.S3: Diagnoses API
// app/api/diagnoses/route.ts
export async function GET(request: NextRequest) {
  // GET /api/diagnoses/:patientId
  // Wrapper rond app/epd/patients/[id]/diagnose/actions.ts getPatientDiagnoses
}

export async function POST(request: NextRequest) {
  // POST /api/diagnoses
  // Wrapper rond app/epd/patients/[id]/diagnose/actions.ts createPatientDiagnosis
}

export async function PATCH(request: NextRequest) {
  // PATCH /api/diagnoses/:id
  // Wrapper rond app/epd/patients/[id]/diagnose/actions.ts updatePatientDiagnosis
}

---

5. Kwaliteit & Testplan

5.1 Test Types

Test Type	Scope	Tools	Wanneer	Verantwoordelijke
Unit Tests	Intent patterns, entity extraction	Vitest	E-D1.S1, E-D2.S1	Developer
Integration Tests	API endpoints	Vitest + MSW	E-D1.S2, E-D1.S3, E-D2.S3	Developer
Component Tests	Blocks	React Testing Library	E-D1.S2, E-D1.S3, E-D2.S2, E-D2.S3	Developer
Manual Tests	Complete workflow	Checklist	E-D2.S3	QA / Developer

5.2 Test Coverage Targets

Area	Target	Reden
Intent patterns	85%+	Correcte intent herkenning
Entity extraction	80%+	Pre-fill correctheid
API routes	80%+	Data integrity
Block components	60%+	Belangrijkste flows

5.3 Manual Test Checklist (Diagnostiek Workflow)

Happy Flow:

• "afspraak diagnostiek met jan morgen 10:00" → AfspraakBlock opent
• Afspraak opslaan → encounter_id teruggegeven
• "rapportage diagnostiek gesprek met jan" → RapportageBlock met encounter koppeling
• Rapportage opslaan → gekoppeld aan encounter
• "diagnose jan" → DiagnoseBlock met overzicht
• "diagnose toevoegen jan F41.1" → DiagnoseFormBlock met ICD-10 pre-filled
• Diagnose opslaan → toegevoegd aan overzicht
• Klik op diagnose → DiagnoseFormBlock (edit mode)
• Status wijzigen → diagnose bijgewerkt

Error Scenarios:

• Geen patiënt gevonden → ZoekenBlock
• Ongeldige datum → validatie fout
• ICD-10 code niet gevonden → validatie fout
• Encounter niet gevonden → rapportage zonder koppeling
• Network error → toast met retry

---

6. Demo & Presentatieplan

6.1 Demo Scenario

Duur: 5 minuten
Doelgroep: Behandelaars, psychologen, psychiaters
Locatie: Live op Vercel

Flow:

1. INTRO (30 sec)
   "Behandelaars besteden veel tijd aan administratie.
    Swift maakt diagnostiek-trajecten sneller."

2. AFSPRAAK PLANNEN (1 min)
   - Typ: "afspraak diagnostiek met jan morgen 10:00"
   - AfspraakBlock verschijnt voorgevuld
   - Opslaan → afspraak aangemaakt

3. RAPPORTAGE SCHRIJVEN (1.5 min)
   - Typ: "rapportage diagnostiek gesprek met jan"
   - RapportageBlock verschijnt met encounter koppeling
   - Schrijf/dicteer verslag
   - Opslaan → gekoppeld aan afspraak

4. DIAGNOSE STELLEN (2 min)
   - Typ: "diagnose jan"
   - DiagnoseBlock toont overzicht
   - Typ: "diagnose toevoegen jan F41.1"
   - DiagnoseFormBlock met ICD-10 pre-filled
   - Vul type, status, ernst in
   - Opslaan → diagnose toegevoegd

5. AFSLUITING (20 sec)
   - Complete flow in 5 minuten
   - Vragen

6.2 Backup Plan

Probleem	Oplossing
Internet issues	Localhost met demo data
AI API down	Pre-cached responses
Encounter niet gevonden	Demo met pre-made encounter
Complete failure	Video recording

---

7. Risico's & Mitigatie

Risico	Kans	Impact	Mitigatie	Owner
Hergebruik componenten complex	Middel	Hoog	Stapsgewijs aanpassen, tests per stap	Dev
ICD-10 zoeker niet accuraat	Middel	Middel	Fuzzy search verbeteren, externe API optie	Dev
Encounter koppeling faalt	Laag	Middel	Duidelijke UX, optionele koppeling	Dev
Datum parsing onnauwkeurig	Middel	Laag	Fallback naar date picker	Dev
Bestaande code breaking changes	Laag	Hoog	Wrapper pattern, geen directe wijzigingen	Dev

---

8. Sprint Planning

Sprint 1 (Week 1): Afspraak & Rapportage

• E-D1.S1: Intent patterns uitbreiden (2 SP)
• E-D1.S2: AfspraakBlock (5 SP)
• E-D1.S3: RapportageBlock uitbreiden (4 SP)
• Deliverable: Afspraak en rapportage flow werkend

Sprint 2 (Week 2): Diagnose Beheer

• E-D2.S1: Intent patterns uitbreiden (2 SP)
• E-D2.S2: DiagnoseBlock (3 SP)
• E-D2.S3: DiagnoseFormBlock (5 SP)
• Bug fixes + demo prep
• Deliverable: Complete diagnostiek workflow werkend

---

9. Definition of Done

Een story is Done wanneer:

• Code geschreven en werkend
• TypeScript types correct
• Component responsive (mobile + desktop)
• Error states afgehandeld
• Hergebruik bestaande code geïmplementeerd
• Geen breaking changes in bestaande code
• Getest in Chrome + Safari
• Demo scenario werkt

Een epic is Done wanneer:

• Alle stories Done
• Integration test passed
• Complete workflow werkt end-to-end

---

10. Referenties

Project Documenten

• FO Diagnostiek: docs/swift/swift-fo-diagnostiek-workflow.md
• FO Algemeen: docs/swift/swift-fo-ai.md
• Bouwplan Swift: docs/swift/bouwplan-swift-v1.md
• UX: docs/swift/swift-ux-v2.1.md

Bestaande Code Referenties (Hergebruik)

Component	Locatie	Hergebruik %	Aanpassingen
Appointment Modal	app/epd/agenda/components/appointment-modal.tsx	80%	Prefill, dark theme, encounter_id callback
Report Composer	app/epd/patients/[id]/rapportage/components/report-composer.tsx	80%	Encounter koppeling, type "diagnostiek"
Diagnose Page	app/epd/patients/[id]/diagnose/page.tsx	70%	Overzicht logica, Swift styling
Diagnose Form	app/epd/patients/[id]/diagnose/components/diagnosis-detail-form.tsx	80%	ICD-10 zoeker verbeteren, Swift styling
Diagnose Actions	app/epd/patients/[id]/diagnose/actions.ts	90%	Direct hergebruik via API wrapper
Encounter Actions	app/epd/agenda/actions.ts	90%	Direct hergebruik via API wrapper

External

• ICD-10 codes: https://www.who.int/standards/classifications/classification-of-diseases
• FHIR Encounter: https://www.hl7.org/fhir/encounter.html
• FHIR Condition: https://www.hl7.org/fhir/condition.html

---

11. Glossary & Abbreviations

Term	Betekenis
Encounter	Afspraak/contactmoment (FHIR term)
Condition	Diagnose (FHIR term)
ICD-10	International Classification of Diseases versie 10
Hoofddiagnose	Primaire diagnose
Nevendiagnose	Secundaire diagnose
Clinical Status	Status van diagnose (actief, inactief, resolved, etc.)
Severity	Ernst van diagnose (mild, matig, ernstig)

---

Versiehistorie:

Versie	Datum	Auteur	Wijziging
v1.0	23-12-2024	Claude	Initiële versie - Apart bouwplan voor diagnostiek workflow