Saltar al contenido principal

Release — Conteos Cíclicos de Inventario (INV-005 / INVE-005_1)

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

Se implementa el módulo de Conteos Cíclicos (INV-005 / INVE-005_1), que cierra los cinco requerimientos de la Fase 2 y elimina la simulación de conteo físico del reporte de precisión.


🧮 Nuevo módulo: conteos cíclicos​

  • Programación por calendario: ciclos con periodicidad única, diaria, semanal o mensual. Al cerrar un ciclo periódico, el sistema programa automáticamente el siguiente.
  • Alcance configurable: por producto, por ubicación (nivel) o por almacén completo.
  • Snapshot del sistema: al crear y al iniciar se congela el stock del sistema (stock_almacen) para comparar contra el conteo físico.
  • Ajustes automáticos: las diferencias generan movimientos de tipo ajuste con usuario, fecha y motivo; el stock queda igual a lo contado (el reconteo prevalece).
  • Reconteo por umbral: si la diferencia absoluta supera el umbral configurado, la línea exige reconteo. Umbral resuelto en cascada: ciclo → usuario → global → 5.

🗄️ Base de datos​

  • Nuevas tablas: conteos, detalle_conteo, configuraciones_conteo, configuraciones_conteo_usuario.
  • Migración TypeORM 009-create-conteos.ts (reversible) y SQL portable 018_create_conteos_tables.sql.
  • DATABASE_SCHEMA.md actualizado (32 tablas; sección 14 "Conteos cíclicos").

🔌 API (ccf-almacen-api)​

  • Dominio conteos: entidades, DTOs con class-validator, servicio transaccional, controlador REST y módulo registrado en app.module.ts.
  • Endpoints: POST/GET /api/conteos, GET /api/conteos/:id, PATCH /api/conteos/:id/{iniciar,registrar,recontar,ajustes,cerrar,cancelar} y la configuración de umbral en /api/conteos/configuracion y /api/conteos/configuracion/usuario/me.
  • RBAC por roles (Administrador, Almacenista, Auxiliar inventario, Auditor) + permiso por bodega (INV-002 Fase 4).

🖥️ Frontend (ccf-almacen-web)​

  • Nueva página Conteos cíclicos (/conteos) con listado, filtros por estado y almacén, paginación, diálogo de programación y detalle con registro de conteo y reconteo en línea.
  • Capa de datos: src/api/conteos.ts, src/hooks/use-conteos.ts, src/models/conteo.entity.ts.
  • Entrada de menú en la barra lateral.

📊 Reporte de precisión de inventario​

  • El reporte estadistica/inventory-accuracy dejó de reportar fisico = sistema (precisión 100 % simulada) y ahora se alimenta de la última línea contada de cada producto de los conteos registrados. Las categorías sin conteos conservan el fallback.

🧪 Pruebas​

  • Nuevas pruebas unitarias del servicio de conteos: 18 casos que cubren los cinco requerimientos, las transiciones de estado y la resolución del umbral.
  • Suite completa del backend en verde (136 pruebas, 14 suites).

📚 Documentación​