Resumen
Back-office interno de devoluciones de Hawkers para ATC, tiendas y administración, desarrollado en Next.js 16 con Auth0 por roles sobre robo-api.
Roles y control de acceso
Sesión de Auth0, roles en el ID token, rutas protegidas por rol y propagación del access token a robo-api desde proxy.ts.
Arquitectura
Server Components con hidratación SWR, capa de actions sobre robo-api, route handlers como BFF, diccionario de UI y tablas con TanStack.
Gestión de devoluciones
Listado con filtros y exportación a CSV, detalle editable, matriz de editabilidad por estado, acciones masivas, historial de cambios y PDF.
Alta manual
El wizard de cuatro pasos de /returns/create para dar de alta una devolución en nombre del cliente, con orígenes, mercancía reclamada y almacén.
Catálogos y administración
Gestión de métodos de devolución, motivos, usuarios de Auth0 y almacenes, con sus traducciones y reglas de validación.
Integraciones
Endpoints de robo-api consumidos, los tres journeys de Salesforce Marketing Cloud y el PDF firmado compartido con el portal del cliente.
Configuración y despliegue
Variables de entorno, ejecución en local, imagen Docker, pipeline de Jenkins y despliegue en GKE del back-office de devoluciones.
Notas técnicas
Hallazgos, deuda técnica y consideraciones a tener en cuenta al trabajar sobre el back-office de devoluciones.