Quitto
Gestão de contratos parcelados — cada parcela no seu lugar.
Acompanhe compras parceladas, aluguéis e acordos entre partes (ou solo): contratos, parcelas,
comprovantes e quitação, com aprovação/contestação, notificações e dashboard.
🔗 usequitto.vercel.app
Funcionalidades
- Contratos parcelados (parcelas iguais ou customizadas), com situação por parcela.
- Participantes & convites com papéis dinâmicos (pagador / aprovador) e RBAC por contrato.
- Comprovantes: upload direto (URL pré-assinada) → fluxo de aprovação / contestação → quitação.
- Notificações in-app (eventos de pagamento) + lembretes de parcelas a vencer/vencidas.
- Dashboard: a pagar/receber, atrasadas, contratos ativos, próximas parcelas com deep-link.
- Documentos: recibo de quitação e extrato em PDF, export CSV.
- LGPD: exportar os próprios dados e excluir a conta (com cascata e purga de arquivos).
- Acessibilidade WCAG 2.2 AA e performance (code-splitting, orçamento Lighthouse).
Arquitetura
Monorepo (Bun workspaces + Turborepo). O front é same-origin: chama /api/* no próprio domínio,
e um reverse-proxy (rewrite na Vercel) encaminha pro backend no Fly — mantendo o cookie de
sessão first-party.
Navegador ──▶ usequitto.vercel.app (React SPA · Vercel)
│ /api/* (rewrite)
▼
usequitto-api.fly.dev (Elysia · Fly.io)
├──▶ Neon (PostgreSQL)
└──▶ Cloudflare R2 (comprovantes · presigned)
| Camada | Tecnologias |
|---|
| API | Bun · Elysia · Drizzle ORM · PostgreSQL · Better Auth (Google + e-mail/senha) |
| Web | React 19 · Vite · TanStack Router & Query · Tailwind v4 · shadcn/Radix |
| Tipos | Eden Treaty (cliente tipado ponta a ponta, sem geração de código) |
| Storage | Cloudflare R2 (prod) · MinIO (dev/CI) — S3-compatível, upload pré-assinado |
| Infra | Vercel (web) · Fly.io (API) · Neon (DB) · GitHub Actions (CI/CD) |
| Qualidade | TDD · Biome/Ultracite · Lefthook · bun test · Vitest · Playwright + axe |
Valores monetários são inteiros em centavos; datas em ISO com máscara pt-BR.
Documentação
- Requisitos — funcionalidades e requisitos não-funcionais (a11y, segurança, performance).
- Arquitetura — topologia, modelo de dados, fluxos-chave e decisões de projeto.
Estrutura
apps/
api/ # backend Elysia (rotas, auth, drizzle, storage)
web/ # SPA React (rotas, hooks, componentes)
packages/
shared/ # tipos e contratos compartilhados (enums, helpers puros)
e2e/ # suíte Playwright (+ axe) dos fluxos críticos
Rodando localmente
Pré-requisitos: Bun ≥ 1.2 e Docker (para Postgres + MinIO).
git clone [email protected]:devjpedro/quitto.git
cd quitto
bun install
# sobe Postgres + MinIO (bucket criado automaticamente)
docker compose up -d
# variáveis de ambiente (ajuste se quiser Google OAuth local)
cp .env.example .env
# aplica as migrations
bun run --filter @quitto/api db:migrate
# sobe API (:3000) + web (:3001)
bun run dev
Abra http://localhost:3001. O Google é opcional em dev (sem GOOGLE_*, sobe só com e-mail/senha).
Variáveis de ambiente
Veja .env.example. Resumo:
| Var | Para quê |
|---|
DATABASE_URL | conexão Postgres |
BETTER_AUTH_SECRET / BETTER_AUTH_URL | sessão/auth |
WEB_ORIGIN | origem confiável (CORS/CSRF) |
GOOGLE_CLIENT_ID / _SECRET | login social (opcional em dev) |
S3_ENDPOINT / _REGION / _BUCKET / _ACCESS_KEY_ID / _SECRET_ACCESS_KEY | storage (R2/MinIO) |
Testes
bun run test # unitários/integração (API: bun test · web: Vitest)
bun run lint && bun run typecheck # Biome + tsc
cd e2e && bun run e2e # E2E Playwright (+ axe a11y) — precisa de docker compose up
bun run --filter @quitto/web lh # Lighthouse local no /login
CI/CD
GitHub Actions (.github/workflows/ci.yml):
push/PR ──▶ verify (lint·typecheck·test·build) + e2e (Playwright·axe) ← gate
push main ──────▶ migrate (Neon) ──▶ deploy-api (Fly) ∥ deploy-web (Vercel) ──▶ smoke
Nada vai pra produção sem o gate passar. O deploy de produção é orquestrado pelo pipeline: o
main migra o banco e publica API + web em paralelo, depois valida com smoke test.
Licença
Proprietário — © 2026 João Pedro Souza Silva. Todos os direitos reservados. Veja LICENSE.
