5.1 KiB
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_usersenbackend/routers/admin.pypara aceptarpage,per_page,ally filtros SQL con conteoquery.count()y.offset().limit(). - Crear endpoint
/api/v1/users/teachersenbackend/routers/admin.pycon filtro de rol y proyección ligera (id,name,email). - Añadir índices en
User.role_idyUser.is_activeenbackend/app/models/user.py.
- Actualizar
- Hecho cuando:
/api/v1/users?page=1&per_page=25retorna estructura contotal,pages,page,per_page,has_prev,has_nexty/api/v1/users/teachersretorna solo docentes activos sin errores.
-
Tarea 2: Optimización de Backend en Auditoría y Reservas
- Estimación: 25 min
- Acciones:
- Actualizar
AuditService.get_logspara recibirpage,per_page,searchy calculartotal = query.count()con.offset().limit(). - Actualizar
get_audit_logsenbackend/routers/admin.pypara exponer el bloquepaginationcompleto. - Actualizar
list_reservationsenbackend/routers/reservations.pypara mover los filtros en Python (floor,shift,search,is_virtual) a la consulta SQLAlchemy relacional con joins e imponer unlimitde seguridad predeterminado de 1000 registros.
- Actualizar
- Hecho cuando: Las consultas a
/api/v1/audit-logsretornan metadatos de paginación precisos y/api/v1/reservationsejecuta 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_commissionsenbackend/routers/academic.pypara soportarsearch,page,per_page,subjects,academic_termsycareersen la respuesta unificada. - Modificar
list_subjectsenbackend/routers/academic.pypara admitirpage,per_pagecon retrocompatibilidad.
- Modificar
- Hecho cuando: Las llamadas con parámetros de paginación a
/api/v1/commissionsy/api/v1/subjectsretornan 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
handleUsersListenfrontend/src/routes/admin.jspara consumir/admin/usersconpage,per_page,search,role,statusy construir el objetopaginationconpages_list. - Optimizar
fetchUsersAndRolesyhandleCommissionsListpara que la vista de comisiones use/api/v1/users/teachersen vez de cargar todos los usuarios. - Modificar
frontend/views/admin/users/list.htmlpara renderizar la barra de paginación conservando los query parameters activos y mostrando el contador total de registros y páginas.
- Modificar
- 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.pycubriendo paginación de usuarios, auditoría, endpoint de docentes y filtros de reservas. - Ejecutar suite
pytest tests -ven backend y verificar 100% verde. - Verificar con
pyright(Principio 10) que no haya errores de tipado o diagnóstico.
- Crear
- 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>enfrontend/views/dashboard/dashadm.htmlpara 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_classroomsylist_reservationsen FastAPI evitando códigos 422. - Limpiar el objeto de parámetros en
frontend/src/routes/admin.jspara/subjectsy/commissions.
- Reparar balance de etiquetas
- Hecho cuando:
/dashboard,/admin/subjects_listy/admin/commissions_listrenderizan 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.12enpackage.json,app.js,__init__.py,setup.py. - Actualizar
CHANGELOG.mdyMEMORY.md. - Ejecutar
git add ., commit ygit push origin dev. - Desplegar en el contenedor LXC de producción
10.0.0.217mediante script y verificar HTTP 200 en/versiony funcionamiento fluido en/admin/users_list,/dashboard,/admin/subjects_listy/admin/commissions_list.
- Incrementar versión semántica a
- Hecho cuando: Producción corre en
v3.8.12con respuesta exitosa y verificación de disponibilidad.