Files

48 lines
3.0 KiB
Markdown

# Tareas de Implementación: 005-importador-semanas-rango
- [x] **Tarea 1: Pruebas Automatizadas (Test-First)**
- Archivo: `backend/tests/test_sheets_import_temporal_scope.py`
- Contenido:
- Test de importación con `single_date_only=True` (1 asignación por fila).
- Test de importación con `weeks_to_generate=4` (4 asignaciones consecutivas).
- Test de importación con rango `date_from` y `date_to` (asignaciones estrictamente dentro del rango).
- Test de importación de materia con múltiples carreras (`ASIG00125` o similar) sin errores de `_sa_instance_state`.
- Hecho cuando: Los tests reflejen la especificación y fallen o validen según corresponda.
- [x] **Tarea 2: Backend Core - Servicio `sheets_importer.py`**
- Archivos: `backend/app/services/sheets_importer.py`
- Contenido:
- Agregar parámetros `weeks_to_generate`, `date_from`, `date_to` a `sync(...)`.
- Implementar parser y normalización de fechas `date_from` y `date_to`.
- Generar fechas correspondientes al día lectivo dentro del intervalo o por cantidad de semanas.
- Exponer en `stats['filters_applied']` la configuración temporal seleccionada.
- Hecho cuando: `sheets_importer.py` genere las fechas precisas según el modo indicado.
- [x] **Tarea 3: Backend Core - Servicio y Routers**
- Archivos: `backend/app/services/dashboard_service.py`, `backend/routers/admin.py`
- Contenido:
- Extraer parámetros temporales en `sync_sheets_data(data)` y pasarlos a `importer.sync(...)`.
- Validar en router que si se envía `date_from` y `date_to`, `date_from <= date_to`.
- Hecho cuando: El endpoint `/api/v1/admin/sync-sheets` acepte y aplique los parámetros temporales.
- [x] **Tarea 4: Frontend BFF e Interfaz de Usuario**
- Archivos: `frontend/src/routes/admin.js`, `frontend/views/admin/import.html`
- Contenido:
- Diseñar bloque de configuración temporal en `import.html` con 3 opciones claras:
1. Por Semanas (Input numérico + badges rápidos: 1, 4, 8, 16 semanas).
2. Rango de Fechas (Campos Desde y Hasta con datepickers).
3. Fecha Puntual Única (Switch `single_date_only` + campo de fecha puntual).
- Manejar la interacción JavaScript para alternar visibilidad o habilitación de campos según la opción elegida.
- Actualizar modal de confirmación mostrando el resumen temporal.
- Adaptar `admin.js` para recibir y enviar los campos en el payload JSON.
- Hecho cuando: Bedelía pueda elegir visualmente semanas, rango o fecha puntual y ver el resultado exacto en el resumen.
- [x] **Tarea 5: Verificación Integral, Cero Diagnósticos y Despliegue**
- Contenido:
- Ejecutar suite completa `pytest tests -v` (100% aprobada).
- Verificar `npx pyright` con 0 errores y 0 advertencias.
- Incrementar versión semántica a `v3.8.3` en backend y frontend.
- Actualizar `CHANGELOG.md` y `MEMORY.md`.
- `git push origin dev` y despliegue SSH a `10.0.0.217` con reinicio de servicios y smoke test HTTP 200 en `/version`.
- Hecho cuando: El servidor de producción esté corriendo `v3.8.3` activo y verificado.