Visão geral
O FinFlow reúne contas, receitas, despesas, transferências, objetivos, cartões de crédito, relatórios e assistência financeira em uma experiência única. O aplicativo Expo e o painel Next.js compartilham o mesmo Supabase, as mesmas categorias e os mesmos dados.
O histórico técnico permanece disponível em commits e contributors.
Funcionalidades
- Cadastro, confirmação de e-mail, login e recuperação de acesso.
- Perfil obrigatório, aceite dos termos e tutorial inicial pulável.
- Contas ativas e arquivadas, seleção independente e compartilhamento controlado.
- Receitas, despesas e transferências únicas, parceladas ou recorrentes, inclusive de contas para objetivos.
- Recorrências semanais, mensais e anuais, preservando itens já concluídos.
- Conclusão integral ou parcial com data e histórico das baixas.
- Categorias de receita e despesa sincronizadas entre aplicativo e site.
- Objetivos financeiros com guardar, resgatar, projeção e histórico.
- Cartões, compras únicas, parceladas ou fixas, faturas e estornos.
- Pagamento integral ou parcial de fatura, com saldo remanescente e juros opcionais.
- Histórico com busca e filtros por período, status, tipo, conta e categoria.
- Calendário web com agendamentos por dia, filtros de situação e criação direta na data selecionada.
- Fluxo de caixa realizado e previsto, com seleção de múltiplas contas.
- Relatórios por categoria; cada parcela de cartão aparece no mês da sua fatura.
- Assistente restrito a finanças, com prévia e confirmação explícita antes de alterar dados.
- Planos, checkout pelo backend, temas e notificações configuráveis.
- Proteção biométrica no mobile, sessão SSR na web e atualização OTA pelo EAS Update.
Regras financeiras importantes
- Uma transferência entre contas é uma única movimentação: debita a origem e credita o destino. Transferências para objetivos usam a operação atômica de guardar dinheiro, sem virar despesa.
- Guardar ou resgatar dinheiro de um objetivo é movimento interno e não vira receita ou despesa.
- Movimentações concluídas usam
data_realizacao; pendentes usam data_vencimento.
- O pagamento bancário de uma fatura afeta o saldo da conta, mas não duplica a despesa nos relatórios por categoria.
- Uma compra parcelada gera uma cobrança por parcela. A categoria recebe somente o valor da parcela correspondente a cada
mes_fatura.
- Séries concluídas não são reabertas quando ocorrências futuras são editadas ou excluídas.
- Ações compostas devem passar pelas RPCs transacionais e idempotentes do Supabase.
Arquitetura
| Camada | Tecnologias |
|---|
| Aplicativo | Expo SDK 54, React Native 0.81, React 19 e Expo Router |
| Painel web | Next.js 16 App Router, React 19 e @supabase/ssr |
| Backend | Supabase Auth, PostgreSQL, RLS, RPCs e Edge Functions |
| Persistência local | Expo SecureStore, SQLite e AsyncStorage limitado a preferências/cache |
| IA | Edge Function finance-ai, OpenAI ou Groq configurado apenas no servidor |
| Pagamentos | Paddle Billing no site; Google Play Billing planejado para o app Android |
| Distribuição mobile | EAS Build e EAS Update |
Aplicativo Expo ─┐
├── Supabase Auth + RLS + RPCs ── PostgreSQL
Painel Next.js ──┘ │ │
│ └── Edge Function IA └── assinaturas
└── Paddle Checkout + webhook verificado
Estrutura do repositório
app/ telas e rotas do aplicativo Expo
(tabs)/ Início, Histórico, Objetivos, Fluxo e Ajustes
chat-ia.tsx assistente financeiro mobile
assets/ ícones, logo e imagens do aplicativo
components/ componentes React Native compartilhados
lib/ domínio financeiro e integrações mobile
shared/ contratos compartilhados, inclusive da IA
supabase/
functions/ Edge Functions
migrations/ schema, RLS e RPCs versionados
web/
src/app/ rotas, Server Components e Server Actions
src/components/ layout, autenticação, tutorial e UI
src/lib/ domínio web e clientes Supabase SSR
docs/ setup, handoffs, políticas e auditorias
scripts/ testes e verificações de segurança
constants/ catálogos compartilhados entre app e site
Documentação técnica
A referência atual está no índice de documentação:
Handoffs datados são históricos. Em caso de divergência, prevalecem o código e as migrations da main, seguidos pelos documentos acima.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
