Operações de Arquivo

O menu Arquivo fornece todas as operações necessárias para criar, abrir, salvar e exportar suas especificações de modelo. Compreender estas operações e os formatos de arquivo disponíveis ajuda você a gerenciar seu trabalho de forma eficiente e colaborar com outros.

Criando uma Nova Especificação

Nova Especificação de Modelo (a partir de Template)

Cria uma nova especificação pré-preenchida com um plano de contas padrão, configurações típicas de contas mestre e estruturas de contas comuns para um determinado setor ou tipo de negócio. Templates fornecem um ponto de partida que você pode personalizar em vez de construir tudo do zero.

Quando usar: Ao iniciar um novo modelo para um tipo de negócio comum (ex.: empresa de serviços, empresa industrial, genérico). Templates economizam tempo significativo de configuração.

Nova Especificação de Modelo (em Branco)

Cria uma especificação vazia sem contas, sem períodos e com configurações padrão. Você define tudo desde o início.

Quando usar: Ao construir um modelo altamente especializado que não se encaixa em nenhum template disponível, ou quando você deseja controle total sobre cada aspecto da especificação.

Abrindo uma Especificação Existente

Abrir

Carrega uma especificação existente a partir de um arquivo Excel (.xlsx). A aplicação lê os dados da especificação das planilhas estruturadas da pasta de trabalho Excel e preenche o editor com todas as configurações, contas, períodos e parâmetros.

O que é lido: A operação Abrir espera um arquivo Excel no formato de especificação da aplicação, não uma planilha qualquer. Este é o mesmo formato produzido pela operação Salvar.

Quando usar: Ao retomar o trabalho em uma especificação previamente salva, ou ao abrir uma especificação compartilhada por um colega.

Salvando Seu Trabalho

Salvar

Salva a especificação atual no caminho de arquivo existente, sobrescrevendo a versão anterior. Se a especificação ainda não foi salva, Salvar se comporta como Salvar Como e solicita um nome de arquivo e local.

Salvar Como

Salva a especificação atual em um novo arquivo, solicitando que você escolha um nome de arquivo e local. O arquivo original (se houver) permanece inalterado. Use Salvar Como para criar uma cópia da sua especificação, por exemplo, para preservar uma versão base antes de fazer alterações significativas.

Tanto Salvar quanto Salvar Como produzem um arquivo Excel (.xlsx) no formato de especificação da aplicação.

Importar e Exportar

Importar YAML

Carrega uma especificação a partir de um arquivo YAML (.yaml ou .yml). YAML é um formato baseado em texto que representa os mesmos dados de especificação que o formato Excel, mas em uma estrutura de texto simples legível por humanos.

Quando usar: Ao carregar uma especificação armazenada em controle de versão (Git), revisar uma especificação compartilhada como arquivo de texto, ou migrar de um fluxo de trabalho baseado em texto.

Exportar como YAML

Salva a especificação atual como um arquivo YAML. O arquivo exportado contém todas as configurações, contas, períodos e parâmetros em um formato de texto estruturado.

Quando usar: Ao salvar uma especificação para controle de versão, criar um backup baseado em texto, compartilhar uma especificação por e-mail ou mensagem (arquivos YAML são pequenos e legíveis), ou permitir comparação textual para ver exatamente o que mudou entre versões.

Baixando o Modelo Gerado

Baixar Modelo

Após gerar o modelo (veja Geração do Modelo), esta operação salva o modelo financeiro Excel gerado em sua máquina local. Este é o produto final — uma pasta de trabalho completa com todas as planilhas, fórmulas, gráficos e formatação.

Isto é diferente de Salvar, que salva a especificação (o projeto). Baixar Modelo salva o produto gerado (o modelo Excel finalizado).

Excel vs. YAML: Qual Formato Usar

A aplicação suporta dois formatos para especificações: Excel e YAML. Cada um tem vantagens dependendo do seu fluxo de trabalho.

Formato Excel (`.xlsx`)

| Vantagem | Detalhe | |----------|---------| | Familiar | A maioria dos profissionais de finanças está confortável com arquivos Excel. | | Autocontido | Um único arquivo contém todos os dados da especificação. | | Compartilhável | Fácil de enviar por e-mail ou compartilhar via armazenamento em nuvem. | | Edição direta | Pode ser aberto no Excel para revisão manual (embora editar fora da aplicação não seja recomendado). |

Melhor para: Trabalho do dia a dia, compartilhamento com colegas e armazenamento de arquivo.

Formato YAML (`.yaml`)

| Vantagem | Detalhe | |----------|---------| | Controle de versão | Funciona perfeitamente com Git e outras ferramentas de controle de versão. | | Comparação textual | Mudanças entre versões são visíveis linha por linha. | | Leve | Tamanho de arquivo pequeno; rápido para ler e escrever. | | Programável | Pode ser gerado ou modificado por scripts e ferramentas de automação. | | Legível por humanos | A estrutura é clara sem precisar abrir uma aplicação especializada. |

Melhor para: Equipes usando Git para colaboração, fluxos de trabalho automatizados, pipelines CI/CD e situações onde rastrear o histórico de alterações é importante.

Fluxo de Trabalho Recomendado

Para a maioria dos usuários, o seguinte fluxo de trabalho combina as vantagens de ambos os formatos:

Trabalhe na aplicação usando o formato Excel para edição e salvamento do dia a dia.
Exporte para YAML em marcos importantes (antes de grandes mudanças, em lançamentos de versão) para controle de versão.
Importe do YAML quando precisar restaurar uma versão anterior ou carregar uma especificação de um repositório.

O Indicador de Alterações

A barra de status na parte inferior da aplicação exibe um indicador de alterações (um asterisco * ao lado do nome do arquivo) quando a especificação atual possui alterações não salvas. Este sinal visual lembra você de salvar seu trabalho antes de fechar a aplicação ou gerar o modelo.

O indicador desaparece quando você salva (via Salvar ou Salvar Como). Ele reaparece sempre que você faz uma alteração em qualquer parte da especificação.

Dicas

Salve frequentemente. Use o atalho de teclado (Ctrl+S / Cmd+S) para salvar rapidamente sem navegar pelos menus.
Use Salvar Como para criar pontos de verificação antes de fazer grandes mudanças estruturais na sua especificação.
Exporte para YAML antes e depois de edições significativas se você deseja um registro textual claro do que mudou.
Não confunda Salvar e Baixar. Salvar preserva a especificação (seu projeto). Baixar fornece o modelo gerado (o produto finalizado).