Files

5.1 KiB

Desglose de Tareas: Paginación Server-Side y Optimización de Base de Datos

Tareas de Implementación

  • Tarea 1: Optimización de Backend en Usuarios y Endpoint Especializado de Docentes

    • Estimación: 25 min
    • Acciones:
      • Actualizar get_users en backend/routers/admin.py para aceptar page, per_page, all y filtros SQL con conteo query.count() y .offset().limit().
      • Crear endpoint /api/v1/users/teachers en backend/routers/admin.py con filtro de rol y proyección ligera (id, name, email).
      • Añadir índices en User.role_id y User.is_active en backend/app/models/user.py.
    • Hecho cuando: /api/v1/users?page=1&per_page=25 retorna estructura con total, pages, page, per_page, has_prev, has_next y /api/v1/users/teachers retorna solo docentes activos sin errores.
  • Tarea 2: Optimización de Backend en Auditoría y Reservas

    • Estimación: 25 min
    • Acciones:
      • Actualizar AuditService.get_logs para recibir page, per_page, search y calcular total = query.count() con .offset().limit().
      • Actualizar get_audit_logs en backend/routers/admin.py para exponer el bloque pagination completo.
      • Actualizar list_reservations en backend/routers/reservations.py para mover los filtros en Python (floor, shift, search, is_virtual) a la consulta SQLAlchemy relacional con joins e imponer un limit de seguridad predeterminado de 1000 registros.
    • Hecho cuando: Las consultas a /api/v1/audit-logs retornan metadatos de paginación precisos y /api/v1/reservations ejecuta sus filtros en la cláusula SQL WHERE.
  • Tarea 3: Optimización de Backend en Estructura Académica (Comisiones y Asignaturas)

    • Estimación: 20 min
    • Acciones:
      • Modificar list_commissions en backend/routers/academic.py para soportar search, page, per_page, subjects, academic_terms y careers en la respuesta unificada.
      • Modificar list_subjects en backend/routers/academic.py para admitir page, per_page con retrocompatibilidad.
    • Hecho cuando: Las llamadas con parámetros de paginación a /api/v1/commissions y /api/v1/subjects retornan datos paginados y los conteos de registros reales.
  • Tarea 4: Implementación de Paginación en Frontend BFF y Vistas Nunjucks

    • Estimación: 30 min
    • Acciones:
      • Modificar handleUsersList en frontend/src/routes/admin.js para consumir /admin/users con page, per_page, search, role, status y construir el objeto pagination con pages_list.
      • Optimizar fetchUsersAndRoles y handleCommissionsList para que la vista de comisiones use /api/v1/users/teachers en vez de cargar todos los usuarios.
      • Modificar frontend/views/admin/users/list.html para renderizar la barra de paginación conservando los query parameters activos y mostrando el contador total de registros y páginas.
    • Hecho cuando: Al navegar por /admin/users_list, la página se divide en bloques de 25 registros, los enlaces de página funcionan manteniendo los filtros y la memoria se mantiene estable.
  • Tarea 5: Suite de Pruebas Automatizadas y Verificación de Tipos (Zero Errors)

    • Estimación: 25 min
    • Acciones:
      • Crear backend/tests/test_pagination_db.py cubriendo paginación de usuarios, auditoría, endpoint de docentes y filtros de reservas.
      • Ejecutar suite pytest tests -v en backend y verificar 100% verde.
      • Verificar con pyright (Principio 10) que no haya errores de tipado o diagnóstico.
    • Hecho cuando: Todas las pruebas automatizadas pasan y no hay advertencias ni errores en el Language Server.
  • Tarea 6: Reparación de Layout de Dashboard y Resiliencia en Filtros de Asignaturas/Comisiones

    • Estimación: 20 min
    • Acciones:
      • Reparar balance de etiquetas </div> en frontend/views/dashboard/dashadm.html para devolver módulos de gestión, menús visuales y gráfico de tendencia a su posición correcta en el grid principal.
      • Soportar parámetros de búsqueda vacíos en list_subjects, list_commissions, list_classrooms y list_reservations en FastAPI evitando códigos 422.
      • Limpiar el objeto de parámetros en frontend/src/routes/admin.js para /subjects y /commissions.
    • Hecho cuando: /dashboard, /admin/subjects_list y /admin/commissions_list renderizan perfectamente los elementos y datos en la UI.
  • Tarea 7: Bump Semántico a v3.8.12, Git Push y Despliegue en Producción

    • Estimación: 20 min
    • Acciones:
      • Incrementar versión semántica a v3.8.12 en package.json, app.js, __init__.py, setup.py.
      • Actualizar CHANGELOG.md y MEMORY.md.
      • Ejecutar git add ., commit y git push origin dev.
      • Desplegar en el contenedor LXC de producción 10.0.0.217 mediante script y verificar HTTP 200 en /version y funcionamiento fluido en /admin/users_list, /dashboard, /admin/subjects_list y /admin/commissions_list.
    • Hecho cuando: Producción corre en v3.8.12 con respuesta exitosa y verificación de disponibilidad.