Als developer wil ik het contacten component common ground proof maken

[matthiasoliveiro]

Voor dit component stellen wij de volgende standaarden voor:

• Schema.org
• vCard

Wij willen de vCard standaard gebruiken gezien dit voor het opslaan van contacten de belangrijkste standaard is. Uit de Schema.org standaard stellen wij de volgende objecten voor:

• Person
• Organization

We stellen deze objecten voor om in het contactencomponent onderscheid te kunnen maken tussen mensen en organisaties. Verder zijn wij ons ook bewust van de hCard norm, dit is echter een HTML-implementatie van de vCard norm en daarom verder niet relevant

Organisatie	standaard	URL
w3c	vCard	https://w3.org/TR/vcard-rdf
Schema.org	Person	https://schema.org/Person
Schema.org	Organization	https://schema.org/Organization
microformat	hCard	http://microformats.org/wiki/hcard

Taken lijst todo:

• [ ] Architectuur afstemming
• [x] Ontwerp gegevens model
• [x] Realisatie
• [x] Postman testscripts
• [x] Documentatie Redoc
• [ ] ~Testscripts aan leveren aan testvoorziening~
• [x] Voorbeeld implementatie
• [ ] Code opleveren in Utrecht repo

Checklist Definition of done

• [x] Oas documentatie
• [x] Postman scripts (test scripts)
• [ ] ~Aangeleveren testscripts aan de api test voorziening~
• [x] Containers moeten gepubliceert zijn
• [ ] Gereviewd op de design decisions
• [x] Voorbeeld implementatie beschikbaar
• [x] Redoc moet beschikbaar zijn
• [ ] ~Documentatie moet beschikbaar zijn op github-pages~
• [X] NLX integratie moet werken

[rubenvdlinde]

Ook even voor de overweging is dat we het hier nog hebben over de opzet van het datamodel, dus deze is dan in lijn met het vCard gedachte goed. Dan heb je als BL laag zelf nog de vrijheid om hem als hCard, vCard of legacy MS dingen weer te geven. Die keuze is zowiezo niet aan de CRUD API.

[matthiasoliveiro]

• Test voorziening geeft niet thuis en kunnen we niet afronden.
• Github pages is een strech goal en een nice to have, we hebben het nu ander opgelost via de readme (zie tabel)
• NLX hebben we een andere afspraak voor gemaakt en wordt los opgepakt. Het component is NLX ready maar het staat nog niet aan dat is een andere story

[CMasselink]

Documentatie in redoc is nog niet overal in orde:

Eén van de vinkjes uit de todo lijst is ook het opleveren van de code op Github omgeving van Utrecht. Daar moeten we voor dit maar ook de andere componenten ook nog naar kijken om te realiseren.