Aplicativo financeiro pessoal em HTML, CSS e JavaScript. Identidade neutra, temas claro e escuro e gráficos locais sem dependências externas. Etapa atual: protótipo interno, sem publicação.
Com Node.js 22 ou mais recente, configure uma credencial local uma vez (substitua felipe pelo identificador do cliente):
node scripts/setup-auth.mjs felipe
Quando o script mostrar o prompt no terminal, digite uma linha JSON como {"username":"seu-usuario","password":"sua-senha"} e pressione Enter. A entrada fica oculta. A credencial fica em private/, que não é incluída no Git. Depois, inicie o servidor:
npm run dev
Abra http://127.0.0.1:4173 e entre com a credencial pessoal configurada. O painel em /app.html, seus scripts e a base financeira do cliente só são servidos depois do login. A sessão dura até oito horas ou até clicar em Sair. No Windows, iniciar-zuvori.ps1 procura Node no PATH ou no runtime local do Codex. O servidor escuta somente no próprio computador e não inicia sem ao menos um cliente com auth.json.
npm run dev; no Windows, usa iniciar-zuvori.ps1.As configurações em .vscode/settings.json encaminham o Go Live para o servidor protegido na porta 4173. A raiz está limitada a public/; os arquivos do painel ficam em protected/. Se o servidor protegido estiver parado, o Go Live não abre o painel. Não remova o proxy nem mude a raiz para a pasta do repositório ao usar dados pessoais.
Na primeira abertura, o servidor de desenvolvimento disponibiliza private/clients/<cliente>/data/finances.json, se existir, e o app importa o arquivo para o navegador. Nas próximas aberturas, prevalecem as alterações no armazenamento local daquele cliente. Para carregar um arquivo atualizado, use Dados & preferências → Importar arquivo. A importação substitui a base atual mediante confirmação, não faz mesclagem automática.
private/clients/
felipe/
auth.json # hash da credencial local
data/finances.json # base inicial
sources/ # configuração e materiais de origem
reports/ # revisões, conferências e QA
delliz/
data/ # vazia por enquanto
sources/
reports/
A pasta da Delliz está preparada, vazia e sem credencial; por enquanto ela não consegue entrar. Quando a credencial dela for configurada em private/clients/delliz/auth.json, o servidor associará a sessão apenas à pasta delliz. A base do Felipe não é usada como exemplo para ela. O aplicativo usa chaves diferentes por cliente para evitar mistura acidental na interface, inclusive no mesmo navegador. Dados antigos do navegador são migrados somente para Felipe. O armazenamento do mesmo perfil de navegador não é uma barreira de segurança entre clientes: para testes por pessoas diferentes no mesmo computador, use perfis de navegador separados.
Backups exportados levam o nome do cliente. A importação rejeita um backup identificado como outro cliente; backups antigos sem identificação só são aceitos na conta Felipe. Downloads ainda vão para a pasta configurada no navegador: guarde cada arquivo baixado em private/clients/<cliente>/reports/ ou data/, conforme o caso. Os cálculos gerais usam os lançamentos de cada cliente; indicadores específicos da realidade da Delliz serão definidos quando ela fornecer os dados.
O Worker com login da Zuvori e armazenamento privado no Cloudflare KV está preparado, mas ainda não foi implantado. A publicação e a troca do domínio dependem de configurar a conta Cloudflare, uma nova senha forte e revisar a cópia da análise. Consulte docs/cloudflare-worker.md. Os dados enviados ao KV ficam fora do repositório; a versão remota é somente leitura.
private/, tmp/, os PDFs, backups e imagens de QA são locais e ignorados pelo Git. Cada credencial fica em private/clients/<cliente>/auth.json como hash com salt; usuários e senhas não estão no código. O build copia public/ e protected/, sem dados financeiros ou credenciais. Não coloque documentos ou backups nessas pastas públicas do build.
O login protege a prévia servida pelo servidor local. Os dados editados ainda são armazenados no localStorage do navegador sem criptografia e não sincronizam entre dispositivos; quem tem acesso ao computador, ao perfil do navegador ou aos arquivos locais pode lê-los fora do aplicativo. A proteção da futura hospedagem é descrita em docs/cloudflare.md. Ocultar valores só desfoca a interface.
O extrator utilizado nesta primeira importação é específico aos modelos de fatura fornecidos. Precisa de Python com pdfplumber:
python scripts/import-statements.py "CAMINHO_DAS_FATURAS" --output private/clients/felipe/data/finances.json
Ele recupera o cabeçalho PDF quando há bytes inválidos antes dele e exige conciliação exata de cada fatura antes de gravar a base. Os valores esperados das faturas, parcelas da Mary e ajustes de centavos ficam em private/clients/felipe/sources/import-config.json, também ignorado pelo Git (opção --config). Este extrator é específico dos documentos do Felipe; para a Delliz ou outros modelos, revise o extrator e concilie os documentos antes de importar.
Guarde o JSON classificado do mês anterior e importe o mês novo em outro arquivo, após adaptar o extrator e conferir os totais das novas faturas. Então execute:
node scripts/transfer-classifications.mjs --previous private/clients/felipe/data/finances.json --current private/clients/felipe/data/novo-mes.json --output private/clients/felipe/data/novo-mes-revisado.json --report private/clients/felipe/reports/pendencias-novo-mes.json
O arquivo revisado reaproveita nomes, categorias e finalidades apenas quando encontra uma parcela posterior da mesma compra, com a descrição original do banco, conta, final do cartão e valor compatíveis. Os números das parcelas devem avançar conforme os meses transcorridos. Classificações provisórias, correspondências duplicadas e valores divergentes aparecem no relatório de pendências para conferência. Compras sem correspondência permanecem sem identificação. O arquivo anterior não é sobrescrito; importe o revisado no aplicativo depois de conferir as pendências.
Valores em centavos inteiros. Despesas pela competência da fatura, não pelo mês da compra. Pagamentos de faturas anteriores excluídos, evitando dupla contagem. Receitas não informadas permanecem desconhecidas: não são presumidas como zero. Resultado registrado é receitas menos despesas, não saldo bancário.
O saldo informado de uma conta é uma posição sem data confirmada até que ela seja fornecida. Valores a receber são previsões por competência e ficam separados das receitas realizadas; só entram no resultado quando o recebimento for confirmado e registrado como receita. Os dados privados de saldo e recebíveis são preservados na configuração local da importação e incluídos no backup do aplicativo.
Projeção inclui apenas parcelamentos explícitos da competência selecionada. Não inclui novas compras, assinaturas recorrentes, despesas não enviadas ou juros futuros. Para Inter, valores futuros explicitados na fatura ajustam diferenças de centavos; para as demais parcelas, o valor atual é usado como estimativa. Mapfre exige confirmação antes de entrar na projeção. Não confundir soma nominal de parcelas com saldo para quitação antecipada.
O painel de compras parceladas separa parcelas de empréstimos e mostra apenas compras com parcelamento informado. O simulador usa reduções escolhidas nas despesas sem parcelas de alimentação fora, assinaturas e combustível; o prazo de reserva usa somente essas reduções. O potencial de seis meses soma esse cenário com o espaço que cada parcela deixaria de ocupar, comparado ao mês atual, sem presumir receitas ou caixa disponível. Combustível é estimado por descrições de postos e pode incluir outros produtos. “Assinaturas e software” representa cobranças no mês; a periodicidade de cada serviço ainda deve ser confirmada.
Categorias são sugestões pelo estabelecimento, não informação oficial do banco. Não se assume que todo gasto num cartão MEI seja profissional. Os limites refletem a emissão da fatura.
npm test
npm run build
Os testes cobrem centavos, projeções, virada de ano, validação de backups, autenticação local e bloqueio/validação de JWT na futura hospedagem. dist/ contém apenas o aplicativo estático. Para Cloudflare Pages, mantenha também functions/ na raiz do repositório para compilar o middleware de autenticação.
Wordmark em public/assets/wordmark.svg e símbolo em public/assets/symbol.svg. A marca usa preto, cinza e branco. Cores dos gráficos são semânticas e independentes da identidade. Sem fontes remotas, rastreadores ou requisições a bancos.