O que Next.js Pages Router (Legado) faz?
Prioridade: P0 (CRÍTICA)
[!IMPORTANT] O projeto utiliza o Pages Router (
pages/) do Next.js. NÃO use recursos do App Router.
Diretrizes de Implementação
- Arquitetura de Roteamento: Use o diretório
pages/. Use_app.tsxpara estado global/layouts e_document.tsxpara atributos HTML personalizados. Defina rotas dinâmicas usando colchetes[id].tsxou catch-all[...slug].tsx. - Obtenção de Dados (SSR/SSG): Use
getServerSideProps(para cada requisição) ougetStaticProps(em tempo de build) comgetStaticPathspara rotas dinâmicas. Exporte-os como funçõesasyncindependentes. - Isolamento de Lógica: Nunca faça
fetchdos seus próprios endpoints/apia partir de hooks do lado do servidor. Importe a camada de serviço ou a lógica do banco de dados diretamente. - Hooks do Cliente: Use
useRouter()denext/routerpara navegação e acesso a parâmetros de consulta. Userouter.push()ou<Link>para roteamento no lado do cliente. - APIs: Implemente Rotas de API em
pages/api/para lógica exclusiva do servidor ou webhooks. Padronize as respostas com códigos de status HTTP apropriados. - Compatibilidade com Next.js 15+: Tenha cuidado com atualizações do Next.js 15; garanta que todos os retornos de
getServerSidePropscorrespondam aoPagePropsesperado. - Estilização: Padronize via Módulos CSS (
*.module.css) ou Tailwind CSS. Evite CSS global, a menos que seja importado em_app.tsx.