72 lines
3.4 KiB
Markdown
72 lines
3.4 KiB
Markdown
# 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(...)`:
|
|
```python
|
|
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`.
|