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