Versions et publication

Construire et servir sont deux choses différentes, et la plateforme les sépare avec deux pièces : les versions (des branches de l'app, chacune avec son design et ses données) et la publication (quelle adresse sert quelle version).

La règle qui résume tout : chaque hôte sert UNE version de cette app. Publier, ce n'est pas « mettre en ligne » — c'est choisir quelle version une adresse sert.

#Les versions d'une app

Une version est une branche complète de l'application : les écrans, le modèle, les APIs, les scripts, les workflows, les rapports et les données. Deux versions ne partagent rien — toucher à l'une ne touche pas à l'autre.

Le menu des versions se trouve dans l'en-tête de l'arborescence de l'app, à côté du bouton de paramètres. Ce qu'il montre, c'est votre version de travail :

Élément	Ce qu'il fait
La liste des versions	Cliquer sur une ligne change votre version de travail pour celle-ci. La coche marque la version actuelle.
⟲ (sur chaque ligne)	Ouvre l'historique de cette version — ce qui a changé, quand et par qui.
🗑 (sur chaque ligne)	Supprime la version.
Nouvelle version…	Crée une branche.
Merge sélectif…	Récupère des modifications choisies d'une version vers une autre.

Dans une app qui n'a jamais eu de versions, le menu dit « Cette app n'a pas encore d'historique. ».

#Créer une version

1. Ouvrez le menu des versions et cliquez sur Nouvelle version….
2. Remplissez le Nom (par exemple 1.1) et choisissez À partir de — la version d'origine.
3. Cliquez sur Créer une version.

« Crée une branche à partir de la version d'origine, avec les données copiées. La nouvelle version n'est servie par aucun hôte tant qu'elle n'est pas associée à l'un d'eux. »

Deux conséquences qu'il vaut la peine de retenir :

• Les données sont copiées, pas partagées. La 1.1 naît avec une copie de ce que la main avait à cet instant ; à partir de là, elles suivent des vies séparées.
• Personne ne la voit, tant que vous ne publiez pas une adresse qui pointe vers elle. Vous pouvez travailler des mois sur une version sans qu'aucun utilisateur s'en aperçoive.

Dès que la version est créée, vous vous mettez à travailler dessus (« Version « 1.1 » créée — vous travaillez maintenant dessus. »).

#Supprimer une version

Le 🗑 d'une ligne supprime « le design, la base de données et l'historique de cette version. Les autres versions ne sont pas touchées ». Deux protections :

• la version main ne se supprime pas ;
• la version sur laquelle vous travaillez non plus — « passez à une autre avant de la supprimer ».

#Publier

La publication vit dans Paramètres de l'app → Général, dans la section Publication.

Chaque ligne est une adresse publiée : l'hôte, la version qu'il sert, et le ✕ pour Dépublier.

Pour publier une nouvelle adresse :

1. Écrivez l'hôte dans le champ (l'exemple dit ex. : cartes.entreprise.com) — seulement le nom, sans https:// ni chemins.
2. Choisissez la version qu'il se met à servir.
3. Cliquez sur Publier.

Une fois confirmé, « Hôte publié. » apparaît et la nouvelle ligne rejoint la liste.

#Avant qu'il n'y ait la moindre adresse

« Aucun hôte publié — l'app répond sur /app/{slug} avec la version de travail. » C'est l'adresse interne de toujours, et c'est ainsi que l'on essaie une app avant de lui donner un nom propre.

Remarquez la différence : sur /app/{slug} s'exécute la version de travail de celui qui regarde ; sur un hôte publié s'exécute la version que l'hôte sert, pour tout le monde. C'est pour cela qu'en production on publie toujours un hôte — pour que ce que les utilisateurs voient ne dépende pas de la branche sur laquelle quelqu'un travaille.

#Dépublier

Le ✕ de la ligne (Dépublier) retire l'adresse. La version n'est pas touchée — elle cesse simplement d'être servie là.

Pour changer de version sur une adresse déjà publiée, dépubliez et publiez à nouveau avec la nouvelle version. C'est l'opération « mettre la 1.1 en production », et elle prend quelques secondes.

#L'app en fonctionnement

Une adresse publiée sert l'application construite. Qui y arrive ne voit pas la plateforme : il voit l'écran d'entrée de l'app, avec son thème.

À partir de là, ce que chaque personne peut faire dépend du compte avec lequel elle entre et de ses rôles — sujet de la page Utilisateurs de l'app. Les écrans d'entrée, d'inscription et de récupération se dessinent, et ont leur propre page : Écrans publics et inscription.

#Une organisation de travail saine

Une façon courante d'organiser cela dans une équipe :

1. main est la version en production. L'hôte officiel (crm.entreprise.fr) sert la main.
2. Pour une modification importante, on crée une version (1.1) à partir de la main et on travaille là.
3. Pour la montrer à quelqu'un avant l'heure, on publie un second hôte (crm-test.entreprise.fr) qui sert la 1.1.
4. Quand elle est prête, l'hôte de production se met à servir la 1.1 — ou on récupère ce qui compte vers la main avec le Merge sélectif….

#Ce qui ne voyage pas avec l'app

Quand vous exportez une app dans un package, l'hôte reste de côté — il appartient à cette installation, et le même package installé ailleurs aura ses propres adresses. Restent également de côté l'historique des exécutions et les clés API. Voir Importer et exporter des apps.

#Questions fréquentes

J'ai changé de version et l'app paraît vide. Chaque version a ses données. La 1.1 n'a que ce qui existait dans l'origine au moment de sa création, plus ce qui y a été fait depuis.

J'ai publié l'hôte et le navigateur ne trouve rien. Il manque le DNS : le nom doit pointer vers cette installation. Tant que cela n'est pas fait, utilisez /app/{slug} pour essayer.

Puis-je avoir deux hôtes qui servent la même version ? Oui. Un hôte sert une version, mais rien n'empêche que plusieurs pointent vers la même — par exemple, une adresse courte et une adresse complète.

J'ai supprimé une version par erreur. Il n'y a pas de retour en arrière : cela supprime le design, les données et son historique. C'est la raison pour laquelle les versions en production ont toujours un hôte associé — une version servie par un hôte est une version que personne ne supprime par distraction.