Catalogue d’ingrédients

De quoi s’agit-il ?

Le catalogue d’ingrédients est la base commune sur laquelle repose toute la formulation d’AreaCacao. Il rassemble plus de 10 000 fiches techniques (macronutriments, allergènes UE-14, densité et poids par unité) qui alimentent l’éditeur de recettes, les formulateurs et le calcul automatique des macronutriments.

La base globale est en lecture seule : vous pouvez rechercher, filtrer et consulter la fiche complète de n’importe quel ingrédient, mais ses données ne se modifient pas depuis cet écran. Ce qui vous appartient : vous pouvez créer vos propres ingrédients personnalisés (des fiches privées qui s’utilisent dans vos recettes comme celles du catalogue), définir des champs personnalisés pour votre compte et importer ou exporter votre propre catalogue personnalisé.

Chemin d’accès

• URL : https://app.areacacao.com/ingredients
• Comment y accéder : menu latéral → section FORMULATION → Ingrédients.
• Disponibilité : accessible à tout utilisateur connecté (aucune restriction selon l’offre).

Sections de l’écran

En-tête

En haut, vous trouverez le lien Retour au tableau de bord et le titre Catalogue d’ingrédients. Sous le titre s’affiche un sous-titre dynamique avec le nombre de fiches de la liste, du type « Base globale de N ingrédients avec macronutriments et allergènes vérifiés. » Ce nombre correspond au total des résultats de la liste en cours : il change quand vous recherchez ou filtrez. Tant qu’il n’y a aucun résultat (pendant le chargement ou si les filtres ne renvoient rien), vous verrez le texte de repli « Base globale de plus de 10 000 ingrédients avec macronutriments et allergènes vérifiés. ».

L’écran comporte deux onglets : Catalogue (la base globale) et Mes ingrédients (les ingrédients personnalisés de votre compte). Une fois l’onglet Mes ingrédients ouvert, si vous avez vos propres fiches, il affiche à côté de son nom un badge indiquant le nombre d’ingrédients personnalisés actifs.

À droite de l’en-tête se trouvent trois boutons :

• Nouvel ingrédient — ouvre le formulaire pour créer un ingrédient personnalisé avec sa fiche complète (macronutriments, micronutriments, allergènes et coût).
• Champs personnalisés — ouvre le gestionnaire pour définir des champs propres à votre compte (origine, certification, lot, etc.). Voir Champs personnalisés.
• Importer / Exporter — ouvre la fenêtre pour exporter ou charger votre catalogue personnalisé en JSON ou CSV. Voir Importer et exporter.

Barre de filtres

Au-dessus du tableau, une barre horizontale de filtres propose trois commandes :

• Champ de recherche avec le texte indicatif « Rechercher par nom, marque… ».
• Sélecteur de catégorie avec l’option par défaut Toutes les catégories. Les catégories sont chargées à partir du catalogue ; ce n’est pas une liste figée.
• Avec allergènes — case à cocher qui limite la liste aux ingrédients déclarant au moins un allergène UE-14.

Quand vous modifiez un filtre, la liste revient à la page 1.

Filtrer par étiquettes

Sous la barre de filtres, une section Étiquettes permet d’affiner le catalogue selon des caractéristiques transversales. C’est un filtre à sélection multiple : cliquez sur les pastilles qui vous intéressent et la liste se réduit. Au sein d’un même axe, il suffit que l’ingrédient porte une des étiquettes cochées ; entre des axes différents, il doit les satisfaire tous (par exemple, Biologique + Torréfié affiche les ingrédients biologiques qui sont aussi torréfiés). Quand des étiquettes sont actives, un bouton Effacer (N) apparaît pour les retirer toutes d’un coup. Toute modification ramène la liste à la page 1.

Les pastilles sont regroupées par axes :

Tableau des résultats

Chaque ligne de la liste affiche ces colonnes :

Cliquez sur n’importe quelle ligne pour ouvrir la fiche ingrédient.

Pagination

La liste affiche 50 ingrédients par page. Quand il y a plusieurs pages, un pied de tableau indique la plage visible (« Affichage de X–Y sur TOTAL »), les flèches Page précédente / Page suivante et l’indicateur de la page en cours.

Actions disponibles

États de l’écran

• Chargement : des lignes squelettes s’affichent en attendant la liste.
• Aucun résultat : « Aucun ingrédient ne correspond à ces filtres. ».
• Erreur de chargement : bandeau rouge avec le message du système ou l’avertissement « Erreur lors du chargement des ingrédients ».
• Limite quotidienne de consultations : chaque compte peut demander jusqu’à 2 000 pages du catalogue par jour (liste et recherche). Au-delà, le bandeau rouge indique « Vous avez consulté le catalogue plus de 2 000 fois aujourd’hui. Il sera de nouveau disponible demain ; si vous avez besoin du catalogue complet, écrivez à l’assistance. ».

Étapes suivantes