Bring the engineer-facing FDS documentation next to the code it describes: ADR-0001 to ADR-0006, the ADR index and template, the L3 component view, and the slice-1 proposal. All translated to Dutch. Source: projects/open-register-fd/ in Respellion/innovation-lab. Land the set in docs/architecture/fds/ rather than docs/architecture/. This repo already owns adr-0001-loose-coupling to adr-0004-bdd-framework, so a flat import collides on every number. The subfolder keeps the imported numbering, and with it about thirty ADR-000N cross-references in the imported text. Add the mermaid custom fence to pymdownx.superfences. Without it the imported diagrams publish as raw code blocks, because the site has no mermaid support today. Add the nav group and one link from the docs index. The blueprint, the FDS gap analysis and the privacy views stay in the lab repo; the OKRs cite them and they feed tender responses. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
FDS-architectuur — Open Register
Deze map bevat de architectuurbesluiten en de engineer-documentatie voor de FDS-kant van deze referentie-applicatie: deelnemen aan het Federatief Datastelsel als afnemer.
De strategische inzet, de slices en de portfoliostatus staan in het Innovation Lab-repo,
Respellion/innovation-lab, onder projects/open-register-fd/. Daar staan ook de
architectuurblauwdruk, de FDS gap-analyse en de privacy-views.
Documenten
| Document | Waarvoor |
|---|---|
c4-component-view.md |
Componentview op niveau 3: ports en adapters, en welke views nog waarde toevoegen |
slice-1-proposal.md |
Het bouwbare eerste increment; plak dit in een poc-voorstel-issue |
adr/ |
De geaccepteerde architectuurbesluiten, ADR-0001 tot en met ADR-0006. Zie de tabel hieronder. |
Architecture Decision Records
Een ADR legt een besluit vast dat vaststaat, met de context en de gevolgen, zodat het niet stil
opnieuw wordt uitgevochten. Statuswaarden: proposed → accepted → (vervangen door ADR-NNNN |
deprecated).
Een geaccepteerde ADR wijzigen betekent een nieuwe ADR schrijven die de oude vervangt. Wij herschrijven de historie nooit.
ADRs liggen naast governance. Acceptatie volgt de asynchrone bezwaarronde uit
Respellion/innovation-lab, operating-model/operating-model.md, sectie Besluitvorming.
| ADR | Besluit | Status |
|---|---|---|
| 0001 | Anti-Corruption Layer op elke registergrens | accepted |
| 0002 | FSC voor connectiviteit tussen organisaties, geen ruwe REST | accepted |
| 0003 | Policy-based access control via OPA, FTV-klaar | accepted |
| 0004 | Begrensde cache; registers blijven systeem van registratie | accepted |
| 0005 | Verwerkingenlog via event-emissie, in lijn met LDV | accepted |
| 0006 | Modulegrens en hergebruikstrategie: in-process → .NET-module → OpenMetadata-feed → gateway op verzoek | accepted |
Nummering
Deze reeks staat los van de ADR-reeks over de referentie-applicatie zelf, die begint bij
adr-0001-loose-coupling.md. Vandaar de eigen map fds/: beide
reeksen beginnen bij 0001, en de nummers zouden anders botsen.
Nieuwe FDS-ADR: kopieer adr/template.md, neem het volgende nummer, en open een
pull request.