Saltar al contenido principal

INV-001 — Reubicación de productos y consulta de contenido de ubicaciones

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

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​

RFDescripciónEstado
RF-INV-001-03Registrar movimientos de reubicación y actualizar la posición en tiempo real✅ Implementado
RF-INV-001-04Mostrar la ubicación en consultas de inventario y en el despacho✅ Completado en despacho
RF-INV-001-05Consultar 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:

ColumnaTipoNotas
id_reubicacionSERIAL PKIdentificador
id_productoINTEGERFK → productos ON DELETE RESTRICT
id_nivel_origenINTEGERFK → niveles ON DELETE SET NULL (nullable)
id_nivel_destinoINTEGERFK → niveles ON DELETE RESTRICT
id_usuario_responsableINTEGERFK → usuarios ON DELETE SET NULL (nullable)
fechaTIMESTAMPPor defecto CURRENT_TIMESTAMP
comentariosTEXTOpcional

Dominio ubicaciones​

  • Entidad Reubicacion (entities/reubicacion.entity.ts).
  • UbicacionesService.createReubicacion(): en una transacción valida el producto y el nivel destino, actualiza productos.id_nivel y 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: emite reubicacion-creada y ubicacion-actualizada por Socket.IO en el namespace por defecto.

Endpoints nuevos​

MétodoRutaDescripción
POST/api/reubicacionesRegistra una reubicación (Admin, Almacenista, Auxiliar inventario)
GET/api/reubicaciones?productoId=Historial de reubicaciones
GET/api/reubicaciones/:idDetalle 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 incluyen producto.nivel (+ cadena) para exponer la ubicación del producto en el despacho.

💻 Frontend (ccf-almacen-web)​

  • src/models/ubicacion.entity.ts: tipos IContenidoUbicacion, IContenidoUbicacionProducto, IReubicacion y TipoUbicacionValor.
  • 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-actualizada para refrescar el contenido en tiempo real.
  • components/requests/request-dispatch.tsx: nueva columna Ubicación en la tabla de productos a despachar (usa formatearRutaNivel).

📚 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.md actualizado al esquema real (28 tablas, incluidas multi-almacén, ubicaciones, reubicaciones, lotes/series, transferencias, devoluciones, alertas, notificaciones y logs).

🧪 Verificación​

  • Backend: npm run build sin errores; npm test → 61 tests ✅; ESLint limpio.
  • Migración 006-create-reubicaciones ejecutada correctamente (migration:run).
  • Frontend: npx tsc --noEmit sin 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:

VistaComponenteCambio
Resumen de inventariocomponents/inventory/inventory-summary.tsxLínea de Ubicación por producto (y búsqueda por ubicación)
Movimientos (lista)components/inventory/inventory-movement-list.tsxUbicación en cada movimiento
Movimientos (detalle)components/inventory/inventory-movement-detail.tsxCampo Ubicación del producto
Alertas de stockpages/stock-alerts.tsxUbicación por alerta

Soporte backend adicional:

  • movimientos-inventario.service.ts: las consultas incluyen producto.nivel (+ cadena).
  • productos.service.ts / stock-alert.dto.ts: las alertas de stock devuelven ubicacion (ruta formateada).
  • detalle-solicitud.service.ts: el detalle de despacho incluye producto.nivel.

🧪 Pruebas unitarias (INV-001)​

Se agregaron pruebas unitarias dedicadas (Jest, repositorios mockeados, sin BD):

SuiteCasosCobertura
src/domains/ubicaciones/ubicaciones.service.spec.ts17Validació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.ts4Ubicació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).