Files

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_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.
  • 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.
  • 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.
  • 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.
  • 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.