Appliquei

Gestão financeira pessoal — frontend SPA + API serverless + Firestore.

Stack

Camada	Tecnologia
Frontend	HTML/CSS/JS vanilla, Chart.js, módulos ES + classic scripts (bundle Vite)
Build	Vite 5 em modo MPA (multi-page app)
API	Node.js serverless (Vercel Functions) — 12 endpoints
Validação API	Zod schemas + wrapper unificado em api/_lib/handler.js
Banco	Firestore (regras enforced em firestore.rules)
Auth	Firebase Auth (e-mail/senha + Google)
Pagamentos	Asaas (assinaturas, cartão, webhooks idempotentes)
Observabilidade	Sentry (browser e Node) — lazy-loaded por DSN
CI	GitHub Actions (lint + 58 unit tests + 108 flow tests + Vite build)

Desenvolvimento

Requer Node.js 22+ (testes usam node --test com glob expansion).

npm install
npm run dev       # Vite dev server em :5173
npm run build     # build de produção em dist/
npm run preview   # serve dist/ em :4173

/api/* não roda em vite dev (são Vercel Functions). Para testar billing/auth/admin localmente, em outro terminal:

npx vercel dev    # serve dist/ + api/ em :3000

Scripts npm

Script	O que faz
npm run dev	Vite dev server (HMR, sem API)
npm run build	vite build → dist/
npm run preview	Serve dist/ localmente
npm run lint	ESLint 9 em api/, scripts/, web/
npm run lint:fix	Lint com auto-fix
npm run format	Prettier write em todos os JS/JSON/MD
npm run format:check	Verifica formatação sem alterar
npm test	58 unit tests (node --test)
npm run test:flows	108 checks de billing/referral (mock Asaas + Firestore)
npm run optimize:assets	Re-encoda JPGs grandes com sharp
npm run icons:build	Regera icons/ (tela de início) a partir do SVG
npm run ingest:cvm	Dry-run da ingestão da CVM (relatório, não grava)

以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗