Resumen
Portal público de devoluciones para el cliente final de Hawkers, desarrollado en Next.js 16 (App Router) sobre robo-api.
Arquitectura
Providers de React Context, gestión de estado en sessionStorage, patrón BFF y flujo de datos del Customer Returns Portal.
Flujo de devolución
Los cuatro pasos del wizard de devolución, sus validaciones, el cálculo del importe y la pantalla de confirmación.
Consulta de estado
Recuperación de una devolución existente en la página /info, con sus estados, línea temporal y descarga de PDFs.
API routes e integraciones
Los diez route handlers del portal, la autenticación con Auth0 contra robo-api y la integración con Salesforce Marketing Cloud.
PDFs y URLs firmadas
Firma HMAC-SHA256 de las URLs de PDF, rutas /doc y /status, generación con react-pdf, QR, fuentes e idioma del documento.
Internacionalización
Resolución de idioma con next-intl, cookies compartidas con la web SFCC, ficheros de mensajes y traducciones remotas de robo-api.
Configuración y despliegue
Variables de entorno, Basic Auth, ejecución en local, imagen Docker, pipeline de Jenkins y despliegue en GKE.
Notas técnicas
Hallazgos, deuda técnica y consideraciones a tener en cuenta al trabajar sobre el Customer Returns Portal.