Ingrédients personnalisés

De quoi s’agit-il ?

Le catalogue d’ingrédients est une base globale et partagée de plus de 10 000 fiches vérifiées, en lecture seule pour tous les utilisateurs. Les ingrédients personnalisés en sont le pendant : des fiches que vous créez vous-même, privées et propres à votre compte, avec la même richesse de données que celles du catalogue.

Ils servent pour tout ce que la base globale ne couvre pas : une matière première d’un fournisseur particulier, une préparation maison, un produit régional ou tout autre produit, avec vos propres valeurs nutritionnelles et votre coût. Une fois créés, ils s’utilisent dans vos recettes et vos formulateurs comme n’importe quel ingrédient du catalogue.

Chemin d’accès

• URL : https://app.areacacao.com/ingredients
• Comment y accéder : menu latéral → section FORMULATION → Ingrédients.
• Disponibilité : tout compte connecté, sans restriction selon l’offre.

L’écran s’intitule Catalogue d’ingrédients et comporte un sélecteur à deux onglets :

• Catalogue — la base globale en lecture seule.
• Mes ingrédients — les ingrédients personnalisés de votre compte.

Le bouton Nouvel ingrédient se trouve dans l’en-tête, à droite, à côté de Champs personnalisés et Importer / Exporter.

Créer un ingrédient

Champs de la fiche

Toutes les valeurs nutritionnelles sont pour 100 g. Les champs numériques acceptent la virgule décimale (par exemple 2,5).

Identité

• Nom (obligatoire)
• Code interne — votre SKU ou référence interne.
• Autres noms — séparés par des virgules.
• Catégorie — champ en texte libre : vous pouvez saisir n’importe quelle valeur ou choisir l’une des suggestions du menu déroulant, qui sont des catégories du catalogue (Produits du cacao, Produits laitiers, Édulcorants, Matières grasses et huiles, Fruits à coque et graines, Fruits, Condiments, Additifs et agents de texture, Boissons alcoolisées). Les suggestions s’affichent dans la langue de l’interface ; si vous en choisissez une, la fiche est rangée dans cette catégorie du catalogue et son nom se traduit quand vous changez de langue.
• Sous-catégorie
• Marque
• Fournisseur — sélecteur avec recherche, relié à votre liste de fournisseurs : choisissez-en un, Sans fournisseur, ou saisissez un nouveau nom et cliquez sur Créer « … ».

Valeurs nutritionnelles (pour 100 g)

Eau, matières grasses, acides gras saturés, glucides, sucres, protéines, fibres, sel, alcool (éthanol), calories (kcal), beurre de cacao et cacao total (%).

• Beurre de cacao : uniquement la matière grasse issue du cacao (chocolat, couverture, beurre de cacao) ; pour les produits laitiers et le beurre, laissez-le vide.
• Alcool (éthanol) : grammes d’éthanol pour 100 g, pour les vins et les liqueurs.
• Eau non renseignée : si vous ne saisissez pas l’eau, aucune valeur n’est enregistrée et la validation la traite comme inconnue, pas comme 0. Si l’ingrédient ne contient pas d’eau, saisissez 0.
• Estimation de l’eau : dès que les matières grasses, les glucides et les protéines sont saisis (un 0 compte), le formulaire propose une « Estimation indicative par différence » (100 − matières grasses − glucides totaux − protéines − sel, en soustrayant aussi les fibres et l’alcool déclarés) avec un bouton Utiliser. Si vous l’utilisez, le champ devient Eau (estimée) et la fiche l’enregistre marquée comme estimée. S’il y a des fibres, vous indiquez si votre étiquette les présente à part des glucides (étiquetage UE : elles sont soustraites) ou incluses dedans (étiquetage des États-Unis ou du Canada : elles ne sont pas soustraites une seconde fois). Pour une boisson alcoolisée, l’estimation n’apparaît que si vous déclarez l’alcool.
• Énergie calculée : quand les calories sont vides et que les matières grasses, les glucides et les protéines sont saisis, le formulaire propose l’énergie selon le règlement (UE) 1169/2011, annexe XIV (9 × matières grasses + 4 × glucides + 4 × protéines + 2 × fibres + 7 × alcool), elle aussi avec un bouton Utiliser. Rien ne se remplit tout seul.
• Tableau vide : si vous ne saisissez aucune valeur nutritionnelle, le formulaire prévient que la validation ne pourra pas compter cet ingrédient dans la composition de vos recettes.

Micronutriments

Section repliable, fermée par défaut, avec 20 micronutriments et deux valeurs supplémentaires :

• Vitamines (11) : A, D, E, K, C, B1 (thiamine), B2 (riboflavine), B3 (niacine), B6, B9 (folates) et B12.
• Minéraux (9) : calcium, fer, magnésium, phosphore, potassium, zinc, cuivre, manganèse et sélénium.
• Autres (2) : cholestérol et caféine.

Allergènes

Sélection par cases à cocher dans la liste officielle de l’UE (14) : gluten, crustacés, œufs, poissons, arachides, soja, lait, fruits à coque, céleri, moutarde, sésame, sulfites, lupin et mollusques. C’est un modèle simple de type « contient » : la fiche de l’ingrédient ne saisit pas les traces (elles se cochent dans la recette). Voir Allergènes UE-14.

Trois situations sont possibles :

• Allergènes cochés : la fiche contient ces allergènes.
• Aucun coché : en enregistrant, vous confirmez qu’il ne contient aucun des 14 (« Aucun allergène coché : en enregistrant, vous confirmez que cet ingrédient ne contient aucun des 14. »).
• Je ne connais pas encore ses allergènes (ils restent non déclarés) : case qui désactive la liste. La fiche n’est pas enregistrée comme « sans allergènes » : les recettes contenant cet ingrédient signaleront que leur déclaration d’allergènes est incomplète tant que vous ne les aurez pas déclarés.

Conservateurs

Section repliable et facultative Cet ingrédient contient-il un conservateur ?, avec quatre réponses : Je ne sais pas (celle de départ), Pas de conservateur, C’est un conservateur et En contient un dans sa composition. Les deux dernières demandent la substance et, dans le dernier cas, la quantité. Voir Utiliser le feu tricolore des conservateurs.

Propriétés physiques

• Unité de base — grammes par défaut.
• Densité (g/ml) — nécessaire pour convertir des volumes (ml, L) en poids.
• Poids par unité (g) — nécessaire pour convertir des unités en poids.

Coût

• Prix au kg — un coût de référence pour la fiche, dans la devise de votre compte. L’historique des achats et la stratégie de prix par fournisseur se trouvent dans le module Coûts.

Notes

Texte libre pour toute observation.

Voir, modifier et supprimer

Dans l’onglet Mes ingrédients, vous voyez la liste de vos fiches. Si vous n’en avez encore créé aucune, l’onglet affiche un état vide avec le titre « Vous n’avez pas encore d’ingrédients personnels », le texte « Créez des fiches sur mesure avec vos macronutriments, allergènes et prix. Elles seront disponibles dans vos recettes et formulations. » et un bouton Nouvel ingrédient.

Quand il y a des fiches, le même rappel de vérification que dans le formulaire apparaît au-dessus du tableau. Dans le tableau, quand une fiche a un Code interne, il s’affiche sous forme de badge à côté de son nom, et la colonne Allergènes indique le nombre d’allergènes, un tiret (aucun) ou Non déclarés. Pour chaque ligne :

• Voir — cliquez sur la ligne pour ouvrir sa fiche complète.
• Modifier — le bouton avec l’icône de crayon rouvre le formulaire avec les données chargées.
• Supprimer — le bouton avec l’icône de corbeille la retire (après confirmation).

L’utiliser dans une recette

Quand vous ajoutez des ingrédients dans l’éditeur de recettes ou dans les formulateurs, la recherche d’ingrédients affiche aussi vos ingrédients personnalisés, signalés par l’étiquette À moi pour les distinguer du catalogue global.

Ils s’ajoutent et se calculent exactement comme ceux du catalogue : ils apportent leurs macronutriments au total de la recette et participent à la conversion d’unités par la densité ou le poids par unité. C’est pourquoi il est conseillé de déclarer la densité et le poids par unité si vous comptez utiliser l’ingrédient en millilitres ou en unités.

Ingrédients personnalisés ou champs personnalisés

Ce sont deux choses distinctes et complémentaires :

En résumé : les ingrédients personnalisés ajoutent des fiches ; les champs personnalisés ajoutent des champs à ces fiches.

Référence technique

Pour les intégrations ou l’assistance. L’API est authentifiée par la session de l’utilisateur (le userId est déterminé par le serveur, jamais transmis par le client) :

• ID : préfixe ci_ (le catalogue global utilise d’autres identifiants).
• Persistance : table custom_ingredients ; les champs de cette fiche ont été déployés avec la migration Drizzle 0070 (en production). Les macronutriments et micronutriments sont stockés en JSON ; les allergènes, sous forme de liste limitée à l’UE-14, ou null quand ils ne sont pas déclarés.
• Validation : le backend utilise un schéma strict (il rejette les champs inconnus) et limite les allergènes à la liste officielle.

Étapes suivantes