4.4 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.4.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). -
Materias Compartidas en Múltiples Carreras (Many-to-Many): Se creó la tabla
subject_careersen la base de datos relacional para asociar una materia a múltiples carreras simultáneamente (ej: IOT en DATOS, TEC. DIG y VIDEOJUEGOS, o Teoría y Práctica en PROF PROF y CIENCIAS), manteniendocareer_idprincipal por retrocompatibilidad. -
Normalización del Importador de Google Sheets:
sheets_importer.pydescubre dinámicamente las 6 pestañas semanales (Lunes a Sábado), desglosa y mapea de forma canónica las carreras separadas por guion (-), soporta códigos combinados (/) y desglosa métricas por día de cursada (by_day). -
Reactivación de Bedelía en Producción: Activada la cuenta
bedelia@edu-space.compara trabajo operativo institucional continuo.
Próximos pasos
- Desplegar
v3.4.0en el servidor de producción LXC Debian10.0.0.217(/opt/admin-edu-space). - Crear tabla
subject_careersen PostgreSQL de producción y ejecutar la sincronización masiva para validar que se pueblen los 6 días y las relaciones Many-to-Many. - Monitorear logs de producción (
/var/log/admin-edu-space/).