Spaces:
Runtime error
Runtime error
File size: 4,866 Bytes
bbd61b0 5c66c84 bbd61b0 5c66c84 4a23a55 5c66c84 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 | # Backlog de trabajo
Lista de items identificados pero no abordados todavía. Tickea con `[x]` cuando se resuelven y muévelos a "Hecho" si querés conservar historial, o borralos.
## Performance — N+1 queries
Patrón uniforme de fix (mismo que usamos en sesión 2026-05-31 para sections/attendances/representative): batch-load-into-dict.
**Bad:**
```python
items = query.all()
for item in items:
related = db.query(Related).filter(Related.id == item.related_id).first()
```
**Good:**
```python
items = query.all()
related_ids = {i.related_id for i in items if i.related_id is not None}
related_by_id = {r.id: r for r in db.query(Related).filter(Related.id.in_(related_ids)).all()} if related_ids else {}
for item in items:
related = related_by_id.get(item.related_id)
```
### MEDIUM (1 + N o 1 + 2-3N)
Todos resueltos en sesión 2026-05-31 tarde (commits `bc019a7`, `8c218e0`, `7d5d51b`, `db14bae`). Mejora típica: 3-11x más rápido. Ver "Hecho" abajo para detalle.
### LOW (solo en bulk CSV uploads)
- [ ] **`enrollments.py:167-238`** — `POST /api/v1/enrollments/bulk` — 1 + 5N en CSVs grandes. Batch upfront: users por email, sections por nombre, enrollments existentes; precomputar capacity checks.
- [ ] **`users.py:127-224`** — `POST /api/v1/users/bulk` — 1 + 4N en CSVs grandes. Set de emails/card_ids upfront, single batch query para detectar duplicados.
### Borderline (revisar si se vuelve N+1 en uso real)
- [ ] **`teacher.py:595-644`** — `GET /api/v1/teacher/students/{student_id}/profile` — solo 1 query extra para padre, no es N+1 estrictamente. Solo problemático si se llama en loop desde otro endpoint. Auditar callers antes de tocar.
## Otros pendientes operativos
- [ ] **Eliminar secret `RUN_MIGRATIONS`** de HF Space Settings si quedó configurado (el código ya no lo lee, pero limpiar evita confusión). UI: https://huggingface.co/spaces/Talosware/talos-access/settings → Variables and secrets.
- [ ] **Validar cadena Alembic 001→022 sobre Postgres vacío** — en sesión actual usamos `alembic stamp head` para evitar este test. Si en algún momento un dev nuevo arma su entorno con `alembic upgrade head` desde cero, puede fallar por migraciones que se crearon contra MariaDB. Workaround: rebajar a `stamp head` o auditar y reescribir migraciones legacy.
- [ ] **Crear `backend/tests/test_entrypoint_paths.py`** — integration test que ejerce los 3 paths del entrypoint (UPGRADE/STAMP/INIT) end-to-end. Hubiera atrapado el bug de syntax MySQL en la migración `33cb4ee027ee` antes del bundling en el commit `2b28dbf`. Ver spec `docs/superpowers/specs/2026-05-31-run-migrations-automation-design.md` líneas 129-134.
- [ ] **Cambiar default `DEBUG` a `False`** en `backend/app/core/config.py:17`. Hoy default es `True` (echo SQL en producción si no se overridea). Cambiar default a `False` y settear `DEBUG=true` solo en `docker-compose.yml` para local. Más seguro como default.
## Cómo usar este backlog
- Agregar items: cualquier "deuda" detectada en una sesión que no se ataca en el momento debe terminar acá. Si es spec o plan formal, va a `docs/superpowers/`; si es un TODO concreto, va acá.
- Resolver: tildá `[x]`, podés dejar o mover a sección "Hecho" abajo.
- Sin owners ni fechas — este es un backlog informal, no un Jira.
## Hecho
### 2026-05-31 (tarde) — N+1 MEDIUM
- [x] `teacher_sections.py` — `GET /teacher-sections`: **7.0s → 0.88s** (-87%). Commit `bc019a7`.
- [x] `teacher_subjects.py` — `GET /teacher-subjects` + `PUT /teacher-subjects/{teacher_id}`: 2.3s → **0.74s** (-68%). Commit `7d5d51b`.
- [x] `section_subjects.py` — `GET /section-subjects` + `PUT /section-subjects/{section_id}`: 3.9s → **0.74s** (-81%). Commit `db14bae`.
- [x] `teacher.py` — `GET /teacher/subjects`: 3.4s → **0.90s** (-74%); `GET /teacher/sections`: **11.5s → 1.89s** (-84%, era 1+4N nested); `GET /teacher/schedule`: 8.1s → **0.99s** (-88%). Commit `8c218e0`.
Para la vista de docente (que llamaba 3 endpoints serial = 23s totales), ahora total ≈ 3.78s. **6x más rápido.**
### 2026-05-31 (noche) — TZ bug en checkout_time
- [x] Backend escribía `datetime.now()` naive en container TZ=Caracas → DB guardaba 4h adelantado en UTC, frontend mostraba 4h atrasado. Fix en 4 archivos: attendances.py, facial.py, teacher.py, developer.py. Commit `4a12934`. Datos históricos reparados con migración 024 (`+8h` neto, filtro `NOW()-1h` para preservar writes nuevos). Memoria: [[reference-container-tz-caracas]].
### 2026-05-31 (mañana) — N+1 HIGH
- [x] `sections.py` HIGH — `GET /sections`: 4.2s → **0.97s** (-77%). Commit `56ae587`.
- [x] `attendances.py` HIGH — `GET /attendances/today`: 3.2s → **0.84s** (-74%). Commit `cb5338b`.
- [x] `representative.py` HIGH — `GET /representative/children`: 1+6N → 1+7 queries totales. Commit `dcc7429`.
|