Skip to content
RamonzitoooPublic

About

FinTrack v4.0 — Plataforma de Controle Financeiro Pessoal, Orcamento 50/30/20, Caixinhas CDI, Contracheque CLT & FIRE (100% Client-Side & Zero-Knowledge)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

FinTrack Blueprint — Plataforma de Controle Financeiro & Gestão Patrimonial

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.

Live Demo Release React 19 Tailwind v4 Zero Knowledge


🌐 Acesso Online & Downloads Diretos

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

🧩 Ferramentas e Módulos do FinTrack

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):

1. 📊 Visão Geral (Cockpit Executivo & Orçamento 50/30/20)

  • 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.

2. 🏦 Bancos & Custódia de Liquidez

  • 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).

3. 🎯 Caixinhas, Metas & Planejamento FIRE

  • 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.

4. 💼 Contracheque CLT & Calculadora Anti-Impulso

  • 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.

5. 💳 Cartões de Crédito & Simulador À Vista vs. Parcelado

  • 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.

6. 🧾 Despesas, Envelopes Vivos & Quitador de Dívidas

  • 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").

7. ⚖️ Impostos & Reforma Tributária (RTC) — Aba Opcional

  • 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:8081 e http://localhost:8082 (liberados na CSP apenas para localhost / 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.

8. 🔒 Privacidade & Blindagem Zero-Knowledge

  • Cofre Zero-Knowledge AES-256-GCM (Ativo na v4 React): Cifragem em repouso no localStorage via WebCrypto API (PBKDF2-HMAC-SHA256 com 600.000 iterações, chaves extractable: false, Recovery Key de 120 bits e auto-lock por inatividade), com exportação/importação .vault interoperá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-Peek ao passar o mouse).
  • Backups Seguros: Exportação/importação .json, .csv e .vault com proteção contra Prototype Pollution e CSV Formula Injection (CWE-1236).

System Overview

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:

  1. Aplicação Modular (v4.0 — React 19 + TypeScript + Vite 8 + Tailwind CSS v4): Orquestrada em ./src/README.md com componentes reativos, Cofre Zero-Knowledge AES-256-GCM interoperável com .vault v3.4, física fluida inspirada no Apple HIG / Material Design 3 e matemática financeira determinística.
  2. Aplicação Monolítica Standalone (v3.4 / Bundle Autocontido): Preservada em ./public/app.html, além do artefato compilado ./app.html gerado por ./scripts/README.md.

Local Interface & Invariants

  • [vite.config.ts:default]: Exporta a configuração do Vite (defineConfig) com base: './', integrando @vitejs/plugin-react e @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) quando process.env.DISABLE_HMR === 'true'.
  • [vite.config.ts:build.rollupOptions.output]: Quando process.env.STANDALONE_BUILD === 'true', desativa code-splitting (codeSplitting: false) para geração de bundle único; caso contrário, particiona dependências de node_modules via manualChunks ('vendor-react', 'vendor-motion', 'vendor-icons', 'vendor-core').

Subdirectories & System Boundaries

  • 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, ExpensesTab e 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).
  • 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.html e dist/standalone.html).

Global Invariants

  • 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), enquanto caixinhas operam 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 via structuredClone para 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__, constructor e prototype; toda célula CSV iniciada por =, +, -, @, \t, \r ou | recebe prefixo '.

Global Side Effects

  • 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' em document.body e 'dark' + data-theme em document.documentElement.
  • I/O de Arquivos no Cliente ([src/App.tsx:handleExportJSON], [src/App.tsx:handleExportCSV], [src/App.tsx:AppModals.onImportJSON]): Exportação de backups .json e planilhas .csv via Blob + URL.createObjectURL e leitura local via FileReader.readAsText (zero tráfego de rede).

System Verification

  • Run: npm test (37 testes unitários TS: 28 financeMath + 9 cryptoVault)
  • Typecheck: npm run lint (tsc --noEmit em modo strict)
  • 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

🚀 Como Executar Localmente

Opção 1 — Uso Direto Sem Instalação (Standalone)

Baixe fintrack-standalone.html nos Releases (ou abra ./app.html diretamente no navegador).

Opção 2 — Ambiente de Desenvolvimento React 19

# 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 build

Acesse no navegador: http://localhost:3000


👤 Autor

Ramon Cavalcanti (@Ramonzitooo)

About

FinTrack v4.0 — Plataforma de Controle Financeiro Pessoal, Orcamento 50/30/20, Caixinhas CDI, Contracheque CLT & FIRE (100% Client-Side & Zero-Knowledge)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages