Ga naar hoofdinhoud

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]]