FinanceApp — Gestão Financeira Pessoal
App web para controle completo das finanças pessoais: contas, transações, parcelas, gastos fixos, metas e planejamento orçamentário.
Stack: Next.js 16 · Supabase · Tailwind CSS v4 · shadcn/ui · Recharts · Vercel
Funcionalidades
Dashboard
- Resumo do mês: receitas, despesas e saldo
- Filtro por período (mês/ano)
- Cards individuais das contas pinadas ao dashboard
- Gráfico de categorias com maiores gastos
- Diagnóstico financeiro automático (alertas e dicas com base nos dados do mês)
- Próxima ação recomendada (parcelas ou recorrências pendentes de decisão)
- Modal de onboarding para novos usuários
Contas (Multi-conta)
- Criação de múltiplas contas com nome, ícone e cor personalizáveis
- Templates prontos: Conta Corrente, Cartão de Crédito, Carteira Digital, Poupança, Investimentos, Dinheiro Físico
- Tipo por conta: entrada, saída ou ambos
- Pin/unpin: contas não pinadas são excluídas de todos os totais e gráficos agregados (dashboard, analytics, relatórios e parcelas ativas)
- Cada conta tem sua própria visão de transações com filtros independentes
Transações
- Registro manual de receitas e despesas
- Campos: valor, data, descrição, categoria, conta, tag, tipo de parcelamento, marcação de recorrência
- Busca e filtros por categoria, tipo e conta
- Edição e exclusão inline
- Seleção múltipla em massa: dentro de uma conta (Contas e Cartões), marque várias transações com checkbox e aplique de uma vez: mudar categoria, mover para outra conta ou excluir — cada ação pede confirmação mostrando a quantidade de transações afetadas
- Editar categoria vira regra automática: ao trocar a categoria de uma transação para uma categoria normal, o sistema cria/atualiza automaticamente uma regra (badge "Automática" em
/settings/rules) e aplica a mesma mudança em todas as transações passadas com a descrição exata. Categorias especiais nunca entram nesse mecanismo — nem geram regra, nem são sobrescritas por uma
- Exportação das transações para CSV
Importação de Extratos
- CSV genérico: compatível com Nubank, Inter, Banco do Brasil, Itaú, Bradesco e outros — detecção automática de colunas
- OFX / QFX: formato padrão bancário com maior precisão de dados (Itaú, Bradesco, Santander, Caixa, BB, Inter)
- C6 Bank: layout específico da conta corrente e fatura do cartão
- Fluxo de revisão antes de salvar: categorização automática por regras + edição manual de cada item importado
- Detecção automática de transferências: descrições iniciadas por "Transferência", "Transf", "TED" ou "DOC" são marcadas como tipo Transferência (não entram como receita/despesa real). PIX é tratado como transação normal, pois pode ser tanto um gasto real quanto uma transferência entre contas próprias
- Herança de categoria por histórico: ao importar, uma descrição já categorizada antes puxa a mesma categoria automaticamente — mas esse histórico nunca considera categorias especiais, evitando que uma associação especial pontual "vaze" para outras transações com descrição parecida
Categorização Automática
- Regras baseadas em palavra-chave: ao criar uma regra em
/settings/rules, ela pode ser aplicada retroativamente a transações já importadas
- Criação automática ao editar: não é preciso criar regra manualmente na maioria dos casos — editar a categoria de uma transação (em Transações ou Analytics) já cria a regra sozinha (veja acima). O botão de criar regra manual existe apenas em
/settings/rules
Analytics (Análise Mensal)
- Gráficos de gastos e receitas por categoria
- Filtro por conta específica ou visão geral (excluindo contas não pinadas)
- Filtro de período (mês/ano)
- Drill-down: clicar em uma categoria abre a lista de transações daquele grupo, com descrição/data, seletor de categoria e valor lado a lado para recategorizar rapidamente
Relatórios
Quatro tipos de relatório, todos com filtro por conta:
- Mensal: resumo de receitas e despesas do mês com breakdown por categoria
- Anual: visão do ano inteiro com comparativo mês a mês
- Parcelas: todas as compras parceladas ativas e seu progresso
- Gastos Fixos: recorrências confirmadas agrupadas por subcategoria, com média mensal
Gastos Recorrentes (Fixos)
- Detecção automática de gastos recorrentes dos últimos 12 meses (mínimo 2 ocorrências)
- Agrupamento por subcategoria (ex: "Mercado" agrupa Hortifruti, Pão de Açúcar, Carrefour)
- Ações por item: confirmar como fixo, ignorar ou ocultar
- Gestão de subcategorias para agrupamento personalizado
- Cartões & Parcelas sempre contam como fixo: os parcelamentos ativos aparecem como um grupo próprio no topo da tela, somados automaticamente ao total "Fixos confirmados / mês" — sem precisar de confirmação manual e sempre recalculado com base no mês atual
Parcelas Ativas
- Lista de compras parceladas em andamento com progresso (X/Y parcelas)
- Badges de status: "Última parcela", "Quase acabando", "Longo prazo"
- Cadastro manual de parcelamentos (para parcelas não importadas)
- Filtro por conta
- Remover da lista de parcelamentos: ícone de lixeira em cada card, com confirmação — não apaga a transação, só limpa os campos de parcela (
installment_current/installment_total, ou o sufixo (X/Y) legado), fazendo o item deixar de ser detectado como parcelamento
Investimentos
- Contas dedicadas a investimento (
is_investment), separadas das contas normais em /transactions
- Templates prontos: Corretora (RICO, XP, Clear, Nubank Investimentos), Previdência Privada, Criptomoedas, Tesouro Direto, Outro
- Importação de posição por conta: patrimônio total, breakdown de ativos por categoria e lista de proventos previstos
- Botão de atualizar posição a qualquer momento (reimportar extrato da corretora)
This is the beginning of the README. Read the rest at the original. Read the full README ↗
