Histórico de versões e duplicar

Quem itera, vence

O chocolateiro trabalha por iterações: altera 2 g de açúcar, experimenta um consumível novo, ajusta a fluidez, repete. O AreaCacao regista esse percurso por si. O controlo de versões das receitas é o controlo de versões das fábricas, pensado para o atelier: experimente sem receio, fica tudo registado e pode voltar atrás quando quiser.

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

Registo completo do ecossistema

Uma versão não guarda só os ingredientes: congela todo o ecossistema da receita nesse momento, de forma fiel e imutável. Se alguma destas coisas mudar, a versão regista-o e a comparação mostra-o:

• Ingredientes, quantidades, unidades e %.
• Consumíveis (embalagens, caixas, etiquetas) e o respetivo custo — consulte Consumíveis.
• Custos: custo completo, preços por canal, ponto de equilíbrio e a cascata de sub-receitas — consulte Custos.
• Validação técnica: a pontuação físico-química e os respetivos parâmetros — consulte Validação de fórmula.
• Nutrição: macros, energia e alergénios.
• Modo de preparação (passos e notas), partes da formulação, rendimento (quebra, 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 cronologia

Abra-a com o botão Histórico do cabeçalho do editor (/validation?id=<id>) ou a partir do menu ⋮ → Histórico de versões. Só o vê nas suas próprias receitas: quem edita uma receita partilhada consigo não gere o respetivo histórico. Abre-se uma cronologia vertical à esquerda: cada versão é um cartão com o número, a data, uma etiqueta com o tipo de versão, a pontuação de validação e umas etiquetas de alterações (por exemplo Custo +8%, Pontuação 78→91, +2 ingredientes, Consumível novo). À direita, um painel largo conta-lhe o que aconteceu nessa versão.

Quando uma receita acumula várias versões, um seletor Comparar com: Anterior / Original (v1) permite-lhe escolher a referência da comparação: a versão imediatamente anterior (o que mudou nesse passo) ou a Criação (o quanto se afastou do ponto de partida). Uma faixa «A comparar com…» lembra-lhe sempre a referência, e uma ajuda curta esclarece a diferença (Anterior = o passo imediatamente 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, consumíveis e custo). Se for a primeira vez, carregue em Como funciona? no cabeçalho para um breve lembrete do modelo.

Perceber num relance

O painel direito foi pensado para que perceba o impacto antes de ler o detalhe:

• Resumo do impacto — um título em linguagem corrente («Adicionou 1 consumível», «O custo subiu 8%»), as contagens de elementos adicionados / eliminados / modificados e as métricas principais (custo, validação, peso) com setas ↑/↓ e cor: o custo a subir aparece a vermelho, a validação a melhorar aparece a verde, o peso é neutro.
• Linguagem visual coerente — cada alteração tem um ícone e uma cor: Adicionado (verde), Eliminado (vermelho), Modificado (âmbar). Nos valores numéricos, verá o antes → depois e a variação (p. ex. 10 g → 11 g · ↑10%).
• Detalhe por dimensão — mais abaixo, só as secções que mudaram realmente (fórmula, partes, ingredientes, consumíveis, custos, validação técnica, nutrição, alergénios, modo de preparação, dados, medições de aw/pH). O que não mudou não acrescenta ruído.

Ver a receita completa de uma versão

Carregue em Ver receita completa para abrir, por cima da cronologia, a receita completa dessa versão em modo só de leitura: métricas (peso, validação, custo), ingredientes (por partes, se a receita as tiver), rendimento, consumíveis, custos, alergénios, nutrição e modo de preparação. Nos estados de origem ou «sem alterações» verá também uma pré-visualização dos ingredientes sem sair do painel. A partir da receita completa, o botão Abrir a receita atual leva-o ao editor com a receita tal como está agora, não com essa 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 criou a receita.
• Dia de trabalho — a versão que consolida automaticamente as alterações de um dia. Não registamos cada tecla: uma versão por dia de trabalho.
• Versão — um marco que assinala com Criar versão agora.
• Restaurada — o estado deixado por uma restauração.
• Antes de escalar — o estado da receita imediatamente antes de a escalar sobre si mesma, com o fator aplicado (por exemplo Antes de escalar ×2). Consulte Escalar receita.

Em históricos antigos pode ver também Antes de restaurar: foi assim que ficaram registadas as restaurações feitas com versões anteriores da aplicação, que guardavam o estado anterior à restauração.

Criar uma versão quando quiser

Carregue em Criar versão agora para fixar um marco (por exemplo, antes de uma alteração grande). Pode acrescentar uma nota opcional a descrevê-lo — convidamo-lo a fazê-lo, mas nunca o obrigamos: prima Enter para saltar. Mais tarde, pode acrescentar ou editar a nota de qualquer versão a partir do respetivo cartão.

Restaurar sem perder nada

Selecione uma versão, carregue em Restaurar esta versão e confirme. O seu trabalho atual fica guardado no histórico e a restauração é registada como uma única versão nova, Restaurada, por isso o trabalho novo não se perde e pode voltar para a frente quando quiser. A restauração recupera a receita completa: ingredientes, consumíveis, custos, validação, nutrição, medições de aw/pH e notas.

Duplicar e experimentar (fork)

Carregue em Duplicar e experimentar para criar uma cópia independente da receita, com a sua própria cronologia (começa na sua própria versão 1 «Criação»), e a aplicação leva-o para a cópia. Atenção: é duplicada a versão atual da receita, não a versão selecionada na cronologia; para partir de uma versão anterior, restaure-a primeiro. A cópia recebe o nome da receita de origem com o sufixo (derivada). É a forma recomendada de testar variantes (outra % de cacau, outro recheio) sem mexer na receita original — a receita de origem não é alterada.

Gravação automática

Não há botão Guardar: o editor guarda as suas alterações automaticamente após uma breve pausa. O indicador do cabeçalho mostra o estado:

• A guardar… — a alteração está a ser enviada.
• Tudo guardado — não há nada pendente; é seguido do tempo decorrido desde a última gravação.
• Alterações por guardar (ou N alterações por guardar) — clique no indicador para forçar a gravação.
• Sem ligação: N alterações por guardar. Serão guardadas automaticamente quando a rede voltar. — ficou sem ligação; não feche o separador do navegador até ela voltar.
• Erro: tentar novamente — a última gravação falhou; clique para tentar novamente.

Eliminar uma receita

Abra o menu ⋮ → Eliminar receita. A aplicação pede confirmação antes de apagar.

Disponibilidade por plano

Disponível em todos os planos. A única exceção é a conta gratuita limitada (aquela em que uma conta pode ficar quando o período experimental de 14 dias termina sem subscrição): não inclui o histórico de versões, pelo que, ao abri-lo, verá o aviso «O histórico de versões está incluído nos planos Starter e Pro.»

Desempenho

A cronologia só é carregada quando a abre — não torna mais pesada a vista da receita — e o registo é eficiente: o dia de trabalho é consolidado em segundo plano, sem interromper a sua edição.

Próximos passos