ADR-0001: Framework Frontend — Next.js

Status

Accepted

Context and Problem Statement

Os projetos atenvi-admin e atenvi-web precisam de um framework React com suporte a SSR/SSG, roteamento, e ecossistema maduro para aplicações de gestão empresarial.

Decision Drivers

• Necessidade de SSR para SEO e performance inicial
• Roteamento baseado em arquivos reduz boilerplate
• Suporte a API Routes para proxying leve (antes do BFF)
• Ecossistema e comunidade ativos
• Compatibilidade com Storybook para o design system

Considered Options

• Next.js
• Remix
• Vite + React SPA

Decision Outcome

Chosen option: Next.js, porque oferece SSR/SSG out-of-the-box, App Router com Server Components reduz bundle do cliente, e tem integração madura com Storybook e Turbopack.

Positive Consequences

• Server Components reduzem JS enviado ao cliente
• App Router habilita layouts aninhados e streaming
• Deploy simplificado (Vercel ou self-hosted)

Negative Consequences

• Complexidade maior que SPA puro (Server vs Client Components)
• Vendor lock-in parcial com convenções do Next.js

More Information

• Versão mínima: Next.js 15 (App Router)
• Projetos: atenvi-admin, atenvi-web