001 — Executive · Stack da Aplicação: OpenAPI, Estado, UI e Testes

001 — Executive · Stack da Aplicação: OpenAPI, Estado, UI e Testes

Status: Concluído Aprovado por / em: Joseph Trupel — 2026-06-29

---

Decisões executivas

Sobre a fundação da ADR 001, montar a stack da aplicação que todo projeto usa: o contrato de API OpenAPI (derivado de Zod) com a tela de testes Scalar e tipos gerados, o estado com Zustand, o shadcn/ui completo, o Sonner, os testes com Vitest (orientado a testes) e o banco (PostgreSQL + Prisma).

Tudo segue o Manifesto — a stack universal é regra, não recomendação.

Escopo

Entra agora

• OpenAPI + Scalar: contrato derivado de Zod 4 (z.toJSONSchema), servido em /openapi.json e testável em /reference. Tipos gerados (openapi-typescript) + cliente openapi-fetch.
• Zustand: store de exemplo no padrão store.ts + sync.tsx, com página demo.
• shadcn/ui completo em packages/ui.
• Sonner para notificações.
• Vitest + Testing Library, com teste de contrato (schema → teste → implementação).
• PostgreSQL em Docker + Prisma com scripts de banco.

Pode adiar

• Camada de dados real (a API de exemplo é em memória).
• Autenticação, multi-tenant.

Fica de fora

• Regra de negócio — o boilerplate é neutro de domínio.

Prazos

Marco	Esperado	Real
Stack da aplicação montada e validada	2026-06-29	2026-06-29

Recursos a implementar

• Fluxo ponta a ponta: schema Zod → contrato OpenAPI → tipos gerados → store Zustand → teste.
• Banco em Docker pronto para db:push.

Objetivos / KPIs

• Stack universal 100% presente e validada (lint, typecheck, test, build).
• Contrato e validação a partir de uma fonte única (Zod), sem divergência.

Módulos / áreas afetados

• apps/web (API, estado, UI, testes, banco) e packages/ui.

Referências e links

• Stack universal
• Frontend e Zustand
• OpenAPI e Scalar
• Testes
• ADR 001 — Fundação