3.0 KiB
3.0 KiB
Tareas de Implementación: 005-importador-semanas-rango
-
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_fromydate_to(asignaciones estrictamente dentro del rango). - Test de importación de materia con múltiples carreras (
ASIG00125o similar) sin errores de_sa_instance_state.
- Test de importación con
- Hecho cuando: Los tests reflejen la especificación y fallen o validen según corresponda.
- Archivo:
-
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_toasync(...). - Implementar parser y normalización de fechas
date_fromydate_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.
- Agregar parámetros
- Hecho cuando:
sheets_importer.pygenere las fechas precisas según el modo indicado.
- Archivos:
-
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 aimporter.sync(...). - Validar en router que si se envía
date_fromydate_to,date_from <= date_to.
- Extraer parámetros temporales en
- Hecho cuando: El endpoint
/api/v1/admin/sync-sheetsacepte y aplique los parámetros temporales.
- Archivos:
-
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.htmlcon 3 opciones claras:- Por Semanas (Input numérico + badges rápidos: 1, 4, 8, 16 semanas).
- Rango de Fechas (Campos Desde y Hasta con datepickers).
- 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.jspara recibir y enviar los campos en el payload JSON.
- Diseñar bloque de configuración temporal en
- Hecho cuando: Bedelía pueda elegir visualmente semanas, rango o fecha puntual y ver el resultado exacto en el resumen.
- Archivos:
-
Tarea 5: Verificación Integral, Cero Diagnósticos y Despliegue
- Contenido:
- Ejecutar suite completa
pytest tests -v(100% aprobada). - Verificar
npx pyrightcon 0 errores y 0 advertencias. - Incrementar versión semántica a
v3.8.3en backend y frontend. - Actualizar
CHANGELOG.mdyMEMORY.md. git push origin devy despliegue SSH a10.0.0.217con reinicio de servicios y smoke test HTTP 200 en/version.
- Ejecutar suite completa
- Hecho cuando: El servidor de producción esté corriendo
v3.8.3activo y verificado.
- Contenido: