ERD en relatiemodel
Deze map bevat de documentatiestructuur voor het ERD-hoofdstuk van OefenHub. De bestaande tabeldocumentatie in database_informatie blijft de bron van waarheid; dit hoofdstuk voegt daar een leesbare visuele en navigerende laag bovenop toe.
De opzet is bewust gelaagd: eerst een helikopteroverzicht, daarna doorklikbare domeinpagina's, daarna cross-domeinrelaties en een relatie-index. Daardoor blijft het mogelijk om in te zoomen zonder één onleesbaar totaaldiagram te maken. Deze consolidatieronde trekt de leesroute, terminologie en navigatie gelijk over alle ERD-pagina's.
Leesvolgorde
- Leeswijzer en werkwijze
- Helikopteroverzicht
- Domeinkaart
- Identiteit en autorisatie
- Relatiebeheer
- Docentstructuur en leerlingtoegang
- Communicatie en notificaties
- Configuratie en contentbeheer
- Ticket- en meldingsbeheer
- Oefenruns, delen en voortgang
- Audit, historie en technische uitgangspunten
- Cross-domein relaties
- Relatie-index
- Zoompad en onderhoud
Status
Deze ERD-map kan na ronde 9 als eerste complete documentatieset worden gebruikt. De inhoud is nog steeds ondersteunend aan de brondocumenten in database_informatie, maar de belangrijkste domeinen zijn nu in eerste diepte uitgewerkt en onderling navigeerbaar.
Gebruik de pagina's in deze volgorde:
- bij oriëntatie: start met Leeswijzer en werkwijze, Helikopteroverzicht en Domeinkaart;
- bij domeinreview: gebruik de domeinpagina's 4 t/m 11;
- bij impactanalyse: gebruik Cross-domein relaties en Relatie-index;
- bij vervolgwerk: gebruik Zoompad en onderhoud.
Onderhoudsafspraak
- Diagrammen zijn ondersteunend; de tabeldefinities in de bovenliggende databasehoofdstukken blijven leidend.
- Deel-ERD's mogen stap voor stap worden ingevuld en aangescherpt.
- Wanneer een tabel, FK of logische verwijzing wijzigt, moet naast de tabeldefinitie ook de relevante domeinpagina of relatie-index worden bijgewerkt.
- Interne documentlinks worden zonder
.md-extensie geschreven, zodat zij aansluiten op Docusaurus-docroutes.