Files

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

  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.