feat(bedelia): associate careers to commissions and subjects, clean dashboard mock fallbacks, and update SSD documentation

This commit is contained in:
2026-10-07 17:02:56 -03:00
parent 1e6f493358
commit 8dc055cd1e
18 changed files with 564 additions and 318 deletions
+175 -173
View File
@@ -1,208 +1,210 @@
# GUÍA OPERATIVA DE SISTEMA, RELEVAMIENTO DE BEDELÍA Y ROADMAP DE EVOLUCIÓN
# GUÍA OPERATIVA DE SISTEMA, MANUAL DE PROCEDIMIENTOS Y ROADMAP DE EVOLUCIÓN
## Plataforma Admin Edu-Space — UniCABA
**Documento de Operaciones y Prospectiva Tecnológica**
**Versión:** 1.0 (Producción MVP)
**Documento de Operaciones, Flujo Secuencial de Bedelía y Manual de Usuario**
**Versión:** 3.3.0 (Producción MVP)
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
---
## 1. Guía de Procedimientos del Programa por Rol
## 1. Guía de Procedimientos Operativos por Rol
### 1.1. Para el Personal de Bedelía (Gestores de Espacios)
---
El personal de Bedelía es el corazón operativo de la infraestructura física universitaria. Su flujo de trabajo en Edu-Space sigue el siguiente ciclo:
### 1.1. Para el Personal de Bedelía (Gestores de Espacios y Cursadas)
El personal de Bedelía es el corazón operativo de la infraestructura física y académica. El objetivo central de este sprint es **reemplazar definitivamente el archivo Excel que Bedelía utiliza actualmente para sus gestiones diarias**. A partir de ahora, la plataforma es la fuente única de verdad para administrar sedes, aulas, ciclos lectivos, materias, comisiones, docentes, alumnos y reservas.
```
[ Inicio de Cuatrimestre ]
│
▼
1. Configuración del Ciclo Lectivo
(Fechas de inicio, fin, feriados y recesos)
│
▼
2. Carga/Actualización de Aulas y Sede
(Capacidad física, proyectores, computadoras, AC)
│
▼
3. Importación o Carga de Comisiones y Materias
(Docente a cargo, alumnos inscriptos, días y turnos)
│
▼
4. Ejecución del Optimizador Genético
(Distribución automatizada sin colisiones ni solapamientos)
│
▼
5. Publicación y Monitoreo en Tiempo Real
(Cartelera digital activa y gestión de contingencias/reparaciones)
[ 1. Sede / Edificio ] ──▶ [ 2. Aula (Física/Virtual) ]
│ │
▼ ▼
[ 3. Ciclo Lectivo ] ──▶ [ 4. Carrera / Titulación ]
│ │
▼ ▼
[ 5. Asignatura / Materia ] (Vinculada a la Carrera)
│
▼
[ 6. Crear Comisión ] (Vinculada a Materia, Carrera y Ciclo)
│
┌───────────────┴───────────────┐
▼ ▼
[ 7. Asociar Profesores ] [ 8. Asociar Alumnos ]
│ │
└───────────────┬───────────────┘
▼
[ 9. Reserva de Espacios ]
(Asignación en Aula & Horario)
```
#### Paso a Paso Operativo:
1. **Configuración de Ciclo Lectivo:**
- Navegar al menú **Ciclos Lectivos** en la barra lateral.
- Definir el ciclo activo (ej: `2026 - 2C`), fijando las fechas de inicio de clases, exámenes finales y cierres de actas.
2. **Inventario de Aulas y Recursos:**
- En **Gestión de Aulas**, registrar cada aula con su capacidad real de asientos, tipo de pizarrón, presencia de proyector, conectividad de red y climatización.
- Marcar aulas en estado `Mantenimiento` en caso de fallas edilicias para excluirlas del algoritmo de asignación.
3. **Carga y Verificación de Comisiones:**
- Ingresar a **Comisiones / Horarios** para verificar la nómina de materias activas, sus horarios (Turno Mañana, Tarde o Noche) y la cantidad estimada de matriculados.
4. **Asignación Asistida por IA (Optimizador Genético):**
- Acceder al módulo **Optimizador Genético**.
- Seleccionar el ciclo lectivo y pulsar **"Ejecutar Optimización"**.
- El sistema evaluará millones de combinaciones en segundos, priorizando que los grupos más numerosos ocupen las aulas mayores y minimizando distancias de traslado de docentes.
- Bedelía puede revisar el cronograma propuesto y confirmarlo con un clic.
5. **Atención de Cambios de Último Momento:**
- Si un docente requiere cambio de aula o si un equipo multimedia falla, Bedelía ingresa a **Reservas / Asignaciones**, busca la franja horaria y reubica la comisión en un aula alternativa libre sugerida por el sistema.
---
#### 📋 Flujo Secuencial de 9 Pasos (Paso a Paso Detallado):
#### Paso 1: Crear Sitio / Sede (Edificio)
1. **Acceso:** Ir al menú lateral ➔ **Espacios & Sedes** (o **Administración**) ➔ **Sedes / Edificios** (`/buildings/list_buildings`).
2. **Acción:** Presionar el botón `+ Nueva Sede`.
3. **Completar Datos:**
- **Nombre:** Ej. *Sede Central UniCABA*.
- **Dirección / Código:** Ej. *Paseo Colón 255* / *SEDE-CENTRAL*.
- **Estado:** Activo.
4. **Guardar:** Presionar `Guardar Sede`. El edificio queda registrado para albergar aulas físicas.
#### Paso 2: Crear Aula (Espacios Físicos o Virtuales)
1. **Acceso:** Ir al menú lateral ➔ **Espacios & Sedes** ➔ **Catálogo de Aulas** (`/classrooms/list_classrooms`).
2. **Acción:** Presionar el botón `+ Nueva Aula` (`/classrooms/add_classroom`).
3. **Seleccionar Tipo de Espacio:**
- **Espacio Físico:** Seleccionar la Sede creada en el Paso 1, indicar el Piso (ej. *1° Piso*), el Código/Nombre del aula (ej. *Aula 101*), Capacidad máxima de bancos (ej. *40*) y Recursos (Proyector, Aire Acondicionado, PCs).
- **Espacio Virtual:** Marcar el casillero `¿Es espacio virtual / remoto?`. El sistema lo vinculará al entorno institucional remoto (Campus Virtual).
4. **Guardar:** Presionar `Crear Aula`. Queda lista para recibir reservas.
#### Paso 3: Crear Ciclo Lectivo (Período Académico)
1. **Acceso:** Ir al menú lateral ➔ **Académica** ➔ **Ciclos Lectivos** (`/admin/academic_terms_list`).
2. **Acción:** Presionar el botón `+ Nuevo Ciclo Lectivo`.
3. **Completar Datos:**
- **Nombre:** Ej. *2026 - 2° Cuatrimestre* o *2026 - 1C*.
- **Fecha de Inicio y Fin:** Fechas formales del cuatrimestre.
- **Activar:** Marcar como `Ciclo Actual / Activo`. Todas las nuevas comisiones se asignarán por defecto a este ciclo.
4. **Guardar:** Presionar `Guardar Período`.
#### Paso 4: Crear Carrera (Programa Académico / Titulación)
1. **Acceso:** Ir al menú lateral ➔ **Académica** ➔ **Carreras** (`/admin/careers_list`).
2. **Acción:** Presionar el botón `+ Nueva Carrera`.
3. **Completar Datos:**
- **Nombre de la Carrera:** Ej. *Licenciatura en Tecnologías Informáticas* o *Tecnicatura Universitaria en Ciberseguridad*.
- **Código Institucional:** Ej. *LTI* o *TUC*.
- **Descripción:** Objetivos del plan de estudios.
4. **Guardar:** Presionar `Crear Carrera`. Las materias y comisiones quedarán agrupadas bajo esta carrera.
#### Paso 5: Crear Asignatura / Materia (Vinculada a la Carrera)
1. **Acceso:** Ir al menú lateral ➔ **Académica** ➔ **Asignaturas** (`/admin/subjects_list`).
2. **Acción:** Presionar el botón `+ Nueva Asignatura`.
3. **Completar Datos:**
- **Código de Materia:** Ej. *PROG-VANG-2026*.
- **Nombre de la Materia:** Ej. *Programación de Vanguardia*.
- **Carrera Vinculada:** Seleccionar obligatoriamente la Carrera creada en el Paso 4 (ej. *Licenciatura en Tecnologías Informáticas*).
- **Departamento / Créditos:** Indicar departamento y créditos académicos.
- **¿Es Curso Corto / Taller?:** Marcar si aplica para habilitar excepciones de cursada en el mismo día.
4. **Guardar:** Presionar `Crear Asignatura`.
#### Paso 6: Crear Comisión (Asociada a Materia, Carrera y Ciclo)
1. **Acceso:** Ir al menú lateral ➔ **Académica** ➔ **Comisiones** (`/admin/commissions_list`).
2. **Acción:** Presionar el botón `+ Nueva Comisión`.
3. **Completar Datos:**
- **Asignatura / Materia:** Seleccionar la Asignatura creada en el Paso 5 (el sistema muestra su carrera asociada).
- **Código de Comisión:** Ej. *Comisión A* o *K3001*.
- **Ciclo Lectivo:** Seleccionar el ciclo activo creado en el Paso 3.
- **Turno:** *Mañana* (08:00 - 12:00), *Tarde* (14:00 - 18:00) o *Noche / Vespertino* (18:30 - 22:30).
- **Docente Titular (Opcional en este paso):** Puede asignarse de inmediato o más tarde.
- **Cupo Máximo:** Cantidad estimada de matriculados (ej. *35*).
- **Enlace Virtual:** Enlace opcional de Google Meet, Zoom o Teams si cursará en modalidad remota o híbrida.
4. **Guardar:** Presionar `Crear y Asociar Comisión`. La comisión hereda la carrera y el plan de estudios.
#### Paso 7: Asociar Profesores (Equipo Docente / Co-docencia)
1. **Acceso:** En la lista de comisiones (`/admin/commissions_list`), hacer clic en la tuerca o nombre de la comisión para ingresar al **Detalle de Comisión** (`/admin/commission_detail?id=...`).
2. **Sección:** Localizar la tarjeta **"Equipo Docente / Cátedra"**.
3. **Acción:** Seleccionar al profesor en el desplegable de docentes, elegir su rol académico (*Titular*, *Adjunto*, *JTP*, *Ayudante*) y marcar si es el docente principal.
4. **Asignar:** Presionar `+ Vincular Docente`.
- *Nota de Co-docencia:* Si la comisión tiene múltiples docentes registrados, el sistema activará automáticamente la tolerancia de superposición horaria en la matriz de conflictos.
#### Paso 8: Asociar Alumnos (Matriculación de Estudiantes)
1. **Acceso:** Dentro de la misma vista de **Detalle de Comisión** (`/admin/commission_detail`), localizar la tarjeta **"Alumnos Matriculados"**.
2. **Acción:** Presionar `Inscribir Alumno` y seleccionar al estudiante registrado en el sistema.
3. **Validación Automática:** El sistema comprobará si el alumno ya cursa otra materia regular el mismo día.
- Si no hay conflicto: La matriculación se efectiviza inmediatamente.
- Si existe superposición de día: El sistema solicita autorización expresa de Bedelía activando el switch `Autorizar excepción de cursada en el mismo día` e ingresando el motivo institucional.
4. **Confirmar:** Presionar `Inscribir`.
#### Paso 9: Reserva de Espacios (Asignación de Aula y Horario)
Bedelía dispone de **3 modalidades complementarias** para efectuar la reserva según la conveniencia:
1. **Modalidad Rápida desde Comisiones:**
- En `/admin/commissions_list`, pulsar el botón con ícono de calendario `Asignar Aula` (`bi-calendar-plus`) en la fila de la comisión.
- El sistema redirige a `/schedule/add_reservation` precargando automáticamente la comisión, el cupo, la carrera y los datos de la materia.
- Seleccionar Edificio ➔ Piso ➔ Aula, día de la semana y franja horaria.
- Presionar `Confirmar Reserva`. La matriz de conflictos valida en tiempo real y confirma la reserva.
2. **Modalidad Interactiva (Drag & Drop en Calendario Semanal):**
- Ir a **Reservas / Calendario** (`/schedule/calendar`).
- En la barra lateral izquierda se muestran las *Comisiones Pendientes de Aula*.
- Arrastrar la tarjeta de la comisión directamente a la grilla horaria del aula deseada.
- El sistema valida instantáneamente; si no hay solapamiento ni choque de docentes, la reserva queda confirmada. Si hay colisión, revierte el movimiento y muestra una alerta clara en pantalla.
3. **Modalidad Automatizada con Inteligencia Artificial (Optimizador Genético):**
- Ir a **Optimizador de Aulas** (`/genetic-optimizer`).
- Seleccionar el ciclo lectivo y pulsar `Ejecutar Optimización`.
- El algoritmo heurístico evalúa millones de combinaciones, asignando las aulas de mayor capacidad a los grupos más numerosos y evitando todo solapamiento.
- Bedelía previsualiza el resultado y confirma la asignación masiva con 1 clic.
---
#### 📥 Ingesta Masiva desde Google Sheets / Planillas:
- Para no interrumpir la dinámica durante la transición, Bedelía puede usar la importación oficial desde Google Sheets:
- Ir a **Administración** ➔ **Configuración Global** (`/admin/settings`).
- Verificar la URL de la planilla oficial publicada.
- Ejecutar la sincronización masiva para poblar comisiones y horarios.
- *A partir de ese momento, toda modificación, reemplazo o ajuste se realiza exclusivamente en Edu-Space*, dejando la planilla congelada como copia de respaldo.
---
### 1.2. Para el Cuerpo Docente (Profesores)
1. **Consulta de Aulas Asignadas:**
- Iniciar sesión con la cuenta docente. En el **Dashboard de Cátedra**, el profesor ve inmediatamente su agenda semanal: nombre de la materia, número de comisión, aula física asignada, piso y capacidad.
2. **Clases Virtuales e Híbridas (Google Meet):**
- Para las materias con modalidad combinada, el sistema genera y exhibe el enlace directo de **Google Meet**. El docente puede iniciarlo con un solo clic sin necesidad de crear salas manualmente.
3. **Solicitud de Asistencia o Recursos:**
- Desde la ficha de su clase, el profesor puede reportar incidencias (ej: falta de marcadores, proyector averiado) notificando directamente al panel de Bedelía.
1. **Consulta Inmediata de Aulas Asignadas:**
- Iniciar sesión en la plataforma con cuenta institucional.
- En el **Dashboard de Cátedra** (`/dashboard?role=docente`), el docente visualiza su agenda del día y de la semana:
- Nombre de la materia y número de comisión.
- Aula física exacta asignada, piso y sede.
- Cantidad de alumnos matriculados y equipamiento disponible.
2. **Clases Virtuales y Enlace a Google Meet:**
- Si la comisión es virtual o híbrida, el docente visualiza el botón destacado `Unirse a Clase Virtual (Meet)`.
- Con un solo clic se abre la sala de Google Meet oficial vinculada a la comisión.
3. **Libro de Calificaciones (*Gradebook*) y Actas de Notas:**
- Acceder al menú **Mis Materias** ➔ Seleccionar la comisión ➔ Pulsar `Libro de Calificaciones (Actas)`.
- Cargar las notas de exámenes parciales, recuperatorios y TPs en la grilla interactiva.
- El sistema realiza autoguardado asíncrono y calcula promedios y condición académica (*Promocionado*, *Regular*, *Libre*).
- Al finalizar el cuatrimestre, pulsar `Cerrar y Sellar Acta Oficial`. Se genera un identificador inmutable (`ACTA-2026-2C-XXXX`) registrado en auditoría.
4. **Solicitud de Asistencia o Incidencias:**
- Desde la ficha de la clase, el docente puede reportar cualquier falla edilicia (proyector averiado, aire acondicionado, falta de bancos) para que Bedelía actúe de inmediato.
---
### 1.3. Para los Estudiantes (Alumnado)
1. **Localización de Aula en Tiempo Real:**
- Desde cualquier smartphone o computadora, el alumno ingresa a `eduspace.oemspot.com.ar` y visualiza en su pantalla principal el aula de cursada del día, evitando aglomeraciones en los pasillos de entrada.
2. **Calendario Académico y Fechas de Parciales:**
- El alumno consulta los días confirmados de exámenes parciales, recuperatorios y entregas de trabajos prácticos fijados por sus cátedras.
3. **Cartelera de Avisos:**
- Acceso a novedades institucionales y eventuales traslados de aula notificados al instante.
1. **Brújula de Cursada "¿Dónde curso hoy?":**
- Desde su teléfono inteligente o computadora, el estudiante ingresa a `eduspace.oemspot.com.ar`.
- En la pantalla principal visualiza inmediatamente:
- Aula exacta de cursada del día, piso y sede (ej. *Aula 203 - 2° Piso - Sede Central*).
- Horario de inicio y fin de la clase.
- Nombre de la materia y docente a cargo.
2. **Acceso a Clases Virtuales:**
- Si la clase del día es virtual, en lugar del aula física se despliega el botón `Ingresar a la Clase Virtual`.
3. **Calendario Académico y Próximos Exámenes:**
- Visualización de la cuenta regresiva para exámenes parciales, fechas de entrega de trabajos prácticos y recesos.
4. **Consulta de Notas y Certificados:**
- En la sección **Mis Calificaciones**, el alumno puede revisar sus notas de parciales, condición final y número de acta oficial sellada por el docente.
---
## 2. Relevamiento y Cuestionario para Entrevista con Bedelía
## 2. Relevamiento Operativo y Adaptación Institucional
Para perfeccionar la aplicación y adaptarla de forma quirúrgica a las particularidades de UniCABA, se diseñó la siguiente guía de preguntas para entrevistar al equipo de Bedelía:
Para asegurar una transición sin fricción desde el Excel hacia Edu-Space en UniCABA, se definen los siguientes criterios operativos:
### Bloque A: Dinámica y Cuellos de Botella Actuales
1. *¿Cuál es el proceso exacto que utilizan hoy cuando se abre un nuevo cuatrimestre? ¿Cuánto tiempo les demanda asignar manualmente todas las aulas?*
2. *¿Cuáles son los conflictos más frecuentes que ocurren durante las dos primeras semanas de clase? (Ej: grupos que superan la capacidad del aula, docentes que piden proyector sin aviso previo, ruidos molestos).*
3. *¿Cómo gestionan hoy los cambios de aula imprevistos? (¿Cartel de papel en la puerta, aviso por WhatsApp, grupos de delegados?)*
### Bloque B: Reglas de Negocio y Restricciones Específicas
4. *¿Existen docentes que por razones de movilidad reducida o edad deban tener asignadas aulas exclusivamente en Planta Baja o cerca de ascensores?*
5. *¿Hay cátedras que requieran software específico o laboratorios fijos que no puedan dictarse en aulas convencionales?*
6. *¿Qué margen de tolerancia de capacidad prefieren? (Ej: ¿Es aceptable ubicar a 30 alumnos en un aula de 32 bancos, o exigen un 15% de margen de seguridad libre?)*
### Bloque C: Integración con Sistemas Institucionales
7. *¿De qué sistema extraen la nómina de alumnos inscriptos? (¿SIU Guaraní, planillas CSV/Excel, sistema propio de la Ciudad de Buenos Aires?)*
8. *¿Qué formato de reporte o planilla deben entregar a Dirección Académica al cerrar la planificación?*
### Bloque D: Propuestas de Mejora Identificadas para Modificar en Edu-Space
* **Petición detectada:** Incorporación de un botón de "Intercambio Rápido de Aulas" entre dos comisiones simultáneas sin tener que desasignar y volver a asignar a ambas individualmente.
* **Petición detectada:** Alerta visual con código de colores cuando un aula física supere el 95% de aforo de seguridad.
* **Petición detectada:** Exportador directo en PDF imprimible con formato oficial apaisado para pegar en las carteleras de corcho tradicionales para aquellos alumnos sin batería en el móvil.
### Criterios Clave de Usabilidad para Bedelía:
1. **Intercambio Rápido de Aulas:** Permite permutar dos comisiones de aula en la misma franja horaria sin tener que desasignar y reasignar individualmente.
2. **Semáforo Visual de Aforo:** Alertas de color (Verde: < 80% ocupación, Amarillo: 80-95%, Rojo: > 95% o exceso de capacidad).
3. **Exportación Imprimible:** Generador de reportes de cartelera en formato apaisado para impresión en papel ante contingencias eléctricas o de red.
---
## 3. Especificación: Módulo y Pestaña de Beneficios Universitarios
### 3.1. Propósito y Justificación
Uno de los principales factores de permanencia y bienestar estudiantil es el acceso ágil a los convenios y beneficios que brinda la comunidad académica. La incorporación de la pestaña **Beneficios** dentro del ecosistema Edu-Space centraliza esta información en la misma plataforma donde el alumno consulta su vida académica diaria.
```
┌────────────────────────────────────────────────────────────────────────┐
│ PESTAÑA DE BENEFICIOS EDU-SPACE │
├──────────────────┬──────────────────┬─────────────────┬────────────────┤
│ 🏷️ COMERCIO │ 💻 LICENCIAS │ ☕ COMEDOR │ 📚 BIBLIOTECA │
│ Y LIBRERÍA │ DE SOFTWARE │ UNIVERSITARIO │ DIGITAL │
├──────────────────┼──────────────────┼─────────────────┼────────────────┤
│ 20% en fotocopias│ GitHub Student │ Menú estudiantil│ Préstamo de │
│ y apuntes con el │ Pack, JetBrains │ subsidiado con │ e-books y salas│
│ carnet digital. │ Pro y Office 365 │ reserva previa. │ de estudio. │
└──────────────────┴──────────────────┴─────────────────┴────────────────┘
```
### 3.2. Modelo de Datos Propuesto (Entidades)
* **Tabla `beneficio`:**
- `id`: Clave primaria autoincremental.
- `categoria`: Enum (`Librería`, `Gastronomía`, `Software/Tecnología`, `Salud/Deportes`, `Cultura`).
- `titulo`: Nombre del beneficio (ej: *Descuento 20% en Fotocopiadora Central*).
- `descripcion`: Condiciones de uso y letra chica.
- `validez_hasta`: Fecha límite de vigencia.
- `codigo_descuento`: Cupón alfanumérico o enlace de validación.
- `convenio_empresa`: Nombre del proveedor o área universitaria.
- `activo`: Booleano para activar/pausar la visualización.
### 3.3. Interfaz de Usuario (UI)
* Tarjetas dinámicas (*Cards*) con estética Glassmorphism, botón de "Copiar Código", botón de "Ver Mapa de Canje" y filtros por categoría.
## 3. Especificación: Módulo de Beneficios Universitarios (Futuro)
- Pestaña para centralizar convenios estudiantiles (Librerías, Software estudiantil, Comedor universitario, Biblioteca digital).
- Tarjetas con códigos de validación y mapa de canje.
---
## 4. Innovación a Futuro: Credencial Digital con QR y Rol "Recepción"
### 4.1. Arquitectura de Acceso Seguro mediante QR Dinámico
Para modernizar el control de ingreso al edificio de UniCABA y erradicar las credenciales plásticas costosas y extraviables, se proyecta el módulo de **Credencial QR Inteligente**:
```
[ Pantalla Alumno (Edu-Space) ]
Generación de Token TOTP Cifrado (HMAC-SHA256)
(Cambia cada 30 segundos para evitar capturas de pantalla compartidas)
│
▼ Muestra Código QR en Pantalla
[ Puesto de Acceso / Molinete ]
│
▼ Escaneo con Cámara Web o Lector Óptico 2D
[ Tablet / Terminal Rol "Recepción" ]
- Valida firma criptográfica con la API
- Consulta estado del estudiante: ¿Alumno Regular Activo? ¿Tiene clase en esta sede hoy?
│
▼
✅ ACCESO PERMITIDO: Nombre, Foto, Carrera y Aula asignada ("Aula 104 - 1° Piso")
❌ ACCESO DENEGADO / ALERTA: Matrícula suspendida o no regular
```
### 4.2. Especificación del Nuevo Rol de Usuario: `recepcion`
* **Permisos del Rol:**
- Acceso restringido exclusivamente a la pantalla de escaneo (`/reception/scanner`) y al monitor de aforo edilicio en vivo (`/reception/headcount`).
- Imposibilidad de alterar notas, comisiones o configuraciones de Bedelía.
* **Beneficios de Seguridad Institucional:**
- **Control de Aforo en Tiempo Real:** El personal de portería y seguridad conoce en todo momento la cantidad exacta de personas dentro del edificio, dato crítico ante evacuaciones por siniestros.
- **Guía al Ingresante:** Al momento del escaneo, el sistema le muestra en pantalla al recepcionista a qué aula debe dirigirse el estudiante, permitiendo orientarlo amablemente en el momento del ingreso.
- Credencial QR inteligente con token dinámico TOTP (HMAC-SHA256) que cambia cada 30 segundos en la pantalla del alumno.
- Rol de usuario `recepcion` en tablets de molinete para validar ingreso, registrar aforo edilicio en tiempo real y guiar al estudiante a su aula asignada.
---
## 5. Aplicación Móvil en Ionic (Capacitor) para Android e iOS
### 5.1. ¿Por Qué Ionic Framework + Capacitor?
Para llevar Edu-Space a los dispositivos móviles de los estudiantes y profesores sin duplicar el costo de desarrollo en lenguajes nativos independientes (Kotlin/Swift), la elección óptima de ingeniería es **Ionic con Capacitor**:
1. **Reutilización del Código y UI Web:** El diseño responsivo ya desarrollado en HTML5/CSS/JavaScript se compila directamente dentro de un contenedor webview de alto rendimiento nativo.
2. **Acceso a Hardware Nativo mediante Plugins Capacitor:**
- `@capacitor/camera`: Para que el personal de recepción o docentes escaneen códigos QR directamente con el lente del celular.
- `@capacitor/push-notifications`: Notificaciones Push en tiempo real emitidas por Firebase Cloud Messaging (FCM) ante avisos urgentes (ej: *"Tu clase de Algoritmos se trasladó al Aula 201"*).
- `@capacitor/preferences` / `@capacitor-community/sqlite`: Almacenamiento local para permitir al alumno consultar sus horarios sin consumir datos móviles o en zonas del edificio con baja señal de red.
### 5.2. Arquitectura de Distribución
```
┌──────────────────────────────────┐
│ Código Base Edu-Space Frontend │
└─────────────────┬────────────────┘
│
▼
┌──────────────────────────────────┐
│ Capacitor Bridge CLI │
└────────┬────────────────┬────────┘
│ │
┌───────────────▼──┐ ┌──▼────────────────┐
│ Proyecto Nativo│ │ Proyecto Nativo │
│ Android │ │ iOS │
│ (Gradle/APK) │ │ (Xcode/Archive) │
└───────┬──────────┘ └──┬────────────────┘
│ │
▼ ▼
Google Play Store Apple App Store
```
### 5.3. Fases de Implementación Móvil
* **Fase 1 (Empaquetado y Notificaciones):** Inicialización de Capacitor en el proyecto, configuración de iconos adaptativos y recepción de notificaciones Push de cambios de aula.
* **Fase 2 (Modo Desconectado / Offline):** Caché del cronograma semanal en almacenamiento interno del dispositivo para consulta sin internet.
* **Fase 3 (Publicación):** Firma digital de binarios (`.aab` para Android y `.ipa` para iOS) y subida a las consolas de Google Play y Apple Developer.
## 5. Aplicación Móvil Híbrida en Ionic (Capacitor)
- Envoltorio Capacitor multiplataforma para Android e iOS reutilizando la interfaz web responsiva de Edu-Space.
- Notificaciones Push institucionales ante traslados o cancelaciones de aula de último momento.
- Modo de consulta offline del cronograma semanal almacenado en caché interna del teléfono.