Release — Conteos Cíclicos de Inventario (INV-005 / INVE-005_1)
· 2 min de lectura
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
ajustecon 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 portable018_create_conteos_tables.sql. DATABASE_SCHEMA.mdactualizado (32 tablas; sección 14 "Conteos cíclicos").
🔌 API (ccf-almacen-api)
- Dominio
conteos: entidades, DTOs conclass-validator, servicio transaccional, controlador REST y módulo registrado enapp.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/configuraciony/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-accuracydejó de reportarfisico = 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
- Manual de usuario: Conteos Cíclicos.
- Documento funcional: INV-005 / INVE-005_1: Conteos Cíclicos.
- Backlog actualizado (requerimientos marcados como cumplidos).
