SIGTEC – Tutorial Admin General

1 Niveles de acceso en SIGTEC

El sistema tiene 3 roles. Solo el Admin General puede asignar y cambiar roles.

2 Gestión de Laboratorios

Los laboratorios agrupan los equipos y tienen administradores asignados.

Panel de administración de laboratorios

1. Ir a Admin → Laboratorios en el menú lateral
2. El panel muestra tarjetas con nombre, código, estado (Activo/Inactivo), cantidad de equipos, cantidad de admins y quiénes son esos admins
3. Hacé clic en "Nuevo laboratorio" para agregar uno — completá: nombre, código, descripción, ubicación, piso, edificio, email de contacto
4. Para asignar administradores a un laboratorio: ir a Admin → Usuarios, editar el usuario y cambiar su rol a "Admin de Laboratorio" seleccionando el laboratorio. O bien, la sincronización RDI lo hace automáticamente si hay un email en el campo Contacto del equipo.

3 Gestión de Equipos

Cada equipo tiene configuración de disponibilidad, instrucciones de uso enriquecidas y reglas de reserva.

Panel de administración de equipos — el ícono de lápiz por fila permite editar las instrucciones

1. Ir a Admin → Equipos (ABM) en el menú lateral
2. La tabla muestra todos los equipos con: nombre, tipo, laboratorio, responsable, reglas de reserva y estado
3. Hacé clic en "Nuevo equipo" para agregar uno y completá los datos: nombre, tipo, marca, modelo, nº serie, responsable, laboratorio
4. Elegí el modo de reserva: Por horas (con horario de 7:00 a 19:00) o Por días (el usuario elige rango de fechas)
5. Configurá las reglas de reserva: mínimo y máximo de horas (o días), y días de anticipación máxima
6. Si el equipo requiere aprobación previa, marcá "Requiere aprobación del responsable"
7. Usá el editor de instrucciones (texto enriquecido) para redactar el mensaje que verán los usuarios al reservar — podés incluir negrita, cursiva, listas y enlaces a documentos externos
8. Opcionalmente agregá links al manual y video tutorial

Editar instrucciones de un equipo existente

1. En la tabla de equipos, hacé clic en el ícono de lápiz (✏️) al final de la fila del equipo
2. Se abre el modal de instrucciones con el editor enriquecido pre-cargado con el contenido actual
3. Editá el texto: usá la barra de herramientas para aplicar negrita, cursiva, listas o insertar enlaces
4. Para agregar un enlace: seleccioná el texto, hacé clic en el ícono de enlace 🔗, ingresá la URL y confirmá
5. Hacé clic en "Guardar" — los cambios se aplican de inmediato

4 Gestión de Usuarios

El Admin General puede ver y modificar todos los usuarios registrados.

Tabla de usuarios con búsqueda y edición

1. Ir a Admin → Usuarios en el menú lateral
2. Usá la barra de búsqueda para encontrar un usuario por nombre o email
3. La tabla muestra: rol, institución, cantidad de turnos realizados, último acceso y estado
4. Hacé clic en el ícono de edición para abrir el panel de modificación
5. Podés cambiar el rol (Usuario / Admin de Laboratorio / Admin General)
6. Si asignás rol Admin de Laboratorio, seleccioná qué laboratorios administrará
7. Podés desactivar un usuario (no podrá iniciar sesión)
8. Podés marcar un usuario como Externo (investigador visitante u otra institución)

5 Gestión de Turnos

El Admin General ve y puede gestionar todos los turnos del sistema.

Vista de todos los turnos del sistema con filtros

1. Ir a "Mis Turnos" en el menú lateral
2. Ves todos los turnos de todos los usuarios (con nombre de usuario visible)
3. Filtrá por estado o buscá por nombre de equipo / usuario
4. Confirmar: disponible para turnos en estado Pendiente
5. Cancelar: disponible para turnos futuros. Siempre escribí el motivo

6 Estadísticas globales

Las estadísticas muestran el uso global de todo el equipamiento del sistema.

Panel de estadísticas con KPIs, gráficos y rankings

1. Ir a "Estadísticas" en el menú lateral
2. Seleccioná el período: 7 días / 30 días / 3 meses / 1 año
3. Revisá los KPIs: turnos totales, horas de uso, tasa de utilización, usuarios activos
4. El gráfico de barras muestra evolución mensual de turnos y horas
5. El gráfico de torta muestra usuarios internos vs externos
6. Los rankings muestran los equipos y usuarios más activos
7. El indicador circular muestra el porcentaje de eficiencia
8. Hacé clic en "Exportar datos" para descargar en formato JSON

7 Log de Auditoría

El log de auditoría registra todas las acciones realizadas en el sistema por cualquier usuario.

Log de auditoría con filtros, paginación y exportación CSV

1. Ir a Admin → Auditoría en el menú lateral
2. Filtrá por entidad: Turnos / Equipos / Laboratorios / Usuarios
3. Filtrá por rango de fechas usando los selectores de fecha
4. Hacé clic en "Buscar" para aplicar los filtros
5. La tabla muestra: fecha/hora, usuario, acción, entidad, detalle y dirección IP
6. Navegá entre páginas con los botones de paginación (50 registros por página)
7. Hacé clic en "CSV" para exportar los registros filtrados

8 Integración automática con RDI

SIGTEC se sincroniza automáticamente con la base de datos de equipamiento RDI cada 15 minutos, vía SSH.

¿Qué sincroniza automáticamente?

1. Equipos: Si en RDI un equipo tiene URL válida en el campo Turno, SIGTEC lo crea o actualiza (nombre, tipo, marca, modelo, responsable, laboratorio).
2. Administradores de laboratorio: El campo Contacto de cada equipo en RDI puede contener un email. Si lo contiene, ese email se crea automáticamente como Admin de Laboratorio en SIGTEC y se vincula al laboratorio correspondiente. Si el email cambia en RDI, SIGTEC actualiza el vínculo en el siguiente ciclo.
3. Reemplazo de Calendly: Si el campo Turno tiene una URL de calendly.com, la sincronización la reemplaza con la URL de SIGTEC. Backup en /var/www/html/turnos/scripts/calendly-backup.txt.
4. MINCYT nunca se toca: Los equipos con URL turnos.microscopia.mincyt.gob.ar continúan con ese sistema.
5. Baja de equipos: Si se retira el campo Turno en RDI, SIGTEC marca el equipo como Inactivo automáticamente.

Cómo agregar un equipo nuevo al sistema de turnos

1. En RDI, editar el registro del equipo en la tabla Catálogo.
2. Campo Turno: poner cualquier URL válida (ej: https://pendiente o una URL de Calendly existente).
3. Campo Contacto: poner el email del responsable (ej: usuario@mendoza-conicet.gob.ar). La sincronización lo registrará como Admin Lab automáticamente.
4. Esperar hasta 15 minutos: SIGTEC crea el equipo y escribe la URL definitiva en el campo Turno de RDI.
5. Ir a SIGTEC → Admin → Equipos (ABM) para verificar que el equipo fue creado correctamente con sus reglas de reserva, protocolo y manuales.

Cómo cambiar el administrador de un laboratorio

1. En RDI, editar el campo Contacto del equipo correspondiente con el nuevo email.
2. En hasta 15 minutos, SIGTEC crea el nuevo usuario como Admin Lab, lo vincula al laboratorio y desvincula al anterior si ya no aparece en ningún equipo de ese lab.
3. El usuario anterior no se elimina — conserva su historial de turnos, pero pierde el rol de Admin Lab si ya no administra ningún laboratorio.

Monitoreo del proceso de sincronización

1. Ver el log en tiempo real: tail -f /var/log/sigtec-sync.log
2. Forzar sincronización manual: node /var/www/html/turnos/scripts/sync-rdi.js
3. Ver el cron: crontab -l (se ejecuta */15 * * * *)

9 Configuración inicial del sistema

Si estás instalando SIGTEC por primera vez, seguí este orden:

1. Crear Laboratorios: Admin → Laboratorios → Nuevo. Al menos uno antes de poder agregar equipos.
2. Agregar Equipos: Admin → Equipos (ABM) → Nuevo. Asigná cada equipo al laboratorio correspondiente.
3. Asignar Admins de Lab: Esperá a que los responsables se registren por primera vez en el sistema, luego ir a Admin → Usuarios → editar → cambiar rol a "Admin de Laboratorio" → seleccionar laboratorio.
4. Configurar el dominio permitido: En el archivo .env del servidor, la variable ALLOWED_EMAIL_DOMAIN controla qué emails pueden registrarse (ej: ianigla.net). Dejarla vacía permite cualquier email.
5. Probar el flujo: Registrate con un email de prueba, hacé una reserva y confirmala como admin para verificar que todo funciona.