docs(datamodel): feitenronde intake en behandeladvies afgerond

Voegt feitenmodel-intake-behandeladvies.md en model-intake-behandeladvies.md
toe: FCO-IM-feitenronde en entiteiten-/cardinaliteitenafleiding voor
Clinical Intake Assessment, Intake Contact, Child Safety Check en Treatment
Advice. Corrigeert de episode-timing (intake start ná het acceptatiebesluit,
niet bij een niet meer bestaande aanmelding-uitkomst "intake").

Sluit feitenmodel-instroom.md §7 vraag 2 af (behandeladvies-uitkomsten,
sinds sessielog 19 juli geparkeerd): behandeladvies wordt een eigen
Treatment Advice-object met vervangt-mechanisme, naar het patroon van Care
Acceptance Decision — geen apart voorafgaand advies. Op basis van volledige
LKS 4.0-teksttoetsing (niet alleen samenvattingen): doorverwijzing/
terugverwijzing zijn een volgtijdelijk paar, extra_diagnostiek is
praktijkgefundeerd niet LKS-genormeerd, en MDT-bespreking is voor settings
3-8 een dwingende norm (minimale hook: intake_mdt_review).

Legt B31-B34 vast in het besluitenlog, synchroniseert begrippenlijst §4
(Clinical Intake Assessment, Intake Contact, Child Safety Check, Treatment
Advice) en markeert het oudere model-intake.md niet-destructief als
vervangen, consistent met hoe model-aanmelding.md eerder is behandeld.
This commit is contained in:
colinislit
2026-07-19 18:24:34 +02:00
parent 890704a0f4
commit 7ad50f4e33
5 changed files with 850 additions and 31 deletions

View File

@@ -1,7 +1,7 @@
# Begrippenlijst kernmodel — Nederlands/Engels
**Status:** versie 0.2 — §3 (instroom) bijgewerkt na de FCO-IM-feitenronde en het entiteitenmodel
**Datum:** 18 juli 2026, §3 bijgewerkt 19 juli 2026
**Status:** versie 0.3 — §3 (instroom) en §4 (intake/behandeladvies) bijgewerkt na hun FCO-IM-feitenrondes en entiteitenmodellen
**Datum:** 18 juli 2026, §3 en §4 bijgewerkt 19 juli 2026
**Bron:** `besluiten/besluitenlog-datamodel-2026-07-18.md` (B1B30)
**Terminologieonderzoek:** de driedeling Referral Request/Referral Submission/Referral Case uit `onderzoek/onderzoek-engelstalige-epd-terminologie.md` is verwerkt en bevestigd in `feitenmodellen/feitenmodel-instroom.md` en `deelmodellen/model-instroom.md`
**Doel:** één gedeelde betekenis en één Engelse technische naam per kernbegrip, vóór uitwerking van feitzinnen, ERD of SQL
@@ -187,14 +187,21 @@ Een herhaalbare beoordeling van de urgentie van een `Referral Case`, vastgesteld
**Is niet:** een vast statusveld — de meest recente beoordeling geldt, zonder vervangt-relatie (lagere inzet dan een acceptatiebesluit).
## 4. Intake
## 4. Intake en behandeladvies
Bijgewerkt 19 juli 2026 na de FCO-IM-feitenronde voor intake en
behandeladvies (`feitenmodellen/feitenmodel-intake-behandeladvies.md`,
`deelmodellen/model-intake-behandeladvies.md`).
### Clinical Intake Assessment — `clinical_intake_assessment`
**Nederlandse domeinterm:** intake / intaketraject
**Status Engelse naam:** bevestigen
**Status Engelse naam:** aanbevolen
Een dynamisch klinisch onderzoekstraject voor één samenhangende zorgvraag, met meerdere contacten, onderzoeken, disciplines en bevindingen.
Een dynamisch klinisch onderzoekstraject voor één samenhangende zorgvraag,
met meerdere contacten, onderzoeken, disciplines en bevindingen. Hangt aan
de Clinical Care Episode; start op enig moment ná het acceptatiebesluit dat
de episode liet ontstaan, mogelijk na een periode op de intakewachtlijst.
**Is niet:** één gesprek, screening, aanmeldingstraject of FHIR `Encounter`.
@@ -209,14 +216,44 @@ Eén feitelijk contact binnen de intake.
**Is niet:** de intake zelf of automatisch een declarabel consult.
### Intake Assessment Activity`intake_assessment_activity`
**Terminologienotitie:** `Intake Assessment Activity` (`intake_assessment_activity`)
is niet als aparte entiteit doorgezet — onderzoeksactiviteiten (aanvullend
onderzoek, telefonisch contact, huisbezoek, beeldcontact) zijn getypeerde
waarden van `intake_contact.contact_type`, geen zelfstandig object.
**Nederlandse domeinterm:** intakeonderzoek / onderzoeksactiviteit
**Status Engelse naam:** bevestigen
### Child Safety Check — `child_safety_check`
Een diagnostische, somatische of andere onderzoeksactiviteit binnen de intake.
**Nederlandse domeinterm:** kindcheck
**Status Engelse naam:** aanbevolen
**Is niet:** de uiteindelijke diagnose of automatisch een uitgevoerde declarabele prestatie.
De wettelijk verankerde kindcheck (Wet verplichte meldcode huiselijk geweld
en kindermishandeling; KNMG-meldcode) bij de intake van een volwassen
cliënt: is de cliënt verantwoordelijk voor minderjarigen, zijn er zorgen
over hun veiligheid, en is daarop actie ondernomen.
**Is niet:** het volledige meldcode-stappenplan — dat is proces-state,
TIP-terrein. Alleen de klinische feiten horen in het ECD.
### Treatment Advice — `treatment_advice`
**Nederlandse domeinterm:** behandeladvies
**Status Engelse naam:** aanbevolen
Het object dat een Clinical Intake Assessment afrondt: draagt de uitkomst
(in zorg, terug- of doorverwijzing, aanvullende diagnostiek nodig), het
geadviseerde zorgprogramma en de toelichting. Kan een eerder advies van
dezelfde intake vervangen bij heroverweging.
**Is niet:** een apart, voorafgaand advies naast een later formeel besluit —
het advies zelf ís de vervolgrichting, net als bij Care Acceptance
Decision. Geen behandelplan — het advies wijst een richting, het
behandelplan werkt die uit.
**Terminologienotitie:** `doorverwijzing` en `terugverwijzing` zijn volgens
LKS 4.0 een volgtijdelijk paar (eerst doorverwijzen proberen, dan pas
terugverwijzen), geen onafhankelijke alternatieven — gedekt door de
vervangt-relatie, niet door een aparte sequentie-regel. `extra_diagnostiek`
is een praktijkgefundeerde uitkomst, niet LKS-genormeerd.
## 5. Episode en financiering
@@ -530,18 +567,31 @@ Expliciet geselecteerde en getypeerde klinische informatie met bron, bronepisode
- `access_case_consolidation` → hernoemd naar `case_consolidation`, naam bevestigd;
- `screening_recommendation` → vervallen, geen apart besluitobject naast `care_acceptance_decision` (B21).
**Opgelost bij de intake-/behandeladvies-feitenronde (19 juli 2026), zie §4:**
- `clinical_intake_assessment` — naam bevestigd (was: te bevestigen);
- `intake_assessment_activity` → niet als aparte entiteit doorgezet, nu waarde van `intake_contact.contact_type`;
- `treatment_advice` — nieuw, bevestigd (loste `feitenmodellen/feitenmodel-instroom.md` §7 vraag 2 op).
De betekenis van onderstaande begrippen staat vast, maar de Engelse naam moet nog expliciet worden bevestigd:
1. `clinical_intake_assessment` — intake als proces;
2. `funding_case` — financieel traject;
3. `lead_clinician_role` — regiebehandelaar;
4. `care_goal` — behandel-/zorgdoel;
5. `care_planning_profile` — behandelvisieprofiel;
6. `cross_episode_clinical_concept` — voorlopige naam voor de longitudinale architectuurlaag.
1. `funding_case`financieel traject;
2. `lead_clinician_role` — regiebehandelaar;
3. `care_goal` — behandel-/zorgdoel;
4. `care_planning_profile` — behandelvisieprofiel;
5. `cross_episode_clinical_concept` — voorlopige naam voor de longitudinale architectuurlaag.
Daarnaast, uit de instroom-ronde, nog juridisch te bevestigen (niet een naamskwestie maar een inhoudelijke aanname, zie B27 en `deelmodellen/model-instroom.md` §7 punt 3):
7. `municipal_care_assignment` — gemeentelijke toewijzing;
8. `legal_mandate` — wettelijk mandaat (Wvggz).
6. `municipal_care_assignment` — gemeentelijke toewijzing;
7. `legal_mandate` — wettelijk mandaat (Wvggz).
En uit de intake-/behandeladvies-ronde, eveneens een inhoudelijke aanname
i.p.v. een naamskwestie (zie `deelmodellen/model-intake-behandeladvies.md`
§6 punt 3):
8. `child_safety_check` — de vierde vlag (zwangerschap) is toegevoegd op
basis van algemene domeinkennis, niet uit de eerder verzamelde
onderzoeksrapporten.
Deze namen worden vóór het logische ER-model één voor één beoordeeld. Tot dat moment zijn ze bruikbaar als werktermen, niet als definitieve database-identifiers.