3.4 KiB
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=TrueenSubject.careersyCareer.subjectscon anotaciones de lista explícitas (List['Career'],List['Subject']). (Ya aplicado y verificado).
- Garantizar
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):- Si
row_specific_dateestá presente en la fila:[row_specific_date]. - Si
single_date_onlyymanual_dt:[manual_dt]. - Si
date_from_dtydate_to_dt: Calcular todas las fechasden el intervalo[date\_from\_dt, date\_to\_dt]tales qued.weekday() == effective\_day\_idx. - 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]].
- Si
- Ampliar firma de
app/services/dashboard_service.py:- En
sync_sheets_data(data): Extraerweeks_to_generate,date_from,date_todel payload y enviarlos al importador. Reflejartemporal_mode,weeks_to_generate,date_from,date_toen las estadísticas retornadas (stats['filters_applied']).
- En
routers/admin.py:- Validar los parámetros opcionales en el endpoint
/api/v1/admin/sync-sheets.
- Validar los parámetros opcionales en el endpoint
1.2. Frontend BFF (frontend/)
src/routes/admin.js:- Propagar
weeks_to_generate,date_from,date_to,single_date_only,manual_date,time_scope_modeen el payload de sincronización hacia el backend Core.
- Propagar
views/admin/import.html:- Incorporar selector de modalidad temporal mediante controles visuales Bootstrap 5:
- Modo 1: Por Semanas: Input numérico para
Nsemanas 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) ydate_to(Hasta). - Modo 3: Fecha Puntual Única:
single_date_onlyactivado con campo de fecha única puntual.
- Modo 1: Por Semanas: Input numérico para
- 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.
- Incorporar selector de modalidad temporal mediante controles visuales Bootstrap 5:
2. Estrategia de Pruebas (Test-First)
- Crear
backend/tests/test_sheets_import_temporal_scope.py:test_sync_single_date_only_creates_one_reservation()test_sync_custom_weeks_count_creates_n_reservations()test_sync_date_range_creates_reservations_within_range()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.mdyMEMORY.md. git push origin devy despliegue SSH a10.0.0.217.- Smoke test HTTP 200 en
/versiony verificación visual en/admin/import.