veza/docs/MIGRATION_CONSOLIDATION.md
senke 7ede202e95
Some checks failed
Backend API CI / test-unit (push) Failing after 0s
Backend API CI / test-integration (push) Failing after 0s
Stream Server CI / test (push) Failing after 0s
fix(release): v1.0.1 — Conformité complète ROADMAP checklist
- Sécurité: npm 0 CRITICAL, cargo audit 0 vulnérabilités
- OpenAPI: @Param id corrigé pour /tracks/quota/{id}
- Tests: Payment E2E passe, OAuth DATABASE_URL fallback
- Migrations: 000_mark_consolidated.sql
- veza-stream-server: prometheus 0.14, validator 0.19
- docs: SECURITY_SCAN_RC1, V1_SIGNOFF, PROJECT_STATE
2026-03-03 20:17:54 +01:00

1.5 KiB

Migration Consolidation — v0.942

Contexte

Les migrations v0→v0.803 (~91 fichiers) sont consolidées en un schéma unique pour les nouvelles installations.

Trois chemins

Cas Action
DB vide Appliquer 000_full_schema.sql (généré par pg_dump)
DB existante (déjà migrée) Appliquer 000_mark_consolidated.sql — marque sans modifier le schéma
DB consolidée Appliquer les migrations incrémentales après consolidation

Générer le schéma complet

# Depuis une DB avec toutes les migrations appliquées
pg_dump -h localhost -U veza -d veza --schema-only --no-owner --no-privileges \
  -f veza-backend-api/migrations/000_full_schema.sql

Marquer une base existante

Pour une base qui a déjà exécuté les migrations 001_..122_, exécuter manuellement :

psql $DATABASE_URL -f veza-backend-api/migrations/000_mark_consolidated.sql

Cela insère le marqueur 000_consolidated dans schema_migrations sans modifier le schéma.

Archive

Les migrations historiques sont archivées dans veza-backend-api/migrations/archive/v0_to_v0803/ après consolidation. Voir le README de l'archive pour la liste complète.

Test de parité

Valider que le schéma 000_full_schema.sql produit un résultat équivalent aux 91 migrations :

# Optionnel : test avec testcontainers
go test ./tests/... -run MigrationParity -v

Validation manuelle acceptée si le test automatique n'est pas en place (plan de contingence v0.942).