Architectuur diagrammen¶

ID: ADR-0003
Status: Vervangen door ADR-0005
Datum: 2026-05-01
Domein: Architecture
Auteurs: Bas Meeuwissen

Context en Probleemstelling¶

Architectuur diagrammen zijn architectuur artifacten en per definitie de waarheid waardoor deze makkelijk te beheren moeten zijn. Dit betekent dat wijzigingen eenvoudig zijn te herleiden, er een makkelijk review proces kan plaatsvinden en samenwerking goed ondersteund wordt.

Beslissingsfactoren en constraints¶

Technische beperkingen: Installatie van applicaties vergt ondersteuning van IT-support.
Financiële beperkingen: De aanschaf van licenties voor betaalde pakketten is beperkt.
Organisationele beperkingen: De diagrammen moeten begrijpbaar zijn voor alle medewerkers buiten het architectuur domein.
Architecturele beperkingen: De diagrammen moeten voldoende architectuur principes ondersteunen voor Architectuur doeleinden.

Overwogen Opties¶

Optie 1: Tekst-gebaseerde diagrammen met praktische diagrammen zonder officiële EA diagrammen.
Optie 2: Gratis / opensource programma's voor officiële Architectuur standaarden.
Optie 3: Betaalde programma's voor officiële Architectuur standaarden.

Besluitvorming¶

Gekozen optie: Optie 1, omdat de onderhoudbaarheid van tekst-gebaseerde diagrammen vele malen hoger is dan die van proprietary applicaties. De diagrammen bieden voldoende architecturele duidelijkheid zonder officiële standaarden. Daarnaast is de tooling beschikbaar via bestaande applicaties én via het web (github).

Het C4-model is een lichtgewicht model dat gebruikt kan worden voor dit doeleinde en is bij voorkeur de optie om mee te beginnen.

Consequenties¶

Positief, want: Tekst-gebaseerde diagrammen zijn makkelijk te onderhouden via git.
Positief, want: Tekst-gebaseerde diagrammen integreren goed met documentatieplatformen (Zensical, Docusaurus, SSG).
Negatief, want: Bestaande artifacten moeten worden omgezet naar het nieuwe tekst-gebaseerde formaat.
Negatief, want: Het betreft geen officiële architectuur notatie, waardoor andere (enterprise) architecten moeite kunnen hebben met deze keuze.