尚未收集仓库信息。
尚未检测到更新。GitHub 发布版本后会显示在这里。
按最近已完成的 8 小时观测回合间的 GitHub 星标增量排序
An x402-style payment gateway for AI requests. Sign EIP-712, get a signed receipt, verify the signature client-side.
翻译准备中
制作者的介绍仅有上面的一句话。 更多详情请阅读仓库 README。 仓库 README ↗
正在加载完整 README。
查看完整 README ↗Sistema web de gestão financeira pessoal: contas, transações, cartões, investimentos, metas, orçamentos e relatórios, com dashboard em tempo real.
Status deste repositório: em produção real, de ponta a ponta (backend + frontend + banco + auth). A maioria dos módulos de domínio já está implementada —
accounts,categories,transactions,cards,investments,goals,dashboard,reports,settings,notifications,recurring-bills, a integraçãomcp(lançamentos direto pelo Claude — ver seção abaixo). Sóbudgetssegue como esqueleto (*.module.ts/*.controller.ts/*.service.ts), pronto para receber a implementação — verdocs/ARCHITECTURE.md→ "Como implementar um novo módulo".
| Camada | Tecnologias |
|---|---|
| Frontend | Next.js (App Router), React, TypeScript, Tailwind CSS, shadcn/ui-style components, React Hook Form + Zod, TanStack Query, Zustand, Recharts, Axios |
| Backend | NestJS, TypeScript, Prisma ORM, PostgreSQL |
| Auth | JWT (access + refresh rotativo), bcrypt, Guards, Roles |
| Infra | Vercel (frontend), Render (backend), Neon PostgreSQL |
gestao-financeira-saas/
├── backend/ # API NestJS
│ ├── src/
│ │ ├── auth/ # JWT, refresh token, guards, strategies
│ │ ├── users/ # Perfil, troca de senha, exclusão de conta
│ │ ├── accounts/ # ✅ Contas e transferências entre contas
│ │ ├── categories/ # ✅ Categorias de transação
│ │ ├── transactions/ # ✅ Lançamentos (receita/despesa/transferência)
│ │ ├── cards/ # ✅ Cartões, faturas, parcelamento e pagamento em lote
│ │ ├── investments/ # ✅ Aportes e acompanhamento de investimentos
│ │ ├── goals/ # ✅ Metas financeiras com progresso
│ │ ├── budgets/ # Esqueleto — TODO
│ │ ├── dashboard/ # ✅ Agregações reais para os cards e gráficos
│ │ ├── reports/ # ✅ Fluxo de caixa, extrato, exportação
│ │ ├── settings/ # ✅ Preferências do usuário (tema, widgets do dashboard...)
│ │ ├── notifications/ # ✅ Central de notificações
│ │ ├── recurring-bills/ # ✅ Contas fixas recorrentes
│ │ ├── whatsapp/ # ✅ Lançamento de transações via WhatsApp (texto/foto, interpretado por IA)
│ │ ├── mcp/ # ✅ Servidor MCP remoto (OAuth 2.1 + tools) — lançamentos direto pelo Claude
│ │ └── common/ # Prisma service, filtros, interceptors, guards, DTOs
│ ├── prisma/
│ │ ├── schema.prisma # Todas as tabelas, relacionamentos e índices
│ │ └── seed.ts
│ └── test/
├── frontend/ # App Next.js
│ ├── app/
│ │ ├── (auth)/ # login, registro, esqueci/redefinir senha
│ │ └── (dashboard)/ # dashboard, contas, transações, cartões,
│ │ # investimentos, metas, contas fixas, relatórios, config
│ ├── middleware.ts # roteamento de sessão no edge (ver docs/ARCHITECTURE.md)
│ ├── components/{ui,layout,dashboard,cards}
│ ├── hooks/ services/ stores/ types/ utils/
└── docs/ # Documentação detalhada
Backend
cd backend
cp .env.example .env # ajuste DATABASE_URL se necessário
npm install
npx prisma migrate dev --name init
npx prisma db seed
npm run start:dev
Frontend
cd frontend
cp .env.example .env.local
npm install
npm run dev
O backend expõe um servidor MCP remoto em /mcp (autenticado via OAuth 2.1 — ver docs/ARCHITECTURE.md), que permite lançar transações, aportes e compras parceladas direto de uma conversa com o Claude, colando/anexando uma planilha, extrato bancário ou nota da B3.
claude mcp add --transport http poupay https://<seu-dominio-do-backend>/mcp
Na primeira chamada o Claude registra-se automaticamente (Dynamic Client Registration) e abre o navegador para você fazer login no PouPay e autorizar o acesso — nenhuma chave é copiada manualmente.
docs/ARCHITECTURE.md — arquitetura, padrões e como implementar um novo módulodocs/DATABASE.md — modelagem do banco de dadosdocs/DEPLOY.md — deploy em Vercel + Render + Neondocs/ENVIRONMENT.md — variáveis de ambienteUso interno / privado do projeto.