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:
- Formulario "Nuevo reporte" — Panel superior con todos los filtros y el botón de generación.
- 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
.xlsxque 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):
- El sistema valida que las fechas estén completas. Si no: "Las fechas de inicio y fin son obligatorias".
- Si tipo es Rondas y no hay subtipo: "Selecciona un subtipo de reporte".
- El botón cambia a spinner con texto "Generando... Ns" (contador de segundos transcurridos).
- El servidor procesa el reporte en segundo plano.
- El sistema hace polling cada 3 segundos verificando si el reporte está listo.
- Cuando el nuevo reporte aparece en la lista, el spinner se detiene y la lista se actualiza automáticamente.
- 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 rojoExcel— 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).