Files

58 lines
3.8 KiB
Markdown

# 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`.