FRBR migration roadmap — overzicht

De architectuur is in transitie van een vlakke canonical.documents tabel naar de two-stack FRBR-shape die in schema-substraat wordt uitgelegd. De transitie loopt langs een strangler-fig pad (ADR-0032): bouw het nieuwe naast het oude, dual-write naar beide, en drop uiteindelijk de oude tabel.

Vijf fasen, elk met eigen "done"-criterium.

Fase	Wat	Status
Stage 0	Architectuur-commitment op schrift (ADR-0031 accepted, ADR-0032 drafted, design doc)	DONE (eind april / begin mei)
Stage 1	Leeg schema op main brengen — 24 nieuwe FRBR-tabellen	DONE (2026-05-02, PR #4121 + #4122)
Stage 1b	Fundering aanscherpen — drift cleanup tussen docs en live schema	DONE (~2026-05-03)
Stage 2	Eerste canary: Rechtspraak end-to-end door de nieuwe shape	DONE — Wetgeving-canary in soak; Rechtspraak gevolgd
Stage 3	Alle andere bronnen door dezelfde dual-write + backfill pattern	IN PROGRESS
Stage 4	Oude shape wordt een view over de nieuwe (canonical.documents blijft als VIEW)	NOT STARTED
Stage 5	Oude shape verwijderen (DROP TABLE canonical.documents_legacy)	NOT STARTED

Volledige uitwerking per fase: stages. Work-items per fase: work-items.

Waarom strangler-fig

De alternatieve aanpak — "bouw het nieuwe naast het oude en doe op één moment de switchover" — is voor een database van deze grootte (24K+ rijen verspreid over 8 bronnen, met productie-verkeer) onhaalbaar zonder downtime. Strangler-fig laat het oude levend tijdens de verbouwing en draagt geleidelijk last over.

Drie sequencing-principes die expliciet zijn:

1. Phase 0a vóór Phase 2 — bitemporal dso_artikel (ADR-0027) moet landen vóór WI-FRBR-011 (DSO instrument-canary). Anders breekt de pointer-method-invariant; zie bitemporal.
2. F5 rectificatie-fix vóór WI-FRBR-014 — 74% van rectificaties target instrument-stack, niet decision-stack. Zonder fix mis-attributeert OB decision-stack-projectie silently.
3. Strangler view vóór drop — geen DROP TABLE zonder eerst 7 dagen productie-audit op de view-equivalentie.

Onderliggende docs

• ADR-0031 — Two-stack FRBR (de architectuur)
• ADR-0032 — Strangler-fig migration plan
• docs/handoffs/2026-05-03-frbr-roadmap-handoff.md — uitgebreide stages-uitwerking
• docs/handoffs/2026-05-05-architecture-audit.md — empirische status per 2026-05-05
• docs/handoffs/2026-05-06-frbr-phase3-complete-and-judicial-effects-finding.md — Phase 3 status