Informe de validación del manual y del producto
Fecha de revisión: 24 de agosto de 2026. (Revisión anterior: 22 de julio de 2026.)
Método
La cobertura se obtuvo mediante revisión cruzada de:
- todas las rutas visibles bajo
frontnew/src/app/(main), incluidas las de los módulos verticales ((modules)/butcher-pos/*y(modules)/meat-plant/*); - componentes de formularios, diálogos, atajos, menú y manifiestos de módulos;
- clientes API de
frontnew/src/lib/apiyfrontnew/src/modules/*/lib/api; - rutas registradas por Laravel en
/api/v2, incluidas las de módulos (/api/v2/butcher-pos/*,/api/v2/meat-plant/*); - Form Requests, acciones, servicios, enums, settings y catálogos de permisos de dominio y de módulos;
- migraciones vigentes (núcleo y módulos);
- pruebas unitarias, de integración y E2E incluidas en ambos proyectos.
La página /design se excluye por ser una vitrina interna del sistema visual.
Resultado de las verificaciones ejecutadas (2026-08-24)
| Verificación | Resultado |
|---|---|
| Pruebas backend (Pest, suite completa) | 990 aprobadas de 991 (1 omitida deliberadamente) |
| PHPStan backend | Correcto, 0 errores |
| Pint backend | Correcto |
| Pruebas frontend (Vitest, suite completa) | 286 aprobadas de 286 |
TypeScript frontend (tsc --noEmit) | Correcto, sin errores |
| Enlaces relativos del manual | Correctos (capítulos 1–7, README y este informe) |
Hallazgos de la revisión anterior — estado
- Prueba de navegación desactualizada (
MainNav.test.tsx): resuelta; la suite actual pasa. - Error de tipo en prueba de cuadres: resuelto;
tsctermina sin errores. - Índice técnico de API incompleto (4 rutas de impresión): resuelto; la
prueba de cobertura de
docs/api.mdpasa en la suite actual.
Hallazgos corregidos durante esta revisión: la prueba de la pantalla
Efectivo buscaba los radios Ingreso/Salida previos al rediseño (hoy es un
selector) y el espejo de códigos de error (openapi.yaml ↔ frontend) no incluía
aún los códigos de transformaciones del módulo Carnicería.
Límites de la validación
Las suites verifican reglas, permisos, cálculos, persistencia y contratos con sus dobles de prueba. No se ejecutó una certificación manual contra:
- una cuenta real de DIAN/Soenac;
- una impresora física (tiquetes o etiquetas ZPL) ni un recurso SMB/red;
- básculas físicas (Dibal/Epelsa/Marques): los lectores están cubiertos con archivos de muestra y HTTP simulado; antes de operar en producción debe probarse con un export real de cada marca;
- almacenamiento cloud real (liquidaciones planta ↔ punto de venta);
- datos y credenciales de una empresa de producción;
- concurrencia humana completa en navegadores/dispositivos reales.
Por ello, "validado" significa que el flujo está implementado, contrastado y cubierto por el código y las pruebas disponibles. La aceptación de hardware y proveedores externos debe realizarse en el ambiente de cada instalación.
Cobertura funcional documentada
Núcleo (capítulos 1–4): acceso y contraseña; caja, cierres Z, efectivo y gastos; ventas POS/crédito, precios, pagos, notas, recibos y electrónica; órdenes y conversión; compras, aprobación, notas y egresos; stock, kardex, conteos y merma; terceros, sucursales, productos y todos los catálogos del menú; configuración documental, resoluciones, listas de precios, usuarios, roles y permisos; reportes PDF/Excel y atención de errores.
Módulos (capítulos 5–7): activación por empresa; Carnicería — básculas y escáner del POS, código de peso, tiquetes sin facturar, transformaciones de inventario y liquidaciones PV; Planta — lotes, programaciones, peso planta, traslados, empaque y etiquetas (canastas), despachos y certificado, reingresos, liquidaciones con nube, configuración de planta y reportes.