Los gestores son las personas o entidades responsables de coordinar y presentar a los grupos que visitan el túnel. Cada visita registrada en el sistema está asociada a un gestor, y cada grupo institucional está adicionalmente vinculado a una institución educativa. La página de gestores (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.
/gestores) centraliza el alta, consulta, edición y eliminación de estos registros en una sola pantalla con diseño de dos columnas: formulario de creación a la izquierda y tabla de directorio a la derecha.
¿Qué es un Gestor?
Un Gestor representa al coordinador responsable de una visita. Puede ser el docente de una escuela, un guía de una agencia de turismo, el representante de un club o simplemente un particular que organiza una excursión familiar. El gestor se selecciona en el formulario de registro de visitas y queda vinculado permanentemente al registro de la visita.Un Gestor es la persona que tramita la visita; una Institución es la entidad educativa (escuela, colegio, universidad) a la que pertenece el grupo. Son dos entidades separadas en la base de datos. Un gestor de tipo “Institución Educativa” puede coordinar grupos de distintas instituciones en visitas diferentes. La institución se asocia al grupo (
Grupo.institucion_id), no directamente al gestor.Tipos de gestor
| Tipo | Uso típico |
|---|---|
Institución Educativa | Docentes, directivos o coordinadores de escuelas y universidades |
Agencia de Turismo | Guías o representantes de agencias que organizan excursiones |
Club / Asociación | Responsables de asociaciones vecinales, clubes deportivos o culturales |
Particular / Organismo Público | Ciudadanos, organismos gubernamentales u otras entidades |
Campos del gestor
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
nombre | Texto | ✅ | Nombre completo de la persona o razón social de la entidad |
tipo | Enum | ✅ | Tipo de gestor (ver tabla anterior) |
empresa_institucion | Texto | ❌ | Nombre de la empresa, escuela u organismo que representa |
telefono | Tel | ❌ | Número de teléfono de contacto con código de área |
email | ❌ | Correo electrónico de contacto | |
localidad | Texto | ❌ | Localidad de origen, con autocompletado Georef |
provincia | Texto | ❌ | Provincia de origen, con autocompletado Georef |
pais | Texto | ❌ | País de origen (default: Argentina) |
Operaciones CRUD
- Listar
- Crear
- Editar
- Eliminar (Admin)
Al cargar la página, el sistema ejecuta
GET /api/gestores con el token en el encabezado Authorization. La respuesta es un array de objetos gestor que se muestra en la tabla de directorio. Un campo de búsqueda en la parte superior de la tabla filtra los resultados por nombre en tiempo real (filtrado en el cliente, no requiere nueva petición).La entidad Institución
La Institución representa la entidad educativa a la que pertenece un grupo de visita. Es un catálogo independiente del directorio de gestores.La Institución no es un Gestor. Mientras el Gestor es la persona que coordina, la Institución es la escuela o universidad de la que provienen los alumnos. Un mismo gestor puede llevar grupos de distintas instituciones. Y una misma institución puede tener distintos gestores en distintas visitas.
Campos de la Institución
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
nombre | Texto | ✅ | Nombre oficial de la institución educativa |
telefono | Tel | ❌ | Teléfono de contacto de la institución |
email | ❌ | Correo electrónico institucional | |
localidad | Texto | ❌ | Localidad donde se ubica la institución |
provincia | Texto | ❌ | Provincia donde se ubica la institución |
pais | Texto | ❌ | País de la institución (default: Argentina) |
Endpoints de Institución
| Método | Endpoint | Descripción |
|---|---|---|
GET | /api/instituciones | Lista todas las instituciones registradas |
POST | /api/instituciones | Crea una nueva institución |
El Grupo: nexo entre Gestor e Institución
La entidad Grupo es creada automáticamente al registrar una visita. Vincula al Gestor con la Institución (en visitas educativas) y almacena la información del tipo de visitantes.Grupos Institucionales
Vinculan un Gestor con una Institución educativa. Almacenan el
nivel_educativo del grupo: Infantes, Primario, Secundario, Terciario, Universitario o Adultos Mayores.Grupos Particulares
Solo tienen Gestor, sin institución. Almacenan
nombre, tipo_grupo (Menores, Adultos o Mixto), teléfono, email y ubicación geográfica del grupo.Crear gestores e instituciones desde el formulario de visitas
Para agilizar el flujo de trabajo, el formulario de registro de visitas incluye botones “Nuevo” junto a los selectores de gestor y de institución. Al hacer clic se abre un modal de creación en línea sin necesidad de abandonar el formulario.Clic en 'Nuevo' junto al selector de Gestor
Se abre el modal con el formulario de gestor. Completa los campos obligatorios (nombre y tipo) y los opcionales que tengas disponibles.
Guardar el gestor nuevo
Al hacer clic en “Guardar Gestor”, se ejecuta
POST /api/gestores. Si el servidor responde con éxito, el nuevo gestor se agrega a la lista local y se selecciona automáticamente en el formulario principal.