60 lines
5.1 KiB
Markdown
60 lines
5.1 KiB
Markdown
# 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 `</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.
|
|
|
|
- [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.
|