QAReviewChecklist
Versie door Michael van der Zel (overleg | bijdragen) op 25 okt 2017 om 06:05 (→Model en Elementen)
Inhoud
Checklist: Zorgverlener Review ZIB
- Inhoudelijke check extra/gewijzigde/wegvallen velden of extra/gewijzigde waarden.
- Worden de gegevenselement namen en omschrijvingen herkend door de Zorgverelener.
- Hoe zit de ZIB in de systemen/processen die de Zorgverlener gebruikt.
Checklist: Architectuur QA Review ZIB
Het gaat hier om waar we inhoudelijk naar te kijken als Architect.
We mogen ervan uitgaan dat (medisch) inhoudelijke review al is geweest.
N.B. Het gaat hier om de (technische) methodologische controle van de ZIB.
Definities
Dit geld voor alle tekstuele definities, dus van het hoofdstuk "Concept", maar ook van de tekstuele toelichtingen bij het model en de elementen en de waardelijsten en waarden.
- De eerste zin zou als vervanging kunnen dienen voor het element naam in een zin als korte omschrijving
- Moet extra richting geven aan het gebruik bovenop de naam en korte omschrijving
- Als het niet voor de hand liggend is moet uitgelegd waarom een element nodig is
- Zijn de teksten consistent
- Voorbeelden moeten in DCM::ExampleValue
- Voor de inhoudsdeskundige architect: Kloppen de definities van de elementen
Model en Elementen
Klopt het model; dwz:
- Zijn overal (de juiste) datatypen gebruikt
- Check de kardinaliteit
- Heeft het minimale model betekenis? Dus laat alle elementen weg met minimale kardinaliteit van 0.
- Als er een verwijzing (reference) is, wijst die dan naar het rootconcept van de andere ZIB?
- Als er een verwijzing in zit moet er gecontroleerd worden of die in een ZIB zit en niet in beide (heen en weer). De verwijzing wordt doorgaans toegevoegd op de ZIB die "later" wordt gemaakt. Dus e.g. een Verrichting wordt meestal gedaan nav een Probleem en niet andersom. Een Verrichting kan dan een verwijzing hebben naar een Probleem.
- Zijn de namen van de elementen generiek genoeg voor de betekenis en waardelijst die het heeft.
- De naam van de elementen bevat in principe niet opnieuw de bouwsteennaam.
- Check de overlap met de Basiselementen?
- Hebben alle elementen een codering LOINC of SNOMED CT zijn preferent.
Waardelijsten (ValueSets)
Constraints
- "Hangt" de Constraint aan het betreffende Element
Examples
- Klopt het voorbeeld; Is het consistent met het model en is het duidelijk?`
Overige
- Is het echt een aparte bouwsteen waardig
- Is er al een bouwsteen waar we het concept in kwijt kunnen?
- Is er overlap met andere bouwstenen
- (geen verwijzing waar die er wel zou moeten zijn)
- Overige bevindingen, adviezen
Sub-ZIB (complexere data-types, part)
- In tegenstelling tot een volledige ZIB, zijn de Concept en Example hoofdstukken ingevuld
- Is het in de naam duidelijk dat het een Sub-ZIB is? (e.g. door namespace nl.zorg.part te gebruiken)
Checklist: Model Technisch Review ZIB
TODO: lijstje compleet maken Deze controle kan overigens geheel automatisch
- Metadata
- "Lite" hoofdstukken gevuld, Concept, Purpose, ...
- Informatiemodel
- een rootconcept
- geen loshangende concepten
- alle gegevenselementen ...
- ... hebben een ZIB datatype en bij gecodeerd een waardelijst
- ... hebben een definitie
- ... hebben een example value
- ...
Ter inspiratie
Stan Huff Requirements for good models:
- Accurate – corresponds to the real world
- Unambiguous – only one meaning
- Understandable - People recognize the real world referent(s)
- Reproducible - Different modelers would model in the same way
- Parsimonious and harmonious use of terminology - Semantics of the model and terminology match
- Flexible - Evolve gracefully over time
- Consistent across domains – Specimen Collection and I&O Charting
- Practical – implementable in real systems
- Minimally complex – cover only what is needed
- Common queries are easy
- Fits with available technology (OO languages)