Aptli

Cumplimiento de Trabajo

El cumplimiento de trabajo abarca el ciclo de vida completo de las operaciones de campo — desde la planificación de lo que hay que hacer, hasta la asignación de equipos, la autorización de retiro de materiales, la captura del trabajo completado y la verificación de la calidad. El sistema separa la planificación (versionada, compatible con colaboración sin conexión) de la ejecución (en tiempo real, confirmación inmediata para los trabajadores).

Flujo de Trabajo Principal

Tareas (Versionadas) → Órdenes de Trabajo (Tiempo Real) → Reportes (Tiempo Real) → Validaciones (Tiempo Real)
   Planificación              Asignación                     Ejecución               Control de Calidad

Tareas - Fase de Planificación (Versionadas)

  • Los admins diseñan áreas de trabajo sin conexión
  • Definen requisitos de recursos y ubicaciones
  • Operaciones en lote compatibles (rediseño de campaña completa)
  • Flujo de trabajo de versión/commit con capacidad de reversión

Órdenes de Trabajo - Fase de Asignación (Tiempo Real)

  • Asignar tareas a trabajadores con plazos
  • Generar códigos QR de retiro para inventario protegido
  • Confirmación inmediata (sin esperar commits de versión)
  • Flexible: 10 veces más tareas que objetivos para que el trabajador elija

Reportes - Fase de Ejecución (Tiempo Real)

  • Los trabajadores documentan el trabajo completado
  • Se crean automáticamente transacciones de consumo de inventario
  • El cálculo de pago se basa en el trabajo real completado
  • Se admite trabajo ad hoc (no se requiere tarea formal)

Validaciones - Fase de Control de Calidad (Tiempo Real, Mostradas en Reportes)

  • El personal de QC verifica la precisión de los reportes
  • Las validaciones aparecen como insignias en la página de reportes (sin página de lista independiente)
  • Haz clic en una insignia para abrir el modal de validación — ver, editar o crear sin salir del reporte
  • Registra hallazgos (discrepancias de volumen, problemas de calidad)
  • Validación multi-recurso (algunos aprueban, otros fallan)
  • Niveles de severidad: critical, warning, info
  • La cola de supervisores móvil en /m/validations se mantiene

Conceptos Clave

Ejecución en Tiempo Real:

  • Las órdenes de trabajo, reportes y validaciones operan en tiempo real (no versionados)
  • Los trabajadores necesitan confirmación inmediata: "¿Tengo este trabajo?"
  • La cadena de pagos requiere datos confirmados (no se puede esperar al commit de versión del admin)
  • La visibilidad de stock debe ser actual (el siguiente escaneo QR necesita saldo preciso)

Tareas Multi-Recurso:

  • Una sola tarea puede requerir múltiples recursos (reduce el desorden en el mapa)
  • Ejemplo: instalación de puerta = 1 puerta + 12 tornillos + 0,5 L de adhesivo
  • El progreso se calcula como el promedio de todos los recursos

Objetivos de Recursos vs. Reservas:

  • Las órdenes de trabajo muestran Objetivos de Recursos = metas a alcanzar
  • NO son reservas fijas (el inventario no se bloquea)
  • Permite flexibilidad cuando cambian las prioridades
  • La asignación real ocurre en el momento del escaneo QR de retiro

Trabajo Ad-Hoc:

  • Los reportes no requieren tareas formales
  • Vincular una tarea en el reporte es opcional
  • Compatible con mantenimiento no planificado y respuestas a incidencias
  • Igual crea transacciones de consumo y datos de pago

Cálculo de Progreso

Progreso a Nivel de Tarea

Promedio de completación de todos los recursos de la tarea.

Ejemplo:

Tarea A (10 m cable + 10 m excavación):
  Cable: 5 m completados / 10 m = 50%
  Excavación: 0 m completados / 10 m = 0%
  Progreso = (50% + 0%) / 2 = 25%

Progreso a Nivel de Orden de Trabajo

Progreso hacia los objetivos de recursos asignados (no los volúmenes completos de la tarea).

Ejemplo:

Orden de trabajo (10 m cable de Tarea A, 20 m cable de Tarea B):
  Reportado: 5 m de Tarea A, 10 m de Tarea B
  Progreso = (5/10 + 10/20) / 2 = 50%

Regla Clave: Calcular contra la cantidad asignada, no el volumen total de la tarea.

Gestión de Sobre-Entrega

Las contribuciones se limitan al 100% por tarea; la validación verifica la precisión.

Ejemplo:

Orden de trabajo (20 m cable, 40 m excavación):
  Reportado: 10 m cable, 60 m excavación
  Progreso = (10/20 + min(60,40)/40) / 2 = 75%

Consideraciones de Inmutabilidad

Las Órdenes de Trabajo y Reportes Permanecen:

  • Cuando la infraestructura es demolida, las asignaciones/reportes permanecen
  • Proporciona historial de trabajo (qué se hizo, cuándo, por quién)
  • Se admiten soft deletes (retención configurable en ajustes de la app)
  • Derecho admin Ver Eliminados para ver registros con soft delete

Versiones de Tareas Comprimidas:

  • El historial de versiones de tareas se comprime, nunca se elimina
  • Es posible revertir a definiciones de tareas anteriores
  • Detección de conflictos espaciales (geografía superpuesta)

Registro de Auditoría de Transacciones:

  • Las transacciones de consumo de reportes son inmutables
  • No se puede borrar el uso de materiales
  • Las correcciones agregan nuevas transacciones de ajuste

Secciones

  • Proyectos - Agrupar órdenes de trabajo relacionadas; rastrear el progreso a nivel de campaña
  • Tareas - Definir áreas de trabajo con requisitos de recursos
  • Órdenes de Trabajo - Asignar trabajo a usuarios con autorización de inventario
  • Reportes - Documentar el trabajo completado y el consumo
  • Validaciones - Control de calidad gestionado como insignias en la página de reportes