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:
items = query.all()
for item in items:
related = db.query(Related).filter(Related.id == item.related_id).first()
Good:
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_MIGRATIONSde 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 headpara evitar este test. Si en algún momento un dev nuevo arma su entorno conalembic upgrade headdesde cero, puede fallar por migraciones que se crearon contra MariaDB. Workaround: rebajar astamp heado 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ón33cb4ee027eeantes del bundling en el commit2b28dbf. Ver specdocs/superpowers/specs/2026-05-31-run-migrations-automation-design.mdlíneas 129-134. - Cambiar default
DEBUGaFalseenbackend/app/core/config.py:17. Hoy default esTrue(echo SQL en producción si no se overridea). Cambiar default aFalsey settearDEBUG=truesolo endocker-compose.ymlpara 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
-
teacher_sections.py—GET /teacher-sections: 7.0s → 0.88s (-87%). Commitbc019a7. -
teacher_subjects.py—GET /teacher-subjects+PUT /teacher-subjects/{teacher_id}: 2.3s → 0.74s (-68%). Commit7d5d51b. -
section_subjects.py—GET /section-subjects+PUT /section-subjects/{section_id}: 3.9s → 0.74s (-81%). Commitdb14bae. -
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%). Commit8c218e0.
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
- 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. Commit4a12934. Datos históricos reparados con migración 024 (+8hneto, filtroNOW()-1hpara preservar writes nuevos). Memoria: [[reference-container-tz-caracas]].
2026-05-31 (mañana) — N+1 HIGH
-
sections.pyHIGH —GET /sections: 4.2s → 0.97s (-77%). Commit56ae587. -
attendances.pyHIGH —GET /attendances/today: 3.2s → 0.84s (-74%). Commitcb5338b. -
representative.pyHIGH —GET /representative/children: 1+6N → 1+7 queries totales. Commitdcc7429.