38 lines
4.7 KiB
Markdown
38 lines
4.7 KiB
Markdown
# 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 `<td>` 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. |