talos-access / docs /backlog.md
Greg
Claude Opus 4.7 (1M context)
docs(backlog): record TZ bug fix in done log
4a23a55
|
Raw History Blame Contribute Delete
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_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

  • teacher_sections.py — GET /teacher-sections: 7.0s → 0.88s (-87%). Commit bc019a7.
  • teacher_subjects.py — GET /teacher-subjects + PUT /teacher-subjects/{teacher_id}: 2.3s → 0.74s (-68%). Commit 7d5d51b.
  • section_subjects.py — GET /section-subjects + PUT /section-subjects/{section_id}: 3.9s → 0.74s (-81%). Commit db14bae.
  • 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

  • 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

  • sections.py HIGH — GET /sections: 4.2s → 0.97s (-77%). Commit 56ae587.
  • attendances.py HIGH — GET /attendances/today: 3.2s → 0.84s (-74%). Commit cb5338b.
  • representative.py HIGH — GET /representative/children: 1+6N → 1+7 queries totales. Commit dcc7429.