Arquitectura del código

Directrices para navegar por el repositorio de la aplicación sin confundir las capas de interfaz de usuario, API y persistencia.

Zona	Rol
`src/app`	Rutas, páginas y puntos finales de la API de Next.js
`src/components`	Interfaz, pestañas, widgets y modales
`src/providers`	Estado del cliente y llamadas a la API de configuración
`src/lib`	Tipos, autenticación, control de acceso, persistencia, integraciones y reglas de negocio
`public`	Recursos estáticos
`e2e`	Escenarios de Playwright
`scripts`	Pruebas de contenedores y herramientas de mantenimiento
`data`	Datos locales persistentes, nunca código fuente

Las mutaciones de configuración se realizan a través de rutas del servidor, que aplican privilegios de administrador y filtran las respuestas. Las integraciones se consultan en el lado del servidor para evitar exponer sus secretos directamente al navegador.

Antes de modificar un tipo compartido, busque sus consumidores en la API, los formularios, la capa de persistencia, los filtros de lectura y las pruebas. Una opción visible sin un contrato de servidor completo es una función incompleta.