13.1.1 Qué son los Checklists Avanzados

El módulo de Checklists te permite definir protocolos de inspección estandarizados (plantillas) y ejecutarlos en terreno como registros trazables, con folio único, geolocalización, evidencia fotográfica, firma electrónica y generación de PDF corporativo. Los Checklists Avanzados agregan tres capacidades que conviven en la misma pantalla de ejecución: scoring de auditoría, turnos y vínculo a activos.

Antes, una inspección con puntaje ponderado o un relevo de turno se llevaba en planillas Excel paralelas, propensas a errores y difíciles de auditar. IAegis reemplaza esa planilla por un flujo digital de principio a fin: la plantilla define las reglas de puntaje, el operador ejecuta la inspección desde su teléfono, el sistema calcula el cumplimiento en vivo, y el ciclo puede cerrarse con un plan de medidas correctivas verificado y firmado por el SSO.

Las tres capacidades diferenciadoras son:

• Scoring de auditoría: las plantillas pueden agrupar los puntos de control en secciones ponderadas, y cada punto puede tener un tipo de respuesta distinto (Sí/No, numérico, selección única, selección múltiple), su propio peso y una marca de ítem crítico. El sistema calcula un % de cumplimiento por sección y total, y clasifica el resultado en una banda: Excelente, Aceptable, Regular o Crítico.
• Turnos (fases OPEN → CLOSED / IN_FOLLOWUP → RESOLVED): las plantillas con campos de cierre convierten el checklist en un turno abierto. Se abre al inicio del trabajo, se ejecuta, y se cierra más tarde (relevos de turno, entrega de equipo) capturando datos de cierre (por ejemplo, kilometraje final), notas y, opcionalmente, un plan de acción para los hallazgos No OK.
• Vínculo a activo (Reposit): una plantilla puede exigir seleccionar un activo del catálogo (vehículo, maquinaria, etc.), prefillando campos desde sus datos (patente, código, último kilometraje/horómetro) y sincronizando de vuelta las lecturas al activo.

13.1.2 Checklist simple vs. checklist avanzado

13.1.3 Conceptos clave

13.1.4 Encuadre normativo (Chile)

El módulo de Checklists da soporte a varias exigencias de la normativa chilena de seguridad y salud en el trabajo:

Los checklists tienen varios roles: quien los ejecuta, quien cierra el turno, quien completa las medidas y quien verifica el cierre. Cada acción está protegida por un permiso distinto, de modo que solo las personas autorizadas pueden avanzar el ciclo.

13.2.1 Permisos del módulo

13.2.2 Rutas y navegación

La entrada principal está en el menú de Registros: el botón Ejecutar Checklist te lleva al selector de plantillas. Estas son las rutas del módulo:

13.2.3 Requisitos de acceso

• Empresa activa obligatoria: todas las pantallas requieren tener una empresa seleccionada. Sin ella verás el mensaje "Selecciona una empresa" (en admin, referido a "Plantillas de Checklist").
• Sin el permiso de ejecución (y sin ser admin): al entrar al selector verás "Acceso Denegado" / "No tienes permisos para acceder a este módulo."
• Enforcement por contrato: al cerrar y verificar, el sistema controla que actúes sobre el contrato correcto. Es una comprobación de defensa en profundidad; el respaldo final vive en el servidor.

Es la primera pantalla al entrar a /records/checklists. Muestra un grid con las plantillas disponibles de tu empresa activa (ordenadas de la más reciente a la más antigua) para que elijas cuál ejecutar.

Figura 13.1 — Selector de plantillas de checklist: grid de tarjetas "Ejecutar Checklist" con el contador de puntos de control.

El encabezado muestra el título "Ejecutar Checklist" y el subtítulo "Selecciona una plantilla para iniciar". Cada tarjeta de plantilla incluye:

• Un ícono identificador.
• El título de la plantilla.
• La descripción (alcance y objetivos).
• Un contador "N Puntos de Control" con la cantidad de ítems.

Botones y acciones

Estados de la pantalla

El Runner es la pantalla donde ejecutas la inspección: respondes cada punto de control, capturas la ubicación y la evidencia, ves el scoring en vivo y guardas el registro. Se abre al pulsar Iniciar en una plantilla. El título y la descripción de la plantilla encabezan la vista.

Figura 13.2 — Ejecución: pantalla inicial del Runner con la cabecera, el bloque de ubicación vacío y el aviso de geolocalización.

13.4.1 Anatomía de la pantalla

El Runner arma su contenido según cómo esté diseñada la plantilla. Estos bloques aparecen de forma condicional, de arriba hacia abajo:

13.4.2 Ubicación y geolocalización

La Ubicación de la Inspección es obligatoria. Es un campo de solo lectura con un botón para geolocalizar: al pulsarlo, IAegis pide tu ubicación GPS y rellena la latitud y longitud (con 5 decimales) y muestra un mapa.

• Mientras esté vacío, verás el aviso: "La geolocalización es obligatoria. Pulsa el botón para registrar tu ubicación."
• El placeholder del campo es "Pulsa el botón para geolocalizar".
• Si intentas guardar sin ubicación, el sistema lo bloquea (ver validaciones en 13.4.8).

13.4.3 Vínculo a activo y datos de apertura

Si la plantilla exige un activo, el Runner abre automáticamente el modal selector de activo al entrar (si aún no hay uno elegido). También puedes abrirlo con el botón Seleccionar / Cambiar del panel "Activo a inspeccionar". El selector filtra el catálogo Reposit por la categoría que pide la plantilla.

Figura 13.3 — En la plantilla se define la categoría de activo y los campos contextuales de apertura y cierre que luego aparecen en el Runner.

Al elegir un activo, los datos de apertura marcados con "prefillar desde activo" se rellenan automáticamente con sus datos: patente, código, nombre, marca, modelo, último kilometraje o último horómetro. Los campos de apertura pueden ser de cuatro tipos:

13.4.4 Tipos de respuesta por ítem

El corazón del checklist avanzado es que cada punto de control puede responderse de forma distinta. Estos son los cuatro tipos:

Figura 13.4 — Runner con puntos de control de distinto tipo y el panel de cumplimiento calculando en vivo.

13.4.5 Hallazgos No OK y evidencia

Cuando marcas un ítem como No OK (o eliges una opción de bajo puntaje en los otros tipos), aparecen los campos de hallazgo:

Figura 13.5 — Hallazgo No OK: campo "Descripción del Hallazgo" con dictado por voz y botones "Tomar Foto" / "Subir Foto".

13.4.6 Panel de scoring en vivo

Si la plantilla tiene scoring o secciones, el bloque "Cumplimiento de la auditoría" calcula el resultado en tiempo real a medida que respondes:

• Contador: "N OK · N No OK · N N/A · N evaluados (N/A excluido)".
• Porcentaje grande coloreado por banda, o "—" si todavía no evaluaste nada.
• Badge de banda: "Excelente" / "Aceptable" / "Regular" / "Crítico".
• Barras por sección (si la plantilla tiene secciones) con el % de cumplimiento de cada una.

13.4.7 Auto-llenado por foto (OCR IA)

El bloque "Auto-llenar desde foto del checklist en papel" está siempre disponible. Permite subir una foto del checklist físico y que la IA (OCR) detecte las marcas ✓ / ✗ / N-A y autocomplete el status de cada ítem que coincida.

Mientras procesa, el botón muestra "Analizando…" y queda deshabilitado. Si ningún ítem coincide, la IA avisa que la foto no corresponde a este checklist; en ese caso revisa que subiste el documento correcto o completa manualmente.

13.4.8 Guardar: validaciones y fase resultante

Al terminar, tienes dos botones de guardado y uno de cancelar:

Antes de crear el registro, el sistema valida en este orden y muestra el mensaje literal correspondiente si algo falla:

Fase resultante

En /records/checklists/completed encuentras todos los checklists que puedes ver (los propios, o todos si eres admin o tienes VER TODOS LOS REGISTROS), organizados por fase, con buscador y tarjetas de resumen con scoring.

Figura 13.6 — Historial de Checklists: encabezado, chips de fase y tarjetas con badges de banda y contadores.

El encabezado dice "Historial de Checklists" con un contador "N registros". Debajo hay filtros:

Secciones destacadas (con el filtro "Todos")

• Turnos abiertos · N (borde ámbar): "Estos checklists están en estado OPEN y requieren completar los datos de cierre." Lista hasta 5, cada uno con su folio, "abierto el <fecha>" y un botón Cerrar que lleva a la pantalla de cierre.
• En seguimiento · N (borde índigo): "Cerrados con plan de acción abierto. El verificador SSO firma el cierre cuando todas las medidas estén completas." Incluye el enlace "Ver bandeja completa →" hacia la bandeja de seguimiento.

La tarjeta de un checklist

Cada tarjeta muestra: título, folio CHK-XXXX, badge de banda ("Banda · %"), badge de hallazgos ("N Hallazgos"), contadores OK / No OK / N/A, barra de cumplimiento (o el desglose por sección si la plantilla tiene secciones), inspector y fecha. Es expandible para ver ubicación, mapa, hallazgos con sus comentarios y el detalle completo de ítems con su status.

Estados de la pantalla

Cuando un checklist quedó en fase OPEN, hay que cerrarlo. La pantalla de cierre (/records/checklists/:id/close) captura los datos de cierre, los comentarios y, si corresponde, el plan de acción. Requiere el permiso CERRAR TURNO DE CHECKLIST.

Llegas aquí desde el botón Cerrar de la sección "Turnos abiertos" del historial. El encabezado muestra "Cierre de turno" + el título de la plantilla + "Folio <folio> · N hallazgos 'No OK'".

13.6.1 Datos de cierre y comentarios

13.6.2 El plan de acción

Debajo de los datos de cierre está el plan de acción, opcional. Sirve para dejar registradas las medidas correctivas de los hallazgos No OK. El bloque avisa según el caso:

• Con hallazgos: "Hubo N hallazgo(s) 'No OK'. Si agregas medidas, el checklist pasará a Seguimiento (IN_FOLLOWUP)."
• Sin hallazgos: "Sin hallazgos 'No OK'. Si no agregas medidas, el checklist pasará a Cerrado."

Figura 13.7 — Un cierre con plan de acción abre el ciclo de seguimiento: las medidas se gestionan luego desde la bandeja.

El plan se organiza en tres horizontes: Corto plazo, Mediano plazo y Largo plazo. Cada medida nueva nace con una jerarquía sembrada según el horizonte (Administrativo / Ingeniería / Sustitución respectivamente) y en estado PENDING. Los campos de cada medida:

Botones del cierre

El botón principal dice "Cerrar turno" si no hay medidas, y "Cerrar y abrir seguimiento" si hay al menos una.

13.6.3 Cerrar el turno: validaciones

Al pulsar el botón de cierre, el sistema valida y muestra el mensaje literal si algo falla:

Estados especiales de la pantalla

La bandeja (/records/checklists/follow-up) es la vista del supervisor/SSO sobre todos los checklists en fase IN_FOLLOWUP de la empresa activa. Reúne indicadores, permite completar medidas pendientes en línea e ir a verificar. Requiere el permiso VER BANDEJA DE SEGUIMIENTO DE CHECKLISTS.

Figura 13.8 — Bandeja de seguimiento: KPIs y tarjetas de checklists con plan de acción abierto.

El encabezado dice "Seguimiento" / "Checklists en seguimiento" / "Checklists cerrados con plan de acción abierto. Verifica cuando todas las medidas estén completadas."

Indicadores (KPIs)

La tarjeta de seguimiento

Cada tarjeta muestra: badge "Seguimiento", folio, "N medida(s) vencida(s)" si aplica, "Listo para verificar" si aplica, título, activo vinculado, "Cerrado: <fecha>", "N días desde apertura" y "completadas/total medidas completadas".

Cada medida pendiente muestra su descripción y "Vence <fecha> · Resp: <nombre>".

Estados de la pantalla

La verificación (/records/checklists/:id/verify) es el cierre formal del ciclo: el SSO revisa que todas las medidas se ejecutaron, escribe un comentario de cierre técnico y firma digitalmente. Con eso el checklist pasa a RESOLVED. Requiere el permiso VERIFICAR CIERRE DE CHECKLIST.

El encabezado muestra "Verificación de cierre" + el título + "Folio <folio> · N medidas en el plan". Debajo aparece la lista de medidas: cada una con un checkbox, su descripción y "jerarquía · Plazo: <fecha> · Resp: <nombre>". Si una medida está COMPLETED, se ve "Completada por <nombre> · <fecha>" y su comentario de evidencia.

Campos de la verificación (solo cuando todo está marcado)

Botones y validaciones

Mensajes de validación literales al firmar:

• Sin permiso en el contrato: "No tienes permisos para verificar este checklist en su contrato."
• No todas marcadas: "Debes marcar todas las medidas como verificadas antes de firmar."
• Sin comentario: "Ingresa un comentario de cierre técnico."
• Sin firma: "Debes firmar el cierre digitalmente."
• Error de permiso del servidor: "No tienes permisos para verificar este checklist."
• El estado cambió: "No se pudo verificar: el checklist cambió de estado o tiene medidas pendientes. Recarga la página."
• Otro error: "Error al guardar la verificación: <detalle>"

Estados especiales

[Runner: plantilla con campos de cierre]
              |
              v
          OPEN  (turno abierto)
              |
       Cierre de turno (13.6)
        /              \
   sin plan          con plan
      |                  |
      v                  v
   CLOSED           IN_FOLLOWUP
                         |
              responsables completan medidas
              (COMPLETED con evidencia)
                         |
                 Verificación SSO (13.8)
                  firma DS 44 + comentario
                         |
                         v
                     RESOLVED

Las plantillas son el diseño reutilizable de cada inspección. Se gestionan en /admin/checklist-templates y las diseña quien tenga el permiso GESTIONAR PLANTILLAS DE CHECKLIST (típicamente el Tenant Admin). Aquí defines los puntos de control, el scoring, los turnos y el vínculo a activos.

13.9.1 Hub de plantillas

Figura 13.9 — Administración de plantillas: grid de plantillas existentes y botón "Nueva Plantilla".

El encabezado dice "Plantillas de Checklist" / "Formatos de Inspeccion Estandarizada" con el botón Nueva Plantilla. Cada tarjeta muestra el título, la descripción, "N Puntos de Control" y los botones editar (lápiz) y eliminar (papelera).

Estados: sin empresa (pide seleccionarla, "Plantillas de Checklist"); sin permiso ("Acceso Denegado" / "No tienes permisos para gestionar plantillas de checklist." + "Volver"); cargando (spinner + "Cargando plantillas..."); error ("Error" + "Error al cargar las plantillas. Por favor, intenta nuevamente."); vacío (ícono + "Sin Plantillas Definidas" / "Crea tu primera plantilla de checklist").

13.9.2 Editor: Configuración Maestra

El editor encabeza con "Ingeniería de Checklist" (plantilla nueva) o "Refinar Protocolo" (edición) y el subtítulo "Diseño de Matrices Operativas Aegis". Se organiza en módulos.

Figura 13.10 — Editor de plantilla: módulo "Configuración Maestra" y comienzo de la "Arquitectura de Control".

13.9.3 Editor: Arquitectura de Control

Aquí defines los puntos de control (ítems). Es una lista arrastrable: puedes reordenarlos con drag & drop.

Figura 13.11 — Arquitectura de Control: lista de puntos de control con su chip de tipo y acciones.

El botón "Inyectar Punto de Control" agrega un ítem vacío. Si intentas borrar el único ítem, el editor avisa: "Un protocolo debe contener al menos un punto de control."

Panel de configuración por ítem

Figura 13.12 — Configuración avanzada de un punto de control: tipo de respuesta, peso, ítem crítico y escala/opciones.

Nota de selección única: "El puntaje del ítem = score de la opción elegida." Nota de selección múltiple: "El puntaje del ítem = promedio de los score de las opciones marcadas."

13.9.4 Editor: Scoring de Cumplimiento

El módulo de scoring agrupa los puntos de control en secciones ponderadas.

Figura 13.13 — Scoring de Cumplimiento: secciones, pesos y asignación de ítems.

Con el scoring apagado, se muestra: "Activa el scoring para agrupar los puntos de control en secciones y asignarles un peso. Sin scoring, la auditoría se calcula como % plano sobre todos los ítems." Avisos: sección vacía → "Sección vacía · no se guardará"; ítems sin asignar → "N sin asignar".

13.9.5 Editor: Vínculo a Activo y campos contextuales

Figura 13.14 — Vínculo a Activo (Reposit) y campos contextuales de apertura y cierre.

Los campos contextuales se organizan en dos bloques: "Apertura · antes de los ítems" y "Cierre · después de los ítems". Recuerda: si defines campos de cierre, la plantilla se vuelve de turno. Cada campo tiene:

Los botones "Agregar campo de apertura" / "Agregar campo de cierre" y "Quitar" (por campo) gestionan la lista. Al quitar la categoría de activo, los campos contextuales se vacían.

13.9.6 Guardar: validaciones y persistencia

El footer del editor tiene "Abortar Diseño" (cancelar) y "Consolidar Protocolo" (guardar; muestra "Guardando..." mientras persiste). Al guardar, valida:

Caso 1: Inspección con scoring en una sola pasada

1. El operador entra a Registros → Ejecutar Checklist y pulsa Iniciar en la plantilla de scoring.
2. Registra la ubicación con el botón de geolocalización.
3. Responde cada punto según su tipo (OK/No OK/N/A, número, opción única/múltiple).
4. En los hallazgos No OK agrega la descripción y, si puede, una foto.
5. Observa el % y la banda en el panel "Cumplimiento de la auditoría".
6. Pulsa Guardar y Generar PDF. Se crea el registro con folio CHK-XXXX.

Caso 2: Turno de vehículo, de apertura a resolución

1. El operador ejecuta una plantilla con campos de cierre y vincula el vehículo; el kilometraje inicial se prefilla desde el activo. Al guardar queda en fase OPEN.
2. Al terminar el turno, el supervisor entra al historial, sección Turnos abiertos, pulsa Cerrar e ingresa el kilometraje final.
3. Como hubo hallazgos No OK, agrega medidas (o pulsa Generar con IA) y pulsa Cerrar y abrir seguimiento → pasa a IN_FOLLOWUP y notifica a los responsables.
4. Los responsables completan sus medidas subiendo evidencia.
5. El SSO va a Verificar, marca todas las medidas, escribe el comentario de cierre técnico y firma → pasa a RESOLVED.

Caso 3: Diseñar una plantilla avanzada (admin)

1. El Tenant Admin entra a /admin/checklist-templates → Nueva Plantilla.
2. Escribe el título y el alcance; agrega los puntos de control y configura cada uno (tipo, peso, crítico).
3. Activa el Scoring de Cumplimiento, crea secciones (Frenos, EPP, Estructura), asigna ítems y reparte los pesos.
4. Elige la categoría de activo (Vehículo) y define los campos de apertura (km inicial, prefill) y de cierre (km final).
5. Pulsa Consolidar Protocolo. La plantilla queda disponible para ejecutar.

Caso 4: Cargar rápido con la foto del checklist en papel

1. En el Runner, en el bloque "Auto-llenar desde foto del checklist en papel", pulsa Subir foto.
2. Sube una foto (≤8 MB) del checklist físico firmado.
3. La IA detecta las marcas y autocompleta el status de los ítems que coincidan.
4. Revisa cada status autocompletado, corrige lo necesario y guarda.