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