8.5 KiB
8.5 KiB
ROADMAP OFICIAL — Sistema Integral UniCABA (Admin Edu-Space)
Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía
Institución: Universidad de la Ciudad de Buenos Aires (UniCABA)
Versión: 3.4.3 (Refactorización del Importador Google Sheets: Selección Granular y Grilla Interactiva)
Fecha de Actualización: 07 de Octubre de 2026
Rama Base: dev
🗺️ Visión del Proyecto y Objetivo del Sprint
Consolidar la plataforma Admin Edu-Space como el sistema integral de gestión áulica y académica para UniCABA, reemplazando definitivamente el archivo Excel que el personal de Bedelía utiliza para su gestión diaria. A partir de este hito, la plataforma se convierte en la fuente única de verdad para la asignación de espacios, horarios y docentes, relegando las planillas externas a un simple mecanismo de importación masiva de datos iniciales.
📊 Estado Global de Progreso
Fase 0: Desacople y Arquitectura Base [████████████████████] 100% (Completado)
Fase 1: Paridad Legacy, Virtualidad y Dashboards[████████████████████] 100% (Completado)
Fase 2: Co-docencia y Matriz de Conflictos [████████████████████] 100% (Completado)
Fase 3: Hitos Evaluativos y Calificaciones [████████████████████] 100% (Completado)
Fase 4: UI/UX Drag & Drop e Impersonación [████████████████████] 100% (Completado)
Fase 5: Integración Auth, Email & Moodle [████████████████████] 100% (Completado)
Fase 5.1: Bedelía UX, ABMs 100% y Reset Seguro [████████████████████] 100% (Completado)
Sprint Activo: Flujo Bedelía & Reemplazo Excel [████████████████░░░░] 80% (En Curso)
Fase 6: Despliegue en Servidores y Hardening [███████░░░░░░░░░░░░░] 35% (Planificado)
🚀 Detalle de Fases y Entregables
Fase 0: Desacople y Arquitectura Base ✅ (Completada)
- Backend Flask como API REST pura bajo
/api/v1/retornando exclusivamente JSON. - Frontend BFF en Node.js + Express con renderizado de plantillas Nunjucks.
- Autenticación desacoplada con tokens JWT en Cookie
HttpOnlysegura. - Pipeline de seguridad
SecurityFilterChaincon blindaje OWASP y rate limiting. - Cliente Axios centralizado con interceptor Bearer token automático.
Fase 1: Paridad Legacy, Virtualidad y Dashboards Especializados ✅ (Completada)
- Importador de Google Sheets corregido: eliminación de colisiones en aulas virtuales múltiples (
Campus Virtual · VIRTUAL). - Dashboards específicos e interactivos para Bedelía, Docente, Alumno y Administrador.
- Cartelera del Día (
today_schedule) con bloques horarios (07:00 a 22:00 hs) y filtros dinámicos. - Generación y persistencia de enlaces de Google Meet institucional por comisión y reserva.
Fase 2: Co-docencia, Matriz de Conflictos y Regla Diaria ✅ (Completada)
- Tabla relacional
commission_teacherspara soportar múltiples docentes por comisión (titulares, adjuntos, ayudantes). - Matriz de conflictos con validación física estricta, chequeo de aforo de seguridad y superposición docente.
- Excepción de superposición justificada por co-docencia activa.
- Regla restrictiva de cursada diaria para estudiantes con bypass por curso corto (
is_short_course) o excepción expresa de Bedelía.
Fase 3: Hitos Evaluativos y Libro de Calificaciones (Gradebook) ✅ (Completada)
- Programación y calendario de parciales, recuperatorios, entregas y exámenes finales.
- Matriz de carga rápida de notas con autoguardado asíncrono y promedios en tiempo real.
- Cierre formal e inmutable de actas con número oficial (
ACTA-YYYY-Sem-ID) y registro de auditoría. - Consulta de calificaciones y estado de regularidad para alumnos.
Fase 4: UI/UX Avanzada para Bedelía & Modo Impersonación ✅ (Completada)
- Grilla semanal interactiva (Drag & Drop) con FullCalendar y barra lateral de comisiones sin aula.
- Detección visual de colisiones en tiempo real con reversión automática y mensajes de alerta.
- Modo de impersonación administrativa (login as) con cabecera
X-Impersonate-Usery banner visual ámbar. - Integración de Optimizador Genético heurístico acoplado a turnos académicos reales.
Fase 5: Integración Auth, Email y Moodle 4.1 ✅ (Completada)
- Panel de configuración global administrativa con contraseñas cifradas vía Fernet.
- Capa de caché híbrida (
CacheServiceen Redis/memoria) y cola asíncrona tolerante a fallos (MoodleSyncTaskcon DLQ). - Autenticación híbrida: Google OAuth 2.0 (
@unicaba.edu.ar), Moodle SSO y Login Local con fallback. - Motor de notificaciones transaccionales por email (
EmailService) para docentes.
Fase 5.1: Cobertura ABM 100% y Mantenimiento Seguro ✅ (Completada)
- ABMs completos y protegidos para Sedes/Edificios, Aulas (físicas/virtuales), Ciclos Lectivos, Carreras, Materias, Comisiones y Reservas.
- Módulo de Reinicio Total del Sistema (
POST /api/v1/admin/system/reset) con validación obligatoria de contraseña de Administrador y preservación de cuentas y roles RBAC. - Soporte de inicialización limpia (
--empty-academic/--no-demo) para arranque desde cero.
Sprint Activo: Flujo Completo de Bedelía & Reemplazo Definitivo de Excel 🏛️ ⚡ (En Curso)
- Objetivo: Permitirle a Bedelía gestionar íntegramente el ciclo de asignaciones académicas sin depender de planillas de cálculo, estandarizando el flujo de trabajo en 9 pasos secuenciales:
- Paso 1 — Sede / Edificio: Alta y mantenimiento del espacio físico (
/buildings/list_buildings). - Paso 2 — Aula (Física / Virtual): Definición de espacios, capacidades de aforo y recursos (
/classrooms/list_classrooms). - Paso 3 — Ciclo Lectivo: Definición del período académico y activación del cuatrimestre vigente (
/admin/academic_terms_list). - Paso 4 — Carrera / Titulación: Alta del programa académico o plan de estudios (
/admin/careers_list). - Paso 5 — Asignatura / Materia: Alta en el plan de estudios vinculada obligatoriamente a la Carrera (
/admin/subjects_list). - Paso 6 — Comisión: Creación de comisiones vinculadas a la materia, carrera y ciclo lectivo con filtrado y visualización contextual (
/admin/commissions_list). - Paso 7 — Asociar Profesores: Asignación previa del equipo de cátedra (titulares y adjuntos) con roles específicos (
/admin/commission_detail). - Paso 8 — Asociar Alumnos: Matriculación de estudiantes en la comisión con validación de restricciones horarias (
/admin/commission_detail). - Paso 9 — Reserva de Espacios: Asignación ágil del aula (física o virtual) a la comisión, con validación de conflictos en 1 clic (
/schedule/add_reservationo Drag & Drop en/schedule/calendar_view).
- Paso 1 — Sede / Edificio: Alta y mantenimiento del espacio físico (
- Asignaturas Compartidas entre Múltiples Carreras:
- Modelo Many-to-Many (
subject_careers) en base de datos. - Asignación múltiple y visualización de badges por titulación en asignaturas y comisiones.
- Filtro por carrera unificado para materias compartidas.
- Modelo Many-to-Many (
- Canal de Importación de Planillas (Google Sheets):
- Descubrimiento dinámico de pestañas para los 6 días semanales (Lunes a Sábado con GIDs oficiales).
- Desglose y normalización de carreras compuestas separadas por guion (
-). - Soporte de múltiples códigos de materia (
/). - Informe detallado por día de cursada (
by_day) en UI.
- Documentación Operativa:
- Manual del Personal de Bedelía con el flujo secuencial de 9 pasos.
- Manual del Docente (agenda, Google Meet y actas de notas).
- Manual del Estudiante (consulta de aulas y exámenes).
- Validación en Entorno Real:
- Verificación en contenedor LXC productivo (
10.0.0.217/eduspace.oemspot.com.ar).
- Verificación en contenedor LXC productivo (
Fase 6: Despliegue en Servidores y Hardening 🏢 (Planificada)
- Automatización de workers persistentes en systemd para la cola asíncrona de Moodle.
- Configuración optimizada de
docker-compose.ymlde producción. - Pruebas de estrés de concurrencia y validación final de performance sub-segundo.