¿Qué hace Next.js Pages Router (Legado)?
Prioridad: P0 (CRÍTICA)
[!IMPORTANTE] El proyecto usa Next.js Pages Router (directorio
pages/). NO use características de App Router.
Directrices de Implementación
- Arquitectura de Rutas: Use el directorio
pages/. Use_app.tsxpara estado/layout global y_document.tsxpara atributos HTML personalizados. Defina rutas dinámicas usando corchetes[id].tsxo catch-all[...slug].tsx. - Obtención de Datos (SSR/SSG): Use
getServerSideProps(para cada solicitud) ogetStaticProps(en tiempo de compilación) congetStaticPathspara rutas dinámicas. Exporte estas como funcionesasyncindependientes. - Aislamiento de Lógica: Nunca haga
fetcha sus propios endpoints/apidesde hooks del lado del servidor. Importe directamente la capa de servicios o la lógica de la base de datos. - Hooks del Cliente: Use
useRouter()denext/routerpara la navegación y acceso a parámetros de consulta. Userouter.push()o<Link>para el enrutamiento del lado del cliente. - APIs: Implemente rutas API en
pages/api/para lógica solo del servidor o webhooks. Estandarice las respuestas con códigos de estado HTTP apropiados. - Compatibilidad con Next.js 15+: Tenga cuidado con las actualizaciones a Next.js 15; asegúrese de que todos los objetos devueltos por
getServerSidePropscoincidan con elPagePropsesperado. - Estilo: Estandarice mediante Módulos CSS (
*.module.css) o Tailwind CSS. Evite CSS global a menos que se importe en_app.tsx.