Geração do Modelo

A geração é a etapa final que transforma sua especificação em um modelo financeiro Excel totalmente funcional. O pipeline de geração lê cada configuração, conta, período e parâmetro que você definiu e gera um arquivo .xlsx abrangente com planilhas interconectadas, fórmulas, formatação e gráficos.

O Pipeline de Geração

O processo de geração consiste em 15 etapas sequenciais. Cada etapa cria planilhas ou componentes específicos no arquivo de saída. Entender o que cada etapa faz ajuda a interpretar as atualizações de progresso e diagnosticar problemas caso a geração encontre erros.

Etapa 1: Inicialização

Inicializa o ambiente de geração, cria a pasta de trabalho e configura os recursos compartilhados (estilos, fontes, cores, formatos numéricos). Esta etapa valida que todos os pré-requisitos estão atendidos antes de prosseguir.

Etapa 2: Banco de Dados

Cria a planilha Banco de Dados — uma Tabela do Excel com seus dados históricos importados (ou uma tabela vazia e corretamente estruturada quando nenhum arquivo de dados é anexado). Toda fórmula de período realizado do modelo lê desta tabela, de modo que alternar a coluna Incluir de um registro filtra o modelo inteiro a partir de um único lugar.

Etapa 3: Casos

Cria uma planilha por caso de negócio — uma grade de unidades por períodos com sinalizadores 1/0 de inclusão. Essas grades definem quais unidades de negócio cada caso inclui; a planilha Unidades Incluídas resolve o caso ativo em tempo de execução.

Etapa 4: Unidades

Cria a planilha Unidades Incluídas — a única planilha que escreve nomes de unidades e rótulos de períodos (todas as demais fazem referência a ela). Suas células resolvem o caso de negócio ativo selecionado no Painel de Controle.

Etapa 5: Cenários

Cria uma planilha por cenário, cada uma sendo uma grade de índices por períodos com taxas de crescimento. O seletor de cenários do Painel de Controle decide qual grade alimenta as projeções.

Etapa 6: Índices

Cria a planilha Índices — a grade de índices econômicos (inflação, câmbio, juros) cujas linhas alimentam toda fórmula projetada. Suas células selecionam as taxas do cenário ativo, de modo que trocar de cenário reprecifica o modelo inteiro.

Etapa 7: Fontes

Cria a planilha Fontes e Ajustes — uma matriz de inclusão de fontes por conjuntos de fontes. O menu suspenso de fontes do Painel de Controle seleciona entre os conjuntos.

Etapa 8: Controle

Cria planilhas de controle que gerenciam parâmetros do modelo como um todo: seleção de cenário ativo, alternância de períodos e configurações de exibição.

Etapa 9: Contas

A etapa principal. Gera uma planilha para cada conta, preenchendo-a com fórmulas que referenciam contas pai, dados de origem e cálculos entre contas. Esta é tipicamente a etapa mais longa, especialmente para modelos com muitas contas.

Etapa 10: Premissas-Chave

Cria a planilha de Premissas-Chave (se habilitada) e vincula as células de contas elegíveis a ela. Esta etapa reescreve fórmulas nas planilhas de contas para referenciar a planilha centralizada de Premissas-Chave.

Etapa 11: Análise

Constrói a planilha de consolidação da Análise Completa, agregando todos os dados de unidades em demonstrações financeiras unificadas.

Etapa 12: Análise Rápida

Gera planilhas de Análise Rápida (consolidada e por unidade, conforme configurado) com visões condensadas das principais métricas financeiras.

Etapa 13: Saídas

Cria planilhas de relatório nos formatos Longo, Médio e Curto com base na sua configuração de Relatórios. Aplica o divisor de valores, configurações de decimais e regras de formatação.

Etapa 14: Gráficos

Gera folhas de gráfico para cada gráfico definido, vinculando-as aos intervalos de dados apropriados e aplicando configurações visuais (cores, opções de eixo, diferenciação realizado/projetado).

Etapa 15: Conclusão

Finaliza e grava o arquivo .xlsx. Note que o motor nunca calcula um número financeiro — ele escreve fórmulas, e o Excel realiza todo o cálculo quando você abre a pasta de trabalho. O modelo está pronto para download.

Acompanhamento de Progresso em Tempo Real

Durante a geração, a aplicação exibe o progresso em tempo real via conexão WebSocket com o backend. Você visualiza:

• Nome da etapa atual — qual das 15 etapas está em execução.
• Barra de progresso — indicação visual de quanto da geração foi concluído.
• Tempo por etapa — quanto tempo cada etapa concluída levou.

Este feedback permite saber que a geração está prosseguindo normalmente, especialmente para modelos grandes onde a etapa de Contas pode levar vários segundos.

Baixando o Modelo

Após a geração ser concluída com sucesso, um botão de download aparece. Clique nele para salvar o arquivo .xlsx gerado em sua máquina local. O arquivo é uma pasta de trabalho Excel padrão que pode ser aberta no Microsoft Excel, Google Sheets (com algumas limitações) ou qualquer aplicativo de planilha compatível.

O nome do arquivo tipicamente inclui o nome do modelo e um carimbo de data/hora para fácil identificação.

Tratamento de Erros de Geração

Se a geração encontrar um erro, ela para na etapa que falhou e exibe uma mensagem de erro. Causas comuns incluem:

• Erros de validação que não foram corrigidos — sempre execute a validação antes de gerar.
• Referências circulares de fórmulas — o motor de geração não consegue resolver loops infinitos.
• Dados ausentes — uma conta ou período referenciado durante a geração não possui os dados esperados.

Quando um erro ocorre:

1. Leia a mensagem de erro cuidadosamente. Ela identifica a etapa e geralmente a conta ou configuração específica que causou a falha.
2. Verifique o log de geração para contexto adicional. O log registra informações detalhadas sobre a execução de cada etapa.
3. Corrija o problema identificado no editor de especificação.
4. Execute a validação para confirmar que a correção resolveu o problema.
5. Gere novamente.

Desempenho da Geração

O tempo de geração depende da complexidade do modelo:

| Tamanho do Modelo | Tempo Aproximado de Geração | |--------------------|-------------------------------| | Pequeno (1-2 unidades, < 50 contas) | 2-5 segundos | | Médio (3-5 unidades, 50-200 contas) | 5-15 segundos | | Grande (5+ unidades, 200+ contas) | 15-60 segundos |

A etapa de Contas (Etapa 9) tipicamente responde pela maior parte do tempo de geração, pois gera o maior número de planilhas e fórmulas.

Dicas

• Salve sua especificação antes de gerar. A geração lê o estado atual, mas salvar garante que você tenha uma cópia recuperável.
• Valide primeiro, gere depois. Executar a validação antes de gerar detecta a maioria dos problemas e economiza tempo.
• Mantenha a aba do navegador ativa durante a geração para manter a conexão WebSocket para atualizações de progresso em tempo real.
• Para modelos muito grandes, considere gerar com um subconjunto de unidades primeiro para verificar a configuração, depois habilite todas as unidades para a geração final.