AreaCacaoDocs
FormulationMes recettes

Historique des versions et duplication

Versionnage des recettes avec chronologie : capture complète de chaque changement (ingrédients, fournitures, coûts, validation, nutrition), parcourez votre historique, restaurez sans perdre le travail récent et dupliquez pour expérimenter.

Itérez et progressez

Le chocolatier travaille par itérations : vous changez 2 g de sucre, vous essayez une nouvelle fourniture, vous ajustez la fluidité, vous recommencez. AreaCacao garde la trace de ce parcours pour vous. Le versionnage des recettes, c’est le contrôle de versions des usines, conçu pour l’atelier : expérimentez sans crainte, tout est enregistré et vous pouvez revenir en arrière quand vous le souhaitez.

Chaque recette naît avec sa version 1 « Création » le jour où vous la créez, quelle que soit son origine : le Formulateur de chocolats, le Formulateur de garnitures, une importation ou une création à partir de zéro. Cette première version est l’originale et reste intacte : votre premier changement crée la version 2, de sorte que le point de départ est toujours conservé et que vous pouvez le comparer à n’importe quelle version ultérieure. Ensuite, le travail de chaque journée est regroupé automatiquement dans une version, et vous pouvez marquer des étapes quand vous le voulez.

Capture complète de l’écosystème

Une version ne conserve pas seulement les ingrédients : elle fige tout l’écosystème de la recette à cet instant, de manière fidèle et immuable. Si l’un de ces éléments change, la version le capture et le comparatif l’affiche :

  • Ingrédients, quantités, unités et %.
  • Fournitures (emballages, boîtes, étiquettes) et leur coût — voir Fournitures.
  • Coûts : coût complet, prix multicanal, seuil de rentabilité et cascade des sous-recettes — voir Coûts.
  • Validation technique : le score physico-chimique et ses paramètres — voir Validation de formule.
  • Nutrition : macros, énergie et allergènes.
  • Préparation (étapes et notes), parties de la formulation, rendement (perte, ce qu’est une unité, taille et nombre d’unités) et données (nom, type, % de cacao, fluidité, poids total, mesures aw/pH).

Vraiment immuable. Lorsque vous ouvrez une version d’il y a une semaine, vous voyez les coûts et la validation de l’époque — et non recalculés avec les prix d’aujourd’hui. C’est un relevé fidèle de votre recette à chaque instant.

La chronologie

Ouvrez-la avec le bouton Historique de l’en-tête de l’éditeur (/validation?id=<id>), ou depuis le menu ⋮ → Historique des versions. Vous ne la voyez que sur vos propres recettes : une personne qui modifie une recette partagée avec elle ne gère pas son historique. Une chronologie verticale s’ouvre à gauche : chaque version est une carte avec son numéro, la date, une étiquette indiquant le type de version, le score de validation et des puces de changements (par exemple Coût +8 %, Score 78→91, +2 ingrédients, Nouvelle fourniture). À droite, un large panneau vous raconte ce qui s’est passé dans cette version.

Lorsqu’une recette compte plusieurs versions, un sélecteur Comparer avec : Précédente / Originale (v1) vous permet de choisir la référence de comparaison : la version immédiatement précédente (ce qui a changé à cette étape) ou la Création (à quel point la recette s’est éloignée du point de départ). Une bannière « Comparaison avec… » vous rappelle toujours la référence, et une courte aide précise la différence (Précédente = l’étape juste avant · Originale = votre recette de départ). Lorsque vous sélectionnez la version 1, le panneau affiche « Ici commence l’histoire », avec le point de départ de votre recette (poids, ingrédients, fournitures et coût). Si c’est votre première fois, cliquez sur Comment ça marche ? dans l’en-tête pour un bref rappel du fonctionnement.

Vous voyez vos changements récents immédiatement. Les versions du jour sont consolidées en arrière-plan, mais à l’ouverture de l’historique, nous capturons votre dernière modification : inutile de recharger pour voir ce que vous venez de changer.

Comprendre en un coup d’œil

Le panneau de droite est conçu pour que vous compreniez l’impact avant de lire le détail :

  • Résumé de l’impact — un titre en langage naturel (« Vous avez ajouté 1 fourniture », « Le coût a augmenté de 8 % »), le décompte des éléments ajoutés / supprimés / modifiés et les indicateurs clés (coût, validation, poids) avec des flèches ↑/↓ et un code couleur : une hausse du coût est en rouge, une amélioration de la validation en vert, le poids reste neutre.
  • Langage visuel cohérent — chaque changement est signalé par une icône et une couleur : Ajouté (vert), Supprimé (rouge), Modifié (ambre). Pour les valeurs numériques, vous voyez l’avant → après et la variation (par ex. 10 g → 11 g · ↑10 %).
  • Détail par dimension — en dessous, uniquement les sections qui ont réellement changé (formule, parties, ingrédients, fournitures, coûts, validation technique, nutrition, allergènes, préparation, données, mesures aw/pH). Ce qui n’a pas changé n’ajoute pas de bruit.

Voir la recette complète d’une version

Cliquez sur Voir la recette complète pour ouvrir, par-dessus la chronologie, la recette entière de cette version en lecture seule : indicateurs (poids, validation, coût), ingrédients (par parties, si la recette en a), rendement, fournitures, coûts, allergènes, nutrition et préparation. Dans les états d’origine ou « aucun changement », vous voyez aussi un aperçu des ingrédients sans quitter le panneau. Depuis la recette complète, le bouton Ouvrir la recette actuelle vous emmène dans l’éditeur avec la recette telle qu’elle est maintenant, pas avec cette version : pour y revenir, utilisez Restaurer cette version.

Types de version :

  • Création — la version 1, le jour où vous avez créé la recette.
  • Journée de travail — la version qui regroupe automatiquement les changements d’une journée. Nous n’enregistrons pas chaque frappe : une version par journée.
  • Version — une étape que vous marquez avec Créer une version maintenant.
  • Restaurée — l’état laissé par une restauration.
  • Avant mise à l’échelle — l’état de la recette juste avant de la mettre elle-même à l’échelle, avec le facteur appliqué (par exemple Avant mise à l’échelle ×2). Voir Mettre une recette à l’échelle.

Dans les historiques anciens, vous pouvez aussi voir Avant restauration : c’est ainsi qu’étaient enregistrées les restaurations faites avec des versions antérieures de l’application, qui conservaient l’état précédant la restauration.

Créer une version quand vous le voulez

Cliquez sur Créer une version maintenant pour fixer une étape (par exemple, avant un changement important). Vous pouvez ajouter une note facultative pour la décrire — nous vous y invitons sans jamais vous y obliger : appuyez sur Entrée pour passer. Vous pourrez ajouter ou modifier plus tard la note de n’importe quelle version depuis sa carte.

Restaurer sans rien perdre

Sélectionnez une version, cliquez sur Restaurer cette version et confirmez. Votre travail actuel reste enregistré dans l’historique et la restauration est enregistrée comme une seule nouvelle version, Restaurée : le travail récent n’est pas perdu et vous pouvez revenir à l’état le plus récent quand vous le voulez. La restauration récupère la recette complète : ingrédients, fournitures, coûts, validation, nutrition, mesures aw/pH et notes.

Dupliquer et expérimenter (copie dérivée)

Cliquez sur Dupliquer et expérimenter pour créer une copie indépendante de la recette, avec sa propre chronologie (elle démarre à sa propre version 1 « Création »), et l’application vous emmène vers la copie. Attention : c’est la version actuelle de la recette qui est dupliquée, pas la version sélectionnée dans la chronologie ; pour partir d’une version antérieure, restaurez-la d’abord. La copie prend le nom de la recette mère suivi du suffixe (dérivée). C’est la méthode recommandée pour tester des variantes (un autre % de cacao, une autre garniture) sans toucher à la recette d’origine — la recette mère reste inchangée.

Enregistrement automatique

Il n’y a pas de bouton Enregistrer : l’éditeur enregistre automatiquement vos changements après une courte pause. L’indicateur de l’en-tête affiche l’état :

  • Enregistrement… — le changement est en cours d’envoi.
  • Tout est enregistré — rien n’est en attente ; suivi du temps écoulé depuis le dernier enregistrement.
  • Modifications non enregistrées (ou N modifications non enregistrées) — cliquez sur l’indicateur pour forcer l’enregistrement.
  • Hors ligne : N modifications non enregistrées. Elles seront enregistrées automatiquement au retour du réseau. — vous avez perdu la connexion ; ne fermez pas l’onglet avant son retour.
  • Erreur — réessayer — le dernier enregistrement a échoué ; cliquez pour réessayer.

Le navigateur vous prévient si vous essayez de quitter la page avec des modifications non enregistrées. Attendez de voir Tout est enregistré avant de fermer l’onglet.

Supprimer une recette

Ouvrez le menu ⋮ → Supprimer la recette. L’application demande une confirmation avant la suppression.

Disponibilité selon l’offre

Disponible dans toutes les offres. La seule exception est le compte gratuit limité (celui qui peut rester lorsque l’essai de 14 jours se termine sans souscription) : il n’inclut pas l’historique des versions, donc en l’ouvrant vous verrez le message « L’historique des versions est inclus dans les offres Starter et Pro. »

Performances

La chronologie ne se charge que lorsque vous l’ouvrez — elle n’alourdit pas l’affichage de la recette — et la capture est efficace : la journée est consolidée en arrière-plan, sans interrompre votre travail d’édition.

Étapes suivantes

Sur cette page