docs: record safe legacy migration data contract

2026-09-09 22:25:49 +02:00
parent 3e637a8429
commit a0c0ee26ca
1 changed files with 19 additions and 0 deletions
@@ -0,0 +1,19 @@
 # Gecontroleerde migratie van legacy deployments
 `docker-compose.migration.yml` is een optionele operatoroverride, geen wijziging
 aan de standaarddeployment. Gebruik deze alleen na de expliciete migratieprocedure
 in ProjectBrain `scripts/legacy-deployment-migration/`.
 De operator valideert de exacte Git-revisie en imageprovenance, stopt de oude
 container en maakt een gecontroleerde koude kopie van de volledige `local`-map.
 `MIGRATION_LOCAL_ROOT` verwijst uitsluitend naar die kopie. Media, logs en de
 PostgreSQL-data houden hun geneste mountrelatie. De originele data, image en
 container blijven bewaard voor rollback; startupmigraties mogen ze niet wijzigen.
 Alle migratievariabelen zijn verplicht, paden worden niet automatisch aangemaakt,
 en een attemptlabel bindt de nieuwe container aan precies één hersteltransactie.
 De operator controleert gemergde Compose-mounts, gezondheid, HTTP en de echte
 brokerreceipt voordat de configuratie definitief wordt overgezet.
 De override is offline getest met echte Compose-rendering en ontbrekende
 invoervariabelen. Toevoeging van dit bestand bewijst geen uitgevoerde productiemigratie.