# Mini-EPD — Architectuur & Datacomponenten (PO/PM)

## 1In het kort

Het Mini-EPD is een elektronisch patiëntdossier voor de GGZ. Een zorgverlener meldt patiënten aan, doet intake, maakt behandelplannen, schrijft dagrapportages en draagt diensten over. Het hart is de Cortex AI Command Center: een natuurlijke-taal-interface (typen of inspreken) waarmee je acties uitvoert in gewone zinnen — "maak een notitie voor Jan: medicatie ingenomen" of "plan een afspraak morgen om 14:00".

## 2De drie lagen van het systeem

Van wat de gebruiker ziet tot waar de gegevens staan.

Laag 1 · Schermen
Wat de gebruiker ziet
Dashboard · Patiëntdossier · Intake · Behandelplan · Verpleegrapportage · Agenda · Cortex AI Command Center
▼
Laag 2 · Logica
De verwerking (API's)
Rapportage · Overdracht · Behandelplan · Intake · Cortex (intentherkenning + chat) · Spraak-naar-tekst
▼
Laag 3 · Gegevens
Database & externe diensten
Supabase database · Claude AI (Anthropic) · Deepgram (spraak)

## 3De modules (wat de gebruiker ziet)

De schermen waarmee de zorgverlener werkt.

🏠
Dashboard
Startscherm met het Cortex AI Command Center. Hier begint elke actie.
📋
Patiëntdossier
Basisgegevens (incl. BSN), diagnoses, observaties en intakes per patiënt.
📝
Intake
Stapsgewijs: contactpersonen, risicotaxatie, anamnese, onderzoek, diagnose, advies.
🎯
Behandelplan
Doelen en interventies per leefgebied vastleggen en beheren.
🔄
Verpleegrapportage
Dagnotities in tijdlijn + overdracht met AI-samenvatting voor de volgende dienst.
📅
Agenda
Kalender met afspraken; inplannen, verzetten of annuleren.

## 4Het hart: Cortex AI Command Center

De gebruiker typt of spreekt een opdracht. Het systeem begrijpt de bedoeling en handelt — in drie slimme lagen die snelheid én begrip combineren.

🗣
Gebruiker zegt of typt iets
"Maak een notitie voor Jan: medicatie ingenomen"
▼
1
Reflex (lokaal) — snel & gratis
Herkent veelvoorkomende opdrachten direct via patronen (<20ms). Twijfel of complex? → door naar laag 2.
▼
2
Orchestrator (AI) — voor lastige gevallen
Claude lost op: meerdere opdrachten tegelijk, "hem/haar", "morgen", onduidelijke zinnen.
▼
✓
Actie uitgevoerd
Notitie opgeslagen · afspraak gemaakt · patiënt gevonden …
▼
3
Nudge — proactieve suggestie achteraf
"Wil je hier ook een observatie bij maken?" — verhoogt de zorgkwaliteit op het juiste moment.

Waarom drie lagen? De goedkope lokale laag vangt het gros af zonder AI-kosten of vertraging. Alleen echt lastige zinnen gaan naar de betaalde AI.

Wat Cortex begrijpt (de "intents"):

Dagnotitie maken Patiënt zoeken Overdracht bekijken Agenda opvragen Afspraak inplannen Afspraak annuleren Afspraak verzetten

## 5De externe diensten (afhankelijkheden)

Waar het product op leunt buiten de eigen code.

🗄️ Supabase
Database + inloggen (authenticatie)
De plek waar alle patiëntgegevens veilig staan.
🤖 Claude (Anthropic)
Intentherkenning · chat · overdrachtssamenvatting · behandelplan
De "intelligentie" achter Cortex en de samenvattingen. Betaalde API → gebruik = kosten.
🎙️ Deepgram
Spraak omzetten naar tekst
Maakt het inspreken van notities mogelijk. Betaalde API → gebruik = kosten.

## 6De gegevens (datacomponenten)

Het datamodel is FHIR-geïnspireerd — de internationale standaard voor zorggegevens, pragmatisch vereenvoudigd. Alles draait om de patiënt.

PATIËNT
naam · BSN · geboortedatum · status
Screening
aanmelding & besluit
Intake
+ risico, anamnese, onderzoek
Diagnose
DSM-5 / ICD-10
Observatie
metingen & scores
Behandelplan
doelen & interventies
Contactmoment → Rapportage
sessies & dagnotities

Soorten rapportage (type):

voortgangobservatieincidentmedicatiecontactcrisisverpleegkundigbehandeladvies

Categorieën (verpleegkundig):

medicatieADLgedragincidentobservatie

## 7De patiëntreis door de data

Hoe een patiënt door het systeem stroomt.

Aangemeld
status: planned
›
Screening
geschikt?
›
Intake
anamnese, risico
›
In zorg
plan + rapportages
›
Overdracht
samenvatting collega

## 8Belangrijke regels in de data

Goed om te weten als PO/PM.

♻️
Soft delete
Verwijderen markeert alleen; data blijft staan. Niets gaat echt verloren — belangrijk voor zorgdossiers en herstel.
🌙
Shift-logica
Notities vóór 07:00 horen bij de dienst van de vórige dag. Zorgt dat nachtdiensten correct in de overdracht vallen.
✅
Overdrachtsfilter
Alleen notities met "meenemen in overdracht" verschijnen in de samenvatting. De zorgverlener bepaalt wat relevant is.
🔒
Row Level Security (RLS)
De database dwingt af wie welke gegevens mag zien — fundament voor privacy/AVG. In deze fase nog ruim ingesteld.
🧠
AI-herkomst
Bij AI-gegenereerde inhoud worden zekerheid en redenering bewaard — transparant en controleerbaar.

## 9Aandachtspunten & status (eerlijk beeld)

⚠️
Prototype-status
Geen productiesysteem. Beveiligingsregels (RLS) zijn nog ruim; verfijning per team/organisatie is nog niet gebouwd.
⚠️
Twee-sporen datamodel
Naast het nieuwe FHIR-model bestaat nog een ouder model. Het nieuwe is leidend; het oude is nog niet opgeruimd — technische schuld om te bewaken.
⚠️
Externe AI-kosten
Schaalbaarheid van Cortex hangt samen met de gebruikskosten van Claude en Deepgram.
⚠️
Nog geen echte interoperabiliteit
Het model is FHIR-geïnspireerd; volledige FHIR-uitwisseling met externe systemen is nog niet geïmplementeerd.