Validaciones

Las validaciones son el paso de control de calidad después de que se envía un reporte. En la versión actual, las validaciones ya no son una página independiente — aparecen junto al reporte al que aplican, mostradas como una insignia de semáforo en la lista de reportes y como una fila de insignias agrupadas por estado en la vista expandida del reporte.

Un supervisor o inspector de QC abre un reporte, hace clic en una insignia de validación para ver o crear una validación en un modal superpuesto, verifica medidas y calidad de instalación, y registra hallazgos contra las líneas específicas del reporte. Cada hallazgo tiene un nivel de severidad (critical, warning, info) y el estado general de la validación determina si se libera el pago o si el trabajador necesita corregir su trabajo.

Dónde Viven las Validaciones

Lista de reportes: Cada fila de reporte muestra una insignia de validación agregada (gris/roja/amarilla/verde) en su propia columna. La insignia muestra el estado más grave con un conteo — por ejemplo, FAILED · 3 si hay tres validaciones fallidas en ese reporte. Al pasar el cursor sobre la insignia se muestra un desglose por estado, como failed: 1, passed: 2.

Reporte expandido: Al abrir un reporte en la lista se muestra una fila de insignias de validación agrupadas por estado. Hacer clic en cualquier insignia abre el ValidationEditModal — un overlay completo para ver, editar o crear una validación sin salir del reporte.

Móvil: La cola de supervisores móvil en /m/validations no ha cambiado. Los validadores móviles continúan trabajando con las validaciones asignadas desde una lista dedicada.

Vista de impresión: La página independiente /fulfillment/validations/:id se mantiene como vista exclusiva para impresión. El modal tiene un botón Imprimir en su encabezado que abre la página de impresión en una pestaña nueva. Los enlaces directos desde marcadores antiguos siguen funcionando.

Abrir una Validación

Desde la lista de reportes:

Encuentra el reporte que deseas validar
Haz clic en la insignia de validación en la fila del reporte (o expande la fila para ver las insignias agrupadas por estado)
El ValidationEditModal se abre sobre la página
Visualiza la validación existente, o haz clic en Crear validación si no existe ninguna
Registra hallazgos, sube fotos, establece el estado y guarda

Restricciones de acceso:

Ver validaciones no requiere ningún permiso especial
Crear requiere el derecho admin validationsCreate
Editar requiere el derecho admin validationsUpdate

Envío Unificado (Reporte + Validación Juntos)

El rediseño unifica la edición del reporte y sus validaciones. Cuando tienes el reporte y una validación abiertos, el botón Enviar guarda todos los cambios juntos — las ediciones del reporte y las de la validación se confirman en un solo paso. No es necesario guardar las validaciones por separado del reporte.

Estructura de Validación

Campos Principales:

Reporte - Referencia al reporte validado (se establece automáticamente al abrir desde el reporte)
Validador - Usuario que realizó la verificación de QC
Estado - pass, fail, needs-revision, approved-with-notes
Fecha de Validación - Cuándo se realizó el QC
Notas Generales - Observaciones generales, resumen

Hallazgos Detallados:

Hallazgos - Array de problemas específicos encontrados
Fotos - Documentación de problemas de calidad
Acciones Recomendadas - Tareas de seguimiento, correcciones necesarias

Estructura de Hallazgos

Cada hallazgo en una validación apunta a una línea específica de la lista de Trabajo Completado del reporte. Los hallazgos incluyen:

Qué ítem de trabajo tiene el problema (por posición en la lista de trabajo completado)
Tipo de problema — la categoría del problema (p. ej., discrepancia de volumen, problema de calidad)
Severidad — critical, warning o info
Descripción — explicación en lenguaje llano del problema

Ejemplo: Un reporte registra Cable Cat6 (45 m), Cajas de Conexión (8 unidades) y Trabajo de Electricista (3,5 horas). La validación detecta una discrepancia de volumen en el cable (42 m medidos físicamente vs. 45 m reportados, severidad: warning) y un problema de calidad critical en dos cajas de conexión incorrectamente instaladas.

Puntos Clave:

Cada hallazgo referencia una línea específica, por lo que los validadores pueden aprobar algunos trabajos y marcar otros en el mismo reporte
Se pueden agregar múltiples hallazgos por reporte
Las notas detalladas preservan el contexto para la revisión del trabajador

Estado de Validación

pass - El trabajo cumple los estándares de calidad

Todas las medidas son precisas
Instalación según especificaciones
Materiales correctamente documentados

fail - El trabajo no cumple los estándares

Problemas de calidad críticos
Discrepancias de medición significativas
Requiere retrabajo

needs-revision - Problemas menores, se necesitan correcciones

Pequeñas diferencias de medición (dentro de la tolerancia)
Documentación incompleta
Se necesitan fotos

approved-with-notes - Aceptable con observaciones

El trabajo cumple los estándares mínimos
Problemas registrados para seguimiento
Patrones a abordar en capacitación

Tipos de Problema

volume_mismatch - El volumen reportado no coincide con la medición física

Ejemplo: El reporte indica 50 m de cable, la medición muestra 45 m
Severidad: warning (diferencia pequeña) o critical (discrepancia grande)

quality_issue - La instalación no cumple los estándares

Ejemplo: Montaje incorrecto, falta de impermeabilización, daños
Severidad: critical (riesgo de seguridad) o warning (cosmético)

documentation_incomplete - Falta información requerida

Ejemplo: Sin fotos, descripción vaga, certificaciones faltantes
Severidad: info (menor) o warning (requisito regulatorio)

location_discrepancy - Trabajo realizado en ubicación incorrecta

Ejemplo: La geometría del reporte no coincide con la geometría de la tarea
Severidad: critical (sitio completamente incorrecto) o warning (ligeramente desplazado)

consumption_mismatch - Los materiales consumidos no se alinean con el trabajo completado

Ejemplo: Se reportaron 50 m de trabajo con cable, pero se consumieron 80 m del stock
Severidad: warning (investigar desperdicio/robo)

safety_violation - Se observaron prácticas inseguras

Ejemplo: Falta de equipo de seguridad, procedimientos incorrectos
Severidad: critical (siempre)

Niveles de Severidad

critical - Requiere corrección inmediata, trabajo no aceptable

Infracciones de seguridad
Defectos de calidad graves
Errores de medición significativos
Impacto financiero > umbral

warning - Requiere atención, pero el trabajo es marginalmente aceptable

Problemas de calidad menores
Pequeñas discrepancias de medición
Brechas de documentación
Oportunidades de capacitación

info - Registrado para seguimiento, no se requiere acción inmediata

Sugerencias de mejores prácticas
Mejoras de eficiencia
Observaciones informativas

Creando Validaciones

Acceso Requerido: derecho admin validationsCreate

Flujo de Trabajo:

Navegar a Cumplimiento → Reportes
Abrir (o expandir) el reporte que deseas validar
Hacer clic en una insignia de validación para abrir el ValidationEditModal, o hacer clic en Crear validación si no existe ninguna
Revisar el trabajo completado contra el sitio físico
Para cada recurso en trabajo completado:
- Verificar medidas
- Verificar calidad de la instalación
- Documentar cualquier problema en los hallazgos
Subir fotos de problemas de calidad
Establecer el estado general (pass/fail/needs-revision/approved-with-notes)
Agregar notas generales (resumen)
Hacer clic en Enviar para guardar las ediciones del reporte y la validación juntas

Validación en Campo: Flujo del validador móvil (/m/validations):

Verificación GPS (¿estás en el sitio?)
Integración de cámara para fotos de problemas de calidad
Voz a texto para descripciones
Modo sin conexión (enviar al volver en línea)

Flujo de Trabajo de Validación

Proceso Típico:

Reporte Enviado - El trabajador completa el reporte
Insignia Visible - La lista de reportes muestra una insignia gris "sin validación" para los reportes sin validaciones
Validador Abre Reporte - Hace clic en la insignia, abre el modal
Visita al Sitio - El validador visita la ubicación (o revisa en base a fotos y datos)
Mediciones - Verificación física del trabajo
Fotos - Documentar calidad (buena o mala)
Hallazgos - Registrar cualquier discrepancia dentro del modal
Estado - Establecer pass/fail/needs-revision en la validación
Enviar - Guarda reporte y validación de forma atómica
Seguimiento - Si es needs-revision, el trabajador aborda los problemas
Re-Validación - Volver a abrir la insignia, agregar hallazgos a la validación existente o crear una nueva
Aprobación Final - Reporte aprobado, pago liberado

Filtrar Reportes por Estado de Validación

Dado que las validaciones ahora viven en la página de reportes, la lista de reportes acepta un filtro de estado de validación:

all — todos los reportes (por defecto)
none — reportes sin ninguna validación (necesitan atención de QC)
any — reportes con al menos una validación
failed — reportes con al menos una validación fallida
revision — reportes con al menos una validación needs-revision
passed — reportes donde todas las validaciones aprueban

Los filtros personalizados siguen aplicando:

Validador (quién realizó el QC)
Rango de fecha
Severidad (solo hallazgos critical)
Tipo de problema (volume_mismatch, quality_issue, etc.)

Integración de Pagos

Las validaciones controlan la liberación del pago:

Retención de Pago:

Reportes con estado fail → pago retenido
Reportes con needs-revision → pago parcial (configurable)
Reportes con approved-with-notes → pago completo, notas registradas

Liberación de Pago:

Reporte enviado
Validación realizada mediante la insignia/modal
Si pass o approved-with-notes → pago liberado
Si needs-revision → pago parcial, se requiere re-validación
Si fail → sin pago, se requiere retrabajo

Protección Financiera:

Previene el pago por trabajo de baja calidad
Incentiva la calidad
Registro de auditoría para decisiones de pago

Analíticas de Validación

Rastrea tendencias de calidad a lo largo del tiempo:

Por Trabajador:

Tasa de aprobación por trabajador
Tipos de problemas comunes
Tendencias de mejora
Identificación de necesidades de capacitación

Por Tipo de Tarea:

Qué tareas tienen mayor tasa de fallo
Problemas de calidad específicos por recurso (cable vs. labor vs. equipo)
Precisión de estimación (las discrepancias de volumen indican estimaciones deficientes)

Por Validador:

Verificaciones de consistencia (¿un validador es demasiado estricto/laxo?)
Tiempo de respuesta de validación
Distribución de severidad de hallazgos

Mejores Prácticas

Validación Oportuna:

Usa el filtro none de la lista de reportes para encontrar reportes que esperan QC
Validar dentro de las 24-48 horas del envío del reporte
Evidencia fresca (materiales aún visibles, el trabajador todavía recuerda)
Pago más rápido a los trabajadores

Hallazgos Específicos:

Referencia la línea específica de trabajo completado por posición (el primer ítem, el segundo ítem, etc.) para que los hallazgos sean accionables
Las descripciones detalladas ayudan al trabajador a entender el problema
Las fotos proporcionan evidencia indiscutible

Retroalimentación Constructiva:

Enmarca como oportunidad de capacitación
Explica por qué importa el problema (seguridad, estándares, costo)
Ofrece sugerencias de mejora

Estándares Consistentes:

Aplica los mismos criterios a todos los trabajadores
Documenta los estándares de calidad claramente
Calibración regular de validadores (asegurar consistencia)

Usar la Vista de Impresión para Copias en Papel:

Abre el ValidationEditModal en una validación existente
Haz clic en el botón Imprimir en el encabezado del modal
La página de impresión se abre en una pestaña nueva, lista para papel o exportación PDF

Inmutabilidad de Validaciones

Soft Deletes: Las validaciones pueden marcarse como eliminadas pero permanecen en la base de datos:

Preserva el historial de QC
Mantiene el registro de auditoría de pagos
Período de retención configurable
Derecho admin viewDeleted para ver validaciones eliminadas

Restricciones de Edición: Después de que se libera el pago:

Las validaciones se vuelven de solo lectura (el modal es solo de vista)
Las correcciones requieren una nueva validación con notas
Preserva la integridad financiera
El historial de versiones rastrea todos los cambios antes de la finalización