INV-001 — Reubicación de productos y consulta de contenido de ubicaciones
Cierre de los requerimientos pendientes de INV-001 (Ubicaciones de Almacén): reubicación física con historial y tiempo real, consulta del contenido de una ubicación y visualización de la ubicación en el despacho.
📋 Requerimientos atendidos
| RF | Descripción | Estado |
|---|---|---|
| RF-INV-001-03 | Registrar movimientos de reubicación y actualizar la posición en tiempo real | ✅ Implementado |
| RF-INV-001-04 | Mostrar la ubicación en consultas de inventario y en el despacho | ✅ Completado en despacho |
| RF-INV-001-05 | Consultar el contenido de una ubicación específica | ✅ Implementado |
RF-INV-001-01 (jerarquía) y RF-INV-001-02 (asignación a producto) ya estaban implementados. El historial de ubicación se cubre ahora con la tabla
reubicaciones.
🔧 Backend (ccf-almacen-api)
Nueva tabla reubicaciones (migración 006-create-reubicaciones.ts)
Registra el historial de cambios de ubicación de cada producto:
| Columna | Tipo | Notas |
|---|---|---|
id_reubicacion | SERIAL PK | Identificador |
id_producto | INTEGER | FK → productos ON DELETE RESTRICT |
id_nivel_origen | INTEGER | FK → niveles ON DELETE SET NULL (nullable) |
id_nivel_destino | INTEGER | FK → niveles ON DELETE RESTRICT |
id_usuario_responsable | INTEGER | FK → usuarios ON DELETE SET NULL (nullable) |
fecha | TIMESTAMP | Por defecto CURRENT_TIMESTAMP |
comentarios | TEXT | Opcional |
Dominio ubicaciones
- Entidad
Reubicacion(entities/reubicacion.entity.ts). UbicacionesService.createReubicacion(): en una transacción valida el producto y el nivel destino, actualizaproductos.id_nively guarda el registro de reubicación. Rechaza mover a la misma ubicación (409).UbicacionesService.getContenido(): devuelve los productos de una zona/pasillo/estante/nivel (incluye descendientes) con stock agregado y la ruta de ubicación resuelta.UbicacionesService.findAllReubicaciones()/findOneReubicacion().- Gateway
ubicaciones.gateway.ts: emitereubicacion-creadayubicacion-actualizadapor Socket.IO en el namespace por defecto.
Endpoints nuevos
| Método | Ruta | Descripción |
|---|---|---|
POST | /api/reubicaciones | Registra una reubicación (Admin, Almacenista, Auxiliar inventario) |
GET | /api/reubicaciones?productoId= | Historial de reubicaciones |
GET | /api/reubicaciones/:id | Detalle de una reubicación |
GET | /api/ubicaciones/contenido?tipo=zona|pasillo|estante|nivel&id= | Contenido de la ubicación |
Despacho
detalle-solicitud.service.ts: las consultas de detalle incluyenproducto.nivel(+ cadena) para exponer la ubicación del producto en el despacho.
💻 Frontend (ccf-almacen-web)
src/models/ubicacion.entity.ts: tiposIContenidoUbicacion,IContenidoUbicacionProducto,IReubicacionyTipoUbicacionValor.src/api/ubicacion.ts:getContenidoUbicacion(),createReubicacion(),getReubicaciones().components/ubicaciones/ubicaciones-management.tsx:- Selección de nivel en la jerarquía y panel Contenido de la ubicación (productos, stock y totales).
- Diálogo Reubicar producto con selectores en cascada del destino y comentarios.
- Suscripción Socket.IO a
reubicacion-creada/ubicacion-actualizadapara refrescar el contenido en tiempo real.
components/requests/request-dispatch.tsx: nueva columna Ubicación en la tabla de productos a despachar (usaformatearRutaNivel).
📚 Documentación (ccf-almacen-wiki)
- Manual Ubicaciones Físicas de Almacén actualizado con las secciones Consultar el contenido de una ubicación y Reubicar un producto.
ccf-almacen-framework/DATABASE_SCHEMA.mdactualizado al esquema real (28 tablas, incluidas multi-almacén, ubicaciones, reubicaciones, lotes/series, transferencias, devoluciones, alertas, notificaciones y logs).
🧪 Verificación
- Backend:
npm run buildsin errores;npm test→ 61 tests ✅; ESLint limpio. - Migración
006-create-reubicacionesejecutada correctamente (migration:run). - Frontend:
npx tsc --noEmitsin errores; ESLint limpio.
🔎 Nota de alcance
La ubicación se administra a nivel de producto (productos.id_nivel), no por ítem individual (lote/serie). El historial de cambios de ubicación queda cubierto por la tabla reubicaciones.
🔄 Complemento (misma entrega): ubicación en las demás vistas de inventario
Se extendió la visualización de la ubicación física del producto (RF-INV-001-04) a las restantes vistas de inventario:
| Vista | Componente | Cambio |
|---|---|---|
| Resumen de inventario | components/inventory/inventory-summary.tsx | Línea de Ubicación por producto (y búsqueda por ubicación) |
| Movimientos (lista) | components/inventory/inventory-movement-list.tsx | Ubicación en cada movimiento |
| Movimientos (detalle) | components/inventory/inventory-movement-detail.tsx | Campo Ubicación del producto |
| Alertas de stock | pages/stock-alerts.tsx | Ubicación por alerta |
Soporte backend adicional:
movimientos-inventario.service.ts: las consultas incluyenproducto.nivel(+ cadena).productos.service.ts/stock-alert.dto.ts: las alertas de stock devuelvenubicacion(ruta formateada).detalle-solicitud.service.ts: el detalle de despacho incluyeproducto.nivel.
🧪 Pruebas unitarias (INV-001)
Se agregaron pruebas unitarias dedicadas (Jest, repositorios mockeados, sin BD):
| Suite | Casos | Cobertura |
|---|---|---|
src/domains/ubicaciones/ubicaciones.service.spec.ts | 17 | Validación de padre al crear (zona/pasillo/estante/nivel) · bloqueo de borrado con dependencias · createReubicacion (producto/nivel inexistente, misma ubicación, camino feliz con historial + evento Socket.io, origen nulo) · getContenido (agregación de stock, ruta resuelta, validación del nodo, consulta por zona) |
src/domains/productos/productos.service.spec.ts | 4 | Ubicación en alertas de stock: ruta formateada, ubicación nula, exclusión por stock, versión paginada |
Resultado: 82 pruebas pasan (6 suites) — npm test.
Antes de esta entrega, INV-001 no tenía pruebas unitarias (las 4 suites existentes cubrían INV-002 y solicitudes).
