El Gestor de Visitas del Túnel Subfluvial es la plataforma operativa que permite al personal registrar y gestionar visitas grupales de manera eficiente. Desde el agendamiento de una nueva visita hasta la generación de reportes gerenciales en PDF, el sistema centraliza toda la operación en una interfaz clara y segura.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/JuanM84/gestor-visitas/llms.txt
Use this file to discover all available pages before exploring further.
Introducción
Conoce el sistema, sus funcionalidades y los roles de usuario disponibles.
Instalación
Instrucciones paso a paso para levantar el backend, frontend y base de datos.
Arquitectura
Diagrama de capas, stack tecnológico y flujo de datos del sistema.
Referencia API
Documentación completa de todos los endpoints REST de la API.
Funcionalidades principales
Dashboard Diario
Vista operativa de turnos del día con estados por color y acciones rápidas.
Registro de Visitas
Registra nuevas visitas con validación de aforo diario y por turno en tiempo real.
Calendario
Vista mensual de ocupación para planificar la agenda con anticipación.
Gestores e Instituciones
Administra el directorio de gestores y las instituciones educativas asociadas.
Reportes PDF
Exporta cronogramas diarios, reportes mensuales y comprobantes individuales.
Estadísticas
KPIs, evolución temporal y rankings para la toma de decisiones gerenciales.
Primeros pasos
Instalar el sistema
Clona el repositorio, configura las variables de entorno y levanta el backend con
npm run dev y el frontend con npm run dev.Consulta la guía de instalación para instrucciones detalladas.Iniciar sesión
Accede con tus credenciales de usuario. El sistema soporta dos roles: Admin (acceso completo) y Guía (registro y consulta de visitas).Consulta la guía de autenticación para más detalles.
Registrar una visita
Desde el Dashboard o el botón “Nueva Visita”, completa el formulario con la fecha, hora, tipo, gestor y cantidad de personas. El sistema valida el aforo automáticamente.Consulta la guía de registro de visitas.
Explorar la API
Si estás integrando el sistema con otra herramienta, consulta la Referencia API para conocer todos los endpoints disponibles.
Roles y permisos
El sistema define dos roles principales:| Rol | Acceso |
|---|---|
| Guía | Dashboard, registro y edición de visitas, consulta de historial, gestión de gestores, exportación de comprobantes |
| Admin | Todo lo anterior + gestión de usuarios, configuración del sistema, días inhábiles, estadísticas gerenciales, auditoría y exportación de informes |
La sesión se cierra automáticamente tras un período de inactividad configurable. Por defecto son 30 minutos. Los administradores pueden ajustar este valor desde Configuraciones del Sistema.