QAReviewChecklist

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.

1. Zijn de teksten consistent
2. Voor de inhoudsdeskundige architect: Kloppen de definities van de elementen

Model en Elementen

Klopt het model; dwz:

1. Zijn overal (de juiste) datatypen gebruikt
2. Check de kardinaliteit
3. Heeft het minimale model betekenis? Dus laat alle elementen weg met kardinaliteit 0..?
4. Als er een verwijzing (reference) is, wijst die dan naar het rootconcept van de andere ZIB?
5. 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.

Constraints

1. "Hangt" de Constraint aan het betreffende Element

Examples

1. Klopt het voorbeeld; Is het consistent met het model en is het duidelijk?`

Overige

1. Is het echt een aparte bouwsteen waardig
2. Is er al een bouwsteen waar we het concept in kwijt kunnen?
3. Is er overlap met andere bouwstenen
4. (geen verwijzing waar die er wel zou moeten zijn)
5. Overige bevindingen, adviezen

Sub-ZIB (complexere data-types, part)

1. In tegenstelling tot een volledige ZIB, zijn de Concept en Example hoofdstukken ingevuld
2. Is het in de naam duidelijk dat het een Sub-ZIB is? (e.g. door namespace nl.zorg.part te gebruiken)

Ter inspiratie

Stan Huff Requirements for good models:

1. Accurate – corresponds to the real world
2. Unambiguous – only one meaning
3. Understandable - People recognize the real world referent(s)
4. Reproducible - Different modelers would model in the same way
5. Parsimonious and harmonious use of terminology - Semantics of the model and terminology match
6. Flexible - Evolve gracefully over time
7. Consistent across domains – Specimen Collection and I&O Charting
8. Practical – implementable in real systems
9. Minimally complex – cover only what is needed
10. Common queries are easy
11. Fits with available technology (OO languages)

http://wiki.hl7.org/index.php?title=DSTU_QA_Guidelines