Aide & tutoriel

ChocoLab suit toujours le même fil : des compositions d'ingrédients justes, une recette en grammes, un bilan qui se recalcule en direct.

1. 1

   Vérifiez vos ingrédients

   Chaque ingrédient porte sa composition en % de la masse (eau, sucres détaillés, matières grasses, cacao, sel…). C'est elle qui alimente tous les calculs : une composition juste = un bilan juste. La base fournie est sourcée ; remplacez les valeurs par les fiches techniques de vos fournisseurs quand vous les avez.

   Ouvrir les ingrédients →
2. 2

   Créez une recette

   Choisissez la catégorie (moulée, enrobage, caramel…) : elle détermine les plages de stabilité utilisées pour les codes couleur. Ajoutez les ingrédients avec leur masse en grammes ; l'étape (Cuisson, Émulsion, Finition…) est un texte libre qui structure la fiche et le PDF.

   Nouvelle recette →
3. 3

   Lisez le bilan matière

   Le panneau de droite se recalcule à chaque frappe : eau, sucres, matières grasses, beurre de cacao, matière sèche, POD/PAC, énergie, allergènes et aw estimée. Les pastilles indiquent la position dans les plages de la catégorie : vert = idéal, orange = acceptable, rouge = hors limites, avec une suggestion de correction.

4. 4

   Déclarez une phase de cuisson si besoin

   Pour un caramel ou une réduction, cochez les ingrédients de la phase cuite puis saisissez au choix : % d'évaporation, eau évaporée en grammes, ou masse finale pesée (le plus précis). Le bilan bascule sur l'état après cuisson.

5. 5

   Mettez à l'échelle

   Trois modes : masse totale cible, nombre de pièces × poids, ou fixer la masse d'un ingrédient (ex. « j'ai 2 kg de couverture »). Les proportions sont conservées à la pleine précision.

6. 6

   Exportez

   PDF labo (avec compositions) ou PDF production (pesées seules), et l'étiquette réglementaire depuis le bouton « Étiquette » de la recette. Chaque enregistrement crée une version : l'historique permet de comparer et restaurer.

Un ingrédient peut avoir un prix à deux endroits : sur sa fiche, et chez chacun de ses fournisseurs dans Approvisionnement. Le coût de revient de vos recettes n'en retient qu'un seul, toujours dans cet ordre :

1. Le fournisseur préféré de l'ingrédient — celui marqué d'une étoile sur sa fiche. Son prix au kg fait foi, même s'il est plus cher.
2. À défaut de préféré, l'article le moins cher au kg parmi ses fournisseurs. Attention, c'est bien le prix au kilo qui compte : un carton de 10 kg à 20 € (2 €/kg) sort avant un sachet d'1 kg à 5 € (5 €/kg).
3. Le prix / kg de la fiche ingrédient, en dernier recours — donc uniquement si cet ingrédient n'a aucun fournisseur.

Autrement dit : dès qu'un fournisseur est renseigné, c'est lui qui pilote vos marges, et le prix de la fiche devient un simple repli. C'est pour ça que la colonne « Prix/kg » de la liste des ingrédients affiche le prix réellement utilisé, en indiquant au survol de quel fournisseur il vient : le modifier met à jour le tarif de ce fournisseur.

Un article dont la contenance ou le prix est à zéro est ignoré : un tarif à 0 € est presque toujours un champ pas encore rempli, pas un approvisionnement gratuit. Le prix de la fiche reprend alors la main, plutôt que de faire tomber vos coûts à zéro sans prévenir. Et si un ingrédient n'a ni fournisseur ni prix de fiche, la recette ne devine rien : elle signale « sans prix ».

Reporter les prix d'une facture à la main prend du temps, alors on ne le fait pas — et six mois plus tard les marges se calculent sur des tarifs qui n'existent plus. Depuis Appro › Factures, déposez le PDF reçu par mail ou photographiez le papier arrivé dans le carton : l'IA lit les lignes, retrouve vos articles et vous propose les nouveaux prix. Un bouton « Comment ça marche ? » sur cet écran détaille le parcours.

Le rapprochement se fait d'abord par la référence du fournisseur, la clé la plus fiable d'une facture ; à défaut par le libellé, et la ligne est alors signalée « à vérifier ». Les frais de port, remises et sous-totaux sont écartés : sans ce tri, une participation transport finirait enregistrée comme le prix d'un ingrédient.

Rien n'est enregistré sans vous.Vous cochez ligne par ligne, le prix au kg reste modifiable à la main, et l'entrée en stock se coche séparément — une facture arrive parfois avant la marchandise. La quantité livrée se calcule sur votreconditionnement : un « colis 6 × 1 L » ne dit pas ce qu'il pèse, et ChocoLab préfère votre fiche à une devinette.

Deux différences de nature à connaître. Corriger un prix deux fois est sans effet ; entrer du stock deux fois doublerait les quantités — une fois la marchandise entrée depuis une facture, un nouveau scan corrige encore les prix mais ne recharge plus le stock. Et le contrôle de réception HACCP n'est jamais créé automatiquement: ce registre atteste d'une vérification physique (température, DLC, état du colis) que seule la personne qui ouvre le carton peut constater. La facture pré-remplit le fournisseur et le contenu, vous enregistrez le reste.

Chaque prix modifié laisse une trace datée, ce qui alimente Évolution des prix : ce qui a augmenté, et le surcoût chiffré sur chaque recette concernée — sous-recettes comprises.

Le Planning organise la journée du labo. Créez vos équipes et personnes (panneau de droite), puis ajoutez des tâches : heure, durée, équipe, et éventuellement une recette avec quantité cible. La recette est alors scalée dans la tâche : les pesées affichées sont directement celles à faire.

Les dépendances enchaînent les tâches (ex. « enrobage 12 h après cristallisation »). La vue « Ma journée » filtre par équipe avec des cases à cocher, le récap des pesées additionne tous les ingrédients du jour, et le PDFs'affiche pour le labo.

Depuis une recette, le bouton « Étiquette »génère : la liste d'ingrédients en ordre pondéral décroissant avec les allergènes en gras, la déclaration nutritionnelle pour 100 g, les mentions INCO à compléter (exploitant, lot, poids net), et une suggestion de DLC dérivée de l'aw. Impression en planche A4 d'étiquettes produit ou en étiquettes DLC internes de labo.

Important :DLC et étiquette sont des propositions. La validation microbiologique (DLC réelle) et la conformité juridique de l'étiquetage restent de votre responsabilité professionnelle.

Les Dossiers regroupent vos échanges avec un client : fichiers joints, notes et fil de commentaires. Deux types de liens sécurisés, révocables à tout moment :

• Partage de recette (depuis la page recette), avec option « masquer les quantités » pour protéger le savoir-faire ;
• Partage de dossier, avec un rôle consultant ou client : la personne accède aux fichiers et peut commenter sous ce rôle.

Formulez un chocolat depuis la fève : masses de cacao / grué, sucre, beurre de cacao, poudre de lait… avec % cacao total, MG totale et seuil de fluidité pour l'enrobage. Le mode inversepart du résultat voulu (% cacao, % MG) et calcule les masses ; le coût de revient au kg s'affiche si vos ingrédients ont un prix.

Le module HACCP couvre l'essentiel du guide d'autocontrôle AFSCA (G-023) : températures, nettoyage, réception des marchandises, traçabilité des lots, non-conformités, lutte contre les nuisibles et formations. Chaque registre s'ouvre depuis l'écran « Aujourd'hui », qui reste le point de départ quotidien.

1. 1

   Aujourd'hui

   L'écran quotidien : relevez la température de chaque enceinte et cochez les nettoyages faits, en un clic. Tout est horodaté et conservé.

   Ouvrir le registre du jour →
2. 2

   Températures

   Vos enceintes et leurs consignes, l'historique des relevés et un graphique par enceinte (bande de consigne, points hors limites en évidence). Une valeur hors limites exige une action corrective.

   Ouvrir le registre →
3. 3

   Nettoyage

   Le plan de nettoyage : quoi, où, à quelle fréquence, avec quel produit. Une tâche cochée reste cochée toute sa période (jour, semaine, mois…) puis se rouvre seule — pas de remise à zéro à gérer.

   Ouvrir le plan →
4. 4

   Réceptions

   Contrôle à la livraison : température si pertinente, DLC/DLUO, état du colis. Trois points indépendants ; chacun peut à lui seul faire échouer la conformité.

   Ouvrir le registre →
5. 5

   Traçabilité

   Un numéro de lot par fabrication (format JJMMAA-NN, proposé automatiquement), avec DLC/DLUO et alerte dès qu'un lot est périmé ou proche de l'être.

   Ouvrir les lots →
6. 6

   Non-conformités

   Le registre transversal pour tout ce qui n'a pas sa place ailleurs : bris, panne d'équipement, plainte client, écart d'audit. Statut ouverte → en cours → clôturée.

   Ouvrir le registre →
7. 7

   Nuisibles

   Journal des passages de contrôle (postes d'appâtage, inspection). Un constat autre que « rien à signaler » exige de décrire les mesures prises.

   Ouvrir le registre →
8. 8

   Formations

   Les habilitations hygiène de votre équipe (HACCP, allergènes…), avec échéance de renouvellement et alerte quand elle approche.

   Ouvrir le registre →

Deux principes structurent l'ensemble : un relevé (température, réception) est un fait horodaté— sa conformité est calculée et figée au moment où il est pris, modifier une consigne plus tard ne réécrit jamais l'historique. Et le pointage du nettoyage repose sur une clé de période: une tâche hebdomadaire cochée le mardi reste cochée jusqu'au dimanche, puis se rouvre seule.

Depuis l'écran « Aujourd'hui », le bouton « Export PDF »rassemble un instantané de tous les registres en un document de quelques pages, prêt à être montré lors d'un contrôle.

Tout est stocké dans une base PostgreSQL, fichiers joints compris. Exportez régulièrement une sauvegarde JSON depuis Paramètres. Les plages de stabilité par catégorie y sont aussi éditables : adaptez-les à vos standards, elles pilotent les codes couleur.

En résumé :ChocoLab est un outil de calcul et d'aide à la formulation. Ses résultats sont théoriques et indicatifs. Vous restez seul responsable des produits que vous concevez, fabriquez et vendez, ainsi que de leur conformité, de leur sécurité sanitaire et de leur étiquetage.

1. 1

   Objet de l'outil

   ChocoLab est un logiciel d'aide à la formulation, au calcul et à l'organisation de la production, destiné à des utilisateurs professionnels. Les informations et résultats qu'il fournit ont une valeur indicative et théorique: ils constituent une aide à la décision et à la conception, et ne valent en aucun cas validation d'un produit fini, ni attestation de sa conformité ou de son innocuité.

2. 2

   Nature théorique et estimative des calculs

   L'ensemble des grandeurs calculées — activité de l'eau (aw), POD/PAC, valeur énergétique, déclaration nutritionnelle, matière sèche, suggestions de DLC, plages de stabilité, coûts de revient — résulte de modèles scientifiques publiés et des données de composition saisies par l'utilisateur. Ces modèles ont un domaine de validité limité et ne reproduisent pas tous les phénomènes réels (cristallisation, interactions entre ingrédients, procédé de fabrication, hygiène, conditionnement, chaîne du froid). Ils ne se substituent pas aux mesures instrumentales (aw-mètre) ni aux analyses de laboratoire (microbiologie, tests de vieillissement, challenge tests, analyses nutritionnelles), qui seules font foi.

3. 3

   Responsabilité exclusive de l'utilisateur

   L'utilisateur demeure seul et pleinement responsabledes recettes, produits et denrées qu'il conçoit, fabrique, étiquette, conserve, commercialise et vend. Il lui appartient notamment d'assurer, sous sa seule responsabilité : le respect de la réglementation d'hygiène (HACCP, paquet hygiène) ; la détermination et la validation des DLC / DDM par des analyses appropriées ; l'exactitude et la conformité de l'étiquetage (règlement INCO n° 1169/2011, dénominations légales, liste d'ingrédients, allergènes, déclaration nutritionnelle) ; la sécurité sanitaire des produits et la maîtrise des risques d'allergènes et de contaminations croisées.

4. 4

   Absence de garantie

   L'application et ses résultats sont fournis « en l'état », sans garantie d'aucune sorte, expresse ou implicite, notamment d'exactitude, d'exhaustivité, d'absence d'erreur, de disponibilité continue ou d'adéquation à un usage particulier. L'utilisateur reconnaît devoir vérifier et valider par ses propres moyens toute donnée et tout résultat avant toute exploitation professionnelle ou commerciale.

5. 5

   Limitation de responsabilité

   Dans les limites permises par la loi applicable, l'éditeur ne pourra être tenu responsable des dommages directs ou indirects — notamment pertes d'exploitation, perte de données, rappels ou retraits de produits, coûts de reformulation, sanctions administratives ou pénales, atteintes à la santé ou à la sécurité des consommateurs — résultant de l'utilisation de l'application, de ses résultats, ou de l'impossibilité de l'utiliser.

6. 6

   Garantie contre les recours de tiers

   L'utilisateur garantit l'éditeur contre toute réclamation, action ou condamnation émanant d'un tiers (client, consommateur, autorité de contrôle) qui trouverait son origine dans les produits qu'il a formulés, fabriqués, étiquetés ou commercialisés à l'aide de l'application.

7. 7

   Absence de conseil

   L'application ne constitue ni un conseil réglementaire, juridique, nutritionnel, médical ou de sécurité alimentaire, ni une prestation de laboratoire ou de certification. Pour toute question de conformité ou de sécurité, l'utilisateur est invité à consulter un professionnel qualifié (laboratoire agréé, conseil réglementaire).

L'utilisation de l'application vaut acceptation des présentes limites. Ce texte est un socle de décharge et ne remplace pas des conditions générales d'utilisation et de vente propres à votre activité : faites-le valider par un conseil juridique avant toute commercialisation. Dernière mise à jour : 19 juillet 2026.