# 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. ## Próximos pasos 1. Finalizar la actualización de documentación SSD (ROADMAP.md, CHANGELOG.md, Guía Operativa). 2. Revisar y pulir en el código cada uno de los 8 pasos del flujo secuencial de Bedelía. 3. Ejecutar pruebas automatizadas y validación en el entorno de pruebas usando las herramientas de navegador / E2E.