Histórico de versões e duplicar

Quem itera, vence

O chocolateiro trabalha por iteração: você muda 2 g de açúcar, testa um insumo novo, ajusta a fluidez, repete. O AreaCacao registra esse percurso para você. O versionamento de receitas é o controle de versões das fábricas, feito para o ateliê: experimente sem medo, tudo fica registrado e você pode voltar atrás quando quiser.

Cada receita nasce com a sua versão 1 “Criação” no dia em que você a cria, seja qual for a origem: o Formulador de chocolates, o de recheios, uma importação ou uma receita começada do zero. Essa primeira versão é o original e fica intacta: a sua primeira alteração cria a versão 2, de modo que o ponto de partida é sempre preservado e você pode compará-lo com qualquer versão posterior. A partir daí, o trabalho de cada dia é consolidado automaticamente numa versão, e você pode definir marcos quando quiser.

Registro completo do ecossistema

Uma versão não guarda só os ingredientes: ela congela todo o ecossistema da receita naquele momento, de forma fiel e imutável. Se qualquer um destes itens mudar, a versão o registra e a comparação o mostra:

• Ingredientes, quantidades, unidades e %.
• Insumos (embalagens, caixas, etiquetas) e o custo deles — veja Insumos.
• Custos: custo carregado, preços por canal, ponto de equilíbrio e a cascata de sub-receitas — veja Custos.
• Validação técnica: a pontuação físico-química e os seus parâmetros — veja Validação de fórmula.
• Nutrição: macros, valor energético e alergênicos.
• Modo de preparo (etapas e notas), partes da formulação, rendimento (perda, o que é uma unidade, tamanho e número de unidades) e dados (nome, tipo, % de cacau, fluidez, peso total, medições de aw/pH).

A linha do tempo

Abra-a com o botão Histórico do cabeçalho do editor (/validation?id=<id>) ou pelo menu ⋮ → Histórico de versões. O histórico só aparece nas suas próprias receitas: quem edita uma receita compartilhada com você não gerencia o histórico dela. Uma linha do tempo vertical se abre à esquerda: cada versão é um cartão com o número, a data, uma etiqueta do tipo de versão, a pontuação de validação e alguns chips de alterações (por exemplo Custo +8%, Pontuação 78→91, +2 ingredientes, Insumo novo). À direita, um painel largo conta o que aconteceu nessa versão.

Quando uma receita acumula várias versões, um seletor Comparar com: Anterior / Original (v1) permite escolher a referência da comparação: a versão imediatamente anterior (o que mudou naquela etapa) ou a Criação (o quanto a receita se afastou do ponto de partida). Um banner “Comparando com…” sempre lembra qual é a referência, e uma ajuda curta esclarece a diferença (Anterior = a etapa logo antes · Original = a sua receita de partida). Ao selecionar a versão 1, o painel mostra “Aqui começa a história”, com o ponto de partida da sua receita (peso, ingredientes, insumos e custo). Se for a sua primeira vez, clique em Como funciona? no cabeçalho para um lembrete rápido do modelo.

Entender de relance

O painel direito foi pensado para que você entenda o impacto antes de ler os detalhes:

• Resumo do impacto — uma manchete em linguagem natural (“Você adicionou 1 insumo”, “O custo subiu 8%”), as contagens de itens adicionados / removidos / modificados e as métricas principais (custo, validação, peso) com setas ↑/↓ e cores: aumento de custo é vermelho, melhora na validação é verde, o peso é neutro.
• Linguagem visual consistente — cada alteração recebe ícone e cor: Adicionado (verde), Removido (vermelho), Modificado (âmbar). Nos valores numéricos você vê o antes → depois e a variação (por exemplo, 10 g → 11 g · ↑10%).
• Detalhes por dimensão — logo abaixo, somente as seções que realmente mudaram (fórmula, partes, ingredientes, insumos, custos, validação técnica, nutrição, alergênicos, modo de preparo, dados, medições de aw/pH). O que não mudou não gera ruído.

Ver a receita completa de uma versão

Clique em Ver receita completa para abrir, por cima da linha do tempo, a receita inteira daquela versão em modo somente leitura: métricas (peso, validação, custo), ingredientes (por partes, se a receita tiver), rendimento, insumos, custos, alergênicos, nutrição e modo de preparo. Nos estados de origem ou “sem alterações”, você também vê uma pré-visualização dos ingredientes sem sair do painel. A partir da receita completa, o botão Abrir a receita atual leva você ao editor com a receita como ela está agora, não com aquela versão: para voltar a ela, use Restaurar esta versão.

Tipos de versão:

• Criação — a versão 1, do dia em que você criou a receita.
• Dia de trabalho — a versão que consolida automaticamente as alterações de um dia. Não registramos cada tecla: uma versão por dia de trabalho.
• Versão — um marco que você define com Criar versão agora.
• Restaurada — o estado deixado por uma restauração.
• Antes de escalar — o estado da receita logo antes de escalá-la sobre ela mesma, com o fator aplicado (por exemplo Antes de escalar ×2). Veja Escalar receita.

Em históricos antigos você também pode ver Antes de restaurar: é assim que ficaram as restaurações feitas com versões anteriores do app, que salvavam o estado anterior à restauração.

Criar uma versão quando você quiser

Clique em Criar versão agora para fixar um marco (por exemplo, antes de uma grande alteração). Você pode adicionar uma nota opcional descrevendo-o — convidamos você a anotar, mas nunca obrigamos: pressione Enter para pular. Mais tarde, você pode adicionar ou editar a nota de qualquer versão pelo cartão dela.

Restaurar sem perder nada

Selecione uma versão, clique em Restaurar esta versão e confirme. O seu trabalho atual fica salvo no histórico e a restauração é registrada como uma única versão nova, Restaurada, então o trabalho novo não se perde e você pode avançar de novo quando quiser. A restauração recupera a receita completa: ingredientes, insumos, custos, validação, nutrição, medições de aw/pH e notas.

Duplicar e experimentar (fork)

Clique em Duplicar e experimentar para criar uma cópia independente da receita, com a sua própria linha do tempo (ela começa na sua própria versão 1 “Criação”), e o app leva você até a cópia. Atenção: é duplicada a versão atual da receita, não a versão selecionada na linha do tempo; para partir de uma versão anterior, restaure-a primeiro. A cópia recebe o nome da receita-mãe com o sufixo (derivada). É a forma recomendada de testar variantes (outro % de cacau, outro recheio) sem mexer na receita original — a receita-mãe não é alterada.

Salvamento automático

Não há botão Salvar: o editor grava as suas alterações automaticamente depois de uma breve pausa. O indicador do cabeçalho mostra o estado:

• Salvando… — a alteração está sendo enviada.
• Tudo salvo — não há nada pendente; vem seguido de há quanto tempo foi feito o último salvamento.
• Alterações não salvas (ou N alterações não salvas) — clique no indicador para forçar o salvamento.
• Sem conexão: N alterações não salvas. Serão salvas automaticamente quando a rede voltar. — a conexão caiu; não feche a aba até ela voltar.
• Erro: tentar novamente — o último salvamento falhou; clique para tentar novamente.

Excluir uma receita

Abra o menu ⋮ → Excluir receita. O app pede confirmação antes de apagar.

Disponibilidade por plano

Disponível para todos os planos. A única exceção é a conta gratuita limitada (a que pode ficar quando o teste de 14 dias termina sem a contratação de um plano): ela não inclui o histórico de versões, então ao abri-lo você vê o aviso “O histórico de versões está incluído nos planos Starter e Pro.”

Desempenho

A linha do tempo só carrega quando você a abre — não pesa na tela da receita — e o registro é eficiente: o dia de trabalho é consolidado em segundo plano, sem interromper a sua edição.

Próximos passos