QAReviewChecklist: verschil tussen versies
(→Checklist: Model Review ZIB) |
|||
Regel 45: | Regel 45: | ||
# Is het in de naam duidelijk dat het een Sub-ZIB is? (e.g. door namespace nl.zorg.part te gebruiken) | # Is het in de naam duidelijk dat het een Sub-ZIB is? (e.g. door namespace nl.zorg.part te gebruiken) | ||
− | =Checklist: Model Review ZIB= | + | =Checklist: Model Technisch Review ZIB= |
− | '' | + | ''afmaken, kan overigens geheel automatisch'' |
# Metadata | # Metadata | ||
− | # "Lite" hoofdstukken gevuld | + | # "Lite" hoofdstukken gevuld, Concept, Purpose, ... |
# Informatiemodel | # Informatiemodel | ||
− | ## | + | ## een rootconcept |
− | ## | + | ## geen loshangende concepten |
− | ## | + | ## alle gegevenselementen ... |
− | ### hebben een ZIB datatype | + | ### ... hebben een ZIB datatype en bij gecodeerd een waardelijst |
− | ### hebben een definitie | + | ### ... hebben een definitie |
+ | ### ... hebben een example value | ||
## ... | ## ... | ||
Versie van 7 apr 2017 om 12:21
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 kardinaliteit 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.
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
afmaken, 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)