Bem-vindo(a)! 👋
Entre para acessar seus lançamentos.
Os dados ficam no servidor, protegidos por criptografia de ponta a ponta.
Gastos por Pilar
Gastos por Categoria
Tipo de Gasto
Por Pessoa
Top 5 Maiores Gastos
📈 Evolução Mensal
➕ Novo Lançamento
| Data | Descrição | Valor | Tipo | Pagamento | Banco | Pessoa | Categoria | Ações |
|---|
Histórico
📖 Como usar o Controle Financeiro
Guia rápido com tudo que você precisa saber.
Começando
- Abrir arquivo - Selecione seu
.jsonde dados - Criar novo - Arquivo vazio com configurações padrão
- Usuário único - Se só há 1 pessoa, entra direto sem perguntar
- Múltiplos usuários - Selecione quem está usando
- Arquivo protegido? Selecione usuário + senha
Nova Entrada
- Obrigatórios - Data, Descrição, Valor, Pessoa e Categoria
- Autocomplete - 2+ caracteres mostra sugestões do histórico
- Parcelado - Valor total é dividido. Tipo = Parcelado, Pagamento = Crédito
- PJ - Marca despesas de pessoa jurídica
- Tags - Etiquetas livres (ex: viagem, reembolsavel). Clique + e use Win+. para emojis
- Receitas - "Salário", "Reembolso" alternam para Entrada automaticamente
- Atividade da sessão - Histórico visual do que foi adicionado/editado
Lançamentos
- Filtros multi-seleção - Ano, Mês, Pessoa, Tipo, Banco, Categoria, PJ, Dia, Tags
- Busca - Instantânea, limpa filtro de ano/mês automaticamente
- Ctrl+Click - Seleciona linhas para ver subtotais
- Editar em massa - Ctrl+Click transfere seleção para checkboxes
- Tags em massa - Adicionar/remover tags em vários registros de uma vez
- 🏷️ - Ícone indica tags na linha (hover mostra nomes)
- KPIs inline - Entradas, Saídas, Saldo e Registros atualizados em tempo real
- Cores - Hoje=verde, futuro=amarelo, fim de semana=vermelho
Dashboard
- Filtros - Ano, Mês, Pessoa e Pilar (múltipla seleção)
- Pilares - Agrupamento automático por categoria (configurável)
- Evolução - Gastos por mês coloridos por pilar (cores configuráveis)
- Top 5 - Maiores gastos (ou detalhamento por pilar)
- PJ - Resumo automático de receita vs custos CNPJ
- Configurável - Pilares, ícones, cores e palavras-chave editados em Config > Dashboard
Insights
- Saúde Financeira - Score verde/amarelo/vermelho por mês
- Recomendações - Top 3 ações baseadas nos dados
- Timeline Parcelado - Quando cada parcela termina e quanto libera
- Custos Recorrentes - PJ + Moradia + Assinaturas (média ou atual)
- Alertas - Categorias que subiram >30% (clique para ver detalhes)
- Navegação - ◀▶ muda o mês de referência (±3 meses)
Desfazer (Undo)
- Ctrl+Z - Desfaz a última ação (até 10 níveis)
- Botão ↩️ - Aparece no cabeçalho quando há histórico
- Operações grandes - Confirmação antes de desfazer (5+ registros)
- Sessão - Histórico mostra itens desfeitos com ↩️ e riscado
- Cobre tudo - Adicionar, editar, excluir, edição em massa
Segurança
- AES-256 - Cada usuário tem sua própria senha
- Privacidade 👁 - Borra valores (hover para revelar)
- Exportar - Cópia em texto puro ou com nova senha
- Sincronização - Releitura automática do disco ao navegar
Configurações
- Aba Listas / Tags - Categorias (com emoji), Bancos, Pagamentos, Tipos, Pessoas, Tags
- Aba Dashboard - Mapeamento categoria→pilar, palavras-chave, ícones e cores
- Aba Insights - Palavras essenciais (protege custos de serem sugeridos para corte)
- Renomear - Atualiza todos os registros existentes
- Emojis - Clique no ícone para alterar (Win + . abre o seletor)
- Segurança - Ativar/remover senha, exportar
Dicas
- Tooltip - Hover em qualquer linha para resumo completo
- Duplicatas - ⚠️ aparece quando mesma descrição + valor em 7 dias
- ✳️ = nova nesta sessão | 💼 = PJ | 🏷️ = tags | ↩️ = desfeito
- Salvar 💾 - Automático. Botão é confirmação visual
- Senha errada - Oferece tentar novamente (não confunde com arquivo corrompido)
- F5 / Recarregar - Aviso antes de sair (dados salvos, mas sessão é perdida)
- Chrome/Edge - Requer File System Access API
Importar Dados
Tem dados em planilha ou CSV? Converta para o formato JSON do app.
- Baixe o template - Use como referência de formato
- Organize seus dados em colunas:
data | descricao | valor | tipo | tipoGasto | formaPagamento | banco | pessoa | categoria - Use IA para converter - Cole seus dados no Claude com o prompt abaixo
- Abra o JSON no app normalmente
🤖 Prompt para conversão (clique para expandir)
Converta meus dados financeiros para o formato JSON do app Controle Financeiro.
FORMATO DE CADA ENTRADA (entry):
{
"id": "gerar UUID único",
"data": "YYYY-MM-DD",
"descricao": "texto da descrição (limpo, sem prefixos como COMPRA CARTAO -)",
"valor": 287.45,
"tipo": "entrada" ou "saida",
"tipoGasto": "Parcelado" | "Fixo" | "Variável" | "N/A",
"formaPagamento": "Crédito" | "Débito" | "Pix" | "Boleto" | "TED" | "Débito Automático" | "Saque" | "Dinheiro",
"banco": "nome do banco",
"pessoa": "nome da pessoa",
"categoria": "uma das categorias abaixo",
"parcelas": null,
"tags": [],
"createdAt": "ISO timestamp"
}
REGRAS IMPORTANTES:
- valor: número com PONTO decimal (287.45). Converter "R$ 1.234,56" para 1234.56
- data: converter DD/MM/YYYY para YYYY-MM-DD
- tipo: "entrada" se for recebimento/crédito/salário. "saida" se for débito/compra/pagamento.
- tipoGasto: "N/A" para entradas. "Fixo" para contas recorrentes (luz, água, condomínio, plano). "Variável" para compras do dia a dia.
- formaPagamento: inferir do histórico:
• "COMPRA CARTAO" = "Crédito"
• "PIX ENVIADO/RECEBIDO" = "Pix"
• "DEBITO AUTOMATICO" = "Débito Automático"
• "TED" = "TED"
• "BOLETO" = "Boleto"
• "SAQUE" = "Saque"
- descricao: limpar prefixos como "COMPRA CARTAO - ", "PIX ENVIADO - ", "DEBITO AUTOMATICO - ". Manter apenas o nome do estabelecimento/serviço.
- pessoa: usar o nome do titular da conta.
- categoria: INFERIR automaticamente pela descrição:
• supermercado, carrefour, mercado = "Alimentação"
• ifood, restaurante, padaria = "Refeição"
• uber, 99, taxi = "Carro / Transporte"
• shell, ipiranga, petrobras = "Combustível"
• enel, sabesp, condominio = "Casa"
• netflix, spotify, amazon prime = "Assinaturas"
• farmacia, drogaria, plano saude = "Saúde / Higiene"
• renner, zara = "Vestuário"
• cinemark, cinema = "Lazer"
• pet shop, cobasi, petz = "Pet"
• escola, educação = "Educação"
• iptu, seguro = "Tributo / Taxas"
• salário, freelance = "Salário"
• hotel, booking, airline, latam = "Viagem"
• livraria, cinema = "Lazer"
• presente = "Presente"
• não identificado = "Outros"
- Ignorar colunas que não existem no formato (Saldo, Agência, Nº Documento, etc.)
CATEGORIAS VÁLIDAS:
Alimentação, Assinaturas, Carro / Transporte, Casa, Combustível, Doação, Educação, Lazer, Pet, Presente, Reembolso, Refeição, Salário, Saúde / Higiene, Seguros, Serviços, Tributo / Taxas, Venda, Vestuário, Viagem
ESTRUTURA FINAL DO ARQUIVO:
{
"version": "2.0",
"config": { copiar do template.json que baixei },
"merchants": {},
"entries": [ ...array com as entradas convertidas... ],
"lastModified": "data de hoje ISO"
}
MEUS DADOS (substituir abaixo):
[COLE AQUI SUA PLANILHA OU CSV]
💡 Dica: O template já vem com categorias, pilares e configurações básicas prontas. Personalize depois em Config.
Sobre
Controle Financeiro v2.3
Este software é de uso pessoal e doméstico. Não é permitida a redistribuição, cópia ou uso comercial sem autorização do autor.
© 2026 Douglas Ramos. Todos os direitos reservados.
⚙️ Configurações
Edite ou remova itens das listas. Renomear atualiza todos os registros existentes.
🔒 Segurança & Exportação
Categorias
Formas de Pagamento
Tipos de Gasto
Bancos
Pessoas
🏷️ Tags
Defina quais categorias pertencem a cada pilar. O Dashboard agrupa despesas por pilar automaticamente.
📊 Mapeamento Categoria → Pilar
Cada categoria de gasto é agrupada em um pilar no Dashboard. Você pode reatribuir, criar ou renomear pilares.
🔍 Palavras-chave por Pilar
Quando uma categoria não está mapeada, o sistema busca estas palavras na descrição para classificar automaticamente.
Palavras-chave que controlam a classificação de custos no módulo Insights.
🏠 Palavras Essenciais (Moradia & Contas)
Custos recorrentes com estas palavras são classificados como essenciais (nunca sugeridos para corte).
🔁 Exceções de Duplicata
Lançamentos com estas palavras nunca são marcados como possível duplicata, mesmo com valor/data próximos (ex.: salário, mesada).
Personalize o visual do aplicativo e defina regras de cor para palavras-chave (formatação condicional).
🎨 Cores por Palavra-chave
Destaque linhas na tabela de lançamentos que contenham determinadas palavras na descrição (similar a formatação condicional do Excel).
Configurações do módulo Investimento. Defina quais receitas são excepcionais e não devem inflar a média de renda usada no cálculo da margem segura.
🚫 Receitas Excepcionais (excluídas da média)
Entradas cujo nome contenha estas palavras serão ignoradas ao calcular a média mensal de renda.
Use para excluir Bônus, FGTS, Previdência, Restituição IR e outros valores não recorrentes.
Insira palavras em letras minúsculas.