Files
admin-edu-space/MEMORY.md
T

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 .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.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_careers en 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), manteniendo career_id principal por retrocompatibilidad.

  • Normalización del Importador de Google Sheets: sheets_importer.py descubre 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.com para trabajo operativo institucional continuo.

Próximos pasos

  1. Desplegar v3.4.0 en el servidor de producción LXC Debian 10.0.0.217 (/opt/admin-edu-space).
  2. Crear tabla subject_careers en 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.
  3. Monitorear logs de producción (/var/log/admin-edu-space/).