Ir para o conteúdo

0003 — Neon (Postgres serverless)

  • Status: aceito
  • Data: (rascunho — confirmar)

Contexto

O app web roda na Vercel (serverless/edge). Um Postgres tradicional com pool de conexões persistentes sofre com o modelo serverless (limite de conexões, cold starts abrindo conexões demais).

Decisão

Usar Neon como Postgres, via @neondatabase/serverless + o driver drizzle-orm/neon-serverless.

Alternativas consideradas

  • Supabase — Postgres + extras (auth, storage); mais do que precisávamos, e auth já é resolvido por better-auth.
  • Postgres gerenciado tradicional (RDS/Railway PG) — bom, mas o modelo de conexão serverless do Neon encaixa melhor com a Vercel.

Consequências

  • Positivas: conexões adequadas a serverless, branching de banco, escala a zero.
  • Trade-offs: dependência de um provedor específico (driver @neondatabase/serverless).
  • Impacto: DATABASE_URL é o segredo central; ver STACK.md (plano Infra).