Catálogo de ingredientes

O que é

O catálogo de ingredientes é a base comum em que assenta toda a formulação do AreaCacao. Reúne mais de 10 000 fichas técnicas (macronutrientes, alergénios UE-14, densidade e peso por unidade) que alimentam o editor de receitas, os formuladores e o cálculo automático de macros.

A base global é só de leitura: pode pesquisar, filtrar e consultar a ficha completa de qualquer ingrediente, mas os respetivos dados não são editáveis a partir deste ecrã. O que é seu: pode criar os seus próprios ingredientes personalizados (fichas privadas que são usadas nas suas receitas tal como as do catálogo), definir campos personalizados para a sua conta e importar ou exportar o seu próprio catálogo personalizado.

Como aceder

• URL: https://app.areacacao.com/ingredients
• Como se chega lá: menu lateral → secção FORMULAÇÃO → Ingredientes.
• Disponibilidade: acessível a qualquer utilizador com sessão iniciada (sem restrições por plano).

Secções do ecrã

Cabeçalho

Na parte superior encontra a ligação Voltar ao painel e o título Catálogo de ingredientes. Por baixo do título é apresentado um subtítulo dinâmico com o número de fichas da listagem, do tipo «Base global de N ingredientes com macros e alergénios verificados.» O número é o total de resultados da listagem atual: muda quando pesquisa ou filtra. Enquanto não há resultados (durante o carregamento ou se os filtros não devolvem nada), verá o texto de reserva «Base global de mais de 10.000 ingredientes com macros e alergénios verificados.».

O ecrã tem dois separadores: Catálogo (a base global) e Os meus ingredientes (os ingredientes personalizados da sua conta). Depois de abrir o separador Os meus ingredientes, se tiver fichas próprias, este mostra junto ao nome um distintivo com o número de ingredientes personalizados ativos.

À direita do cabeçalho há três botões:

• Novo ingrediente — abre o formulário para criar um ingrediente personalizado com a ficha completa (macros, micronutrientes, alergénios e custo).
• Campos personalizados — abre o gestor para definir campos próprios da sua conta (origem, certificação, lote, etc.). Ver Campos personalizados.
• Importar / Exportar — abre a janela para exportar ou carregar o seu catálogo personalizado em JSON ou CSV. Ver Importar e exportar.

Barra de filtros

Por cima da tabela há uma barra horizontal de filtros com três controlos:

• Caixa de pesquisa com o texto de exemplo «Pesquisar por nome, marca...».
• Seletor de categoria com a opção predefinida Todas as categorias. As categorias são carregadas em função do catálogo; não são uma lista fixa.
• Com alergénios — caixa de verificação que limita a listagem aos ingredientes que declaram algum alergénio UE-14.

Ao alterar qualquer filtro, a listagem volta à página 1.

Filtrar por etiquetas

Por baixo da barra de filtros há uma secção Etiquetas que permite restringir o catálogo por características transversais. É um filtro de seleção múltipla: clique nas etiquetas que lhe interessam e a listagem reduz-se. Dentro do mesmo eixo, basta que o ingrediente tenha uma das etiquetas assinaladas; entre eixos diferentes, tem de cumprir todos (por exemplo, Biológico + Torrado mostra os ingredientes biológicos que também são torrados). Quando há etiquetas ativas, aparece um botão Limpar (N) que as remove todas de uma vez. Qualquer alteração faz a listagem voltar à página 1.

As etiquetas estão agrupadas por eixos:

Tabela de resultados

Cada linha da listagem mostra estas colunas:

Clique em qualquer linha para abrir a ficha do ingrediente.

Paginação

A listagem mostra 50 ingredientes por página. Quando há mais de uma página, aparece um rodapé com o intervalo visível («A mostrar X–Y de TOTAL»), as setas Página anterior / Página seguinte e o indicador da página atual.

Ações disponíveis

Estados do ecrã

• A carregar: linhas de esqueleto enquanto a listagem chega.
• Sem resultados: «Não há ingredientes com esses filtros.».
• Erro de carregamento: banner vermelho com a mensagem do sistema ou o aviso «Erro ao carregar os ingredientes».
• Limite diário de consultas: cada conta pode pedir até 2000 páginas do catálogo por dia (listagem e pesquisa). Se o ultrapassar, o banner vermelho indica «Consultou o catálogo mais de 2000 vezes hoje. Volta a estar disponível amanhã; se precisar do catálogo completo, escreva ao apoio ao cliente.».

Próximos passos