6.1.1 Qué es el módulo de Visitas a Terreno

El módulo de Visitas a Terreno permite programar, ejecutar y documentar las visitas de supervisión preventiva realizadas a los distintos frentes de trabajo de tu organización.

Cada visita registra:

• Quién realiza la visita (usuario asignado)
• Dónde se realiza (contrato y subnodo destino)
• Cuándo se programó y cuándo se ejecutó realmente
• Qué se hizo durante la visita (registros vinculados)
• Evidencia geográfica del check-in y check-out (coordenadas GPS)
• Firma digital de cierre al finalizar

6.1.2 Conceptos clave

6.1.3 Permisos necesarios

6.1.4 Cómo acceder al módulo de Visitas

El módulo de Visitas es accesible desde la barra de navegación inferior de la aplicación. Busca el icono de ubicación/pin etiquetado como Visitas.

Figura 6.1 - Barra de navegación inferior mostrando el acceso a Visitas (icono de ubicación resaltado).

6.2.1 Vista general de la Agenda

La Agenda de Visitas es la pantalla principal del módulo. La interfaz se divide en dos secciones: el calendario heatmap a la izquierda y el panel de visitas del día a la derecha.

Figura 6.2 - Agenda de Visitas con calendario heatmap y panel de visitas del día seleccionado.

6.2.2 Calendario heatmap

El calendario muestra un mapa de calor de tus visitas. Cada celda puede contener indicadores visuales:

6.2.3 Panel de visitas del día

Al seleccionar una fecha en el calendario, el panel derecho muestra las visitas de ese día con tarjetas informativas que incluyen folio, estado, contrato, subnodo y usuario asignado.

Figura 6.3 - Panel lateral mostrando una visita programada para el día seleccionado.

6.2.4 Modal de detalle rápido

Al hacer clic en una tarjeta de visita, se abre el modal "Visitas del Día" con un resumen y la opción de navegar al detalle completo.

Figura 6.4 - Modal de detalle rápido con información de la visita y botón "Ir al detalle completo".

6.2.5 Filtros avanzados (administradores)

Los administradores ven una barra de filtros con tres selectores: Contrato, Frente de Trabajo y Colaborador. Los filtros se aplican sobre el calendario y el panel lateral.

6.3.1 Acceder al formulario

Puedes programar una nueva visita de tres formas: desde el botón "+ Nueva Visita" en la agenda, desde el botón "Programar" en el panel lateral, o navegando a /visits/new.

6.3.2 Campos del formulario

Figura 6.5 - Formulario para programar una nueva visita a terreno.

6.3.4 Editar una visita programada

Puedes editar una visita si está en estado Programada y la fecha es hoy o futura. Navega al detalle y haz clic en "Editar Visita".

6.4.1 Información de la visita

La página de detalle muestra toda la información organizada en secciones. La tarjeta principal contiene los tiles: Nodo, Subnodo, Fecha programada y Usuario asignado. Si la visita fue programada por una persona distinta del usuario asignado, también se muestra el tile Creada por.

Figura 6.6 - Página de detalle mostrando la información principal y la línea de tiempo.

6.4.2 Línea de tiempo

La sección "Línea de Tiempo" muestra tres pasos del ciclo de vida:

1. Programada - Fecha y hora de creación (siempre completado)
2. Check-in - Momento del registro de llegada (con indicador de método: manual o geo)
3. Check-out - Momento de la finalización (con indicador de método)

Figura 6.7 - Línea de tiempo y botones de acción: Registrar Llegada, Editar Visita, Cancelar Visita.

6.4.3 Registros vinculados

Muestra los registros de seguridad creados durante la visita. Cada registro aparece con su folio, tipo y título, y el encabezado incluye un contador con la cantidad total.

6.4.4 Geolocalización y mapas

Si la visita tiene datos GPS, se muestran mapas interactivos con las ubicaciones de check-in y check-out, incluyendo coordenadas y precisión.

6.4.5 Sección de cierre

Para visitas Completadas: firma digital y botón "Descargar PDF". Para visitas Canceladas: motivo, usuario y fecha de cancelación.

6.5.1 Check-in manual

6.5.2 Check-in y check-out automáticos por geolocalización

Si tu administrador ha configurado geocercas, el sistema detecta automáticamente cuando llegas al sitio y te muestra una notificación ("¿Llegaste a [Subnodo]?"). Al confirmar con "Sí, registrar llegada", el check-in se registra con método geo. Esto funciona en toda la aplicación, no solo en la página de visitas.

La detección también sugiere el check-out: mientras tienes una visita "En Sitio", si el sistema detecta que llevas más de 3 minutos fuera del área de la geocerca, te muestra la notificación "¿Saliste de [Subnodo]?". Al confirmar con "Sí, finalizar", te lleva al detalle para completar el cierre con firma. El check-out automático es una sugerencia: la finalización definitiva siempre pasa por la firma digital.

6.5.3 Cambio de contexto operativo

Al hacer check-in, el sistema cambia automáticamente tu contexto operativo al contrato y subnodo de la visita. Los registros que crees se vincularán automáticamente.

La vinculación de registros es la función que conecta las actividades de seguridad que documentas en terreno (observaciones, capacitaciones, charlas, etc.) con la visita en la que se realizaron. Es una pieza central del módulo: gracias a ella cada visita queda respaldada con evidencia concreta de la gestión preventiva ejecutada.

6.6.1 Qué significa vincular un registro

Vincular un registro significa asociarlo de forma permanente a una visita. Cuando un registro queda vinculado:

• Aparece en la sección "Registros Vinculados" del detalle de la visita (ver sección 6.4.3), con su folio, tipo y título.
• El contador de registros de la visita aumenta en uno.
• El registro pasa a formar parte de la evidencia de esa visita: se incluye en el informe PDF de cierre y se contabiliza en las métricas del Dashboard (registros por visita, visitas sin registros, etc.).

En la práctica, un registro vinculado responde a la pregunta "qué se hizo durante esta visita". Una visita sin registros vinculados es una visita sin evidencia documentada.

6.6.2 Cómo y cuándo se vincula un registro

La vinculación es automática. No existe un botón de "vincular" que debas pulsar manualmente: el sistema enlaza los registros por ti cuando se cumplen estas condiciones:

1. Tienes una visita en estado En Sitio (es decir, ya hiciste check-in y la visita está activa).
2. Creas un registro de seguridad mientras esa visita está activa.
3. El registro pertenece al mismo contrato y subnodo que la visita.

Si las tres condiciones se cumplen, al guardar el registro este se vincula automáticamente a la visita activa y aparece de inmediato en la sección "Registros Vinculados".

6.6.3 Tipos de registro que se pueden vincular

Los siguientes tipos de registro se vinculan automáticamente a la visita activa cuando coinciden el contrato y el subnodo:

Cualquiera de estos registros sirve para cumplir el requisito de "al menos un registro vinculado" necesario para finalizar la visita.

6.6.4 Desvincular un registro

En caso de que un registro se haya asociado por error a una visita, es posible desvincularlo. Al igual que la vinculación, la desvinculación solo opera mientras la visita está En Sitio.

• Si la visita sigue En Sitio, un registro puede quitarse de la lista de registros vinculados y dejará de contar como evidencia de esa visita.
• Una vez que la visita pasa a Completada, Cancelada o Vencida, los registros vinculados ya no se pueden desvincular.

6.6.5 Registros congelados como evidencia

Cuando finalizas una visita (check-out) o esta cambia a un estado terminal (Completada, Cancelada o Vencida), los registros vinculados quedan congelados como evidencia:

• Ya no se pueden vincular nuevos registros a esa visita.
• Ya no se pueden desvincular los registros existentes.
• La lista de registros vinculados se conserva tal cual quedó al momento del cierre y se refleja en el informe PDF de cierre.

Este congelamiento garantiza la trazabilidad e integridad de la visita: lo que quedó documentado al cerrar es lo que constará para siempre como gestión realizada en terreno.

6.7.1 Proceso de finalización

6.7.2 Firma digital de cierre

Al hacer clic en "Finalizar Visita" se abre un modal con un área de dibujo donde debes trazar tu firma (con el dedo en móvil o el ratón en escritorio), un texto declarativo y los botones Limpiar y Guardar.

6.7.3 Generación automática de PDF

Al completar la finalización, se genera automáticamente un informe PDF con todos los datos de la visita, registros vinculados, firma digital y coordenadas GPS. El PDF queda disponible en la sección de cierre del detalle.

6.8 Cancelar una visita

Puedes cancelar visitas en estado Programada o En Sitio si tienes el permiso CANCELAR VISITAS. Haz clic en "Cancelar Visita", ingresa el motivo (mínimo 10 caracteres) y confirma.

6.9 Estados de una visita

Flujo de estados

6.10 Banner de visita activa

Cuando tienes una visita En Sitio, aparece un banner verde en la parte superior de todas las paginas mostrando: indicador pulsante, nombre del contrato/subnodo, cronómetro en tiempo real y botón "Ver detalle".

6.11.1 Acceder al Dashboard

Desde la Agenda de Visitas, haz clic en el botón "Dashboard" (visible solo para administradores). El selector de periodo permite filtrar por rango temporal.

Figura 6.8 - Dashboard de visitas con KPIs ejecutivos y selector de periodo.

6.11.2 KPIs ejecutivos

6.11.3 Tendencia semanal y distribución por estado

Figura 6.9 - Tendencia semanal (barras apiladas) y distribución por estado (donut).

6.11.4 Ranking por contrato y productividad por usuario

Dos tablas comparativas: Top 8 contratos por volumen y productividad por usuario (visitas completadas, registros, tiempo total).

6.11.5 Indicadores operacionales

Figura 6.10 - Indicadores: visitas sin registros, puntualidad, cancelaciones y cobertura.

6.11.6 Composición y métodos

Figura 6.11 - Registros por tipo, método de check-in y cobertura por subcontrato.

6.11.7 Drill-down interactivo

Todas las tarjetas y gráficos son interactivas. Haz clic en cualquier elemento para abrir un modal drill-down con la lista detallada de visitas correspondientes.

Visitas diarias mínimas

Plazo de programación