Terminal móvil (ccf-almacen-mb) — los datos no cargaban
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íanull→ el interceptor desrc/api/client.tsnunca añadía la cabeceraAuthorization.- El API respondía
401en cada lectura, y elcatchque 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)
| Archivo | Cambio |
|---|---|
src/utils/secure-storage.ts | El 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.ts | El 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.ts | Publica 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)
| Endpoint | Antes (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ón | Detalle |
|---|---|
Rutas literales absorbidas por :id | Nest 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érico | GET /api/productos/ABC devolvía 500; ahora devuelve 404. |
idUsuarioResponsable obligatorio | La 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 CORS | La 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.
