🍞 Calculadora de Fermentação de Pães

Descrição

Esta é uma aplicação web projetada para auxiliar padeiros a calcular com precisão o tempo de fermentação de pães ou a quantidade de ingredientes (especificamente o fermento) necessária com base no tempo de fermentação desejado. A calculadora leva em consideração as diferenças de formulação e comportamento entre Pão Doce e Pão Francês.

Um dos principais diferenciais desta aplicação é sua capacidade de aprendizado: ela utiliza um histórico de execuções de receitas (fornecido pelo usuário e armazenado localmente no navegador via localStorage) para corrigir e refinar as estimativas ao longo do tempo. Quanto mais dados de produção real forem inseridos, mais precisas se tornarão as sugestões da calculadora para as condições específicas do padeiro.

Funcionalidades Principais

• Cálculo Duplo:
  • Calcular Tempo: Estima o tempo de fermentação com base na quantidade de farinha, fermento e temperatura ambiente.
  • Calcular Ingredientes: Estima a quantidade de fermento necessária com base na quantidade de farinha, tempo de fermentação desejado e temperatura ambiente.
• Tipos de Pão Pré-configurados:
  • 🧁 Pão Doce
  • 🥖 Pão Francês
• Receitas Proporcionais Completas: Calcula automaticamente todos os ingredientes (sal, açúcar, reforçador, óleo, água) com base na quantidade de farinha e nas proporções profissionais.
• Correção por Temperatura: Utiliza uma aproximação da regra Q10 (velocidade da fermentação é afetada pela temperatura) para ajustar os cálculos.
• Sistema de Aprendizado Inteligente:
  • Analisa o histórico de execuções anteriores com condições similares (tipo de pão, temperatura, percentual de fermento/tempo).
  • Apresenta o resultado base e, quando dados suficientes existem (mínimo 2 execuções relevantes), um resultado corrigido com base no histórico.
  • Indica o número de execuções relevantes utilizadas para a correção.
• Interface Intuitiva com Abas:
  • 🧮 Calculadora: Para realizar os cálculos de fermentação.
  • 📊 Histórico: Para adicionar novas execuções reais e visualizar o histórico de produção.
  • 💾 Dados: Para gerenciar os dados do histórico (exportar, importar, limpar) e obter informações sobre o sistema de aprendizado.
• Gerenciamento de Histórico:
  • Adição de novas execuções (tipo de pão, farinha, fermento, temperatura, tempo real de fermentação).
  • Visualização cronológica do histórico (mais recente primeiro).
  • Remoção de entradas individuais do histórico.
• Gerenciamento de Dados:
  • Exportação do histórico em formato JSON.
  • Importação de histórico de um arquivo JSON (com validação e prevenção de duplicatas).
  • Opção de limpar todo o histórico (com confirmação).
• Dicas Contextuais: Oferece orientações e dicas relevantes para cada tipo de cálculo.
• Validação de Entradas: Verifica valores mínimos e máximos para os campos.
• Formatação de Números: Quantidades nos resultados e no histórico são exibidas com separadores de milhar para melhor legibilidade (ex: "30.000g", "2.5h").

Interface da Aplicação

A aplicação é organizada em três abas principais:

1. 🧮 Calculadora:

   • Selecione o "Tipo de Pão" (Doce ou Francês).
   • Escolha o "Modo de Cálculo" (Calcular Tempo ou Calcular Ingredientes).
   • Preencha os campos solicitados (quantidade de farinha, fermento, temperatura, tempo desejado).
   • Clique em "✨ Calcular" para ver o resultado estimado, o resultado corrigido (se aplicável) e a receita completa.

2. 📊 Histórico:

   • Visualize o número total de "Receitas Executadas".
   • Use o formulário "Adicionar Nova Execução" para registrar os dados reais de suas produções (farinha, fermento, temperatura e o tempo real que a fermentação levou). Estes dados são cruciais para o aprendizado da calculadora.
   • Consulte a lista de execuções anteriores, com opção de remover entradas.

3. 💾 Dados:

   • Exportar Histórico: Salva seus dados de produção em um arquivo JSON como backup ou para transferir para outro dispositivo.
   • Importar Histórico: Carrega dados de um arquivo JSON para a calculadora.
   • Limpar Histórico: Apaga todos os dados de produção armazenados. Use com cautela.
   • Leia a seção "💡 Sobre o Aprendizado" para entender como seus dados melhoram as estimativas.

Como Funciona o Sistema de Aprendizado

O "cérebro" da calculadora se torna mais inteligente à medida que você o alimenta com dados:

1. Registro de Execuções: Cada vez que você faz pão, insira os detalhes (ingredientes, temperatura, e o tempo real de fermentação) na aba "Histórico".
2. Análise de Padrões: Ao fazer um novo cálculo, o sistema procura no seu histórico por execuções anteriores do mesmo tipo de pão que ocorreram em condições semelhantes (temperatura próxima, e percentual de fermento ou tempo de fermentação também próximos, dependendo do modo de cálculo).
3. Cálculo de Correção: Se houver pelo menos duas execuções anteriores relevantes, a calculadora compara os tempos/quantidades de fermento estimados originalmente para aquelas execuções com os resultados reais que você registrou. Com base nessa diferença (fator de erro médio), ela calcula um "fator de correção".
4. Aplicação Inteligente: Esse fator de correção é então aplicado à estimativa base do seu cálculo atual, fornecendo um resultado "corrigido" que tende a ser mais preciso para suas condições específicas de trabalho.

Precisão Técnica e Receitas Base

As receitas e cálculos baseiam-se em percentuais e técnicas de panificação profissional:

• Pão Doce:
  • Sal: 1.5%
  • Açúcar: 12%
  • Reforçador: 0.8%
  • Hidratação (água gelada): 55%
  • Fermentação: Considerada 20% mais lenta que o pão francês devido ao açúcar.
  • Fermento Biológico Fresco (referência base): 2%
• Pão Francês:
  • Sal: 1.8%
  • Reforçador: 1%
  • Óleo Emulsificante: 1.5%
  • Hidratação (água gelada): 62%
  • Fermento Biológico Fresco (referência base): 2.5%
• Ajuste de Temperatura: Os cálculos de tempo e fermento são ajustados com base na temperatura ambiente, utilizando uma aproximação da regra Q10 (a velocidade da reação química, como a fermentação, tende a dobrar a cada aumento de 8-10°C, e vice-versa).

Tecnologias Utilizadas

• HTML5
• CSS3
• JavaScript (ES6+)
• localStorage do navegador (para persistência dos dados do histórico)

Como Executar

1. Clone esse repositório git clone https://github.com/dihcoder/calc-fermentacao.git.
2. Navegue até o repositório calc-fermentacao e abra o arquivo index.html em qualquer navegador web moderno (Chrome, Firefox, Edge, Safari).
3. A aplicação é totalmente client-side e não requer instalação ou servidor web.

Observações

• A precisão do "Sistema de Aprendizado Inteligente" depende diretamente da quantidade e da qualidade dos dados inseridos no histórico. Quanto mais execuções você registrar, melhores serão as correções.
• Certifique-se de que as condições de suas anotações (especialmente a temperatura) sejam consistentes.
• Lembre-se que a panificação possui muitas variáveis. Use esta calculadora como uma forte aliada, mas sempre observe sua massa!