# Desglose de Tareas: Paginación Server-Side y Optimización de Base de Datos ## Tareas de Implementación - [x] **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. - [x] **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. - [x] **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. - [x] **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. - [x] **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. - [x] **Tarea 6: Reparación de Layout de Dashboard y Resiliencia en Filtros de Asignaturas/Comisiones** - **Estimación**: 20 min - **Acciones**: - Reparar balance de etiquetas `` 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. - [x] **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.