31 lines
2.7 KiB
Markdown
31 lines
2.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.
|
|
|
|
## 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. |