Saltar a contenido

Reportes

¿Qué es?

El módulo de Reportes genera y descarga documentos de análisis en PDF o Excel. Los reportes se generan en segundo plano en el servidor y quedan disponibles en la lista de reportes del usuario hasta que los elimine. Actualmente soporta dos categorías principales: Rondas (actividad de guardias en puntos de control) y Minuta de Novedades (registros del logbook/bitácora).

Este módulo trabaja con plantillas fijas. Si necesitas un reporte personalizado o dinámico —cualquier consulta sobre empleados, contratos, asistencia, novedades u otros datos, descrita con tus palabras— usa Reportes Noha, el generador de reportes con inteligencia artificial.


Vista principal

La página está dividida en dos secciones:

  1. Formulario "Nuevo reporte" — Panel superior con todos los filtros y el botón de generación.
  2. Lista "Reportes generados" — Tabla inferior con los reportes ya creados por el usuario.

Formulario de nuevo reporte

Campo: Tipo

Selector que determina la categoría del reporte:

Valor Descripción
rondas Rondas — actividad de guardias en puntos NFC/QR
minuta_novedades Minuta de Novedades — registros del logbook
rondas_supervisor Rondas de Supervisor — Cobertura (puestos visitados) y Trayectoria (puntos GPS)
registro_asistencia Registro de Asistencia
estado_cliente Estado del Cliente
cuestionarios Cuestionarios — Detallado o Resumen

Al cambiar el tipo, el campo Subtipo se reinicia al primer subtipo disponible.

El selector solo muestra los tipos y subtipos que el rol del usuario tiene habilitados (ver Reportes habilitados por rol). Si el rol no tiene ninguno, aparece «Tu rol no tiene reportes habilitados.»

Campo: Subtipo

Depende del Tipo seleccionado:

Subtipos de Rondas:

Valor Etiqueta
reporte_general Reporte General
marcacion_por_empleado Marcación por Empleado
puntos_marcados Puntos Marcados
turnos_sin_marcar_empleado Turnos Sin Marcar
cumplimiento_programa Cumplimiento de Programa
tag_sin_asignacion Tag Sin Asignación de Turno
marcaciones_sospechosas Marcaciones Sospechosas (ubicación)

Subtipos de Minuta de Novedades:

Valor Etiqueta
all Todas
GENERAL General
VEHICLE_ACCESS Acceso Vehicular
VEHICLE_NEWS Novedades Vehiculares
VEHICLE_CHECK Inspección Vehicular
VISITOR Visitantes
CORRESPONDENCE Correspondencia
HANDOVER Entrega de Turno

Campo: Formato

Selector de formato de salida con dos botones tipo toggle:

  • PDF — Genera un documento PDF que se puede visualizar en el navegador.
  • Excel — Genera un archivo .xlsx que se descarga directamente.

Campos de fecha (obligatorios)

  • Fecha inicio — Selector DD/MM/AAAA. Por defecto: hace 30 días.
  • Fecha fin — Selector DD/MM/AAAA. Por defecto: hoy.

El sistema envía el rango como startDate + " 00:00:00" y endDate + " 23:59:59".

Campo: Agrupar por

Solo visible cuando el tipo es Rondas y el subtipo es Reporte General:

Valor Descripción
none Sin agrupación
point Agrupar por punto de control
guard Agrupar por guardia

Campos opcionales de filtro

  • Zona — Autocompletado de zonas. Al seleccionar una zona, filtra los proyectos disponibles. Se puede limpiar con el botón X.
  • Proyecto — Autocompletado de proyectos. Filtra por zona si se seleccionó. Se puede limpiar con botón X.
  • Empleado — Autocompletado de empleados. Solo visible cuando:
  • Tipo = Rondas + Subtipo = "Cumplimiento de Programa", o
  • Tipo = Minuta de Novedades (cualquier subtipo).

Filtros adicionales para Minuta de Novedades

Estos campos aparecen según el subtipo seleccionado:

Campo Visible cuando Descripción
Asunto (logbookSubject) Tipo General o Todas Texto libre para filtrar por asunto de la minuta
Placa (logbookPlate) Tipos vehiculares o Todas Número de placa del vehículo
Edificio / Unidad (logbookBuilding) Tipos vehiculares, Visitantes, Correspondencia o Todas Nombre del edificio o unidad
Documento visitante (logbookVisitorDoc) Visitantes o Todas Número de documento del visitante

Generación del reporte

Al hacer clic en "Generar reporte" (requiere permiso reports: create):

  1. El sistema valida que las fechas estén completas. Si no: "Las fechas de inicio y fin son obligatorias".
  2. Si tipo es Rondas y no hay subtipo: "Selecciona un subtipo de reporte".
  3. El botón cambia a spinner con texto "Generando... Ns" (contador de segundos transcurridos).
  4. El servidor procesa el reporte en segundo plano.
  5. El sistema hace polling cada 3 segundos verificando si el reporte está listo.
  6. Cuando el nuevo reporte aparece en la lista, el spinner se detiene y la lista se actualiza automáticamente.
  7. Tiempo máximo de espera: 5 minutos. Si se supera: "El reporte está tardando demasiado. Intenta refrescar la lista manualmente."

Errores posibles durante generación

  • "Ya hay un reporte en proceso" — Solo puede haber un reporte generándose por usuario a la vez. Muestra el tipo y subtipo del reporte en curso.
  • "No se encontraron datos para los filtros seleccionados" — No hay datos en el rango de fechas con los filtros aplicados.
  • "No se pudo conectar con el servidor" — Error de red.

Durante la generación aparece el mensaje: "Procesando en segundo plano — la lista se actualizará automáticamente".


Lista de reportes generados

Columnas de la tabla

  • Reporte — Nombre del archivo (o nombre personalizado) en la primera línea. Debajo, etiqueta del tipo y subtipo en formato "Rondas · Reporte General" o "Minuta · Visitantes".
  • Formato — Badge:
  • PDF — Badge rojo
  • Excel — Badge verde
  • Fecha — Fecha y hora de generación en formato AAAA-MM-DD HH:MM.
  • Acciones — Botones por fila:
  • Ver (solo PDF) — Abre el PDF en una nueva pestaña del navegador.
  • Descargar (PDF con permiso reports: export, o Excel siempre) — Descarga el archivo.
  • Renombrar — Le pone un nombre propio al reporte (vacío vuelve al nombre original).
  • Eliminar (requiere reports: delete) — Confirmación con diálogo. Elimina el reporte permanentemente. No se puede deshacer.

La lista muestra únicamente los reportes que generó el usuario que está conectado (ver Cada usuario ve solo sus reportes generados).

Barra de herramientas de la lista

  • Buscar reporte... — Búsqueda en tiempo real por nombre de archivo y etiqueta del tipo.
  • Refrescar — Recarga la lista manualmente desde el servidor.

Paginación

15 reportes por página. Paginación con números de página, botones anterior/siguiente y resumen "Mostrando X a Y de Z reportes".


Reportes habilitados por rol

En Reportes, cada usuario solo puede generar los tipos y subtipos de reporte que su rol tiene habilitados. El portal y la app ofrecen únicamente esos en el selector, y el servidor lo vuelve a comprobar al generar: aunque alguien intente pedir un reporte no habilitado, se rechaza.

Se configura en Portal › Administración → Roles y permisos → rol → fila Reportes → Configurar reportes (n de m). Por defecto el personal tiene todos y el rol Cliente solo los que describen su servicio; la minuta, las marcaciones sospechosas y la trayectoria GPS nacen apagadas para clientes, a propósito. Minuta «Todas» solo aparece si el rol tiene habilitados todos los tipos de minuta. Más detalle en Roles y permisos.


Cada usuario ve solo sus reportes generados

En Reportes, la lista «Reportes generados» es personal: cada usuario ve, descarga, renombra y borra solo los reportes que generó él. Un reporte generado por otro usuario, aunque sea del mismo rol o un administrador, no aparece en tu lista. Si necesitas el mismo reporte, genéralo tú con los mismos filtros.


Reportes para clientes (por contrato)

En el portal de clientes, el cliente también tiene Reportes operativos, pero siempre sobre uno de sus contratos: el campo Proyecto se llama Contrato y lista solo los suyos, y no hay filtros de zona ni de empleado. Si intenta generar sin elegir contrato, dice «Elige el contrato para generar el reporte». El reporte sale solo con los puestos de ese contrato.

El cliente ve únicamente los reportes que la empresa le habilitó al rol Cliente. Las Rondas de Supervisor nunca le aparecen, a propósito: recorren los puestos del supervisor, no los del contrato.


Permisos

Acción Permiso requerido
Ver la página reports: view
Generar reporte reports: create
Descargar PDF reports: export
Eliminar reporte reports: delete

Páginas relacionadas

  • Monitor en vivo — El monitor muestra actividad de guardias en tiempo real; los reportes de Rondas son el historial de esa actividad.
  • Minutas (Logbook) — Los reportes de Minuta de Novedades se generan a partir de los registros del logbook.
  • Turnos y horarios — El subtipo "Cumplimiento de Programa" cruza las rondas con la programación de turnos.
  • Zonas y Proyectos — Los filtros de zona y proyecto en Reportes determinan el alcance del análisis.

Preguntas frecuentes

¿Cuánto tiempo tarda en generarse un reporte? Depende del volumen de datos y el rango de fechas. Reportes de pocos días tardan segundos; reportes de meses o con muchos empleados pueden tardar varios minutos. El contador de segundos muestra el tiempo transcurrido.

¿Puedo generar dos reportes al mismo tiempo? No. Solo puede procesarse un reporte a la vez por usuario. Si intentas generar uno mientras otro está en proceso, el sistema muestra el mensaje "Ya hay un reporte en proceso".

¿Los reportes generados son visibles para otros usuarios? No. Cada usuario ve, descarga, renombra y borra únicamente los reportes que generó él. Ver Cada usuario ve solo sus reportes generados.

¿Por qué aparece "No se encontraron datos"? El rango de fechas o los filtros aplicados no tienen datos en el sistema. Verifica que el proyecto, zona o empleado seleccionado tenga registros en ese periodo.

¿Los reportes tienen vencimiento o se eliminan automáticamente? No hay vencimiento automático visible desde el portal. Los reportes permanecen hasta que el usuario los elimina manualmente con el botón "Eliminar" de cada fila.

¿Puedo ver un reporte de Excel en el navegador? No directamente. Los archivos Excel se descargan automáticamente. Solo los PDFs se abren en una nueva pestaña del navegador.

¿El reporte de "Cumplimiento de Programa" cruza con los turnos asignados? Sí. Este subtipo de Rondas compara los puntos marcados por el guardia con los puntos esperados según la programación de turnos, calculando el porcentaje de cumplimiento.

¿Puedo filtrar la Minuta de Novedades por placa y visitante al mismo tiempo? Sí. Al seleccionar subtipo "Todas", todos los campos de filtro adicionales (Asunto, Placa, Edificio, Documento visitante) aparecen simultáneamente y se aplican en conjunto.

¿Por qué no me aparece un tipo de reporte en el selector? Tu rol no lo tiene habilitado. Un administrador lo puede prender en Roles y permisos → fila Reportes → «Configurar reportes». Ver Reportes habilitados por rol.

¿Por qué dice «Tu rol no tiene reportes habilitados»? El rol del usuario no tiene ningún reporte encendido. Pide a un administrador que los configure en Roles y permisos.

¿Por qué no veo el reporte que generó mi compañero? Porque la lista de reportes generados es personal: cada quien ve solo los suyos. Genera el reporte tú con los mismos filtros.

¿Cómo le cambio el nombre a un reporte? En la lista «Reportes generados», usa Renombrar en la fila. Si dejas el nombre vacío, vuelve al nombre original.

¿Mis clientes pueden generar reportes? Sí, desde su portal, en Reportes → Reportes operativos, siempre sobre uno de sus contratos y solo con los reportes habilitados para el rol Cliente. Ver Reportes para clientes (por contrato).