Files

colinislit d622ac8035 feat(overdracht): E2 + E3 - API overdracht en dagregistratie UI

Epic 2 - API Overdracht:
- GET /api/overdracht/patients (patiënten met alerts)
- GET /api/overdracht/[patientId] (detail met vitals, reports, logs, risks)
- POST /api/overdracht/generate (AI samenvatting met bronverwijzingen)
- lib/ai/overdracht-prompt.ts (system + user prompt)
- lib/types/overdracht.ts (TypeScript types)

Epic 3 - Dagregistratie UI:
- /epd/dagregistratie/[patientId] pagina
- Quick entry form (categorie, tijd, tekst, overdracht checkbox)
- Edit/Delete functionaliteit met inline editing
- Confirm delete dialog
- Summary cards (totaal, overdracht, incidenten)

Bouwplan bijgewerkt naar v1.2 (10/19 stories voltooid)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-12-06 00:18:06 +01:00

12 KiB

Raw Blame History

Mission Control - Bouwplan Overdracht Dashboard

Projectnaam: Verpleegkundige Overdracht Dashboard Versie: v1.2 Datum: 06-12-2024 Auteur: Colin Lit

1. Doel en context

Doel: Een werkend MVP bouwen van het Overdracht Dashboard met Dagregistratie Module. Verpleegkundigen kunnen snel patiëntinformatie overzien en met AI-hulp een beknopte overdracht genereren in 30 seconden.

Context:

Verpleegkundigen doen gemiddeld 6 overdrachten per dag
Huidige workflow is tijdrovend en foutgevoelig
Dit dashboard bundelt vitals, rapportages, dagnotities en risico's
AI genereert gestructureerde samenvattingen met bronverwijzingen

Relatie met andere documenten:

PRD: prd-overdracht-dashboard-v1.md - scope en requirements
FO: fo-overdracht-dashboard-v1.1.md - functionele specificatie
TO: to-overdracht-dashboard-v1.md - technische architectuur

2. Uitgangspunten

2.1 Technische Stack

Component	Technologie	Status
Frontend	Next.js 15 (App Router)	Bestaand
Backend	Next.js API Routes	Bestaand
Database	Supabase (PostgreSQL)	Bestaand
AI	Claude claude-sonnet-4-20250514 (Anthropic)	Bestaand
Styling	TailwindCSS + shadcn/ui	Bestaand
Validation	Zod	Bestaand
Auth	Supabase Auth + RLS	Bestaand

2.2 Projectkaders

Nieuwe dependencies: Geen (alles aanwezig)
Database: 1 nieuwe tabel (nursing_logs)
Routes: 2 nieuwe secties (/epd/overdracht/, /epd/dagregistratie/)
API endpoints: 5 nieuwe endpoints
Data: Demo data beschikbaar (patients, encounters, reports)

2.3 Programmeer Uitgangspunten

Code Quality Principles:

DRY: Hergebruik bestaande componenten (Card, Badge, AIButton)
KISS: Eenvoudige Server Components waar mogelijk
SOC: API logic in /api/, UI in /app/epd/, types in /lib/types/
YAGNI: Alleen MVP features, geen "nice to have"

Bestaande Patterns:

AI integratie: app/api/behandelplan/generate/route.ts
CRUD API: app/api/reports/route.ts
Form components: app/epd/patients/[id]/screening/
Card layouts: components/ui/card.tsx

3. Epics & Stories Overzicht

Epic ID	Titel	Doel	Status	Stories	Complexiteit
E0	Database Setup	nursing_logs tabel + RLS	✅ Done	2	Laag
E1	API Nursing Logs	CRUD endpoints voor dagnotities	✅ Done	2	Laag
E2	API Overdracht	Endpoints voor overdracht data + AI	✅ Done	3	Middel
E3	Dagregistratie UI	Quick entry module	✅ Done	3	Middel
E4	Overdracht Overzicht	Patiënten grid	⏳ To Do	2	Middel
E5	Overdracht Detail	Info blokken + AI samenvatting	⏳ To Do	4	Middel
E6	Integratie & Polish	Sidebar, navigatie, testing	⏳ To Do	3	Laag

Totaal: 19 stories

4. Epics & Stories (Uitwerking)

Epic 0 - Database Setup

Epic Doel: nursing_logs tabel aanmaken met RLS policies en indexes.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afh.	SP
E0.S1	nursing_logs tabel aanmaken	Tabel bestaat met alle kolommen uit TO, indexes aanwezig	✅	-	2
E0.S2	RLS policies implementeren	SELECT/INSERT/UPDATE/DELETE policies actief, alleen eigen logs muteerbaar	✅	E0.S1	2

Technical Notes:

Migratie via npx supabase migration new create_nursing_logs
Kolommen: id, patient_id, shift_date, timestamp, category, content, include_in_handover, created_by
Categories: medicatie, adl, gedrag, incident, observatie

Epic 1 - API Nursing Logs

Epic Doel: CRUD endpoints voor dagnotities.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afh.	SP
E1.S1	GET/POST /api/nursing-logs	Ophalen per patient+date, aanmaken met Zod validatie	✅	E0.S2	3
E1.S2	PATCH/DELETE /api/nursing-logs/[id]	Update eigen logs, hard delete	✅	E1.S1	2

Technical Notes:

Pattern volgen van app/api/reports/route.ts
Zod schema: CreateNursingLogSchema, UpdateNursingLogSchema
shift_date automatisch bepalen op basis van timestamp

Epic 2 - API Overdracht

Epic Doel: Endpoints voor overdracht overzicht, detail en AI generatie.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afh.	SP
E2.S1	GET /api/overdracht/patients	Retourneert patiënten met encounters vandaag + alert counts	✅	E0.S2	3
E2.S2	GET /api/overdracht/[patientId]	Retourneert patient + vitals + reports + logs + risks + conditions	✅	E1.S1	5
E2.S3	POST /api/overdracht/generate	AI samenvatting met bronverwijzingen, logging naar ai_events	✅	E2.S2	5

Technical Notes:

E2.S2: Parallel queries via Promise.all()
E2.S3: Pattern van behandelplan/generate, nieuwe prompt in lib/ai/overdracht-prompt.ts
AI output: { samenvatting, aandachtspunten[], actiepunten[] }

Epic 3 - Dagregistratie UI

Epic Doel: Quick entry module voor verpleegkundige notities.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afh.	SP
E3.S1	Dagregistratie page	Route `/epd/dagregistratie/[patientId]`, lijst van notities vandaag	✅	E1.S2	3
E3.S2	Quick entry form	Categorie dropdown, tijd, tekst (max 500), overdracht checkbox	✅	E3.S1	5
E3.S3	Edit/Delete functionality	Inline edit, confirm delete dialog	✅	E3.S2	3

Technical Notes:

Icons per categorie: Pill (medicatie), Utensils (adl), User (gedrag), AlertTriangle (incident), FileText (observatie)
Kleuren: red (incident), blue (medicatie), green (adl), purple (gedrag), gray (observatie)
Optimistic UI updates

Epic 4 - Overdracht Overzicht

Epic Doel: Grid van patiënten met alerts voor overdracht.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afh.	SP
E4.S1	Overdracht overzicht page	Route `/epd/overdracht/`, grid van PatientCards, filter tabs	⏳	E2.S1	5
E4.S2	PatientCard component	Naam, leeftijd, alert badge (rood=hoog risico), doorklik	⏳	E4.S1	3

Technical Notes:

Filter tabs: "Alle patiënten", "Met alerts"
Alert count = high_risk_count + abnormal_vitals_count + marked_logs_count
Responsive grid: 1 col mobile, 2 col tablet, 3-4 col desktop

Epic 5 - Overdracht Detail

Epic Doel: Patiënt detail pagina met informatieblokken en AI samenvatting.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afh.	SP
E5.S1	Overdracht detail page	Route `/epd/overdracht/[patientId]`, patient header, 2-kolom layout	⏳	E2.S2	3
E5.S2	Info blokken: Vitals + Reports	VitalsBlock (metingen vandaag), ReportsBlock (24u)	⏳	E5.S1	5
E5.S3	Info blokken: Logs + Risks	NursingLogsBlock (gemarkeerd), RisksBlock (actief)	⏳	E5.S2	5
E5.S4	AI Samenvatting blok	AIButton "Genereer samenvatting", loading state, output met bronnen	⏳	E2.S3, E5.S3	5

Technical Notes:

Linker kolom: Vitals, Reports, Logs, Risks (scrollable)
Rechter kolom: AI Samenvatting (sticky)
Bronverwijzingen klikbaar naar originele record
Empty states per blok

Epic 6 - Integratie & Polish

Epic Doel: Sidebar link, navigatie en testing.

Story ID	Beschrijving	Acceptatiecriteria	Status	Afh.	SP
E6.S1	Sidebar uitbreiden	"Overdracht" link in EPD sidebar met alert badge	⏳	E4.S1	1
E6.S2	Navigatie links	Link van dagregistratie naar overdracht en vice versa	⏳	E5.S3	2
E6.S3	Smoke testing	Alle flows werken, geen console errors, performance OK	⏳	E6.S2	3

Technical Notes:

Sidebar icon: ClipboardList (lucide)
Badge toont totaal aantal alerts
Test met bestaande demo patients

5. Kwaliteit & Testplan

Test Types

Test Type	Scope	Verantwoordelijke
Manual Testing	Alle flows	Developer
TypeScript	Type checking	Build process
RLS Testing	Database policies	Developer

Manual Test Checklist

Dagregistratie:

Nieuwe notitie aanmaken werkt
Categorie selectie werkt
"Opnemen in overdracht" checkbox werkt
Edit notitie werkt
Delete notitie werkt (met confirm)
Lijst refresht na mutatie

Overdracht Overzicht:

Grid toont patiënten met encounters vandaag
Alert badges tonen correct aantal
Filter "Met alerts" werkt
Doorklik naar detail werkt

Overdracht Detail:

Patient header toont naam, leeftijd, diagnose
Vitals blok toont metingen vandaag (of empty state)
Reports blok toont laatste 24u (of empty state)
Nursing logs blok toont gemarkeerde notities
Risks blok toont actieve risico's
AI samenvatting genereert binnen 5 sec
Bronverwijzingen in AI output zijn correct

Performance:

Overzicht laadt < 2 sec
Detail laadt < 1.5 sec
AI response < 5 sec

6. Succescriteria (uit PRD)

Overzicht laadt binnen 2 seconden
Patiënt detail toont alle 6 informatieblokken correct (incl. dagnotities)
Dagregistratie form submit < 1 seconde
AI samenvatting genereert binnen 5 seconden
AI output is begrijpelijk en medisch relevant
AI integreert dagnotities correct in samenvatting
Navigatie tussen overzicht, detail en dagregistratie werkt vlot
Alerts (hoog risico, afwijkende vitals, gemarkeerde notities) zijn direct zichtbaar
Empty states bij ontbrekende data zijn informatief

7. Risico's & Mitigatie

Risico	Kans	Impact	Mitigatie
AI samenvatting te lang/vaag	Middel	Hoog	Strikte prompt, max tokens, testen
Geen vitale functies in systeem	Hoog	Laag	Graceful empty state
Performance bij veel data	Laag	Middel	Indexes, parallel queries
AI hallucinaties	Laag	Hoog	Bronverwijzingen verplicht
VPK vergeet notities markeren	Middel	Middel	UI hint, standaard checkbox

8. Niet in Scope (MVP)

Feature	Reden
Medicatie-invoer	Alleen weergave, aparte module
Historische trends	Geen grafieken
PDF export	Komt later
Notificaties	Geen realtime alerts
Multi-afdeling	Te complex
Rechten per rol	Beperkt onderscheid VPK/arts

9. Referenties

Mission Control Documents

Document	Status
PRD Overdracht Dashboard v1.0	Gereed
FO Overdracht Dashboard v1.1	Gereed
TO Overdracht Dashboard v1.0	Gereed
Bouwplan v1.0	Gereed (dit document)

Code Locaties

Wat	Locatie
AI prompt pattern	`lib/ai/behandelplan-prompt.ts`
API route pattern	`app/api/reports/route.ts`
shadcn components	`components/ui/`
EPD layout	`app/epd/layout.tsx`
Sidebar	`app/epd/components/epd-sidebar.tsx`

10. Glossary

Term	Betekenis
Overdracht	Mondelinge/schriftelijke informatieoverdracht tussen diensten
VPK	Verpleegkundige
Dagnotitie	Korte registratie tijdens dienst (nursing_log)
Alert	Signaal voor aandacht (hoog risico, afwijking, incident)
Handover	Engelse term voor overdracht

Changelog

Versie	Datum	Auteur	Wijziging
v1.0	05-12-2024	Colin	Initieel bouwplan gebaseerd op PRD, FO en TO
v1.1	06-12-2024	Claude	E0 + E1 afgerond: database setup + API nursing logs
v1.2	06-12-2024	Claude	E2 + E3 afgerond: API overdracht + dagregistratie UI

12 KiB Raw Blame History

Mission Control - Bouwplan Overdracht Dashboard

1. Doel en context

2. Uitgangspunten

2.1 Technische Stack

2.2 Projectkaders

2.3 Programmeer Uitgangspunten

3. Epics & Stories Overzicht

4. Epics & Stories (Uitwerking)

Epic 0 - Database Setup

Epic 1 - API Nursing Logs

Epic 2 - API Overdracht

Epic 3 - Dagregistratie UI

Epic 4 - Overdracht Overzicht

Epic 5 - Overdracht Detail

Epic 6 - Integratie & Polish

5. Kwaliteit & Testplan

Test Types

Manual Test Checklist

6. Succescriteria (uit PRD)

7. Risico's & Mitigatie

8. Niet in Scope (MVP)

9. Referenties

Mission Control Documents

Code Locaties

10. Glossary

Changelog

12 KiB

Raw Blame History