10 — Architectuur
Levende overzichten van hoe de Ruimtemeesters-apps in elkaar grijpen. Anders dan ADRs (onveranderlijke besluiten) en PRDs (één specifieke verandering) beschrijven architectuur-docs de wereld zoals hij nu is.
Wanneer er iets verandert — een nieuwe app komt erbij, een handover verschuift, een gedeeld contract wijzigt — wordt de relevante architectuur-doc in dezelfde PR bijgewerkt.
Reikwijdte in Documentatie
Architectuur-docs hier zijn portfolio-breed of cross-repo. De interne architectuur van één app blijft in de product-repo.
Wanneer wel
- Een lezer heeft een overzicht nodig van hoe meerdere apps samenwerken
- Een nieuwe collega moet het portfolio-model snappen voordat hij ergens aan begint
- Een diagram is nodig dat anders nergens zou wonen
Wanneer niet
- Eén besluit: schrijf een ADR
- Eén feature: schrijf een PRD
- Een how-to of runbook: dat is operationeel en hoort niet hier
Bestandspatroon
<gebied>-architectuur.md — bijv. portfolio-architectuur.md, auth-cross-app-architectuur.md.
Sjabloon
# <Gebied> Architectuur
**Laatst bijgewerkt:** YYYY-MM-DD
**Status:** Actueel
## Scope
(Wat dit document dekt — en wat niet.)
## Overzicht
(Eén alinea + een diagram als dat helpt. ASCII of mermaid is prima.)
## Componenten
| Component | Wat het bezit | Eigenaar |
|---|---|---|
| | | |
## Belangrijkste flows
(Loop de 2–3 belangrijkste flows end-to-end door.)
## Gerelateerde besluiten
- [[ADR-NAAM]]
- [[ADR-NAAM]]
## Gerelateerde PRDs
- [[PRD-NAAM]]