Saltar al contenido principal

Imagen del producto en el listado y el detalle de movimientos

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

Cada movimiento de inventario decía qué producto se movió, pero solo con texto. Para reconocerlo de un vistazo —y para que el histórico coincida con lo que el usuario vio en el catálogo— el listado de «Movimientos de Inventario» y su panel de detalle ahora muestran la imagen principal del producto tal como está asignada en el catálogo.

Qué cambió​

  • Fila del listado: la imagen del producto ocupa el lugar que antes tenía el icono suelto del tipo de movimiento. El icono sigue visible como distintivo sobre la esquina inferior derecha de la imagen, con el color del tipo (verde entrada, rojo salida, azul ajuste, violeta transferencia, naranja devolución, ámbar dañado/vencido); al lado se mantiene la insignia con el nombre del tipo, así que el color nunca informa solo.
  • Panel «Detalle del Movimiento»: la imagen aparece junto al bloque «Información del Producto», encabezando nombre, SKU, unidad de medida, stock y ubicación.
  • Sin foto o foto rota: el avatar cae primero al marcador del sistema (uploads/productos/not-image.png) y, si tampoco carga, al icono de paquete. No queda nunca un hueco roto.

Cómo se compone​

  • Fuente de la imagen: productos.imagen, la misma columna que pinta el catálogo. El listado de movimientos ya la traía: la consulta del API hace leftJoinAndSelect('movimiento.producto', 'producto') y la página la mapea al modelo Producto. Por eso no hubo cambios en el backend.
  • Resolución de la ruta: utils/producto-imagen.ts (urlImagenProducto), que ya era la única implementación de esa regla (acepta nombre suelto, uploads/…, ruta absoluta y rutas con \ de Windows).
  • Componente nuevo: components/inventory/producto-avatar.tsx, con tamaños sm (40 px, filas del listado) y lg (80 px, detalle), borde y fondo por tokens del sistema y texto alternativo «Imagen de {producto}». Queda documentado en design.md.

Archivos clave​

CapaArchivo
Avatar del producto (nuevo)ccf-almacen-web/src/components/inventory/producto-avatar.tsx
Fila del listadoccf-almacen-web/src/components/inventory/inventory-movement-list.tsx
Panel de detalleccf-almacen-web/src/components/inventory/inventory-movement-detail.tsx
Guion del tour de la pantallaccf-almacen-web/src/config/tours.ts
Sistema visualccf-almacen-web/design.md
Manual de usuariodocs/manuales/inventarios/movimientos-inventario.md

Verificación​

  • npx tsc --noEmit sin errores.
  • Suite completa de la web: 176 suites / 1658 pruebas en verde, incluidas las nuevas pruebas del avatar (resolución de ruta, marcador y caída al icono) y las de integración del listado y el detalle.
  • next lint sin avisos en los archivos tocados.
  • Revisado en Chromium a 1440 px y a 390 px (claro): la imagen no desborda, el distintivo del tipo no tapa el nombre y el detalle conserva sus campos.