Politique de migration des schémas

Le contrat de migration et de version des documents persistés est considéré comme suffisamment stable pour préparer 1.0.0-rc.1. Il n’est plus un bloqueur fonctionnel.

Règle de stabilité

Toute évolution d’un document QForm persistant doit passer par le registre public de migrations. Cela concerne :

• l’enveloppe du document ;
• le schéma FormKit / Quasar ;
• les valeurs persistées ;
• les paramètres du builder ;
• les thèmes et presets visuels.

Aucune lecture opportuniste d’un ancien format ne doit être ajoutée directement dans un composant Vue ou dans un store. La compatibilité doit être centralisée dans le registre, testable et traçable.

Ce qui reste autorisé avant 1.0

Avant 1.0.0, les corrections acceptées sont limitées aux régressions compatibles :

• correction d’une migration existante ;
• ajout d’une migration explicite pour un ancien format détecté ;
• amélioration de la validation d’entrée ;
• documentation d’un cas limite sans changement de contrat.

Un changement qui impose une rupture de document doit attendre une version ultérieure et déclarer un nouveau chemin de migration.

Preuve attendue

Avant promotion de la release candidate, exécutez :

bun run migrations:check
bun run migrations:runtime:check
bun run schema-transfer:check
bun run api:contract:check

Ces commandes confirment que les formats versionnés, les rejets de versions futures et les protections contre les clés dangereuses restent couverts.