Saltar al contenido principal

Terminal móvil (ccf-almacen-mb) — los datos no cargaban

· 4 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

El terminal móvil de CCF Almacén (ccf-almacen-mb) se quedaba «con sesión» pero ninguna lista ni panel cargaba datos: todas las lecturas respondían 401 Missing Authorization header. La validación cubrió las 7 pantallas del terminal y los 37 endpoints que consume.

Causa raíz​

expo-secure-store no tiene implementación en web (su módulo web exporta un objeto vacío). El token de sesión se guardaba y se leía solo de ese almacén, así que en el build web:

  • setSeguro() fallaba en silencio → el token nunca se persistía.
  • getSeguro() devolvía null → el interceptor de src/api/client.ts nunca añadía la cabecera Authorization.
  • El API respondía 401 en cada lectura, y el catch que se tragaba el error hacía que el fallo fuera invisible en la app.

Además, el 401 borraba el token del almacén pero no el estado en memoria del store: la app seguía pensando que había sesión y solo se salía de ese estado cerrando sesión a mano.

Correcciones​

Terminal móvil (ccf-almacen-mb)​

ArchivoCambio
src/utils/secure-storage.tsEl almacén se elige por plataforma: expo-secure-store (Keychain/Keystore) en iOS/Android y AsyncStorage (localStorage) en web, con la misma clave almacen_token para no perder sesiones ya creadas. La escritura en el almacén cifrado se verifica (en Expo Go sobre web resuelve sin error pero no persiste).
src/api/client.tsEl token vigente se mantiene en memoria (setTokenEnMemoria) y es la fuente de verdad de las peticiones: una escritura fallida del almacén ya no deja la app sin cabecera. Un 401 limpia memoria y almacén, y notifica al store.
src/store/useAuthStore.tsPublica el token en memoria al iniciar sesión y al restaurar; ante un 401 vacía la sesión en memoria para volver al login en vez de quedar «con sesión» sin token.

Contratos de escritura (el móvil enviaba cuerpos que el API rechazaba)​

EndpointAntes (400)Ahora
POST /api/solicitudes/:id/despacho-codigo{ codigo, tipoCodigo }{ idSolicitud, items: [{ codigoLeido, tipoCodigo, cantidadConfirmada }] }
POST /api/movimientos-inventario{ productId, type, quantity, notes }{ idProducto, idAlmacen, tipoMovimiento, cantidad, motivo }

El API exige idAlmacen (el stock es por almacén, INV-002) y motivo, así que la pantalla Registrar movimiento ahora pide el almacén y resuelve el producto escrito a mano por código o id.

API (ccf-almacen-api)​

CorrecciónDetalle
Rutas literales absorbidas por :idNest registra las rutas en orden de declaración: @Get(':id') declarado antes absorbía productos/inactivos, logs-operacion/auditoria, movimientos-inventario/trazabilidad y solicitudes/ventanas-horarias. El backend convertía el literal a NaN y PostgreSQL respondía 500. Ahora los literales se declaran antes que :id.
:id no numéricoGET /api/productos/ABC devolvía 500; ahora devuelve 404.
idUsuarioResponsable obligatorioLa columna id_usuario_responsable es NOT NULL pero el DTO lo marcaba opcional: el alta fallaba con 500. Ahora el API lo deduce del usuario del JWT cuando el cliente no lo envía.
X-Health-Check en CORSLa cabecera de la sonda de salud no estaba en allowedHeaders y el navegador rechazaba el preflight, de modo que la app no podía descubrir el API.

Barrido de recursos​

Se validaron las 147 rutas GET literales del API contra la instancia real: 12 respondían 500 y quedaron en 6, todas legítimas (parámetros obligatorios ausentes o la conexión a MongoDB de retroalimentación caída).

Verificación​

  • npm test (API): 1305 pruebas / 143 suites en verde.
  • npx jest (móvil): 106 pruebas / 13 suites en verde, incluida una de regresión del almacén de sesión.
  • npx tsc --noEmit: sin errores en API y móvil.
  • Navegador (build web): las 7 pantallas cargan sin error; GET /api/productos → 200 y la sesión persiste tras recargar.
  • Escrituras verificadas contra el API real: POST /movimientos-inventario → 201.

Archivos clave​

  • Móvil: src/utils/secure-storage.ts, src/api/client.ts, src/store/useAuthStore.ts, src/api/movimientosApi.ts, src/hooks/useBarcodeScanner.ts, src/hooks/useDespachos.ts, src/screens/RegistrarMovimientoScreen.tsx.
  • API: src/domains/productos/productos.controller.ts, src/domains/logs-operacion/logs-operacion.controller.ts, src/domains/movimientos-inventario/movimientos-inventario.controller.ts, src/domains/solicitudes/solicitudes.controller.ts, src/main.ts.