Files

3.4 KiB

Plan Técnico: 005-importador-semanas-rango

1. Arquitectura y Componentes Afectados

1.1. Backend Core (backend/)

  • app/models/subject.py & app/models/career.py:
    • Garantizar uselist=True en Subject.careers y Career.subjects con anotaciones de lista explícitas (List['Career'], List['Subject']). (Ya aplicado y verificado).
  • app/services/sheets_importer.py:
    • Ampliar firma de sync(...):
      def sync(
          self,
          filter_career=None,
          filter_subject=None,
          filter_day=None,
          filter_days=None,
          manual_date=None,
          single_date_only=False,
          weeks_to_generate=16,
          date_from=None,
          date_to=None,
          import_careers=True,
          import_subjects=True,
          import_commissions=True,
          import_classrooms=True,
          import_reservations=True,
          selected_rows=None
      ):
      
    • Lógica de cálculo de fechas por fila (dates_to_generate):
      1. Si row_specific_date está presente en la fila: [row_specific_date].
      2. Si single_date_only y manual_dt: [manual_dt].
      3. Si date_from_dt y date_to_dt: Calcular todas las fechas d en el intervalo [date\_from\_dt, date\_to\_dt] tales que d.weekday() == effective\_day\_idx.
      4. En otro caso (por número de semanas): Tomar W = \max(1, \min(30, int(weeks\_to\_generate or 16))). Generar [base\_monday + timedelta(days=effective\_day\_idx, weeks=w) \text{ para } w \in [0..W-1]].
  • app/services/dashboard_service.py:
    • En sync_sheets_data(data): Extraer weeks_to_generate, date_from, date_to del payload y enviarlos al importador. Reflejar temporal_mode, weeks_to_generate, date_from, date_to en las estadísticas retornadas (stats['filters_applied']).
  • routers/admin.py:
    • Validar los parámetros opcionales en el endpoint /api/v1/admin/sync-sheets.

1.2. Frontend BFF (frontend/)

  • src/routes/admin.js:
    • Propagar weeks_to_generate, date_from, date_to, single_date_only, manual_date, time_scope_mode en el payload de sincronización hacia el backend Core.
  • views/admin/import.html:
    • Incorporar selector de modalidad temporal mediante controles visuales Bootstrap 5:
      • Modo 1: Por Semanas: Input numérico para N semanas con badges de selección rápida (1 sem, 4 sem, 8 sem, 16 sem).
      • Modo 2: Rango de Fechas: Dos campos date_from (Desde) y date_to (Hasta).
      • Modo 3: Fecha Puntual Única: single_date_only activado con campo de fecha única puntual.
    • Sincronización reactiva en JavaScript: al cambiar de modo, se habilitan o deshabilitan los inputs correspondientes y se actualiza el resumen del modal de confirmación.

2. Estrategia de Pruebas (Test-First)

  • Crear backend/tests/test_sheets_import_temporal_scope.py:
    1. test_sync_single_date_only_creates_one_reservation()
    2. test_sync_custom_weeks_count_creates_n_reservations()
    3. test_sync_date_range_creates_reservations_within_range()
    4. test_sync_multi_career_assignment_without_sa_instance_state_error()
  • Ejecución completa con pytest tests -v (61 tests esperados pasando).

3. Despliegue y Validación

  • Bump a v3.8.3.
  • Actualizar CHANGELOG.md y MEMORY.md.
  • git push origin dev y despliegue SSH a 10.0.0.217.
  • Smoke test HTTP 200 en /version y verificación visual en /admin/import.