ehoandClaude Opus 5
334cec0157
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>
47 lines
2.5 KiB
Markdown
47 lines
2.5 KiB
Markdown
# 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`](c4-component-view.md) | Componentview op niveau 3: ports en adapters, en welke views nog waarde toevoegen |
|
|
| [`slice-1-proposal.md`](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](adr/0001-acl-at-every-register-boundary.md) | Anti-Corruption Layer op elke registergrens | accepted |
|
|
| [0002](adr/0002-fsc-for-connectivity.md) | FSC voor connectiviteit tussen organisaties, geen ruwe REST | accepted |
|
|
| [0003](adr/0003-pbac-via-opa.md) | Policy-based access control via OPA, FTV-klaar | accepted |
|
|
| [0004](adr/0004-bounded-cache.md) | Begrensde cache; registers blijven systeem van registratie | accepted |
|
|
| [0005](adr/0005-ldv-verwerkingenlog.md) | Verwerkingenlog via event-emissie, in lijn met LDV | accepted |
|
|
| [0006](adr/0006-module-boundary-and-reuse.md) | 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`](../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`](adr/template.md), neem het volgende nummer, en open een
|
|
pull request.
|