Files
admin-edu-space/specs/005-importador-semanas-rango/spec.md
T

3.9 KiB

Espec: 005-importador-semanas-rango - Selección de Semanas, Rango de Fechas y Fecha Puntual en Importador

1. Visión General y Propósito

El importador de Google Sheets oficial de Bedelía actualmente generaba de manera rígida 16 semanas (cuatrimestre completo) o 1 sola asignación cuando se marcaba la opción de fecha puntual. Bedelía requiere flexibilidad operativa total para poder:

  1. Elegir el número exacto de semanas a importar (ej. 1, 2, 4, 8, 12, 16 semanas).
  2. Definir un rango de fechas explícito ("Desde" y "Hasta") para importar reservas que caigan dentro de un período o corte de calendario específico.
  3. Importar ÚNICAMENTE para fecha puntual (1 sola asignación por fila).
  4. Resolver el error de asignación de carreras múltiples en asignaturas ('list' object has no attribute '_sa_instance_state').

2. Requisitos en Sintaxis EARS (Español Estricto)

2.1. Estrategias Temporales de Importación

  • RF-01 (Ubicuo): EL SISTEMA dispondrá en la interfaz de Bedelía (/admin/import) de tres modos de alcance temporal para la generación de reservas:
    1. Número de Semanas: Permite ingresar un entero positivo (por defecto 16).
    2. Rango de Fechas (Desde - Hasta): Permite ingresar fecha de inicio (date_from) y fecha de fin (date_to).
    3. Fecha Puntual Única: Crea 1 sola asignación por fila en la fecha especificada (manual_date).
  • RF-02 (Basado en Eventos): CUANDO el usuario elija el modo por número de semanas y defina N semanas, EL SISTEMA generará reservas para las primeras N semanas a partir de la fecha base del cuatrimestre o la fecha sugerida.
  • RF-03 (Basado en Eventos): CUANDO el usuario elija el modo por rango de fechas (date_from y date_to), EL SISTEMA calculará todas las fechas que correspondan al día de la semana de cada comisión dentro del intervalo cerrado [date_from, date_to] y generará las reservas correspondientes.
  • RF-04 (Basado en Eventos): CUANDO el usuario active "Importar ÚNICAMENTE para fecha puntual" (single_date_only), EL SISTEMA creará exactamente 1 reserva por fila en la fecha puntual designada.
  • RF-05 (No Deseado / Excepciones): SI el usuario ingresa un rango de fechas donde date_from > date_to, ENTONCES EL SISTEMA bloqueará la sincronización y mostrará una alerta indicando que la fecha inicial no puede ser posterior a la fecha final.
  • RF-06 (No Deseado / Excepciones): SI el número de semanas configurado es menor a 1 o superior a 30, ENTONCES EL SISTEMA limitará automáticamente el valor a los extremos válidos (1 a 30 semanas).

2.2. Robustez del Modelo de Asignaturas y Carreras

  • RF-07 (Ubicuo): EL SISTEMA preservará la relación Many-to-Many entre Subject y Career configurada con colección explícita (uselist=True), garantizando que la importación de asignaturas multi-carrera (ej. ASIG00125) asigne la lista de carreras sin arrojar excepciones de tipo 'list' object has no attribute '_sa_instance_state'.

3. Criterios de Aceptación y Finalización (DoD)

  1. Selector interactivo en la vista /admin/import con opciones claras: "Cuatrimestre / Por Semanas", "Rango de Fechas (Desde - Hasta)" y "Fecha Puntual Única".
  2. Endpoint /api/v1/admin/sync-sheets y servicio GoogleSheetsImporter.sync() procesando weeks_to_generate, date_from, date_to, manual_date y single_date_only.
  3. Pruebas unitarias y de integración que verifiquen:
    • Importación con 4 semanas generando exactamente 4 reservas.
    • Importación con rango de fechas generando las fechas intermedias exactas.
    • Importación con fecha puntual generando 1 sola reserva.
    • Importación de materias multi-carrera sin errores de estado en SQLAlchemy.
  4. Cero errores en @[current_problems] y Pyright (0 errors, 0 warnings).
  5. Suite de tests automatizados al 100% aprobada.
  6. Despliegue en producción institucional verificado en https://eduspace.oemspot.com.ar.