ECLI als canonical identifier

In de uitspraak-stack is ECLI (European Case Law Identifier) de canonieke externe identifier — niet AKN, niet UUID-only.

Wat ECLI is

ECLI is de Europese standaard voor jurisprudentie-identificatie, ingevoerd in Nederland door de Raad voor de rechtspraak in 2013. Formaat:

ECLI:NL:<gerechtcode>:<jaar>:<volgnr>

Voorbeeld: ECLI:NL:RBDHA:2026:10008 — rechtbank Den Haag, 2026, volgnummer 10008.

Waarom ECLI boven AKN of UUID-only

• Domein-natuurlijk: data.rechtspraak.nl serveert via ECLI. Integraties met KOOP / BWB-koppelingen gebruiken ECLI. Geen aparte vertaling nodig.
• Mens-leesbaar: in logs, queries en debugging direct herkenbaar — ECLI:NL:RBDHA:2026:10008 is informatief, b3f2c9a4-... niet.
• Botst niet met UUIDs van andere entiteiten — ECLI heeft een onmiskenbare grammar.
• Stabieler dan AKN-URI's voor uitspraken — AKN is een wetgevings-standaard die uitspraken eigenlijk niet primair adresseert. Voor uitspraken is ECLI de eerste-klas identifier.

Format-CHECK

CONSTRAINT ecli_format CHECK (ecli ~ '^ECLI:NL:[A-Z]+:[0-9]{4}:[A-Z0-9]+$')

Verifieert de ECLI-grammar bij INSERT. Voorkomt dat malformed-strings in de tabel terechtkomen.

Edge-case: pre-2013 LJN-style nummers gebruikten alphanumeric suffixes (ECLI:NL:HR:2009:BJ7327 met letters in de volgnr). Onze regex [A-Z0-9]+ dekt dit; eerder regex [0-9]+ (alleen cijfers) sloot 1.194 van 5.907 ECLIs (20%) uit. Gefixt in PR #4145.

Dual-key — UUID + ECLI

id    UUID PRIMARY KEY,           -- interne PK voor FKs van andere tabellen
ecli  TEXT UNIQUE NOT NULL,       -- externe identifier voor lookups

Twee redenen voor dual-key:

1. Bestaande FKs in decision_authorities, decision_expressions verwijzen naar UUIDs. Migreren naar ECLI-FKs zou een grootschalige refactor zijn zonder semantische winst.
2. Niet alle rijen in de bron-data hebben (vandaag) een geldige ECLI — 4 van 7.413 hebben mogelijk lege of niet-standaard publication_id. Maar de tabel-CHECK eist NOT NULL ECLI. Bij ingest wordt een fallback-ECLI gemint (te documenteren) — geen mogelijkheid om zonder identifier de rij te creëren.

Onderliggende ADRs

• ADR-0035 §2 + §4 — ECLI als externe identifier + dual-key argumentatie