Ecossistema completo de inteligência financeira pessoal, orçamento 50/30/20, gestão de caixinhas com juros compostos, contracheque CLT, cartões de crédito e planejamento de aposentadoria FIRE.
100% Client-Side, Zero-Knowledge e Offline-First — inicia com saldo limpo (
R$ 0,00) e nenhum dado sai do seu dispositivo.
| Recurso | Descrição | Link Direto |
|---|---|---|
| Aplicação Web (GitHub Pages) | Acesse direto no navegador sem instalar nada | Abrir FinTrack Online |
Download Direto — App Standalone (app.html) |
Bundle React 19 completo em 1 único arquivo HTML autocontido com Cofre AES-256-GCM e zero fontes externas (abra offline no navegador) | Download fintrack-standalone.html |
Download Direto — Versão Clássica Zero-Knowledge (public/app.html) |
Monólito v3.4 com cofre criptográfico AES-GCM 256-bit (PBKDF2 600k iterações) | Download fintrack-legacy-vault.html |
| Todas as Versões & Pacotes | Pacote ZIP completo para uso local e histórico de releases | Ver Releases no GitHub |
O FinTrack organiza sua vida financeira em 6 abas operacionais (mais a 7ª aba opcional de Impostos & Reforma Tributária — RTC), uma central de Diagnóstico Técnico, Command Palette (Ctrl + K) e Modo Privacidade (P):
- KPIs em Tempo Real: Saldo Livre Real (bancos menos contas pendentes), Patrimônio Líquido Consolidado, Cobertura de Reserva (em meses) e Teto Antifrágil da Diária Segura até o próximo pagamento.
- Orçamento 50/30/20 Real: Classificação automática entre Essenciais (50%), Estilo de Vida (30%) e Investimentos/Futuro (20%).
- Distribuição Empilhada & Bússola FIRE: Acompanhamento visual de liquidez livre vs. reservas custodiadas vs. contas pendentes.
-
Gestão Multi-Contas (CRUD Inline): Contas digitais, correntes, investimentos e dinheiro físico, com edição inline de instituição, modalidade, saldo e remuneração em % do CDI (conversão composta exata
$(1+i)^{1/12}-1$ com desconto regressivo de IR). -
Transferências Internas (Pix) e edição instantânea de saldos com suporte a desfazer (
Undo).
- Potes Segregados (CRUD Inline): Reserva de Emergência, metas de viagem/objetivos e Independência Financeira (FIRE) com edição inline de meta/aporte e cálculo logarítmico de prazo acelerado por juros compostos.
- Aportes & Resgates Simétricos: Transferências diretas entre conta bancária e caixinha com atualização imediata de liquidez.
- Folha de Pagamento Editável: Proventos, descontos, histórico mensal de holerites e distribuição direta do salário líquido para conta + caixinhas.
- Cálculo Oficial Automático 2026 (1 Clique): Tabelas progressivas oficiais de INSS e IRRF 2026 (Lei 15.270/2025) com suporte a dependentes (
calculateOfficialPayrollTaxes). - Calculadora Anti-Impulso ("Horas de Vida"): Converte o preço de qualquer compra em horas/dias reais de trabalho líquido antes de decidir gastar.
- Melhor Cartão Hoje & CRUD Inline: Cadastro e edição inline de cartões (corte, vencimento, limite), calculando dinamicamente os dias reais de fôlego entre fechamento e vencimento.
- Simulador Matemático À Vista vs. Parcelado + CDI: Compara o desconto à vista contra manter o valor investido a % do CDI enquanto quita as parcelas.
- Molde de Contas Recorrentes, Parcelas Multi-Mês & CRUD Inline: Clona despesas fixas automaticamente por competência, suporta parcelamento multi-mês (1x a 48x) distribuído automaticamente nas competências futuras, edição inline de lançamentos e quitação/estorno contábil simétrico.
- Receitas Avulsas: Controle mensal de entradas extras (freelances, bônus, reembolsos) com marcação de recebimento e reconciliação no fluxo de caixa.
- Envelopes de Rotina: Controle semanal/quinzenal/FDS para Supermercado, Lazer e Transporte conectado aos lançamentos reais do mês.
- Simulador de Quitação de Dívidas (Avalanche vs. Bola de Neve): Compara matematicamente Avalanche (maior taxa de juros) contra Bola de Neve (menor saldo), exibindo prazo total, ordem de quitação e economia de juros.
- Command Palette (
Ctrl + K): Lançamento rápido por linguagem natural (ex.:"almoço 45,90 pix").
- Regime Regular (CBS / IBS / IS 2026–2033): Simulador determinístico da transição da Reforma Tributária do Consumo com alíquotas por ano-calendário, regimes diferenciados e apuração líquida de débitos/créditos.
-
Simples Nacional (Anexos I–V + Fator R): Cálculo progressivo de faixa, alíquota efetiva e enquadramento automático entre Anexo III e Anexo V via Fator R (
$\ge 28%$ ). - Leitor de XML NFS-e / DANFSe (100% Offline): Parser local de documentos fiscais eletrônicos direto no navegador, sem envio de dados a servidores externos.
-
Conector Local Opt-In (Receita Federal MIT): Integração estritamente opcional com os 3 repositórios oficiais MIT da Receita Federal executados localmente em
http://localhost:8080,http://localhost:8081ehttp://localhost:8082(liberados na CSP apenas paralocalhost/127.0.0.1, mantendo bloqueio total a domínios externos). - Lançamento Direto em Despesas: Converte a guia ou tributo apurado em lançamento na aba Despesas em 1 clique.
- Cofre Zero-Knowledge AES-256-GCM (Ativo na v4 React): Cifragem em repouso no
localStoragevia WebCrypto API (PBKDF2-HMAC-SHA256 com 600.000 iterações, chavesextractable: false, Recovery Key de 120 bits e auto-lock por inatividade), com exportação/importação.vaultinteroperável com a versão v3.4 (public/app.html). - PWA Offline-First Blindado: Instalável offline via Service Worker + Manifesto, protegido por Content Security Policy (CSP) estrita (
connect-src 'self' http://localhost:* http://127.0.0.1:*; object-src 'none'; base-uri 'none'; form-action 'none') — bloqueio total a domínios externos e zero fontes externas. - Modo Privacidade (atalho
P): Borra todos os valores monetários com desfoque óptico (Quick-Peekao passar o mouse). - Backups Seguros: Exportação/importação
.json,.csve.vaultcom proteção contra Prototype Pollution e CSV Formula Injection (CWE-1236).
O FinTrack é uma aplicação de planejamento financeiro e gestão patrimonial construída sob arquitetura Zero-Knowledge e PWA Offline-First (CSP estrita + zero fontes externas). Opera em duas frentes sincronizadas:
- Aplicação Modular (v4.0 — React 19 + TypeScript + Vite 8 + Tailwind CSS v4): Orquestrada em
./src/README.mdcom componentes reativos, Cofre Zero-Knowledge AES-256-GCM interoperável com.vaultv3.4, física fluida inspirada no Apple HIG / Material Design 3 e matemática financeira determinística. - Aplicação Monolítica Standalone (v3.4 / Bundle Autocontido): Preservada em
./public/app.html, além do artefato compilado./app.htmlgerado por./scripts/README.md.
[vite.config.ts:default]: Exporta a configuração do Vite (defineConfig) combase: './', integrando@vitejs/plugin-reacte@tailwindcss/vite, resolvendo o alias'@'para a raiz do repositório.[vite.config.ts:server]: Desativa HMR (hmr: process.env.DISABLE_HMR !== 'true') e observação de arquivos (watch: null) quandoprocess.env.DISABLE_HMR === 'true'.[vite.config.ts:build.rollupOptions.output]: Quandoprocess.env.STANDALONE_BUILD === 'true', desativa code-splitting (codeSplitting: false) para geração de bundle único; caso contrário, particiona dependências denode_modulesviamanualChunks('vendor-react','vendor-motion','vendor-icons','vendor-core').
- Aplicação React (
src):./src/README.md— Orquestrador central (App.tsx), roteamento acessível entre as 6 abas canônicas e a 7ª aba opcional Impostos & RTC, atalhos globais de teclado e sincronização de estado.- Componentes de Interface (
src/components):./src/components/README.md— Views modulares das abas financeiras (OverviewTab,BanksTab,GoalsTab,PayrollTab,CardsTab,ExpensesTabe a 7ª aba opcional Impostos & RTC), diagnóstico técnico (AuditDiagnosticView) e os modais interativos (AppModals). - Utilitários, Criptografia & Matemática (
src/utils):./src/utils/README.md— Motor determinístico de matemática financeira (financeMath.ts), Cofre Zero-Knowledge AES-256-GCM (cryptoVault.ts), física de gestos e camada de persistência blindada (storage.ts).
- Componentes de Interface (
- Scripts de Empacotamento (
scripts):./scripts/README.md— Compilador pós-build (build-standalone.js) que embute CSS e JS do Vite em um único arquivo HTML autocontido (./app.htmledist/standalone.html).
- Potes Segregados de Liquidez (
[src/utils/financeMath.ts:executeGoalTransfer],[src/components/OverviewTab.tsx:OverviewTab]): Saldos bancários (bancos) sofrem débito imediato nos aportes e representam liquidez livre de giro (saldoLivre = totalBancos - contasPendentes), enquantocaixinhasoperam como custódia segregada (patrimonioLiquido = totalBancos + totalCaixinhas - contasPendentes - totalDividas). - Teto Antifrágil da Diária Segura (
[src/components/OverviewTab.tsx:OverviewTab]): A base da Diária Segura nunca excede o menor valor entre a sobra orçamentária projetada do mês e o saldo livre real físico nos bancos (Math.min(sobraPrevistaMes, Math.max(0, saldoLivre))). - Simetria Contábil em Despesas (
[src/utils/financeMath.ts:payExpenseInList],[src/utils/financeMath.ts:refundExpenseInList],[src/utils/financeMath.ts:editExpenseAmountInList],[src/utils/financeMath.ts:deleteExpenseFromList]): Toda quitação, estorno, edição ou exclusão de despesa paga reconcilia simetricamente o saldo da conta bancária de origem e armazena snapshot viastructuredClonepara desfazer (undo). - Blindagem contra Prototype Pollution e CSV Injection (
[src/utils/storage.ts:safeJsonParse],[src/utils/storage.ts:sanitizeCsvCell]): Todo JSON importado ou lido do armazenamento local remove chaves__proto__,constructoreprototype; toda célula CSV iniciada por=,+,-,@,\t,\rou|recebe prefixo'.
- Armazenamento Local (
localStorage): Leitura e escrita da chave principal'APP_FINANCEIRO_V2_DATA'([src/utils/storage.ts:STORAGE_KEY]), além das preferências visuais'FINTRACK_PRIVACIDADE'e'FINTRACK_M3_THEME'([src/App.tsx:useEffect]). - Mutação de Classes no DOM Raiz (
[src/App.tsx:useEffect]): Aplicação dinâmica de'privacy-mode'emdocument.bodye'dark'+data-themeemdocument.documentElement. - I/O de Arquivos no Cliente (
[src/App.tsx:handleExportJSON],[src/App.tsx:handleExportCSV],[src/App.tsx:AppModals.onImportJSON]): Exportação de backups.jsone planilhas.csvviaBlob+URL.createObjectURLe leitura local viaFileReader.readAsText(zero tráfego de rede).
- Run:
npm test(37 testes unitários TS: 28financeMath+ 9cryptoVault) - Typecheck:
npm run lint(tsc --noEmitem modostrict) - Build & Standalone Bundle:
npm run build - Legacy & Integration Suite:
node tests/audit.js; node tests/backup_structure.test.js; node tests/financial_math.test.js; node tests/integration_ui.test.js; node tests/refatoracao_etapas.test.js; node tests/verify_theme_css.test.js
Baixe fintrack-standalone.html nos Releases (ou abra ./app.html diretamente no navegador).
# 1. Instalar dependências
npm install
# 2. Iniciar servidor de desenvolvimento (porta 3000)
npm run dev
# 3. Verificação de tipos TypeScript
npm run lint
# 4. Executar os 37 testes unitários TS (28 financeMath + 9 cryptoVault)
npm test
# 5. Build de produção e geração do standalone (saída em dist/ e ./app.html)
npm run buildAcesse no navegador: http://localhost:3000
Ramon Cavalcanti (@Ramonzitooo)