Humbolt MVP

Se rompió · 01

El escáner QR se reiniciaba en cada pulsación de tecla. Como `OperatorApp` vuelve a renderizarse mientras el operador escribe el código o el peso manualmente, los callbacks pasados a `QRScanner` cambiaban de identidad, el efecto de arranque de la cámara se relanzaba y `html5-qrcode` lanzaba “Cannot clear while scan is ongoing” y un AbortError que tumbaba la pantalla.

Se sostiene así

Los callbacks se guardan en refs (`onScanCompleteRef`, `onCancelRef`) que se actualizan en un efecto aparte, y el manejador de éxito se estabiliza con `useCallback` sin dependencias. Así el efecto que abre la cámara sólo corre al montar; además un `finishedRef` evita procesar dos lecturas y el cierre detiene y limpia el escáner de forma ordenada.

Se rompió · 02

El backend devuelve errores en tres formas distintas —`{status:'VALIDATION_ERROR', message, data}`, el `detail` de FastAPI (cadena o lista de `{loc,msg,type}`) y errores de integridad de base de datos—, y aplicar una sola política producía o modales de más o mensajes inútiles como “Error 500 del servidor”.

Se sostiene así

Un único interceptor de respuesta clasifica: el 422 siempre abre modal; 400, 409 y 500 muestran toast; cuando `data` trae el motivo concreto y `message` es genérico, gana el motivo concreto; el prefijo técnico del 500 sólo se antepone si no hubo mensaje legible del API. Los fallos de `/auth/login` y `/auth/register` se marcan como excepción para que los resuelva el formulario, y el duplicado de correo en PATCH de usuario se deja pasar para pintarse como tooltip en el campo.

Se rompió · 03

El PDF de comprobante generado por el servidor fallaba al serializar modelos ORM anidados (ciudad, país) del destinatario.

Se sostiene así

El comprobante se construye en el navegador con jsPDF a partir de los datos ya normalizados del API: `shipment-comprobante-pdf.ts` incluye helpers que extraen el `name` de objetos de localidad, resuelven el código o nombre de la zona postal y traducen los siete estados internos a español antes de dibujar el documento.

Se rompió · 04

Al crear una ruta, las paradas del formulario no tienen todavía identificador; sólo el `POST /routes/` devuelve las paradas reales, y los envíos deben asignarse a un `dropoff_stop_id` concreto del servidor.

Se sostiene así

`buildShipmentAssignmentsFromStops` empareja cada parada de la UI con la del servidor primero por posición —validando que coincida el `recipient_id`— y, si no cuadra, buscando por la combinación de `recipient_id` y `stop_number`. Devuelve un resultado tipado `{ok:true, assignments}` o `{ok:false, error}` con un mensaje que nombra la parada problemática, y está cubierto por pruebas unitarias.

Se rompió · 05

Un login lento seguido de un segundo intento dejaba llegar la respuesta vieja y sobrescribía el estado; y los reintentos automáticos de axios convertían un DELETE con 500 en varias peticiones y varios toasts idénticos.

Se sostiene así

El formulario de login usa un `AbortController` que cancela la petición anterior más un contador de intento que descarta cualquier respuesta que no sea la del intento vigente. En el interceptor, la lógica de reintento (hasta tres, con backoff de 1 s, 2 s y 3 s) se aplica sólo a errores de red y 5xx y excluye explícitamente el método DELETE.

Se rompió · 06

El proyecto nació como un bundle exportado de Figma Make: pantallas completas pero pobladas con datos simulados y sin contrato con ningún backend.

Se sostiene así

Se escribió `gen_services.py`, que descarga el `openapi.json` del backend y emite `types.ts` (98 interfaces y enums) y los servicios; la migración se hizo módulo a módulo sustituyendo el mock por la llamada real, con `normalizePaginationMeta` para tolerar las distintas formas de metadatos de paginación. Quedan aún en el repositorio pantallas heredadas del prototipo (Intelligence Hub, Reportes, Inventario, ShippingModule) que no están enganchadas a ningún menú.