# 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`.