Ingredientes personalizados

O que é

O catálogo de ingredientes é uma base global e partilhada de mais de 10 000 fichas verificadas, só de leitura para todos os utilizadores. Os ingredientes personalizados são o outro lado: fichas criadas por si, privadas da sua conta, com a mesma riqueza de dados que as do catálogo.

Servem para tudo o que a base global não cobre: uma matéria-prima de um fornecedor concreto, uma preparação própria, um produto regional ou qualquer outro ingrediente com os seus valores nutricionais e o seu custo. Depois de criados, são usados nas suas receitas e formuladores tal como qualquer ingrediente do catálogo.

Como aceder

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

O ecrã intitula-se Catálogo de ingredientes e tem um comutador com dois separadores:

• Catálogo — a base global só de leitura.
• Os meus ingredientes — os ingredientes personalizados da sua conta.

O botão Novo ingrediente está no cabeçalho, à direita, junto de Campos personalizados e Importar / Exportar.

Criar um ingrediente

Campos da ficha

Todos os valores nutricionais são por 100 g. Os campos numéricos aceitam vírgula decimal (formato europeu, por exemplo 2,5).

Identificação

• Nome (obrigatório)
• Código próprio — o seu SKU ou referência interna.
• Nomes alternativos — separados por vírgulas.
• Categoria — campo de texto livre: pode escrever qualquer valor ou escolher uma das sugestões da lista pendente, que são categorias do catálogo (Derivados do cacau, Lacticínios, Edulcorantes, Gorduras e óleos, Frutos secos e sementes, Frutas, Condimentos, Aditivos e agentes de textura, Bebidas alcoólicas). As sugestões aparecem no idioma da interface; se escolher uma, a ficha fica nessa categoria do catálogo e o seu nome é traduzido quando muda de idioma.
• Subcategoria
• Marca
• Fornecedor — seletor com pesquisa ligado à sua lista de fornecedores: escolha um existente, Sem fornecedor, ou escreva um nome novo e clique em Criar «…».

Informação nutricional (por 100 g)

Água, lípidos, ácidos gordos saturados, hidratos de carbono, açúcares, proteína, fibra, sal, álcool (etanol), calorias (kcal), manteiga de cacau e cacau total (%).

• Manteiga de cacau: apenas a gordura que vem do cacau (chocolate, cobertura, manteiga de cacau); em lacticínios e manteiga, deixe-a vazia.
• Álcool (etanol): gramas de etanol por 100 g, para vinhos e licores.
• Água não indicada: se não escrever a água, não se guarda nenhum valor e a validação trata-a como desconhecida, não como 0. Se o ingrediente não leva água, escreva 0.
• Estimativa da água: com lípidos, hidratos de carbono e proteína preenchidos (um 0 conta), o formulário oferece uma «Estimativa indicativa por diferença» (100 − lípidos − hidratos de carbono totais − proteína − sal, subtraindo também a fibra e o álcool declarados) com um botão Usar. Se a usar, o campo passa a chamar-se Água (estimada) e a ficha guarda-a assinalada como estimada. Quando há fibra, escolhe se no seu rótulo ela aparece à parte dos hidratos de carbono (rotulagem da UE: é subtraída) ou incluída neles (EUA ou Canadá: não volta a ser subtraída). Numa bebida alcoólica, a estimativa só aparece se declarar o álcool.
• Energia calculada: com as calorias vazias e lípidos, hidratos de carbono e proteína preenchidos, o formulário propõe a energia segundo o Regulamento (UE) 1169/2011, anexo XIV (9 × lípidos + 4 × hidratos de carbono + 4 × proteína + 2 × fibra + 7 × álcool), também com um botão Usar. Nada é preenchido automaticamente.
• Tabela vazia: se não escrever nenhum valor nutricional, o formulário avisa que a validação não poderá contar este ingrediente na composição das suas receitas.

Micronutrientes

Secção expansível, fechada por predefinição, com 20 micronutrientes e dois valores adicionais:

• Vitaminas (11): A, D, E, K, C, B1 (tiamina), B2 (riboflavina), B3 (niacina), B6, B9 (folato) e B12.
• Minerais (9): cálcio, ferro, magnésio, fósforo, potássio, zinco, cobre, manganês e selénio.
• Outros (2): colesterol e cafeína.

Alergénios

Seleção através de caixas de verificação da lista oficial da UE (14): glúten, crustáceos, ovos, peixe, amendoins, soja, leite, frutos de casca rija, aipo, mostarda, sésamo, sulfitos, tremoço e moluscos. É um modelo simples de «contém»: a ficha do ingrediente não regista vestígios (os vestígios assinalam-se na receita). Ver Alergénios UE-14.

Há três situações possíveis:

• Com alergénios assinalados: a ficha contém esses alergénios.
• Nenhum assinalado: ao guardar, confirma que não contém nenhum dos 14 («Nenhum alergénio assinalado: ao guardar, confirma que este ingrediente não contém nenhum dos 14.»).
• Ainda não conheço os seus alergénios (ficam por declarar): caixa que desativa a lista. A ficha não fica guardada como «sem alergénios»: as receitas que levem este ingrediente vão avisar que a declaração de alergénios está incompleta até os declarar.

Conservantes

Secção expansível e opcional Este ingrediente leva conservante?, com quatro respostas: Não sei (a inicial), Não leva conservante, É um conservante e Leva um entre os seus ingredientes. As duas últimas pedem a substância e, no último caso, a quantidade. Ver Como se usa o semáforo de conservantes.

Propriedades físicas

• Unidade base — gramas por predefinição.
• Densidade (g/ml) — necessária para converter volumes (ml, L) em peso.
• Peso por unidade (g) — necessário para converter unidades em peso.

Custo

• Preço por kg — um custo de referência para a ficha, na moeda da sua conta. O histórico de compras e a estratégia de preço por fornecedor ficam no módulo de Custos.

Notas

Texto livre para qualquer observação.

Ver, editar e eliminar

No separador Os meus ingredientes verá a lista das suas fichas. Se ainda não tiver criado nenhuma, o separador mostra um estado vazio com o título «Ainda não tem ingredientes próprios», o texto «Crie fichas à medida com os seus macros, alergénios e preços. Ficarão disponíveis nas suas receitas e formulações.» e um botão Novo ingrediente.

Quando há fichas, o mesmo lembrete de revisão do formulário aparece por cima da tabela. Na tabela, quando uma ficha tem Código próprio, este é apresentado como um distintivo junto ao nome, e a coluna Alergénios indica o número de alergénios, um travessão (nenhum) ou Não declarados. Para cada linha:

• Ver — clique na linha para abrir a ficha completa.
• Editar — o botão com o ícone de lápis reabre o formulário com os dados carregados.
• Eliminar — o botão com o ícone de caixote do lixo remove-a (com confirmação).

Usá-lo numa receita

Ao adicionar ingredientes no editor de receitas ou nos formuladores, a pesquisa de ingredientes mostra também os seus ingredientes personalizados, assinalados com a etiqueta Meu para os distinguir do catálogo global.

São adicionados e calculados exatamente como os do catálogo: contribuem com os seus macros para o total da receita e participam na conversão de unidades por densidade ou peso por unidade. Por isso, convém declarar a densidade e o peso por unidade se for usar o ingrediente em mililitros ou unidades.

Ingredientes personalizados vs. campos personalizados

São duas coisas diferentes e complementares:

Em resumo: os ingredientes personalizados acrescentam fichas; os campos personalizados acrescentam campos a essas fichas.

Referência técnica

Para integrações ou apoio ao cliente. A API é autenticada com a sessão do utilizador (o userId é obtido pelo servidor, nunca pelo cliente):

• IDs: prefixo ci_ (o catálogo global usa outros identificadores).
• Persistência: tabela custom_ingredients; os campos desta ficha foram implementados com a migração Drizzle 0070 (em produção). Os macros e os micronutrientes são guardados em JSON; os alergénios, como lista restrita à UE-14, ou null quando estão por declarar.
• Validação: o backend usa um esquema estrito (rejeita campos desconhecidos) e limita os alergénios à lista oficial.

Próximos passos