V.I.T.A.L

Painel reflexo da minha vida. Começando pela aba Financeiro.

Site publicado (Vercel + Supabase)

O site é estático e fica na Vercel; os dados ficam no Supabase, no schema financeiro (tabelas dividas, ganhos, gastos, investimentos, cartoes, faturas, lancamentos e pagamentos — veja supabase/migrations/).

• Login: e-mail e senha (Supabase Auth). Só os e-mails da tabela financeiro.emails_permitidos conseguem criar conta.
• Segurança: RLS em todas as tabelas — cada linha pertence a um usuário e só ele lê ou altera.
• Tempo real: o painel escuta as mudanças das tabelas (Supabase Realtime), então o que muda num aparelho aparece nos outros.
• Tema: claro, escuro (preto neutro) ou automático, seguindo o sistema; o botão no topo troca e o painel lembra a escolha.
• config.js tem a URL do projeto e a chave publicável (pode ficar no navegador).
• A Vercel publica a cada push: vercel.json roda sh scripts/build.sh, que copia para public/ só a lista fixa de arquivos do site (um arquivo novo do site precisa entrar nessa lista).

Despertador do banco

No plano gratuito, o Supabase pausa o projeto depois de ~7 dias sem acesso. Para evitar isso, a Vercel chama todo dia (cron em vercel.json, 11:17 UTC) a rota api/manter-ativo.js, que executa a função public.manter_ativo() no banco (ela só devolve a hora, sem ler dados). Como reserva, o GitHub Actions faz a mesma chamada todo dia (.github/workflows/manter-ativo.yml). Se mesmo assim o projeto for pausado, basta restaurá-lo no painel do Supabase.

Como usar localmente

1. Abra o index.html no navegador (não precisa instalar nada). Aberto como arquivo, o painel usa o localStorage do navegador em vez do Supabase.
2. Use + Adicionar dívida para cadastrar, e a setinha de cada dívida para Editar ou Excluir. Os dados ficam salvos no navegador (localStorage). dividas.js só define os exemplos mostrados na primeira abertura.

O painel calcula sozinho a parcela atual, quantas faltam, a previsão de término, quanto já foi pago e quanto falta. Clique na setinha de cada dívida (ou do total) para ver os detalhes.

Ao lado das dívidas ficam o gráfico de pizza (quanto falta pagar de cada dívida) e a torre com Quanto eu ganho, Quanto eu gastei e Investimentos. Cada bloco tem uma setinha com os detalhes e os botões para adicionar, editar e excluir. Ganhos e gastos marcados como "Todo mês" entram em todos os meses; os demais, só no mês em que foram lançados.

Embaixo das dívidas, abaixo das dívidas e da pizza, fica o Controle de pagamentos: cadastre cada conta com valor e vencimento; ao clicar em Marcar como paga, a data e a hora do pagamento são registradas sozinhas. Contas pendentes com vencimento passado aparecem como Atrasada.

Melhorias da versão 4 (05/11/2026)

• Conta sem dia de vencimento (V01): a conta tem mês e vencimento opcional. Sem o dia, fica pendente com “vencimento a confirmar” (nunca recebe um dia 10 automático, nem vira atrasada).
• Pretendo pagar em (V04): data prevista e observação opcionais; o vencimento e o status não mudam.
• Parcela de dívida (V11): a conta pode ser ligada à dívida (“Parcela de dívida”). Ligada — ou com o mesmo nome e valor da parcela — ela entra uma vez só no total do mês, e pagá-la paga a parcela.
• Pago com (V13): recursos próprios, cheque especial ou outro crédito. O que foi pago com cheque especial aparece como pago e fica destacado como valor ainda devido ao banco, sem ser somado de novo.
• Parcelas da dívida (V10/V12): na seta de cada dívida dá para marcar a parcela do mês como paga (com data e origem) antes do vencimento e marcar parcelas futuras antecipadas (com valor pago, para o desconto). Antecipadas não são cobradas no mês delas; o “saldo devedor informado pelo banco”, quando preenchido, substitui o cálculo parcela × restantes.
• Celular (V14–V16): contas viram cartões com as ações à vista; a importação diz “Toque para escolher”; o gráfico do mês tem uma cor por fatia, legenda visível e toque mostra nome e valor.
• Datas (V07): todo campo de data tem um texto dd/mm/aaaa ao lado do botão de calendário; o valor continua guardado em ISO (aaaa-mm-dd).
• Carregando (V09): enquanto uma consulta não volta (ou falha), as áreas mostram “Carregando…” ou o erro, em vez de “nenhum cadastro” ou zeros.
• Saúde (V03/V05/V06): refeição planejada fica fora do placar até ser confirmada (o mesmo registro vira realizado); “Sem avaliação” aparece no histórico sem contar como acerto ou erro; a intensidade do treino começa como “Não informada”.
• SHARK (V02/V08): arte avulsa ganha “Editar” (nome, prazo e quantidade, mantendo id, status e vínculo); o resumo diz “Sem atrasos” e quantas artes seguem abertas com e sem prazo.

Histórico das contas (V2-08): cada criação, importação, vinculação, edição, reimportação, pagamento e exclusão feita a partir desta versão vira um evento na tabela financeiro.historico_contas (só de inserção: o app nunca altera nem apaga eventos), com os campos antes/depois, a hora e a origem da ação. O evento só é registrado depois que a ação deu certo; se a gravação falhar, ele espera numa fila deste aparelho (separada por usuário), com aviso visível, e é reenviado com o mesmo id, sem duplicar. O histórico começa nesta versão: não há eventos de antes dela. A sincronização com as faturas nunca exclui contas e não grava valor zero quando a fatura vem vazia ou incompleta. Migração: 20261105190000_historico_contas.sql (aplicada no Supabase em 05/11/2026, versão 20261105192001).

A migração 20261105120000_melhorias_v4.sql só acrescenta colunas (todas opcionais ou com valor padrão); nenhum dado existente é apagado ou alterado.

This is the beginning of the README. Read the rest at the original. Read the full README ↗