# 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 1. `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-8` y `Content-Disposition: attachment; filename="cartelera_unicaba_YYYY-MM-DD.csv"`. 2. `frontend/views/schedule/today_schedule.html`: - Incorporar en el encabezado los botones de acción rápida: - `[ Imprimir Cartelera ]` (dispara `window.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. 3. `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 1. `backend/app/routes/api/reservations.py` o `backend/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 1. `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 1. **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 print` optimizada 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). 2. **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. --- ## 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.py` y `admin.js`.