3.9 KiB
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:
- Elegir el número exacto de semanas a importar (ej. 1, 2, 4, 8, 12, 16 semanas).
- 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.
- Importar ÚNICAMENTE para fecha puntual (1 sola asignación por fila).
- 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:- Número de Semanas: Permite ingresar un entero positivo (por defecto 16).
- Rango de Fechas (Desde - Hasta): Permite ingresar fecha de inicio (
date_from) y fecha de fin (date_to). - 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
Nsemanas, EL SISTEMA generará reservas para las primerasNsemanas 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_fromydate_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
SubjectyCareerconfigurada 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)
- Selector interactivo en la vista
/admin/importcon opciones claras: "Cuatrimestre / Por Semanas", "Rango de Fechas (Desde - Hasta)" y "Fecha Puntual Única". - Endpoint
/api/v1/admin/sync-sheetsy servicioGoogleSheetsImporter.sync()procesandoweeks_to_generate,date_from,date_to,manual_dateysingle_date_only. - 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.
- Cero errores en
@[current_problems]y Pyright (0 errors, 0 warnings). - Suite de tests automatizados al 100% aprobada.
- Despliegue en producción institucional verificado en
https://eduspace.oemspot.com.ar.