Spaces:
Runtime error
Runtime error
|
Download docs/backlog.md from Talosware/talos-access: direct link, hf CLI and curl.
- Browser
- Download file 4.87 kB
-
https://huggingface.co/spaces/Talosware/talos-access/resolve/main/docs/backlog.md
- Command line
-
hf download hf://spaces/Talosware/talos-access/docs/backlog.md
-
curl -L -o backlog.md https://huggingface.co/spaces/Talosware/talos-access/resolve/main/docs/backlog.md
4.87 kB
| # 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`. | |