Release- en compatibiliteitsmodel

/civ-city/governance/positionpapers/release-en-compatibiliteitsmodel

CIV-CITY_PP_P006 release-en-compatibiliteitsmodel concept

CIV-CITY_PP_P006 — Release- en compatibiliteitsmodel

Executive Summary

Deze position paper legt het formele model vast voor bundelopbouw, compatibiliteit, testmomenten en release-overgangen binnen CIV-CITY. Zij maakt expliciet hoe een governancebundel bestuurlijk navolgbaar, technisch importeerbaar en federatief overdraagbaar blijft wanneer families zoals FUN, TMP, WXR, REG, VER en WEB in verschillende releases worden aangevuld of aangescherpt.

1. Doel en reikwijdte

Het release- en compatibiliteitsmodel beschrijft hoe bundels van versie 1.2 naar latere lijnen kunnen doorgroeien zonder verlies van documentcode, parent-child-structuur, metavelden of audittraceability.

2. Basisprincipes

Bundels zijn volledige importeerbare WXR-sets. Alleen geraakte pagina's krijgen een versie-update; ongewijzigde pagina's behouden hun vorige versie. PHP-bestanden blijven stabiel benoemd, terwijl bestuurlijke evolutie op pagina's en in versielogs wordt vastgelegd.

3. Compatibiliteitslagen

De canonieke laag bestaat uit documentcodes, meta-structuur, validatieregels en parent-child-relaties. De presentatielaag mag lokaal verschillen voor templates, thema's en uitrol, zolang de canonieke laag intact blijft.

4. Relatie tussen families

Wijzigingen in FUN kunnen doorwerken in TMP, WXR, REG en VER. Daarom moeten geraakte documenten, testmomenten en compatibiliteitsimplicaties expliciet worden vastgelegd in release- en auditdocumentatie.

5. Test- en vrijgavelogica

Elke release bevat een toets op structuur, importeerbaarheid, governance-logica en federatieve interoperabiliteit. Pas na succesvolle test en bestuurlijke controle kan een release als sluitend of afgerond worden aangemerkt.

6. Relatie met audit en archivering

Releasebeheer staat niet los van archivering. Oudere beschrijvende versies blijven bestuurlijk herleidbaar via versielogs, auditpagina's en archiefstatussen. Daardoor blijft zichtbaar waarom een bundel is aangepast en welke families daarbij geraakt waren.

Update-informatie

  • Versie v0.2 — 11-04-2026: position paper toegevoegd aan de hoofdbundellijn ter completering van de PP-familie en ter verankering van release- en compatibiliteitslogica.