4.7 KiB
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
.credencialesy.envestrictamente 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.) enfrontend/src/routes/dashboard.jsque 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.htmly se reubicaron los modales de eliminación en el bloque físico. Validado con HTTP 200 en/classrooms/list_classrooms?view_mode=physicalyview_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.jsy se ordenó la navegación lateral enbase.htmlcon 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
<td>y del contenedor.table-responsiveenfrontend/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.htmla{% if demo_access_enabled %}(eliminando el fallback permisivois not defined), se estableció el default seguro afalseenauth.jsy se implementó el patrón PRG (Post/Redirect/Get) conres.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
b7f790econ servicios activos y verificados.
Próximos pasos
- Incorporar en el importador de Google Sheets (
sheets_importer.py) las columnas para fecha específica y enlace de videoconferencia (Meet/Zoom/Teams). - 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.