# MEMORY.md - admin-edu-space Memoria del proyecto entre sesiones para la rama `dev`. ## Estado actual - Fases 0 a 5.1 del Roadmap completadas y estabilizadas: - Arquitectura desacoplada: Backend Flask REST API (:5000) + Frontend BFF Node.js/Express (:3000). - Cobertura 100% ABM: Sedes/Edificios, Aulas (físicas/virtuales), Ciclos Lectivos, Carreras, Materias, Comisiones y Reservas. - Matriz integral de conflictos (físico, docente con co-docencia, aforo y restricción diaria del alumno). - Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables. - Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación. - Reinicialización segura del sistema con contraseña de Administrador. - **Sprint Activo: MVP del Sistema de Bedelía — Reemplazo Definitivo del Excel**: - Reemplazar la planilla Excel manual como herramienta operativa diaria de Bedelía. - La plataforma asume el rol de fuente única de verdad para la asignación y gestión de cursadas. - Las planillas/Google Sheets se mantienen únicamente para importación masiva de datos iniciales. ## Decisiones (y por qué) - **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional. - **Asociación Explícita de Carreras**: Toda Asignatura se vincula a su Carrera y toda Comisión hereda y expone la Carrera, permitiendo filtros y búsquedas específicas por titulación. - **Importador de Google Sheets Preservado**: Se conserva como ingestor inicial masivo sin fricción para no interrumpir el flujo actual del personal. - **Guía Operativa por Rol**: Documentar explícitamente el procedimiento para Bedelía, Docentes y Alumnos para facilitar la adopción inmediata. ## Aprendizajes y errores a evitar - **Colisiones Virtuales**: En aulas virtuales no debe aplicarse colisión física horaria; múltiples comisiones pueden cursar simultáneamente con enlaces independientes. - **Manejo de Estados Vacíos (Empty States)**: Proteger siempre las vistas de plantillas en Nunjucks contra colecciones vacías para evitar errores 500 cuando se reinicializa la base. - **Seguridad de Secretos**: Mantener `.credenciales` y `.env` estrictamente fuera del índice de Git. - **Depuración de Mocks en Dashboard**: Se eliminaron los arrays estáticos de fallback (`upcoming_reservations`, `today_schedule_list`, etc.) en `frontend/src/routes/dashboard.js` que mostraban asignaturas ficticias ("Matemática Discreta", "Sistemas Operativos", "Ingeniería de Software") en ausencia de datos reales. - **Resolución de Error 500 en Aulas Presenciales y Virtuales**: Se reparó el balance de etiquetas de Nunjucks en `frontend/views/classrooms/list.html` y se reubicaron los modales de eliminación en el bloque físico. Validado con HTTP 200 en `/classrooms/list_classrooms?view_mode=physical` y `view_mode=virtual`. - **Estandarización de Versiones (v3.3.0)**: Expuesto en Backend (`/api/v1/version`), Frontend BFF (`/version`), badges en el pie de página de la barra lateral (`sidebar-footer`) y en la pantalla de inicio de sesión (`login.html`). - **RBAC Académico y Reestructuración de Menús**: Se otorgó permiso total a Bedelía sobre la gestión académica en `authMiddleware.js` y se ordenó la navegación lateral en `base.html` con una arquitectura de información orientada a IT para los roles Administrador, Bedelía, Docente y Alumno. - **Corrección de Modal Parpadeante en Carreras**: Se extrajeron los modales de edición del `` y del contenedor `.table-responsive` en `frontend/views/admin/careers/list.html`, resolviendo el conflicto de apilamiento y backdrop de Bootstrap 5. - **Blindaje de Acceso Rápido Demo en Login**: Se corrigió el condicional en `login.html` a `{% if demo_access_enabled %}` (eliminando el fallback permisivo `is not defined`), se estableció el default seguro a `false` en `auth.js` y se implementó el patrón PRG (*Post/Redirect/Get*) con `res.redirect('/auth/login?error=...')` ante fallos de credenciales para respetar fidedignamente el estado de la configuración global. - **Despliegue a Producción (/opt/admin-edu-space)**: Sincronizado a commit `b7f790e` con servicios activos y verificados. ## Próximos pasos 1. Incorporar en el importador de Google Sheets (`sheets_importer.py`) las columnas para fecha específica y enlace de videoconferencia (Meet/Zoom/Teams). 2. Monitorear logs de producción (`/var/log/admin-edu-space/`) ante el uso activo de Bedelía con los nuevos filtros de Carrera y vistas de aulas.