Como Criar uma Aplicação de Planeamento de Refeições: Planos Semanais, Listas de Compras e Nutrição

Uma aplicação de planeamento de refeições transforma "o que vamos comer esta semana?" num plano e numa lista de compras. No centro estão três coisas: as suas receitas, um calendário semanal com os momentos das refeições e uma lista de compras construída automaticamente a partir do que está no plano. Tudo o resto — partilha em casa, sobras, controlo da despensa, totais nutricionais, sugestões de IA — é opcional e deve ser acrescentado depois de o ciclo básico funcionar na sua própria cozinha.

O que um planeador de refeições precisa

Páginas

• Vista semanal — sete dias por refeição (pequeno-almoço, almoço, jantar, lanches), com receitas colocadas nos momentos. É o ecrã principal.
• Biblioteca de receitas — as suas receitas, pesquisáveis e com etiquetas.
• Página da receita — ingredientes, passos, porções.
• Lista de compras — gerada a partir da semana, agrupada por corredor, fácil de marcar.
• Definições — tamanho do agregado familiar, preferências alimentares, o dia em que começa a semana, unidades.

Dados

• Receitas com ingredientes guardados como linhas separadas (quantidade, unidade, nome). O nosso guia para criar uma aplicação de receitas explica porque é que esta estrutura importa.
• Planos — agregado familiar, data de início da semana.
• Entradas do plano — plano, dia, momento da refeição, receita (ou texto livre, como "Comer fora"), porções.
• Itens da lista de compras — agregado familiar, ingrediente, quantidade, unidade, corredor, marcado, origem (do plano ou acrescentado manualmente).
• Itens da despensa (opcional) — coisas que tem sempre, como sal e azeite, excluídas da lista.
• Agregados familiares e membros — quem partilha o plano.

Permissões

Um planeador pessoal precisa de uma conta. Para uma família ou colegas de casa, crie um agregado familiar que seja dono das receitas, dos planos e da lista, e deixe os membros entrar por convite. Todos os membros do agregado podem editar; ninguém de fora o vê.

Decisões e compromissos

Momentos fixos ou dias de forma livre. Momentos fixos de pequeno-almoço, almoço e jantar são fáceis de construir e de ler. Alguns agregados só planeiam jantares; deixe-os ocultar os momentos que não usam.

Quão inteligente é a lista de compras. Juntar "200 g de cebola" e "1 cebola" exige saber que uma cebola pesa aproximadamente uma certa quantidade — um buraco sem fundo. Uma boa primeira versão junta apenas unidades iguais e mostra as restantes lado a lado. É honesto e continua a ser útil.

Porções por entrada. Se cozinhar uma receita para quatro pessoas mas a planear para duas, a lista de compras deve ser ajustada. Se cozinhar o dobro para sobras, o plano deve mostrar uma entrada de "sobras" noutro dia que não acrescenta nada à lista.

Nutrição. Os totais nutricionais precisam de um valor nutricional para cada ingrediente. Bases públicas como a FoodData Central do USDA fornecem estes valores, mas fazer corresponder ingredientes escritos livremente às entradas da base de dados dá trabalho e os resultados são estimativas. Trate a nutrição como uma funcionalidade para mais tarde, e nunca a apresente como aconselhamento alimentar.

Sugestões de refeições com IA. "Planeie a minha semana" é uma funcionalidade de IA natural. Mantenha-a segura:

1. Envie ao modelo apenas as receitas que o agregado já tem, mais as preferências ("sem peixe, uma noite vegetariana, rápido nos dias úteis").
2. Peça uma resposta estruturada (uma lista de IDs de receitas por momento) e verifique com código comum que cada ID existe.
3. Nunca confie no modelo para as alergias. Filtre as receitas que contenham um alergénio indicado, antes e depois do passo de IA, com código simples.
4. Mantenha a chave da API no servidor e limite o número de vezes que cada utilizador a pode chamar.

Veja como adicionar funcionalidades de IA à sua aplicação para ver como isto é ligado.

Exemplo de primeiro prompt

Crie uma aplicação web de planeamento de refeições para o meu agregado familiar, pensada primeiro para telemóveis. Temos uma biblioteca de receitas partilhada: cada receita tem um título, fotografia, porções, etiquetas, passos e ingredientes guardados como linhas separadas com quantidade, unidade e nome. O ecrã principal é uma vista semanal (com início à segunda-feira) com momentos de pequeno-almoço, almoço e jantar por dia; posso ocultar os momentos que não usamos. Acrescento uma receita a um momento pesquisando, defino as porções dessa entrada, ou acrescento texto livre como "Comer fora". Posso marcar uma refeição como "cozinhar o dobro" para criar uma entrada de sobras noutro dia que não acrescenta à lista de compras. A lista de compras é gerada a partir da semana: ajustada pelas porções, junta ingredientes idênticos com a mesma unidade, ignora os básicos da despensa que marquei, agrupa por corredor, e deixa-me marcar itens e acrescentar itens extra à mão. Os membros do agregado entram por link de convite e partilham tudo. Início de sessão com email e palavra-passe e uma base de dados. Carregue dez receitas de exemplo.

Passos de construção

1. Vista semanal com receitas de exemplo. Faça com que colocar e mover receitas seja rápido num telemóvel.
2. Geração da lista de compras. Planeie uma semana real e compare a lista com o que compraria de facto. Corrija os ajustes de porções e a junção.
3. Básicos da despensa. Marque as coisas que nunca precisa de comprar.
4. Sobras e comer fora. Confirme que nenhuma das duas acrescenta itens à lista.
5. Agregados familiares e início de sessão. Convide uma segunda conta e edite o plano a partir das duas. Veja como adicionar início de sessão à sua aplicação.
6. Repetir uma semana. "Copiar a semana passada" é uma funcionalidade pequena que as pessoas usam constantemente.
7. Use durante duas semanas. Depois decida se vale a pena acrescentar nutrição ou sugestões de IA.
8. Instale-a. Acrescente-a ao ecrã inicial; veja como criar uma aplicação web adaptada ao telemóvel.

Erros comuns

• Ingredientes como texto. Sem ingredientes estruturados, não há lista de compras automática.
• Juntar unidades em excesso. Supor que "um molho de salsa" equivale a "30 g" produz listas erradas. Mantenha separadas as unidades diferentes.
• Ignorar as porções. Uma lista que ignora as porções planeadas compra o dobro ou metade.
• Deixar a IA tratar das alergias. Os alergénios têm de ser filtrados por código simples, sempre.
• Nutrição apresentada como precisa. Assinale os totais como estimativas e indique a fonte.
• Sem lista offline. O sinal no supermercado costuma ser fraco. Pelo menos mantenha a lista legível depois de carregada e não perca as marcações.
• Planear funcionalidades a mais para a primeira semana. Um plano e uma lista que funcionem valem mais do que uma dúzia de extras meio acabados.

Quando um planeador de refeições pronto é melhor

Muitas aplicações de planeamento de refeições já importam receitas de sites, geram listas e sincronizam com serviços de entregas de supermercado em alguns países. Se quer planear as suas próprias refeições com o mínimo de esforço, experimente algumas antes de construir.

Construa a sua própria quando o seu agregado tiver regras que essas aplicações não tratam, quando quiser que o planeador use a sua própria coleção e estrutura de receitas, ou quando estiver a construir para um grupo específico — um negócio de preparação de refeições que planeia para clientes, um nutricionista a partilhar planos, um lar ou uma equipa desportiva. É também um projeto pessoal gratificante; mais ideias em ideias de projetos paralelos que pode construir com IA.

Construir com a Mythex

A Mythex constrói planeadores de refeições como aplicações web: descreve o planeador no chat, experimenta a vista semanal na moldura de telemóvel da pré-visualização em direto e publica num endereço público que o seu agregado pode adicionar ao ecrã inicial. Acrescenta uma base de dados Postgres dedicada quando a aplicação precisa e armazenamento de ficheiros para as fotografias das receitas. O início de sessão do agregado é trazido por si — escolhe uma abordagem e o agente liga-a. Para as sugestões de refeições com IA, traz a chave de API de um fornecedor de IA e guarda-a como segredo do projeto; a receita de adicionar IA à sua aplicação explica o processo. No Pro, a Mythex também pode empacotá-la como aplicação Android e iPhone, enviada para testes internos no Google Play e para o TestFlight.

Perguntas