3.8 KiB
3.8 KiB
Plan Técnico 001 — Cierre del MVP de Bedelía
Basado en: specs/001-cierre-mvp-bedelia/spec.md y docs/constitution.md.
1. Análisis de Brecha (Gap Analysis)
Al contrastar la especificación spec.md con el estado real del repositorio:
- Flujo de 9 Pasos: Está implementado en un 95%. Requiere una prueba de recorrido integral (smoke test) para asegurar que no haya fallas de integración.
- Matriz de Conflictos: 100% implementada y validada en
test_phase2_rules.py. - Cartelera del Día: Agrupa franjas horarias y soporta filtros de fecha, pero carece de exportación / impresión limpia, lo cual fuerza a Bedelía a mantener planillas manuales para entregar a recepción.
- Exportación / Impresión: Falta agregar la vista de impresión optimizada (
@media print) y la descarga directa de CSV/Excel de la agenda áulica del día/semana.
2. Modificaciones de Archivos y Responsabilidades
A. Frontend BFF & Vistas
frontend/src/routes/schedule.js:- Endpoint
GET /schedule/export_csv: Genera y descarga un archivo CSV con las columnas:Fecha,Horario,Turno,Aula / Espacio,Piso,Materia,Código,Comisión,Carrera,Docentes,Enlace Virtual. - Inyección de cabecera
Content-Type: text/csv; charset=utf-8yContent-Disposition: attachment; filename="cartelera_unicaba_YYYY-MM-DD.csv".
- Endpoint
frontend/views/schedule/today_schedule.html:- Incorporar en el encabezado los botones de acción rápida:
[ Imprimir Cartelera ](disparawindow.print()con estilos CSS@media print).[ Descargar Planilla CSV ](enlace directo a/schedule/export_csv?date=...).
- Agregar bloque de estilos CSS para impresión:
- Oculta sidebar, navbar, filtros y botones interactivos al imprimir.
- Imprime membrete formal: "Universidad de la Ciudad de Buenos Aires (UniCABA) - Cartelera de Asignación de Aulas".
- Formato de tabla claro, legible y ajustado a hoja A4/Oficio.
- Incorporar en el encabezado los botones de acción rápida:
frontend/views/dashboard/dashbede.html:- Agregar botón de acceso directo "Exportar Planilla de Hoy" junto a la agenda operativa de Bedelía.
B. Backend REST API
backend/app/routes/api/reservations.pyobackend/app/routes/api/dashboard.py:- Asegurar que el endpoint que nutre la agenda retorne la carrera, turno y docentes de forma plana para serialización inmediata.
C. Suite de Pruebas
backend/tests/test_cartelera_export.py:- Prueba unitaria/integración que valide la generación y completitud de datos de agenda diaria y semanal.
3. Decisiones Técnicas y Alternativas Descartadas
- Generación de PDF en Servidor vs. Impresión Nativa del Navegador (
window.print):- Alternativa Descartada: Librería pesada de generación de PDF en Node.js (Puppeteer o PDFKit), que consume más de 200MB de RAM y puede fallar en entornos LXC mínimos.
- Decisión Adoptada: Hoja de estilo CSS
@media printoptimizada para el navegador del usuario + exportación de datos crudos en CSV con UTF-8 con BOM (para compatibilidad total con Microsoft Excel en español).
- Exportador CSV en Frontend BFF vs. Backend:
- Decisión Adoptada: El Frontend BFF puede construir y enviar el stream CSV directamente a partir de la respuesta del endpoint
/api/v1/dashboard/today-schedule, reduciendo la carga del backend y aprovechando los formateadores de fecha en español ya existentes.
- Decisión Adoptada: El Frontend BFF puede construir y enviar el stream CSV directamente a partir de la respuesta del endpoint
4. Cobertura de Requisitos Funcionales
- RF-1, RF-2: Verificados mediante el flujo de 9 pasos en UI.
- RF-3, RF-4, RF-5, RF-6: Cubiertos por
tests/test_phase2_rules.py. - RF-7, RF-8: Cubiertos por la nueva funcionalidad de exportación e impresión limpia.
- RF-9: Cubierto por el panel de comisiones sin aula en
dashbede.html. - RF-10: Cubierto por
sheets_importer.pyyadmin.js.