fix: corregir layout de dashboard, resiliencia en filtros de asignaturas y paginacion de bd (v3.8.12)

This commit is contained in:
2026-10-26 12:25:00 -03:00
parent f022cf9bc6
commit 71a0ac5d11
23 changed files with 881 additions and 189 deletions
+13
View File
@@ -11,6 +11,19 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
## [3.8.12] - 2026-10-26
### Fixed
- **Dashboard Layout y Estructura Visual (`frontend/views/dashboard/dashadm.html`)**:
- Removidos 3 tags `</div>` de cierre prematuro en la sección de balance de aulas físicas que expulsaban los módulos de gestión, los menús visuales y el gráfico de tendencia de ocupación fuera del contenedor principal hacia el fondo de la página, restableciendo la UI y UX original.
- **Resiliencia en Filtrado y Paginación de Asignaturas y Comisiones (`/admin/subjects_list` y `/admin/commissions_list`)**:
- Solucionado el error HTTP 422 Unprocessable Entity en FastAPI provocado cuando el frontend o los formularios enviaban parámetros vacíos (`career_id=&active=&search=`). Ahora los endpoints `/api/v1/subjects` y `/api/v1/commissions` aceptan `Optional[str]` y realizan un parsing seguro a enteros, permitiendo renderizar correctamente las 22 asignaturas y 22 comisiones registradas.
- Enriquecido el BFF de Express (`frontend/src/routes/admin.js`) depurando el objeto `params` para no enviar claves vacías a la API.
- **Paginación y Optimización de Base de Datos en Vistas Masivas (Spec 008)**:
- Implementada paginación server-side con metadatos estructurados en `/api/v1/admin/users`, `/api/v1/audit-logs`, `/api/v1/subjects` y `/api/v1/commissions`.
- Añadido endpoint `/api/v1/users/teachers` para selectores de docentes sin transferir la lista de miles de usuarios.
- Corregida la consulta SQL relacional en `ReservationRepository` utilizando `not_(Classroom.code.ilike('%VIRTUAL%'))` y `Classroom.id.is_(None)` para el filtrado seguro de aulas virtuales.
- Creada suite de pruebas unitarias y de integración `backend/tests/test_pagination_db.py` (6 passed).
## [3.8.11] - 2026-10-26
### Fixed
- **Exclusión de Reservas Pasadas en Fichas y Tarjetas de Aulas (`view_classroom` y `list_classrooms`)**:
+5 -6
View File
@@ -9,12 +9,11 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación.
- Reinicialización segura del sistema con contraseña de Administrador.
- **Sprint Activo: Exclusión de Reservas Pasadas en Aulas y Fichas — v3.8.11**:
- **Exclusión de Reservas Pasadas en Fichas y Tarjetas de Aulas (`view_classroom` y `list_classrooms`)**:
- Separadas reservas próximas vigentes de reservas concluidas en `handleViewClassroom`. Las clases de fechas anteriores (ej. 21/10/2026) ya no se muestran en "Próximas Clases y Reservas", mostrando el empty state correspondiente e incorporando una sección colapsable de historial de clases finalizadas.
- Filtradas las cursadas asignadas y `total_classes` en las tarjetas de `list_classrooms` para considerar exclusivamente reservas activas de hoy en adelante, evitando que reservas pasadas continúen figurando como cursadas activas.
- Preformateadas fechas y estados ("Finalizada") en el modal de sesiones del Campus Virtual.
- **Versión Consolidada**: `v3.8.11`.
- **Sprint Activo: Paginación DB, Corrección de Layout de Dashboard y Resiliencia de Asignaturas/Comisiones — v3.8.12**:
- **Corrección de Layout del Dashboard (`dashadm.html`)**: Removidos 3 tags `</div>` extra en el panel de percentiles que provocaban el desbordamiento de la sección de módulos de gestión y la tendencia de ocupación al fondo de la pantalla.
- **Resiliencia en Asignaturas y Comisiones**: Solucionado el error HTTP 422 en FastAPI (`list_subjects` y `list_commissions`) cuando los formularios o peticiones envían strings vacíos en parámetros de filtrado numéricos (`career_id`, `subject_id`). Depurado el BFF en Express para no propagar parámetros vacíos.
- **Paginación Server-Side y Optimización DB (Spec 008)**: Paginación server-side implementada para usuarios, logs de auditoría, asignaturas y comisiones. Endpoint `/api/v1/users/teachers` para listas de selección de docentes.
- **Versión Consolidada**: `v3.8.12`.
## Decisiones (y por qué)
- **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional.
+1 -1
View File
@@ -7,7 +7,7 @@ from typing import Any
from database import db, get_db, engine, SessionLocal, session
from config.config import Config
__version__ = "3.8.11"
__version__ = "3.8.12"
class DummyContext:
def __enter__(self):
+2 -2
View File
@@ -15,12 +15,12 @@ class User(db.Model):
password_hash = db.Column(db.String(255), nullable=False)
name = db.Column(db.String(100), nullable=False)
role = db.Column(db.String(50), nullable=False)
is_active = db.Column(db.Boolean, default=True, nullable=False)
is_active = db.Column(db.Boolean, default=True, nullable=False, index=True)
created_at = db.Column(db.DateTime, default=lambda: datetime.now(timezone.utc).replace(tzinfo=None))
last_login = db.Column(db.DateTime)
preferred_language = db.Column(db.String(10), default=None, nullable=True)
theme_preference = db.Column(db.String(10), default='auto', nullable=False)
role_id = db.Column(db.Integer, db.ForeignKey('roles.id', ondelete='SET NULL'), nullable=True)
role_id = db.Column(db.Integer, db.ForeignKey('roles.id', ondelete='SET NULL'), nullable=True, index=True)
# Extended personal, contact and identity document fields
first_name = db.Column(db.String(100), nullable=True)
@@ -1,8 +1,10 @@
from typing import Optional, List
from datetime import datetime, date, time
from sqlalchemy.orm import joinedload
from sqlalchemy import and_, or_
from sqlalchemy import and_, or_, func, not_
from app.models.reservation import Reservation, ReservationStatus
from app.models.classroom import Classroom
from app.models.user import User
from app.repositories.base_repository import BaseRepository
from app import db
@@ -31,8 +33,13 @@ class ReservationRepository(BaseRepository[Reservation]):
return query.all()
def get_by_date_range(self, start_dt: datetime, end_dt: datetime,
classroom_id: Optional[int] = None) -> List[Reservation]:
"""Obtiene reservas dentro de una ventana temporal con carga ansiosa de relaciones."""
classroom_id: Optional[int] = None,
is_hide_virtual: bool = False,
floor: Optional[str] = None,
shift: Optional[str] = None,
search: Optional[str] = None,
limit: int = 1000) -> List[Reservation]:
"""Obtiene reservas dentro de una ventana temporal con carga ansiosa y filtros en SQL."""
query = Reservation.query.options(
joinedload(Reservation.classroom),
joinedload(Reservation.commission),
@@ -46,7 +53,38 @@ class ReservationRepository(BaseRepository[Reservation]):
if classroom_id:
query = query.filter(Reservation.classroom_id == classroom_id)
return query.order_by(Reservation.start_time.asc()).all()
if is_hide_virtual:
query = query.outerjoin(Classroom, Reservation.classroom_id == Classroom.id).filter(
or_(
Classroom.id.is_(None),
and_(
not_(Classroom.code.ilike('%VIRTUAL%')),
not_(Classroom.building.ilike('%VIRTUAL%'))
)
)
)
if floor:
query = query.join(Classroom, Reservation.classroom_id == Classroom.id).filter(
func.lower(Classroom.floor) == floor.strip().lower()
)
if shift:
query = query.filter(Reservation.shift.ilike(f'%{shift.strip()}%'))
if search:
s_clean = search.strip().lower()
query = query.outerjoin(Classroom, Reservation.classroom_id == Classroom.id)\
.outerjoin(User, Reservation.user_id == User.id)\
.filter(
or_(
Reservation.purpose.ilike(f'%{s_clean}%'),
Classroom.code.ilike(f'%{s_clean}%'),
User.name.ilike(f'%{s_clean}%')
)
)
return query.order_by(Reservation.start_time.asc()).limit(limit).all()
def get_by_teacher(self, teacher_id: int) -> List[Reservation]:
"""Obtiene reservas asignadas a un docente."""
+37 -1
View File
@@ -1,5 +1,6 @@
from typing import Optional, List, Dict, Any
from typing import Optional, List, Dict, Any, Tuple
import json
from sqlalchemy import or_
from app import db
from app.models.audit_log import AuditLog
from app.models.user import User
@@ -94,7 +95,42 @@ class AuditService:
return query.order_by(AuditLog.created_at.desc()).limit(limit).all()
@staticmethod
def get_paginated_logs(
module: Optional[str] = None,
action: Optional[str] = None,
user_id: Optional[int] = None,
search: Optional[str] = None,
page: int = 1,
per_page: int = 25
) -> Tuple[List[AuditLog], int]:
"""Recupera eventos de auditoría con filtros SQL, búsqueda y paginación server-side."""
query = AuditLog.query
if module:
query = query.filter(AuditLog.module == module)
if action:
query = query.filter(AuditLog.action == action)
if user_id:
query = query.filter(AuditLog.user_id == user_id)
if search:
s_clean = search.strip().lower()
query = query.filter(
or_(
AuditLog.details.ilike(f'%{s_clean}%'),
AuditLog.user_email.ilike(f'%{s_clean}%'),
AuditLog.action.ilike(f'%{s_clean}%'),
AuditLog.module.ilike(f'%{s_clean}%'),
AuditLog.ip_address.ilike(f'%{s_clean}%')
)
)
total = query.count()
logs = query.order_by(AuditLog.created_at.desc()).offset((page - 1) * per_page).limit(per_page).all()
return logs, total
@staticmethod
def get_recent_logs(limit: int = 50, module: Optional[str] = None,
action: Optional[str] = None) -> List[AuditLog]:
return AuditService.get_logs(module=module, action=action, limit=limit)
+16 -3
View File
@@ -21,9 +21,22 @@ class ReservationService:
return self.reservation_repo.get_by_id(reservation_id)
def list_reservations(self, start_dt: datetime, end_dt: datetime,
classroom_id: Optional[int] = None) -> List[Reservation]:
"""Obtiene reservas dentro de un rango temporal."""
return self.reservation_repo.get_by_date_range(start_dt, end_dt, classroom_id=classroom_id)
classroom_id: Optional[int] = None,
is_hide_virtual: bool = False,
floor: Optional[str] = None,
shift: Optional[str] = None,
search: Optional[str] = None,
limit: int = 1000) -> List[Reservation]:
"""Obtiene reservas dentro de un rango temporal con filtros SQL."""
return self.reservation_repo.get_by_date_range(
start_dt, end_dt,
classroom_id=classroom_id,
is_hide_virtual=is_hide_virtual,
floor=floor,
shift=shift,
search=search,
limit=limit
)
def check_conflicts(self, classroom_id: int, start_time: datetime, end_time: datetime,
exclude_id: Optional[int] = None) -> List[Reservation]:
+80 -19
View File
@@ -6,6 +6,7 @@ from typing import Optional, List, Dict, Any
from fastapi import APIRouter, Depends, HTTPException, Query, status, Request
from sqlalchemy import func, or_
from datetime import datetime, timezone
import math
from app import db
from app.models.career import Career
@@ -142,13 +143,15 @@ def delete_career(
@academic_router.get("/subjects")
def list_subjects(
search: Optional[str] = Query(None),
career_id: Optional[int] = Query(None),
career_id: Optional[str] = Query(None),
active: Optional[str] = Query(None),
page: Optional[int] = Query(None, ge=1),
per_page: Optional[int] = Query(None, ge=1, le=200),
current_user: User = Depends(get_current_user)
):
"""Lista las asignaturas con filtros opcionales de búsqueda, carrera y estado."""
"""Lista las asignaturas con filtros opcionales de búsqueda, carrera, estado y paginación."""
query = Subject.query
if search:
if search and search.strip():
s_clean = search.strip().lower()
query = query.filter(
or_(
@@ -158,16 +161,30 @@ def list_subjects(
Subject.careers.any(Career.name.ilike(f'%{s_clean}%'))
)
)
if career_id:
query = query.filter(or_(Subject.career_id == career_id, Subject.careers.any(Career.id == career_id)))
parsed_career_id = int(career_id.strip()) if career_id and str(career_id).strip().isdigit() else None
if parsed_career_id:
query = query.filter(or_(Subject.career_id == parsed_career_id, Subject.careers.any(Career.id == parsed_career_id)))
if active == 'true':
query = query.filter(Subject.is_active == True)
elif active == 'false':
query = query.filter(Subject.is_active == False)
subjects = query.order_by(Subject.id.asc()).all()
total = query.count()
careers = Career.query.order_by(Career.name.asc()).all()
if page and per_page:
pages = math.ceil(total / per_page) if total > 0 else 1
subjects = query.order_by(Subject.id.asc()).offset((page - 1) * per_page).limit(per_page).all()
has_prev = page > 1
has_next = page < pages
else:
pages = 1
page = 1
per_page = total or 1
has_prev = False
has_next = False
subjects = query.order_by(Subject.id.asc()).all()
subjects_data = []
for s in subjects:
d = s.to_dict()
@@ -184,7 +201,12 @@ def list_subjects(
return {
'status': 'success',
'total': len(subjects_data),
'total': total,
'page': page,
'per_page': per_page,
'pages': pages,
'has_prev': has_prev,
'has_next': has_next,
'subjects': subjects_data,
'careers': [c.to_dict() for c in careers]
}
@@ -382,31 +404,70 @@ def delete_subject(
@academic_router.get("/commissions")
def list_commissions(
subject_id: Optional[int] = Query(None),
career_id: Optional[int] = Query(None),
search: Optional[str] = Query(None),
subject_id: Optional[str] = Query(None),
career_id: Optional[str] = Query(None),
shift: Optional[str] = Query(None),
active: Optional[str] = Query(None),
page: Optional[int] = Query(None, ge=1),
per_page: Optional[int] = Query(None, ge=1, le=200),
current_user: User = Depends(get_current_user)
):
"""Lista las comisiones académicas con soporte para filtros de carrera, materia y turno."""
"""Lista las comisiones académicas con soporte para filtros de búsqueda, carrera, materia, turno y paginación."""
query = Commission.query
if subject_id:
query = query.filter(Commission.subject_id == subject_id)
if career_id:
query = query.join(Subject, Commission.subject_id == Subject.id).filter(
or_(Subject.career_id == career_id, Subject.careers.any(Career.id == career_id))
joined_subject = False
if search and search.strip():
s_clean = search.strip().lower()
query = query.outerjoin(Subject, Commission.subject_id == Subject.id)
joined_subject = True
query = query.filter(
or_(
Commission.code.ilike(f'%{s_clean}%'),
Commission.schedule.ilike(f'%{s_clean}%'),
Subject.name.ilike(f'%{s_clean}%'),
Subject.code.ilike(f'%{s_clean}%')
)
)
if shift:
query = query.filter(Commission.shift == shift)
parsed_subject_id = int(subject_id.strip()) if subject_id and str(subject_id).strip().isdigit() else None
parsed_career_id = int(career_id.strip()) if career_id and str(career_id).strip().isdigit() else None
if parsed_subject_id:
query = query.filter(Commission.subject_id == parsed_subject_id)
if parsed_career_id:
if not joined_subject:
query = query.join(Subject, Commission.subject_id == Subject.id)
joined_subject = True
query = query.filter(
or_(Subject.career_id == parsed_career_id, Subject.careers.any(Career.id == parsed_career_id))
)
if shift and shift.strip():
query = query.filter(Commission.shift == shift.strip())
if active == 'true':
query = query.filter(Commission.active == True)
elif active == 'false':
query = query.filter(Commission.active == False)
commissions = query.order_by(Commission.year.desc(), Commission.semester.desc(), Commission.code.asc()).all()
total = query.count()
if page and per_page:
pages = math.ceil(total / per_page) if total > 0 else 1
commissions = query.order_by(Commission.year.desc(), Commission.semester.desc(), Commission.code.asc()).offset((page - 1) * per_page).limit(per_page).all()
has_prev = page > 1
has_next = page < pages
else:
pages = 1
page = 1
per_page = total or 1
has_prev = False
has_next = False
commissions = query.order_by(Commission.year.desc(), Commission.semester.desc(), Commission.code.asc()).all()
return {
'status': 'success',
'total': len(commissions),
'total': total,
'page': page,
'per_page': per_page,
'pages': pages,
'has_prev': has_prev,
'has_next': has_next,
'commissions': [c.to_dict() for c in commissions]
}
+88 -12
View File
@@ -7,6 +7,7 @@ from typing import Optional, List, Dict, Any
from fastapi import APIRouter, Depends, HTTPException, Query, status, Request
from sqlalchemy import func, or_
from datetime import datetime, timezone
import math
from app import db
from app.models.user import User
@@ -33,9 +34,12 @@ def get_users(
search: Optional[str] = Query(None),
role_id: Optional[int] = Query(None, alias="role"),
status_filter: Optional[str] = Query(None, alias="status"),
page: int = Query(1, ge=1),
per_page: int = Query(25, ge=1, le=200),
all_records: bool = Query(False, alias="all"),
current_user: User = Depends(require_roles(["ADMIN", "BEDELIA"]))
):
"""Lista usuarios del sistema con filtros de búsqueda y rol."""
"""Lista usuarios del sistema con filtros de búsqueda, rol y paginación server-side."""
query = User.query
if search:
s_clean = search.strip().lower()
@@ -56,8 +60,18 @@ def get_users(
elif status_filter == 'inactive':
query = query.filter(User.is_active == False)
users = query.order_by(User.id.asc()).all()
total = query.count()
roles = Role.query.order_by(Role.name.asc()).all()
roles_data = [{'id': r.id, 'name': r.name} for r in roles]
if all_records:
users = query.order_by(User.id.asc()).limit(1000).all()
pages = 1
page = 1
per_page = total or 1
else:
pages = math.ceil(total / per_page) if total > 0 else 1
users = query.order_by(User.id.asc()).offset((page - 1) * per_page).limit(per_page).all()
users_data = []
for u in users:
@@ -68,17 +82,63 @@ def get_users(
} if u.role_obj else {'id': 1, 'name': u.role or 'Admin'}
users_data.append(d)
roles_data = [{'id': r.id, 'name': r.name} for r in roles]
return {
'status': 'success',
'total': len(users_data),
'total': total,
'page': page,
'per_page': per_page,
'pages': pages,
'has_prev': page > 1,
'has_next': page < pages,
'users': users_data,
'roles': roles_data,
'document_types': DOCUMENT_TYPES
}
@admin_router.get("/users/teachers")
@admin_router.get("/admin/users/teachers")
def get_teachers(
search: Optional[str] = Query(None),
current_user: User = Depends(get_current_user)
):
"""Retorna una lista ligera de docentes activos para selectores y comisiones."""
query = User.query.filter(User.is_active == True)
query = query.filter(
or_(
User.role.ilike('%docent%'),
User.role.ilike('%prof%'),
User.role.ilike('%bedel%'),
User.role.ilike('%admin%')
)
)
if search:
s_clean = search.strip().lower()
query = query.filter(
or_(
User.name.ilike(f'%{s_clean}%'),
User.email.ilike(f'%{s_clean}%'),
User.document_number.ilike(f'%{s_clean}%')
)
)
teachers = query.order_by(User.name.asc()).all()
teachers_data = [
{
'id': t.id,
'name': t.name,
'email': t.email,
'document_number': t.document_number,
'role': t.role
}
for t in teachers
]
return {
'status': 'success',
'total': len(teachers_data),
'teachers': teachers_data
}
@admin_router.post("/users", status_code=status.HTTP_201_CREATED)
@admin_router.post("/admin/users", status_code=status.HTTP_201_CREATED)
async def create_user(
@@ -601,25 +661,41 @@ def get_audit_logs(
module: Optional[str] = Query(None),
action: Optional[str] = Query(None),
user_id: Optional[int] = Query(None),
limit: int = Query(50),
search: Optional[str] = Query(None),
page: int = Query(1, ge=1),
per_page: int = Query(25, ge=1, le=100),
limit: Optional[int] = Query(None),
current_user: User = Depends(require_roles(["ADMIN"]))
):
"""Consulta la bitácora inmutable de auditoría del sistema."""
logs = AuditService.get_logs(module=module, action=action, user_id=user_id, limit=limit)
"""Consulta la bitácora inmutable de auditoría del sistema con paginación server-side."""
actual_per_page = limit if (limit and not per_page) else per_page
logs, total = AuditService.get_paginated_logs(
module=module,
action=action,
user_id=user_id,
search=search,
page=page,
per_page=actual_per_page
)
pages = math.ceil(total / actual_per_page) if total > 0 else 1
distinct_modules = [m[0] for m in db.session.query(AuditLog.module).distinct().all() if m[0]]
distinct_actions = [a[0] for a in db.session.query(AuditLog.action).distinct().all() if a[0]]
all_modules = sorted(list(set(distinct_modules + ['auth', 'admin', 'reservations', 'classrooms', 'buildings', 'academic', 'moodle'])))
all_actions = sorted(list(set(distinct_actions + ['LOGIN', 'LOGIN_FAILED', 'LOGOUT', 'CREATE', 'UPDATE', 'DELETE', 'IMPERSONATE_START', 'IMPERSONATE_END'])))
return {
'status': 'success',
'total': len(logs),
'total': total,
'logs': [log.to_dict() for log in logs],
'modules': all_modules,
'actions': all_actions,
'pagination': {
'page': 1,
'per_page': limit,
'total': len(logs)
'page': page,
'per_page': actual_per_page,
'total': total,
'pages': pages,
'has_prev': page > 1,
'has_next': page < pages
}
}
+3 -2
View File
@@ -22,7 +22,7 @@ dashboard_service = DashboardService()
@classrooms_router.get("")
def list_classrooms(
building_id: Optional[int] = Query(None),
building_id: Optional[str] = Query(None),
floor: Optional[str] = Query(None),
mode: Optional[str] = Query(None),
current_user: User = Depends(get_current_user)
@@ -31,9 +31,10 @@ def list_classrooms(
mode_str = (mode or '').lower()
only_virtual = mode_str == 'virtual'
only_physical = mode_str == 'physical'
parsed_building_id = int(building_id.strip()) if building_id and str(building_id).strip().isdigit() else None
classrooms = classroom_service.list_classrooms(
building_id=building_id,
building_id=parsed_building_id,
floor=floor,
only_virtual=only_virtual,
only_physical=only_physical
+14 -18
View File
@@ -24,14 +24,15 @@ reservation_service = ReservationService()
def list_reservations(
start_date: Optional[str] = Query(None),
end_date: Optional[str] = Query(None),
classroom_id: Optional[int] = Query(None),
classroom_id: Optional[str] = Query(None),
hide_virtual: Optional[str] = Query(None),
floor: Optional[str] = Query(None),
shift: Optional[str] = Query(None),
search: Optional[str] = Query(None),
limit: int = Query(1000, le=5000),
current_user: User = Depends(get_current_user)
):
"""Consulta de reservas por rango de fechas y/o aula."""
"""Consulta de reservas por rango de fechas y/o aula con filtros en SQL."""
now = datetime.now(timezone.utc).replace(tzinfo=None)
try:
start_dt = datetime.strptime(start_date, '%Y-%m-%d') if start_date else now.replace(hour=0, minute=0, second=0)
@@ -44,27 +45,22 @@ def list_reservations(
raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Formato inválido de end_date (debe ser YYYY-MM-DD).")
is_hide_virtual = str(hide_virtual).lower() in ['1', 'true']
parsed_classroom_id = int(classroom_id.strip()) if classroom_id and str(classroom_id).strip().isdigit() else None
reservations = reservation_service.list_reservations(start_dt, end_dt, classroom_id=classroom_id)
reservations = reservation_service.list_reservations(
start_dt, end_dt,
classroom_id=parsed_classroom_id,
is_hide_virtual=is_hide_virtual,
floor=floor,
shift=shift,
search=search,
limit=limit
)
result = []
for r in reservations:
is_virt = bool(r.is_virtual or (r.classroom and r.classroom.is_virtual))
if is_hide_virtual and is_virt:
continue
if floor and r.classroom and str(r.classroom.floor).strip().lower() != floor.strip().lower():
continue
if shift and r.shift and shift.lower() not in r.shift.lower():
continue
r_user: Any = getattr(r, 'user', None)
u_name = (getattr(r_user, 'name', '') or '').lower() if r_user else ''
if search:
s_lower = search.lower()
subj_n = (r.subject_name or '').lower()
subj_c = (r.subject_code or '').lower()
c_name = (r.classroom.code if r.classroom else '').lower()
if s_lower not in subj_n and s_lower not in subj_c and s_lower not in c_name and s_lower not in u_name:
continue
is_virt = bool(r.is_virtual or (r.classroom and getattr(r.classroom, 'is_virtual', False)))
user_dict = {
'id': getattr(r_user, 'id', None),
'name': getattr(r_user, 'name', None),
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup(
name="edu-space-admin",
version="3.8.11",
version="3.8.12",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team",
author_email="admin@edu-space.com",
+194
View File
@@ -0,0 +1,194 @@
"""
Test suite for Server-Side Pagination and DB Optimizations.
Validates pagination contracts, SQL filtering, and lightweight teacher projection.
"""
import pytest
from fastapi.testclient import TestClient
from main import app
from app.models.user import User
from app.models.role import Role
from app.models.subject import Subject, Commission
from app.models.career import Career
from app.models.audit_log import AuditLog
from app.services.audit_service import AuditService
from app.services.jwt_service import JWTService
from werkzeug.security import generate_password_hash
@pytest.fixture
def test_admin_headers(init_database):
admin = User.query.filter_by(email="admin_pag_test@unicaba.edu.ar").first()
if not admin:
admin = User(
name="Admin Paginacion",
email="admin_pag_test@unicaba.edu.ar",
password_hash=generate_password_hash("EduSpace2026!"),
role="ADMIN",
is_active=True
)
init_database.session.add(admin)
init_database.session.commit()
tokens = JWTService.generate_tokens(admin)
return {"Authorization": f"Bearer {tokens['access_token']}"}
def test_users_pagination_defaults(test_admin_headers, init_database):
client = TestClient(app)
# Crear varios usuarios si no existen
for i in range(1, 30):
email = f"pag_user_{i}@unicaba.edu.ar"
if not User.query.filter_by(email=email).first():
u = User(
name=f"Usuario Paginado {i}",
email=email,
password_hash=generate_password_hash("pass"),
role="ALUMNO",
is_active=True
)
init_database.session.add(u)
init_database.session.commit()
# 1. Paginación por defecto (page=1, per_page=25)
res = client.get("/api/v1/users", headers=test_admin_headers)
assert res.status_code == 200
data = res.json()
assert data["status"] == "success"
assert "total" in data
assert data["page"] == 1
assert data["per_page"] == 25
assert "pages" in data
assert len(data["users"]) <= 25
assert data["pages"] >= 2
assert data["has_next"] is True
assert data["has_prev"] is False
# 2. Segunda página
res2 = client.get("/api/v1/users?page=2&per_page=10", headers=test_admin_headers)
assert res2.status_code == 200
data2 = res2.json()
assert data2["page"] == 2
assert data2["per_page"] == 10
assert len(data2["users"]) == 10
assert data2["has_prev"] is True
def test_users_teachers_endpoint(test_admin_headers, init_database):
client = TestClient(app)
# Crear docente específico
teacher = User.query.filter_by(email="profesor_pag_test@unicaba.edu.ar").first()
if not teacher:
teacher = User(
name="Profesor Paginado",
email="profesor_pag_test@unicaba.edu.ar",
password_hash=generate_password_hash("pass"),
role="DOCENTE",
is_active=True
)
init_database.session.add(teacher)
init_database.session.commit()
res = client.get("/api/v1/users/teachers", headers=test_admin_headers)
assert res.status_code == 200
data = res.json()
assert data["status"] == "success"
assert "teachers" in data
assert any(t["email"] == "profesor_pag_test@unicaba.edu.ar" for t in data["teachers"])
# Verificar que sólo expone campos seguros
first = data["teachers"][0]
assert "id" in first
assert "name" in first
assert "email" in first
assert "password_hash" not in first
def test_audit_logs_pagination_and_search(test_admin_headers, init_database):
client = TestClient(app)
# Generar eventos de auditoría
AuditService.log("LOGIN", "auth", details="Prueba de paginacion audit 1", user_email="admin_pag_test@unicaba.edu.ar")
AuditService.log("CREATE", "classrooms", details="Prueba de paginacion audit 2", user_email="admin_pag_test@unicaba.edu.ar")
AuditService.log("UPDATE", "academic", details="Materia actualizada para test", user_email="admin_pag_test@unicaba.edu.ar")
res = client.get("/api/v1/audit-logs?page=1&per_page=2", headers=test_admin_headers)
assert res.status_code == 200
data = res.json()
assert data["status"] == "success"
assert "pagination" in data
pag = data["pagination"]
assert pag["page"] == 1
assert pag["per_page"] == 2
assert pag["total"] >= 3
assert pag["pages"] >= 2
assert len(data["logs"]) == 2
# Búsqueda por texto en SQL
res_search = client.get("/api/v1/audit-logs?search=Materia+actualizada", headers=test_admin_headers)
assert res_search.status_code == 200
data_search = res_search.json()
assert len(data_search["logs"]) >= 1
assert any("actualizada" in (l.get("details") or "") for l in data_search["logs"])
def test_subjects_pagination(test_admin_headers, init_database):
client = TestClient(app)
# Crear carrera y asignaturas
car = Career.query.filter_by(code="CAR-PAG").first()
if not car:
car = Career(name="Carrera Paginacion", code="CAR-PAG")
init_database.session.add(car)
init_database.session.commit()
for i in range(1, 6):
code = f"SUBJ-PAG-{i}"
if not Subject.query.filter_by(code=code).first():
s = Subject(name=f"Asignatura Paginada {i}", code=code, career_id=car.id, is_active=True)
init_database.session.add(s)
init_database.session.commit()
res = client.get("/api/v1/subjects?page=1&per_page=3", headers=test_admin_headers)
assert res.status_code == 200
data = res.json()
assert data["status"] == "success"
assert data["page"] == 1
assert data["per_page"] == 3
assert len(data["subjects"]) == 3
assert data["total"] >= 5
assert data["has_next"] is True
def test_commissions_pagination(test_admin_headers, init_database):
client = TestClient(app)
# Crear comisiones
subj = Subject.query.filter_by(code="SUBJ-PAG-1").first()
if subj:
for i in range(1, 4):
code = f"COMM-PAG-{i}"
if not Commission.query.filter_by(code=code, subject_id=subj.id).first():
c = Commission(code=code, subject_id=subj.id, shift="Mañana", active=True)
init_database.session.add(c)
init_database.session.commit()
res = client.get("/api/v1/commissions?page=1&per_page=2", headers=test_admin_headers)
assert res.status_code == 200
data = res.json()
assert data["status"] == "success"
assert data["page"] == 1
assert data["per_page"] == 2
assert len(data["commissions"]) <= 2
assert "total" in data
def test_empty_query_params_resilience(test_admin_headers, init_database):
"""Verifica que query parameters vacíos no causen error 422 Unprocessable Entity."""
client = TestClient(app)
res_subj = client.get("/api/v1/subjects?career_id=&active=&search=", headers=test_admin_headers)
assert res_subj.status_code == 200
assert "subjects" in res_subj.json()
res_comm = client.get("/api/v1/commissions?subject_id=&career_id=&shift=&active=&search=", headers=test_admin_headers)
assert res_comm.status_code == 200
assert "commissions" in res_comm.json()
res_resv = client.get("/api/v1/reservations?classroom_id=&floor=&shift=&search=&hide_virtual=false", headers=test_admin_headers)
assert res_resv.status_code == 200
assert "reservations" in res_resv.json()
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "frontend",
"version": "3.8.11",
"version": "3.8.12",
"description": "",
"main": "index.js",
"scripts": {
+3 -3
View File
@@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
});
// Versiones institucionales del sistema
const APP_VERSION = '3.8.11';
const FRONTEND_VERSION = '3.8.11';
const BACKEND_VERSION = '3.8.11';
const APP_VERSION = '3.8.12';
const FRONTEND_VERSION = '3.8.12';
const BACKEND_VERSION = '3.8.12';
env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION);
+120 -55
View File
@@ -359,26 +359,47 @@ const MOCK_USERS = [
{ id: 4, name: 'Laura Martínez', email: 'lmartinez@edu-space.com', role_id: 2, role: { name: 'Bedel' }, is_active: false, created_at: '2025-05-20' }
];
const fetchUsersAndRoles = async (apiClient) => {
let users = [...MOCK_USERS];
const buildPagination = (page, perPage, total) => {
const pages = Math.ceil(total / perPage) || 1;
const pages_list = [];
const maxPages = 7;
let startPage = Math.max(1, page - Math.floor(maxPages / 2));
let endPage = Math.min(pages, startPage + maxPages - 1);
if (endPage - startPage + 1 < maxPages) {
startPage = Math.max(1, endPage - maxPages + 1);
}
for (let i = startPage; i <= endPage; i++) {
pages_list.push(i);
}
return {
page,
per_page: perPage,
total,
pages,
has_prev: page > 1,
has_next: page < pages,
pages_list,
iter_pages: () => pages_list
};
};
const fetchRolesAndDocs = async (apiClient) => {
let roles = [...MOCK_ROLES];
let document_types = [];
try {
const [uRes, rRes] = await Promise.allSettled([
apiClient.get('/users'),
apiClient.get('/roles')
const [rRes, dRes] = await Promise.allSettled([
apiClient.get('/roles'),
apiClient.get('/admin/users/document-types')
]);
if (uRes.status === 'fulfilled' && uRes.value.data) {
const d = uRes.value.data;
users = d.users || (Array.isArray(d) ? d : users);
document_types = d.document_types || [];
}
if (rRes.status === 'fulfilled' && rRes.value.data) {
const d = rRes.value.data;
roles = (d.roles || d) || roles;
}
if (dRes.status === 'fulfilled' && dRes.value.data) {
document_types = dRes.value.data.document_types || [];
}
} catch (e) {
console.warn('Using mock users/roles data:', e.message);
console.warn('Using mock roles data:', e.message);
}
if (!document_types || document_types.length === 0) {
document_types = [
@@ -393,44 +414,60 @@ const fetchUsersAndRoles = async (apiClient) => {
{ code: 'LE', name: 'Libreta de Enrolamiento', category: 'Histórico Nacional', placeholder: 'Libreta Enrolamiento' }
];
}
return { users, roles, document_types };
return { roles, document_types };
};
const fetchUsersAndRoles = async (apiClient) => {
const { roles, document_types } = await fetchRolesAndDocs(apiClient);
return { users: [...MOCK_USERS], roles, document_types };
};
const handleUsersList = async (req, res) => {
try {
const { users, roles, document_types } = await fetchUsersAndRoles(req.apiClient);
const search = (req.query.search || '').toLowerCase().trim();
const page = parseInt(req.query.page, 10) || 1;
const per_page = 25;
const search = (req.query.search || '').trim();
const role_filter = req.query.role || '';
const status_filter = req.query.status || '';
const msg = req.query.msg || '';
const error = req.query.error || '';
let filtered = [...users];
if (search) {
filtered = filtered.filter(u =>
(u.name && u.name.toLowerCase().includes(search)) ||
(u.first_name && u.first_name.toLowerCase().includes(search)) ||
(u.last_name && u.last_name.toLowerCase().includes(search)) ||
(u.email && u.email.toLowerCase().includes(search)) ||
(u.personal_email && u.personal_email.toLowerCase().includes(search)) ||
(u.document_number && u.document_number.toLowerCase().includes(search)) ||
(u.phone && u.phone.toLowerCase().includes(search))
);
let users = [];
let roles = [...MOCK_ROLES];
let document_types = [];
let total = 0;
try {
const resp = await req.apiClient.get('/admin/users', {
params: {
page,
per_page,
search: search || undefined,
role: role_filter || undefined,
status: status_filter || undefined
}
});
if (resp.data) {
users = resp.data.users || [];
roles = resp.data.roles || roles;
document_types = resp.data.document_types || [];
total = resp.data.total !== undefined ? resp.data.total : users.length;
}
} catch (apiErr) {
console.warn('Users list API notice:', apiErr.message);
}
if (role_filter) {
filtered = filtered.filter(u => String(u.role_id) === String(role_filter));
}
if (status_filter === 'active') filtered = filtered.filter(u => u.is_active);
if (status_filter === 'inactive') filtered = filtered.filter(u => !u.is_active);
const pagination = buildPagination(page, per_page, total);
res.render('admin/users/list', {
title: 'Gestión de Usuarios — Edu-Space Admin',
users: filtered,
users,
roles,
document_types,
search,
role_filter,
status_filter,
pagination,
msg,
error
});
@@ -441,14 +478,15 @@ const handleUsersList = async (req, res) => {
users: MOCK_USERS,
roles: MOCK_ROLES,
document_types: [],
search: '', role_filter: '', status_filter: '', msg: '', error: ''
search: '', role_filter: '', status_filter: '', msg: '', error: '',
pagination: buildPagination(1, 25, MOCK_USERS.length)
});
}
};
const handleUserAdd = async (req, res) => {
try {
const { roles, document_types } = await fetchUsersAndRoles(req.apiClient);
const { roles, document_types } = await fetchRolesAndDocs(req.apiClient);
res.render('admin/users/form', {
title: 'Nuevo Usuario — Edu-Space Admin',
user: null,
@@ -473,11 +511,10 @@ const handleUserAdd = async (req, res) => {
const handleUserEdit = async (req, res) => {
try {
const userId = req.params.id || req.query.id;
const { users, roles, document_types } = await fetchUsersAndRoles(req.apiClient);
let targetUser = userId ? users.find(u => String(u.id) === String(userId)) : null;
const { roles, document_types } = await fetchRolesAndDocs(req.apiClient);
let targetUser = null;
// Si no se encontró en la lista general y hay userId, intentar fetch individual
if (!targetUser && userId && req.apiClient) {
if (userId && req.apiClient) {
try {
const singleRes = await req.apiClient.get(`/users/${userId}`);
if (singleRes.data && (singleRes.data.user || singleRes.data.data)) {
@@ -488,8 +525,7 @@ const handleUserEdit = async (req, res) => {
}
}
targetUser = targetUser || (userId ? null : users[0]) || MOCK_USERS[0];
targetUser = targetUser || MOCK_USERS[0];
const userName = targetUser ? (targetUser.name || `${targetUser.first_name || ''} ${targetUser.last_name || ''}`.trim() || targetUser.email || `Usuario #${targetUser.id}`) : 'Usuario';
res.render('admin/users/form', {
@@ -784,21 +820,30 @@ router.post(['/career_delete', '/career_delete/:id', '/careers/delete/:id'], han
const handleSubjectsList = async (req, res) => {
try {
const page = parseInt(req.query.page, 10) || 1;
const per_page = 25;
const search = (req.query.search || '').trim();
const career_id = req.query.career_id || '';
const active = req.query.active || '';
let subjects = [];
let careers = [];
let total = 0;
try {
const params = { page, per_page };
if (search) params.search = search;
if (career_id) params.career_id = parseInt(career_id, 10);
if (active) params.active = active;
const [sRes, cRes] = await Promise.allSettled([
req.apiClient.get('/subjects', { params: { search, career_id, active } }),
req.apiClient.get('/subjects', { params }),
req.apiClient.get('/careers')
]);
if (sRes.status === 'fulfilled' && sRes.value.data) {
subjects = sRes.value.data.subjects || [];
careers = sRes.value.data.careers || [];
total = sRes.value.data.total !== undefined ? sRes.value.data.total : subjects.length;
}
if (cRes.status === 'fulfilled' && cRes.value.data && (!careers || careers.length === 0)) {
careers = cRes.value.data.careers || [];
@@ -807,6 +852,8 @@ const handleSubjectsList = async (req, res) => {
console.warn('Subjects list API notice:', apiErr.message);
}
const pagination = buildPagination(page, per_page, total);
res.render('admin/subjects/list', {
title: 'Gestión de Asignaturas - Edu-Space Admin',
subjects,
@@ -817,7 +864,7 @@ const handleSubjectsList = async (req, res) => {
can_edit: true,
msg: req.query.msg || '',
error: req.query.error || '',
pagination: { pages: 1, page: 1, total: subjects.length, has_prev: false, has_next: false }
pagination
});
} catch (err) {
console.error('Error in subjects list:', err.message);
@@ -899,6 +946,8 @@ router.post(['/subject_delete', '/subject_delete/:id', '/subjects/:id/delete'],
const handleCommissionsList = async (req, res) => {
try {
const page = parseInt(req.query.page, 10) || 1;
const per_page = 25;
const search = (req.query.search || '').trim();
const subject_id = req.query.subject_id || '';
const career_id = req.query.career_id || '';
@@ -912,14 +961,24 @@ const handleCommissionsList = async (req, res) => {
let teachers = [];
let academic_terms = [];
let careers = [];
let total = 0;
try {
const params = { page, per_page };
if (search) params.search = search;
if (subject_id) params.subject_id = parseInt(subject_id, 10);
if (career_id) params.career_id = parseInt(career_id, 10);
if (shift) params.shift = shift;
if (active) params.active = active;
if (unassigned_room) params.unassigned_room = unassigned_room;
const [cRes, uRes] = await Promise.allSettled([
req.apiClient.get('/commissions', { params: { search, subject_id, career_id, shift, active, unassigned_room } }),
req.apiClient.get('/users')
req.apiClient.get('/commissions', { params }),
req.apiClient.get('/admin/users/teachers')
]);
if (cRes.status === 'fulfilled' && cRes.value.data) {
total = cRes.value.data.total !== undefined ? cRes.value.data.total : (cRes.value.data.commissions || []).length;
commissions = (cRes.value.data.commissions || []).map(c => ({
...c,
get_full_code: () => c.full_code || c.code,
@@ -962,16 +1021,20 @@ const handleCommissionsList = async (req, res) => {
}
if (uRes.status === 'fulfilled' && uRes.value.data) {
const users = uRes.value.data.users || [];
teachers = users.filter(u => {
const r = (u.role || '').toLowerCase();
return r.includes('docent') || r.includes('prof') || r.includes('admin') || r.includes('bedel');
});
teachers = uRes.value.data.teachers || uRes.value.data.users || [];
if (!uRes.value.data.teachers) {
teachers = teachers.filter(u => {
const r = (u.role || '').toLowerCase();
return r.includes('docent') || r.includes('prof') || r.includes('admin') || r.includes('bedel');
});
}
}
} catch (apiErr) {
console.warn('Commissions list API notice:', apiErr.message);
}
const pagination = buildPagination(page, per_page, total);
res.render('admin/commissions/list', {
title: 'Gestión de Comisiones — Edu-Space',
commissions,
@@ -989,7 +1052,7 @@ const handleCommissionsList = async (req, res) => {
msg: req.query.msg || (created ? 'created' : ''),
error: req.query.error || '',
can_edit: true,
pagination: { pages: 1, page: 1, total: commissions.length, has_prev: false, has_next: false }
pagination
});
} catch (err) {
console.error('Error in commissions list:', err.message);
@@ -1007,7 +1070,7 @@ const handleCommissionDetail = async (req, res) => {
try {
const [cRes, uRes] = await Promise.allSettled([
req.apiClient.get(`/commissions/${id}`),
req.apiClient.get('/users')
req.apiClient.get('/admin/users/teachers')
]);
if (cRes.status === 'fulfilled' && cRes.value.data && cRes.value.data.commission) {
commission = cRes.value.data.commission;
@@ -1017,11 +1080,13 @@ const handleCommissionDetail = async (req, res) => {
commission = list.find(c => String(c.id) === String(id)) || list[0];
}
if (uRes.status === 'fulfilled' && uRes.value.data) {
const users = uRes.value.data.users || [];
teachers = users.filter(u => {
const r = (u.role || '').toLowerCase();
return r.includes('docent') || r.includes('prof') || r.includes('admin') || r.includes('bedel');
});
teachers = uRes.value.data.teachers || uRes.value.data.users || [];
if (!uRes.value.data.teachers) {
teachers = teachers.filter(u => {
const r = (u.role || '').toLowerCase();
return r.includes('docent') || r.includes('prof') || r.includes('admin') || r.includes('bedel');
});
}
}
} catch (apiErr) {
console.warn('Commission detail API notice:', apiErr.message);
+23 -22
View File
@@ -327,35 +327,36 @@
<!-- Pagination -->
{% if pagination.pages > 1 %}
<div class="d-flex justify-content-center py-3">
<nav>
<div class="card-footer bg-body-tertiary border-0 py-3 d-flex flex-column flex-md-row justify-content-between align-items-center gap-2">
<small class="text-muted">
Mostrando página <strong>{{ pagination.page }}</strong> de <strong>{{ pagination.pages }}</strong> (Total: <strong>{{ pagination.total }}</strong> comisiones)
</small>
<nav aria-label="Commissions pagination">
<ul class="pagination pagination-sm mb-0">
{% if pagination.has_prev %}
<li class="page-item">
<a class="page-link" href="/admin/commissions_list">
<i class="bi bi-chevron-left"></i>
<li class="page-item {% if not pagination.has_prev %}disabled{% endif %}">
<a class="page-link" href="/admin/commissions_list?page={{ pagination.page - 1 }}{% if search %}&search={{ search }}{% endif %}{% if subject_filter %}&subject_id={{ subject_filter }}{% endif %}{% if career_filter %}&career_id={{ career_filter }}{% endif %}{% if shift_filter %}&shift={{ shift_filter }}{% endif %}{% if active_filter %}&active={{ active_filter }}{% endif %}">
<i class="bi bi-chevron-left me-1"></i>Anterior
</a>
</li>
{% for pg in pagination.pages_list %}
<li class="page-item {% if pg == pagination.page %}active{% endif %}">
<a class="page-link" href="/admin/commissions_list?page={{ pg }}{% if search %}&search={{ search }}{% endif %}{% if subject_filter %}&subject_id={{ subject_filter }}{% endif %}{% if career_filter %}&career_id={{ career_filter }}{% endif %}{% if shift_filter %}&shift={{ shift_filter }}{% endif %}{% if active_filter %}&active={{ active_filter }}{% endif %}">
{{ pg }}
</a>
</li>
{% endif %}
{% for pg in pagination.iter_pages(left_edge=1, right_edge=1, left_current=2, right_current=2) %}
{% if pg %}
<li class="page-item {% if pg == pagination.page %}active{% endif %}">
<a class="page-link" href="/admin/commissions_list">{{ pg }}</a>
</li>
{% else %}
<li class="page-item disabled"><span class="page-link">…</span></li>
{% endif %}
{% endfor %}
{% if pagination.has_next %}
<li class="page-item">
<a class="page-link" href="/admin/commissions_list">
<i class="bi bi-chevron-right"></i>
</a>
</li>
{% endif %}
<li class="page-item {% if not pagination.has_next %}disabled{% endif %}">
<a class="page-link" href="/admin/commissions_list?page={{ pagination.page + 1 }}{% if search %}&search={{ search }}{% endif %}{% if subject_filter %}&subject_id={{ subject_filter }}{% endif %}{% if career_filter %}&career_id={{ career_filter }}{% endif %}{% if shift_filter %}&shift={{ shift_filter }}{% endif %}{% if active_filter %}&active={{ active_filter }}{% endif %}">
Siguiente<i class="bi bi-chevron-right ms-1"></i>
</a>
</li>
</ul>
</nav>
</div>
{% elif pagination and pagination.total > 0 %}
<div class="card-footer bg-body-tertiary border-0 py-2 d-flex justify-content-between align-items-center">
<small class="text-muted">Total: <strong>{{ pagination.total }}</strong> comisiones registradas</small>
</div>
{% endif %}
{% else %}
+23 -20
View File
@@ -229,33 +229,36 @@
<!-- Paginación -->
{% if pagination.pages > 1 %}
<div class="card-footer bg-body-tertiary border-0 py-2">
<div class="card-footer bg-body-tertiary border-0 py-3 d-flex flex-column flex-md-row justify-content-between align-items-center gap-2">
<small class="text-muted">
Mostrando página <strong>{{ pagination.page }}</strong> de <strong>{{ pagination.pages }}</strong> (Total: <strong>{{ pagination.total }}</strong> asignaturas)
</small>
<nav aria-label="Subjects pagination">
<ul class="pagination pagination-sm justify-content-center mb-0">
{% if pagination.has_prev %}
<li class="page-item">
<a class="page-link" href="/admin/subjects_list">Anterior</a>
<ul class="pagination pagination-sm mb-0">
<li class="page-item {% if not pagination.has_prev %}disabled{% endif %}">
<a class="page-link" href="/admin/subjects_list?page={{ pagination.page - 1 }}{% if search %}&search={{ search }}{% endif %}{% if career_filter %}&career_id={{ career_filter }}{% endif %}{% if active_filter %}&active={{ active_filter }}{% endif %}">
&laquo; Anterior
</a>
</li>
{% endif %}
{% for p in pagination.iter_pages(left_edge=2, right_edge=2, left_current=2, right_current=2) %}
{% if p %}
<li class="page-item {% if p == pagination.page %}active{% endif %}">
<a class="page-link" href="/admin/subjects_list">{{ p }}</a>
</li>
{% else %}
<li class="page-item disabled"><span class="page-link">…</span></li>
{% endif %}
{% for p in pagination.pages_list %}
<li class="page-item {% if p == pagination.page %}active{% endif %}">
<a class="page-link" href="/admin/subjects_list?page={{ p }}{% if search %}&search={{ search }}{% endif %}{% if career_filter %}&career_id={{ career_filter }}{% endif %}{% if active_filter %}&active={{ active_filter }}{% endif %}">
{{ p }}
</a>
</li>
{% endfor %}
{% if pagination.has_next %}
<li class="page-item">
<a class="page-link" href="/admin/subjects_list">Siguiente</a>
<li class="page-item {% if not pagination.has_next %}disabled{% endif %}">
<a class="page-link" href="/admin/subjects_list?page={{ pagination.page + 1 }}{% if search %}&search={{ search }}{% endif %}{% if career_filter %}&career_id={{ career_filter }}{% endif %}{% if active_filter %}&active={{ active_filter }}{% endif %}">
Siguiente &raquo;
</a>
</li>
{% endif %}
</ul>
</nav>
</div>
{% elif pagination and pagination.total > 0 %}
<div class="card-footer bg-body-tertiary border-0 py-2 d-flex justify-content-between align-items-center">
<small class="text-muted">Total: <strong>{{ pagination.total }}</strong> asignaturas registradas</small>
</div>
{% endif %}
</div>
</div>
+27 -16
View File
@@ -231,24 +231,35 @@
<!-- Pagination -->
{% if pagination and pagination.pages > 1 %}
<div class="card-footer bg-body-tertiary border-0 py-2 d-flex justify-content-center">
<ul class="pagination pagination-sm mb-0">
{% if pagination.has_prev %}
<li class="page-item"><a class="page-link" href="/admin/users_list">&laquo;</a></li>
{% endif %}
{% for p in pagination.iter_pages(left_edge=1, right_edge=1, left_current=2, right_current=2) %}
{% if p %}
<div class="card-footer bg-body-tertiary border-0 py-3 d-flex flex-column flex-md-row justify-content-between align-items-center gap-2">
<small class="text-muted">
Mostrando página <strong>{{ pagination.page }}</strong> de <strong>{{ pagination.pages }}</strong> (Total: <strong>{{ pagination.total }}</strong> usuarios registrados)
</small>
<nav aria-label="Navegación de usuarios">
<ul class="pagination pagination-sm mb-0">
<li class="page-item {% if not pagination.has_prev %}disabled{% endif %}">
<a class="page-link" href="/admin/users_list?page={{ pagination.page - 1 }}{% if search %}&search={{ search }}{% endif %}{% if role_filter %}&role={{ role_filter }}{% endif %}{% if status_filter %}&status={{ status_filter }}{% endif %}">
&laquo; Anterior
</a>
</li>
{% for p in pagination.pages_list %}
<li class="page-item {% if p == pagination.page %}active{% endif %}">
<a class="page-link" href="/admin/users_list">{{ p }}</a>
<a class="page-link" href="/admin/users_list?page={{ p }}{% if search %}&search={{ search }}{% endif %}{% if role_filter %}&role={{ role_filter }}{% endif %}{% if status_filter %}&status={{ status_filter }}{% endif %}">
{{ p }}
</a>
</li>
{% else %}
<li class="page-item disabled"><span class="page-link">…</span></li>
{% endif %}
{% endfor %}
{% if pagination.has_next %}
<li class="page-item"><a class="page-link" href="/admin/users_list">&raquo;</a></li>
{% endif %}
</ul>
{% endfor %}
<li class="page-item {% if not pagination.has_next %}disabled{% endif %}">
<a class="page-link" href="/admin/users_list?page={{ pagination.page + 1 }}{% if search %}&search={{ search }}{% endif %}{% if role_filter %}&role={{ role_filter }}{% endif %}{% if status_filter %}&status={{ status_filter }}{% endif %}">
Siguiente &raquo;
</a>
</li>
</ul>
</nav>
</div>
{% elif pagination and pagination.total > 0 %}
<div class="card-footer bg-body-tertiary border-0 py-2 d-flex justify-content-between align-items-center">
<small class="text-muted">Total: <strong>{{ pagination.total }}</strong> usuarios registrados</small>
</div>
{% endif %}
</div>
-3
View File
@@ -207,9 +207,6 @@
</div>
</div>
</div>
</div>
</div>
</div>
<!-- Admin Visual Menu Launchpad -->
<div class="card border-0 shadow-sm mb-4">
@@ -0,0 +1,67 @@
# Plan Técnico: Paginación Server-Side y Optimización de Base de Datos
## 1. Arquitectura Técnica de la Solución (4 Capas)
### 1.1 Capa de Esquemas y Contratos (Schemas / DTOs)
- **Contrato Estándar de Respuesta Paginada (`PaginatedResponse[T]`)**:
```python
{
"status": "success",
"total": int,
"page": int,
"per_page": int,
"pages": int,
"has_prev": bool,
"has_next": bool,
"items": List[T]
}
```
- Para endpoints existentes (`/users`, `/audit-logs`), mantener retrocompatibilidad incorporando las claves esperadas por los clientes existentes (`users`, `logs`, `commissions`, etc.) junto al bloque de metadatos de paginación.
### 1.2 Capa de Persistencia y Repositorios (Storage / Repositories)
- **`AuditService.get_logs`**:
- Modificar firma para admitir `page: int = 1`, `per_page: int = 25`, `search: Optional[str] = None`.
- Construir query con `AuditLog.query`.
- Si `search`: agregar filtro OR sobre `AuditLog.details.ilike(f'%{s}%')`, `AuditLog.user_email.ilike(f'%{s}%')`, `AuditLog.action.ilike(f'%{s}%')`.
- Calcular `total = query.count()`.
- Aplicar `.order_by(AuditLog.created_at.desc()).offset((page - 1) * per_page).limit(per_page)`.
- Retornar tupla `(logs, total)`.
- **`ReservationService` y `ReservationRepository`**:
- Trasladar los filtros en memoria (`floor`, `shift`, `search`, `is_virtual`) a la consulta SQLAlchemy relacional.
- Añadir `limit: int = 1000` predeterminado a las consultas para proteger los buffers del gestor de base de datos.
- **Modelos SQLAlchemy**:
- Verificar índices en columnas frecuentes de ordenamiento y filtrado (`role_id`, `is_active` en `User`, `status`, `start_time` en `Reservation`).
### 1.3 Capa de Routers FastAPI (`backend/routers/`)
- **`backend/routers/admin.py`**:
- `get_users`: Recibir `page: int = Query(1, ge=1)`, `per_page: int = Query(25, ge=1, le=100)`, `all: bool = Query(False)`.
- Si `all` es `False`, ejecutar `total = query.count()`, `.offset((page - 1) * per_page).limit(per_page)` y devolver metadatos completos (`total`, `page`, `per_page`, `pages`, `has_prev`, `has_next`).
- Crear endpoint `/api/v1/users/teachers`: Consulta filtrada de usuarios activos con rol docente (`docente`, `profesor`, etc.) proyectando solo `id`, `name`, `email` ordenado alfabéticamente.
- `get_audit_logs`: Aceptar `page: int = Query(1, ge=1)`, `per_page: int = Query(25, ge=1, le=100)`, `search: Optional[str] = Query(None)`. Retornar el objeto `pagination` estructurado con `total`, `pages`, `has_prev`, `has_next`.
- **`backend/routers/academic.py`**:
- `list_commissions`: Agregar `page`, `per_page`, `search` con filtrado SQL y cálculo de totales.
- `list_subjects`: Agregar `page`, `per_page`, manteniendo compatibilidad con llamadas sin paginación explícita.
- **`backend/routers/reservations.py`**:
- Integrar filtros SQL en `list_reservations` con límite máximo de registros.
### 1.4 Capa de Frontend BFF (Node.js Express + Nunjucks)
- **`frontend/src/routes/admin.js`**:
- `handleUsersList`: Extraer `page: parseInt(req.query.page, 10) || 1`, `per_page: 25`, `search`, `role`, `status`. Llamar a `/admin/users` pasando estos parámetros. Armar el objeto `pagination` con `pages_list` para navegación compacta.
- Desacoplar `fetchUsersAndRoles`: En pantallas de alta/edición (`handleUserAdd`, `handleUserEdit`), solicitar únicamente roles y document_types sin descargar toda la base de usuarios.
- `handleCommissionsList`: Reemplazar la llamada a `GET /users` por `GET /users/teachers` para poblar el dropdown de docentes.
- **`frontend/views/admin/users/list.html`**:
- Actualizar el markup de paginación para iterar sobre `pagination.pages_list` y generar enlaces conservando query params:
`href="/admin/users_list?page={{ p }}{% if search %}&search={{ search }}{% endif %}{% if role_filter %}&role={{ role_filter }}{% endif %}{% if status_filter %}&status={{ status_filter }}{% endif %}"`.
- Incorporar métricas de página: *"Mostrando página {{ pagination.page }} de {{ pagination.pages }} (Total: {{ pagination.total }} usuarios)"*.
---
## 2. Plan de Pruebas Automatizadas
1. **Pruebas de Backend (`backend/tests/test_pagination_db.py`)**:
- `test_get_users_pagination_defaults`: Verificar que `/api/v1/users` retorne `page=1`, `per_page=25` y las propiedades `total`, `pages`, `has_prev`, `has_next`.
- `test_get_users_search_and_role_filters`: Comprobar que los filtros por texto y rol se ejecutan a nivel SQL.
- `test_get_teachers_endpoint`: Validar que `/api/v1/users/teachers` devuelva solo usuarios docentes con datos mínimos.
- `test_get_audit_logs_pagination`: Validar cálculo correcto de páginas y `has_next`/`has_prev` con filtrado SQL.
- `test_reservations_sql_filtering`: Validar filtros por modalidad y rango temporal con límites.
2. **Inspección de Linter y Tipado**:
- Ejecutar `pyright` sobre todo el backend para garantizar 0 errores (Principio 10).
@@ -0,0 +1,62 @@
# Especificación: Paginación Server-Side y Buenas Prácticas de Base de Datos en Listas y Vistas
## 1. Contexto y Justificación del Problema
En entornos con ingesta masiva de datos (como la sincronización con Moodle institucional que incorpora más de 14.000 registros), la recuperación de entidades sin paginación ni cláusulas `LIMIT`/`OFFSET` (mediante `.all()`) provoca cuellos de botella críticos:
1. **Saturación de Memoria**: La carga de miles de usuarios o registros en memoria sobre el proceso ASGI FastAPI y el BFF Express genera picos de RAM, lentitud y potencial caída del contenedor.
2. **Filtrado Ineficiente en CPU**: Filtrar arrays en memoria Node.js o bucles Python en lugar del motor relacional PostgreSQL / SQLite desaprovecha los índices B-Tree y genera latencias de red por transferencia innecesaria de payloads masivos.
3. **Consumo de Ancho de Banda y Renderizado Lento**: Enviar listas completas al frontend satura el DOM del navegador y degrada severamente la experiencia de usuario.
Esta especificación establece la arquitectura estándar de paginación server-side, optimización de consultas SQL (filtros en `WHERE`, conteo con `count()`, proyecciones ligeras para selectores) y controles visuales en los módulos de:
- **Usuarios** (`/admin/users`, `/admin/users_list`).
- **Auditoría** (`/admin/audit-logs`, `/admin/audit_logs`).
- **Espacios y Sedes** (`/classrooms`, `/buildings`).
- **Estructura Académica** (`/careers`, `/subjects`, `/commissions`, `/academic-terms`).
- **Reservas y Calendario** (`/reservations`).
---
## 2. Requisitos Funcionales en Sintaxis EARS
### 2.1 Módulo de Usuarios (`/users`, `/admin/users_list`)
- **RF-01 (Ubicuo - Paginación y Conteo Server-Side en Usuarios)**:
`EL SISTEMA aplicará paginación server-side basada en LIMIT y OFFSET sobre la tabla users en los endpoints /api/v1/users y /api/v1/admin/users, retornando el total de registros coincidentes, la página actual, la cantidad por página y el total de páginas.`
- **RF-02 (Basado en Eventos - Filtrado en Motor SQL)**:
`CUANDO el cliente envíe parámetros de búsqueda ('search'), rol ('role') o estado ('status'), EL SISTEMA aplicará los filtros en la cláusula WHERE de la consulta SQL antes de ejecutar el conteo y la paginación, sin cargar el universo completo de usuarios en memoria.`
- **RF-03 (Opcional - Consulta Ligera para Selectores y Modales)**:
`DONDE una operación requiera poblar selectores de docentes o modales rápidos, EL SISTEMA proveerá el endpoint especializado /api/v1/users/teachers o el parámetro query all=true con límite de seguridad, retornando únicamente los atributos esenciales (id, name, email) para evitar transferencias masivas innecesarias.`
- **RF-04 (Basado en Estados - Preservación de Estado de Navegación en UI)**:
`MIENTRAS el operador navegue entre páginas de la lista de usuarios en /admin/users_list, EL SISTEMA preservará los filtros activos de búsqueda, rol y estado en los enlaces de la barra de paginación.`
### 2.2 Módulo de Auditoría (`/audit-logs`, `/admin/audit_logs`)
- **RF-05 (Ubicuo - Paginación y Filtrado SQL en Bitácora)**:
`EL SISTEMA ejecutará las consultas de auditoría en /api/v1/audit-logs con paginación server-side nativa (page, per_page), calculando el número total de eventos coincidentes mediante COUNT() y aplicando LIMIT y OFFSET en la base de datos.`
- **RF-06 (Basado en Eventos - Búsqueda de Texto en Eventos de Auditoría)**:
`CUANDO el administrador filtre por texto libre ('search'), módulo ('module'), acción ('action') o usuario ('user_id'), EL SISTEMA evaluará las condiciones en el motor relacional sobre las columnas indexadas de AuditLog.`
### 2.3 Módulo de Estructura Académica (Carreras, Asignaturas, Comisiones)
- **RF-07 (Ubicuo - Paginación y Carga Optimizada de Comisiones y Asignaturas)**:
`EL SISTEMA soportará parámetros de paginación (page, per_page) y filtros en SQL para /api/v1/subjects y /api/v1/commissions, garantizando que el listado administrativo no transfiera entidades innecesarias.`
- **RF-08 (No Deseado - Prevención de Carga Masiva de Usuarios en Comisiones)**:
`SI la vista de comisiones /admin/commissions_list requiere el catálogo de docentes para asignación, ENTONCES EL SISTEMA consultará únicamente a los usuarios con rol docente (/api/v1/users/teachers) en lugar de invocar la totalidad de usuarios de la base de datos.`
### 2.4 Módulo de Reservas y Calendario (`/reservations`)
- **RF-09 (Basado en Eventos - Filtrado SQL de Reservas)**:
`CUANDO se consulte el cronograma de reservas (/api/v1/reservations), EL SISTEMA resolverá los filtros de modalidad virtual, piso, turno y texto de búsqueda en la consulta relacional con JOINs y cláusula WHERE, restringiendo el resultado a un límite máximo de seguridad (por defecto 1000 registros).`
### 2.5 Módulo de Espacios y Sedes (`/classrooms`, `/buildings`)
- **RF-10 (Ubicuo - Filtrado Indexado y Métricas de Espacios)**:
`EL SISTEMA ejecutará los filtros de sede, piso y modalidad en /api/v1/classrooms y /api/v1/buildings directamente en la base de datos, asegurando tiempos de respuesta sub-segundo sin degradación por volumen.`
---
## 3. Criterios de Aceptación y Validación
1. La llamada a `/api/v1/users` sin parámetros debe retornar por defecto `page=1`, `per_page=25` y el total real calculado mediante `query.count()`.
2. La navegación en `/admin/users_list` no debe congelar el navegador ni la memoria del servidor al paginar o buscar.
3. El endpoint `/api/v1/audit-logs` debe devolver metadatos de paginación (`page`, `per_page`, `total`, `pages`, `has_prev`, `has_next`) consistentes con la vista `/admin/audit_logs`.
4. El endpoint `/api/v1/users/teachers` debe responder únicamente con docentes activos y campos `{id, name, email}`, reemplazando la llamada masiva a `/users` en la vista de comisiones.
5. Cero errores de diagnóstico en Pyright y 100% de la suite de pruebas unitarias/integración en verde.
@@ -0,0 +1,59 @@
# 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.