colin/triqura-ecd
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(datamodel): FCO-IM feitenronde instroom, besluitenlog + herstructurering

Browse Source 
Voegt de discovery- en besluitvormingsronde van 18-19 juli toe (besluitenlog,
begrippenlijst, feitenmodel-instroom met scenariotoetsen, terminologie- en
leveranciersonderzoek) en synchroniseert feitenmodel-instroom.md met de
screening=acceptatie-beslissing (§5). Herstructureert docs/datamodel/ naar
submappen per documentsoort (besluiten/sessielogs/feitenmodellen/deelmodellen/
onderzoek/entiteitenkaarten) zodat toekomstige besluitenlogs en feitenrondes
per deelgebied een vaste plek krijgen.
This commit is contained in:
colinislit
2026-07-19 11:07:21 +02:00
parent 37beef14be
commit 2a1278936b
20 changed files with 6169 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files

484
docs/datamodel/begrippenlijst-kernmodel.md Normal file
View File

@@ -0,0 +1,484 @@
# Begrippenlijst kernmodel — Nederlands/Engels
**Status:** versie 0.1, ter inhoudelijke en terminologische review
**Datum:** 18 juli 2026
**Bron:** `besluiten/besluitenlog-datamodel-2026-07-18.md`
**Terminologieonderzoek:** `onderzoek/onderzoek-engelstalige-epd-terminologie.md` adviseert voor de instroom een driedeling in Referral Request, Referral Submission en Referral Case; nog niet als begrippenbesluit verwerkt
**Doel:** één gedeelde betekenis en één Engelse technische naam per kernbegrip, vóór uitwerking van feitzinnen, ERD of SQL
## 1. Gebruik en naamgeving
- De **Nederlandse domeinterm** en definitie leggen de zorginhoudelijke betekenis vast.
- De **Engelse conceptnaam** is de naam in technische modeldocumentatie.
- De **identifier** is de voorgestelde stam voor tabellen, attributen, events en API-objecten. De fysieke naamgevingsconventie wordt bij het logische model definitief.
- Een term met status **bevestigen** heeft nog expliciete domeinreview nodig; de betekenis staat wel vast.
- Officiële Nederlandse wettelijke of professionele termen blijven als bronterm en metadata beschikbaar.
- Lokale namen impliceren geen directe FHIR-, zib- of andere standaardmapping. Uitwisseling loopt via adapters.
### Vermijden
- `admission` voor aanmelding of acceptatie: dit suggereert klinische opname.
- `trajectory` voor traject: dit is in deze betekenis een Dutchism.
- `encounter` voor intake: een intake is een proces met meerdere contacten.
- `consent` voor planakkoord: planakkoord is niet hetzelfde als behandeltoestemming.
- Ongekwalificeerde namen als `care_plan`, `care_team` en `episode_of_care`: die kunnen ten onrechte een directe FHIR-mapping suggereren.
## 2. Identiteit en cliëntrol
### Person — `person`
**Nederlandse domeinterm:** persoon
**Status Engelse naam:** aanbevolen
Een natuurlijke persoon van wie identiteit en demografische gegevens kunnen worden vastgelegd, onafhankelijk van een zorgrelatie.
**Is niet:** automatisch een cliënt, medewerker, vertegenwoordiger of contactpersoon. Die betekenissen ontstaan via afzonderlijke rollen en relaties.
### Client — `client`
**Nederlandse domeinterm:** cliënt
**Status Engelse naam:** aanbevolen
De instellingsgebonden rol van een persoon voor wie zorg of mogelijke zorg wordt geadministreerd.
**Is niet:** de persoon zelf, een zorgepisode of bewijs dat al een behandelrelatie bestaat.
**Terminologienotitie:** `client` is een bewuste productkeuze. De UI gebruikt “cliënt”; uitwisselingsadapters kunnen waar nodig naar `Patient` mappen.
## 3. Instroom en beoordeling
### Inbound Care Signal — `inbound_care_signal`
**Nederlandse domeinterm:** aanmeldsignaal
**Status Engelse naam:** bevestigen
Eén afzonderlijke binnenkomst bij de instelling, met een eigen bron, tijdstip, documenten en oorspronkelijk geuite zorgvraag.
**Is niet:** een verwijzing, aanmeldingstraject, intake of geaccepteerd zorgverzoek. Een zelfaanmelding en informatie van een derde kunnen beide een aanmeldsignaal zijn.
**Terminologienotitie:** `referral` is te smal; `signal` is internationaal minder gangbaar maar dekt wel dat iedere binnenkomst als zelfstandig bronfeit behouden blijft.
### Access Assessment Case — `access_assessment_case`
**Nederlandse domeinterm:** aanmeldingstraject
**Status Engelse naam:** bevestigen
Het institutionele beoordelingsproces voor één samenhangende zorgvraag, gevoed door één of meer aanmeldsignalen.
**Is niet:** een opname, verwijzing, klinische intake, zorgepisode of financieel traject.
**Terminologienotitie:** `case` duidt hier een behandelbare workflowcase aan, nog geen klinische casus of zorgepisode.
### Presenting Care Need — `presenting_care_need`
**Nederlandse domeinterm:** zorgvraag
**Status Engelse naam:** bevestigen
De door cliënt of bron geuite behoefte, klacht of gewenste ondersteuning waarop de instroombeoordeling en mogelijke zorg zich richten.
**Is niet:** een diagnose, vastgesteld behandeltekort, bestelling van zorg of FHIR `ServiceRequest`.
**Open nuance:** bij de verdere modellering moet onderscheid worden gemaakt tussen de oorspronkelijk geuite zorgvraag en de later professioneel beoordeelde zorgbehoefte.
### Referral — `referral`
**Nederlandse domeinterm:** verwijzing
**Status Engelse naam:** aanbevolen
Een formele verwijzing door een bevoegde of toegestane bron, inclusief relevante verwijzer, context en geldigheid.
**Is niet:** ieder aanmeldsignaal. Een zelfaanmelding of los aanvullend document is niet automatisch een verwijzing.
### Signal-to-Case Assignment — `signal_case_assignment`
**Nederlandse domeinterm:** toewijzing van aanmeldsignaal aan aanmeldingstraject
**Status Engelse naam:** aanbevolen
De historiseerbare koppeling waarmee een aanmeldsignaal aan een beoordelingscase wordt toegewezen.
**Is niet:** destructieve verplaatsing. Het oorspronkelijke signaal en eerdere toewijzingen blijven bestaan.
### Access Case Consolidation — `access_case_consolidation`
**Nederlandse domeinterm:** logische samenvoeging van aanmeldingstrajecten
**Status Engelse naam:** bevestigen
Een niet-destructieve relatie waarbij één aanmeldingstraject als leidend wordt aangewezen en de oorspronkelijke trajecten, signalen en herkomst behouden blijven.
**Is niet:** database-merge, verwijderen, overschrijven of stil hernummeren.
### Screening — `screening`
**Nederlandse domeinterm:** screening
**Status Engelse naam:** aanbevolen
Een institutionele beoordelingsstap binnen het aanmeldingstraject waarin informatie wordt verzameld en een inhoudelijk advies kan worden voorbereid.
**Is niet:** de formele acceptatie, klinische intake of zorgepisode.
### Screening Recommendation — `screening_recommendation`
**Nederlandse domeinterm:** screeningsbesluit / screeningsadvies
**Status Engelse naam:** bevestigen
De inhoudelijke uitkomst van de screening, bijvoorbeeld geschiktheid, geadviseerde bestemming en urgentie.
**Is niet:** het formele acceptatiebesluit. De Engelse naam gebruikt bewust `recommendation`, omdat de screening niet altijd besluitvormend is.
### Care Acceptance Decision — `care_acceptance_decision`
**Nederlandse domeinterm:** acceptatiebesluit
**Status Engelse naam:** aanbevolen
Het formele besluit waarmee een cliënt voor een samenhangende zorgvraag tot het zorgproces wordt toegelaten en een zorgepisode kan ontstaan.
**Is niet:** behandelovereenkomst, behandeltoestemming, opnamebesluit, zorgplicht of toewijzing van verantwoordelijkheid.
## 4. Intake
### Clinical Intake Assessment — `clinical_intake_assessment`
**Nederlandse domeinterm:** intake / intaketraject
**Status Engelse naam:** bevestigen
Een dynamisch klinisch onderzoekstraject voor één samenhangende zorgvraag, met meerdere contacten, onderzoeken, disciplines en bevindingen.
**Is niet:** één gesprek, screening, aanmeldingstraject of FHIR `Encounter`.
**Terminologienotitie:** `assessment` mag niet worden geïnterpreteerd als één meetmoment; dit is een procesobject.
### Intake Contact — `intake_contact`
**Nederlandse domeinterm:** intakecontact
**Status Engelse naam:** aanbevolen
Eén feitelijk contact binnen de intake.
**Is niet:** de intake zelf of automatisch een declarabel consult.
### Intake Assessment Activity — `intake_assessment_activity`
**Nederlandse domeinterm:** intakeonderzoek / onderzoeksactiviteit
**Status Engelse naam:** bevestigen
Een diagnostische, somatische of andere onderzoeksactiviteit binnen de intake.
**Is niet:** de uiteindelijke diagnose of automatisch een uitgevoerde declarabele prestatie.
## 5. Episode en financiering
### Clinical Care Episode — `clinical_care_episode`
**Nederlandse domeinterm:** zorgepisode
**Status Engelse naam:** aanbevolen
De instellingbrede ordening van één formeel geaccepteerde klinische zorgperiode.
**Is niet:** FHIR `EpisodeOfCare`, aanmeldingstraject, afdeling, zorgprogramma, behandelovereenkomst of financieel traject.
Een episode kan meerdere zorgprogramma’s, organisatorische eenheden en disciplines omvatten. Na afsluiting ontstaat bij terugkeer een nieuwe, gerelateerde episode.
### Episode Relationship — `episode_relationship`
**Nederlandse domeinterm:** episoderelatie
**Status Engelse naam:** aanbevolen
Een getypeerde relatie tussen twee zorgepisodes, bijvoorbeeld terugkeer, voortzetting van relevante voorgeschiedenis of andere klinische samenhang.
**Is niet:** autorisatie, toegang of automatische overname van informatie.
### Funding Case — `funding_case`
**Nederlandse domeinterm:** financieel traject
**Status Engelse naam:** bevestigen
Een zelfstandig object dat financierings-, legitimatie- en declaratieregels voor een periode volgt.
**Is niet:** zorgepisode, factuur, declaratieregel of behandelplan.
**Terminologienotitie:** `billing episode` is te smal en `financial trajectory` is een Dutchism. De precieze naam wordt bij de declaratieronde opnieuw beoordeeld.
### Care Program — `care_program`
**Nederlandse domeinterm:** zorgprogramma
**Status Engelse naam:** aanbevolen
Een inhoudelijk georganiseerd zorgaanbod of behandelprogramma dat tijdens een periode bij een zorgepisode betrokken kan zijn.
**Is niet:** organisatorische afdeling, eigenaar van de episode of een aparte zorgepisode.
### Organizational Unit — `organizational_unit`
**Nederlandse domeinterm:** organisatorische eenheid
**Status Engelse naam:** aanbevolen
Een formeel onderdeel van de instelling, zoals afdeling, locatiegebonden team of andere beheerde organisatie-eenheid.
**Is niet:** zorgprogramma, zorgteam rond een cliënt of automatisch een autorisatiegroep.
### Care Program Involvement — `care_program_involvement`
**Nederlandse domeinterm:** zorgprogrammabetrokkenheid
**Status Engelse naam:** aanbevolen
De tijdgebonden betrokkenheid van een zorgprogramma bij een zorgepisode.
**Is niet:** eigenaarschap of klinische verantwoordelijkheid.
### Organizational Unit Involvement — `organizational_unit_involvement`
**Nederlandse domeinterm:** organisatorische betrokkenheid
**Status Engelse naam:** aanbevolen
De tijdgebonden betrokkenheid van een organisatorische eenheid bij een zorgepisode.
**Is niet:** autorisatie of verantwoordelijkheid voor een specifiek besluit.
## 6. Zorgteam, rol en bevoegdheid
### Episode Clinical Team — `episode_clinical_team`
**Nederlandse domeinterm:** zorgteam rond de zorgepisode
**Status Engelse naam:** aanbevolen
De tijdgebonden verzameling professionals die rond een zorgepisode betrokken zijn.
**Is niet:** FHIR `CareTeam`, een afdeling, autorisatiegroep of permanent personeelsteam.
### Episode Team Assignment — `episode_team_assignment`
**Nederlandse domeinterm:** zorgteamlidmaatschap / teamtoewijzing
**Status Engelse naam:** aanbevolen
De tijdgebonden toewijzing van een professional aan het zorgteam, inclusief de functionele teamrol.
**Is niet:** automatisch bewijs van toegang, beslisbevoegdheid of klinische verantwoordelijkheid.
### Episode Team Role — `episode_team_role`
**Nederlandse domeinterm:** teamrol binnen de zorgepisode
**Status Engelse naam:** aanbevolen
De functionele rol die een professional gedurende een periode binnen het zorgteam vervult.
**Is niet:** professie, functiebenaming of beslisbevoegdheid.
### Clinical Responsibility Assignment — `clinical_responsibility_assignment`
**Nederlandse domeinterm:** klinische verantwoordelijkheidstoewijzing
**Status Engelse naam:** aanbevolen
Een expliciete, tijdgebonden verantwoordelijkheid voor een zorgaspect, taak, proces of besluitgebied.
**Is niet:** algemene aansprakelijkheid, toegang, teamlidmaatschap of professie.
### Decision Authority — `decision_authority`
**Nederlandse domeinterm:** beslisbevoegdheid
**Status Engelse naam:** aanbevolen
De bevoegdheid om een bepaald type besluit te nemen, getoetst aan actuele rol, kwalificaties en geldende configuratie.
**Is niet:** aanwezigheid bij overleg, adviesrecht of uitsluitend een BIG-professie.
### Lead Clinician Role — `lead_clinician_role`
**Nederlandse domeinterm:** regiebehandelaar
**Officiële bronterm:** `regiebehandelaar`
**Status Engelse naam:** bevestigen
De Nederlandse GGZ-rol met regieverantwoordelijkheden volgens het toepasselijke kwaliteitsstatuut en de lokale roltoewijzing.
**Is niet:** automatisch de psychiater, hoofdbehandelaar, enige verantwoordelijke, casemanager of `attending physician`.
**Terminologienotitie:** er bestaat geen volledige één-op-éénvertaling. De officiële Nederlandse term en brondefinitie blijven daarom altijd beschikbaar.
## 7. Behandelplan
### Treatment Plan — `treatment_plan`
**Nederlandse domeinterm:** behandelplan
**Status Engelse naam:** aanbevolen
Eén levend, multidisciplinair en episodegebonden plan met een stabiele identiteit.
**Is niet:** FHIR `CarePlan`, plat formulier, plansnapshot of disciplinespecifiek deelplan.
### Treatment Plan Snapshot — `treatment_plan_snapshot`
**Nederlandse domeinterm:** behandelplansnapshot / plansnapshot
**Status Engelse naam:** aanbevolen
Een onveranderlijke formele weergave van het behandelplan bij vaststelling, formele evaluatie of cliëntbespreking.
**Is niet:** een nieuw behandelplan of een vrij bewerkbare werkversie.
### Focus Area — `focus_area`
**Nederlandse domeinterm:** aandachtgebied
**Status Engelse naam:** aanbevolen
Een onderwerp binnen het behandelplan waarop doelen, risico’s, krachten, herstel of preventie betrekking kunnen hebben.
**Is niet:** uitsluitend een probleem, diagnose of leefgebied.
### Focus Perspective — `focus_perspective`
**Nederlandse domeinterm:** perspectief op aandachtgebied
**Status Engelse naam:** aanbevolen
Een duiding van een aandachtgebied, zoals klacht, diagnose, leefgebied, kracht, beschermende factor, risico, herstel of preventie.
**Is niet:** een apart behandelplan of een verplichte enkelvoudige classificatie.
### Care Goal — `care_goal`
**Nederlandse domeinterm:** behandel-/zorgdoel
**Status Engelse naam:** bevestigen
Een gewenste uitkomst binnen het behandelplan, inclusief klinische, maatschappelijke, herstelgerichte en preventieve doelen.
**Is niet:** uitsluitend symptoomreductie of automatisch FHIR `Goal`.
**Terminologienotitie:** `treatment_goal` is mogelijk te smal voor preventieve en maatschappelijke doelen.
### Planned Intervention — `planned_intervention`
**Nederlandse domeinterm:** geplande interventie
**Status Engelse naam:** aanbevolen
Een in het behandelplan afgesproken professionele interventie of activiteit ter ondersteuning van één of meer doelen.
**Is niet:** afspraakmoment, bewijs van uitvoering of automatisch een declarabele prestatie.
### Client Perspective — `client_perspective`
**Nederlandse domeinterm:** cliëntperspectief
**Status Engelse naam:** aanbevolen
De eigen doelen, voorkeuren, bezwaren, context en duiding van de cliënt binnen het behandelplan.
**Is niet:** planakkoord of behandeltoestemming.
### Client Plan Response — `client_plan_response`
**Nederlandse domeinterm:** cliëntreactie op plansnapshot / planakkoord
**Status Engelse naam:** aanbevolen
De snapshotgebonden reactie van de cliënt of vertegenwoordiger: akkoord, gedeeltelijk akkoord, niet akkoord of niet verkregen.
**Is niet:** behandeltoestemming, juridische grondslag of planstatus.
### Treatment Consent — `treatment_consent`
**Nederlandse domeinterm:** behandeltoestemming
**Status Engelse naam:** aanbevolen
Toestemming voor een concrete behandeling of afgebakend geheel van behandelingen.
**Is niet:** akkoord met het behandelplan als geheel.
### Treatment Legal Basis — `treatment_legal_basis`
**Nederlandse domeinterm:** juridische grondslag voor behandeling
**Status Engelse naam:** aanbevolen
De expliciete juridische grondslag waarop behandeling zonder reguliere toestemming in een afgebakende situatie mag plaatsvinden.
**Is niet:** een generieke bypass voor ontbrekend planakkoord of behandeltoestemming.
### Care Planning Profile — `care_planning_profile`
**Nederlandse domeinterm:** behandelvisieprofiel
**Status Engelse naam:** bevestigen
Een versiegebonden ADM-configuratie voor terminologie, perspectieven, vereisten, scope en protocollen rond behandelplanning.
**Is niet:** behandelplan, klinisch schema, UI-thema of FHIR-profiel.
### Care Planning Profile Version — `care_planning_profile_version`
**Nederlandse domeinterm:** behandelvisieprofielversie
**Status Engelse naam:** aanbevolen
Een onveranderlijke, gepubliceerde versie van een behandelvisieprofiel waarnaar een plansnapshot kan verwijzen.
**Is niet:** een planversie of losse wijzigingsaudit.
## 8. MDO en evaluatie
### Multidisciplinary Case Review — `multidisciplinary_case_review`
**Nederlandse domeinterm:** MDO-proces / multidisciplinaire casusbespreking
**Status Engelse naam:** aanbevolen
De workflow van casusinbreng, voorbereiding, overleg, gedeelde analyse, uitkomst, acties en eventuele planwijzigingsvoorstellen.
**Is niet:** één vergadering, MDO-verslag, automatisch bevoegd besluit of planwijziging.
### Multidisciplinary Team Meeting — `multidisciplinary_team_meeting`
**Nederlandse domeinterm:** MDO-sessie
**Status Engelse naam:** aanbevolen
De feitelijke overlegsessie waarin één of meer casussen kunnen worden besproken.
**Is niet:** het volledige MDO-proces of automatisch een besluitvormend orgaan.
### Case Submission — `case_submission`
**Nederlandse domeinterm:** casusinbreng
**Status Engelse naam:** aanbevolen
De formele inbreng van een casus of vraagstelling voor een multidisciplinaire bespreking.
**Is niet:** de bespreking, uitkomst of rapportage.
### Treatment Plan Change Proposal — `treatment_plan_change_proposal`
**Nederlandse domeinterm:** behandelplanwijzigingsvoorstel
**Status Engelse naam:** aanbevolen
Een vanuit MDO, evaluatie of andere bron voorgestelde wijziging van het levende behandelplan.
**Is niet:** een reeds goedgekeurde of automatisch doorgevoerde planwijziging.
### Formal Treatment Review — `formal_treatment_review`
**Nederlandse domeinterm:** formele evaluatie
**Status Engelse naam:** aanbevolen
Een cliëntgericht evaluatieproces met input, doelbeoordeling, deelnemers, conclusies, acties en mogelijke wijzigingen van het behandelplan.
**Is niet:** MDO, losse rapportage, herinnering of automatisch een nieuwe plansnapshot.
## 9. Episode-overstijgende informatie
### Cross-Episode Clinical Concept — `cross_episode_clinical_concept`
**Nederlandse domeinterm:** getypeerd episode-overstijgend klinisch gegeven
**Status Engelse naam:** bevestigen
Expliciet geselecteerde en getypeerde klinische informatie met bron, bronepisode, geldigheid, actualiteit, reviewdatum en eigen autorisatieregels.
**Is niet:** generieke cliëntgegevensbak, tekstkopie of automatisch overgenomen episode-inhoud.
**Ontwerpnotitie:** dit is een voorlopig verzamelbegrip voor de architectuur. Concrete typen zoals vroegsignaal of beschermende factor krijgen later een eigen naam en model.
## 10. Open terminologiebesluiten
De betekenis van onderstaande begrippen staat vast, maar de Engelse naam moet nog expliciet worden bevestigd:
1. `inbound_care_signal` — aanmeldsignaal;
2. `access_assessment_case` — aanmeldingstraject;
3. `presenting_care_need` — zorgvraag;
4. `access_case_consolidation` — logische samenvoeging;
5. `screening_recommendation` — screeningsbesluit/-advies;
6. `clinical_intake_assessment` — intake als proces;
7. `funding_case` — financieel traject;
8. `lead_clinician_role` — regiebehandelaar;
9. `care_goal` — behandel-/zorgdoel;
10. `care_planning_profile` — behandelvisieprofiel;
11. `cross_episode_clinical_concept` — voorlopige naam voor de longitudinale architectuurlaag.
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.