Aller au contenu

Brouillon → publication

Vous ne modifiez pas directement les doctypes d’un domaine réel. Vous ouvrez un brouillon, vous y changez les définitions, puis vous publiez quand le résultat est prêt. Cette page décrit ce que l’état de brouillon autorise, et ce que la publication vérifie avant d’écrire.

Live domain Live domain

Deux états. Un domaine porte un indicateur draft. Un brouillon est un vrai domaine, avec un nom généré automatiquement qui commence par _. Facet fonde chaque garde-fou sur cet indicateur, jamais sur le préfixe. Dans un brouillon :

  • la version de schéma peut diminuer ou sauter un cran,

  • les modifications destructives, comme la suppression d’un champ ou un changement de type, sont permises à version inchangée,

  • un changement de version n’exige aucune fonction de migration,

  • tout le reste passe toujours la validation : noms de champs, noms d’actions, compilation des scripts.

    Ce que fait la publication. POST /Api/core/Domain/:id/publish transforme le brouillon en domaine réel. Publier, c’est copier puis supprimer, pas renommer. La cible reçoit de nouvelles lignes sous son propre nomà ; le brouillon est ensuite supprimé. En mode écrasement, le document core.Domain réel reste tel quelà : sa description, ses context sets et ses hooks gardent leurs valeurs réelles, et un hook du brouillon que le domaine réel n’a pas revient en avertissement. Avant d’écrire quoi que ce soit, la publication vérifie queà :

  • le nom cible ne contient que des lettres minuscules, des chiffres et des tirets, et commence par une lettre. Un _ initial répond 422 : ce préfixe est réservé aux brouillons,

  • la source est un brouillon, lu sous un verrou de ligne,

  • le graphe de composition est fermé — chaque entrée children: a un member_of correspondant,

  • en mode création (overwrite: false, par défaut), le nom cible est libre. Un nom qu’un domaine réel porte déj à répond 409,

  • en mode écrasement (overwrite: true), le nom cible peut déj à exister. Chaque doctype dont la structure diffère de celle du réel doit porter un schema_version exactement égal à la version réelle plus un, et une fonction de migration pour cet écartà ; un écart sans fonction répond 422. Un doctype de structure identique passe sans changement de version.

    Puis, en une seule transaction, la publication :

  • copie chaque définition de doctype et ses modèles de vue,

  • repointe les références internes au domaine vers le nouveau nom,

  • en mode écrasement, aligne les modèles de vue du réel sur ceux du brouillon : un modèle changé est mis à jour, un modèle propre au brouillon est créé, un modèle propre au réel est supprimé. Les vues enregistrées ne sont jamais touchées,

  • transfère les éditeurs de domaines du brouillon,

  • ouvre des tickets d’attribution de domaine quand les définitions touchent d’autres domaines,

  • supprime le brouillon.

Un crash avant le commit laisse le brouillon intact. Vous pouvez relancer la même publication.

Que deviennent les documents. La publication ne migre jamais les documents réels à l’avance. Ils restent à leur version de schéma stockée. Une migration à la demande parcourt la chaîne à la prochaine lecture. La barrière de version garantit que chaque écart a une fonctionà ; le parcours à la demande ne peut donc échouer sur une entrée manquante.

Les données d’un brouillon sont jetables. Les documents créés dans le brouillon ne passent pas de l’autre côté — la publication les supprime logiquement avec le brouillon. Seule la structure se publie. Un token d’aperçu vous permet de tester d’abordà : il ouvre les routes standard pour les documents du brouillon, sous votre propre identité.

Le compromis. Les vérifications qui protègent les données réelles ne tournent pas pendant l’édition. Un problème de version n’apparaît qu’à la publication, quand la barrière le refuse, et vous revenez au brouillon pour le corriger. Un brouillon dérivé d’un domaine réel ne suit plus ce domaine ensuite. Les deux peuvent diverger, et la comparaison n’a lieu qu’au moment de publier. Deux états, c’est aussi deux copies d’une définition. Le domaine réel continue de servir ses définitions actuelles pendant que vous éditez le brouillon. Vos changements n’atteignent les autres utilisateurs qu’à la publication. Une dernière limiteà : la réplication reste inerte dans un brouillon. Un domaine de brouillon ne sert jamais de source ni de consommateur de réplication, vous ne pouvez donc pas tester un champ replicate avant de publier.