diff --git a/CHANGELOG.md b/CHANGELOG.md
index add0a53..1b3feea 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -11,6 +11,30 @@ 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.14] - 2026-10-26
+### Added
+- **Filtrado Temporal y Resiliente en Listado de Reservas (`/schedule/list_reservations`)**:
+ - Incorporado soporte de parámetros `scope` (`month`, `week`, `today`) y `only_virtual` en el backend FastAPI (`routers/reservations.py`, `ReservationService`, `ReservationRepository`).
+ - Al pulsar "Sesiones del Mes" en la vista de aulas virtuales (`/classrooms/list_classrooms?view_mode=virtual`), el frontend BFF precarga las fechas de inicio (`YYYY-MM-01`) y fin de mes en los inputs del formulario y activa el switch "Solo Aulas Virtuales", desplegando de inmediato las 24 sesiones virtuales programadas del mes.
+ - Añadido switch explícito "Solo Aulas Virtuales" y banner de filtro activo contextual en `schedule/list.html`.
+- **Desglose Claro de Espacios Áulicos (Físicas vs Virtuales)**:
+ - En el Dashboard (`dashadm.html`), la tarjeta KPI de Aulas ahora desglosa con total transparencia los espacios: **3 físicas** en Edificio Central y **19 virtuales** a demanda del Campus Virtual, con accesos directos independientes a cada catálogo.
+ - En la vista de aulas (`/classrooms/list_classrooms`), la vista presencial muestra "3 aulas presenciales encontradas" y la vista virtual indica "19 salas virtuales a demanda encontradas", clarificando los badges en las pestañas superiores.
+- **Persistencia y UX del Menú Lateral (Sidebar)**:
+ - Removido el colapso forzado (`data-bs-parent="#sidebarNav"`). Al interactuar con un submenú, este permanece desplegado.
+ - Implementada apertura automática del submenú correspondiente según la URL activa y persistencia de submenús abiertos en `localStorage` (`edu_sidebar_open_menus`).
+### Fixed
+- **Contraste de Tarjeta KPI de Administradores (`/admin/users_list`)**:
+ - Implementadas clases de estilo dedicadas en modo oscuro y claro (`.kpi-number-admin`, `.kpi-badge-admin`, `.kpi-icon-admin`) con contraste institucional púrpura de alta legibilidad.
+- **Reubicación Ergonómica del Botón de Modo Oscuro / Claro**:
+ - Retirado el botón de cambio de tema de las pantallas de autenticación (`login.html` y `admin_login.html`).
+ - Reubicado de forma ergonómica en el encabezado de la barra lateral (`sidebar-header`) junto al toggle de colapso, y en la cabecera móvil (`mobile-header`).
+- **Internacionalización y Textos en Español**:
+ - Mapeo de roles en backend y frontend para mostrar consistentemente `Administrador` en lugar de `Admin` o `System Administrator`.
+ - Traducido "Classroom Management System" por "Sistema de Gestión de Espacios Áulicos" y textos residuales en inglés.
+- **Balance de Estructura HTML**:
+ - Sincronizados y verificados al 100% los tags `
` en todas las plantillas del frontend, garantizando cero desbordes de contenedor.
+
## [3.8.13] - 2026-10-26
### Added
- **Métricas y Contadores Rápidos de Usuarios por Rol (`/admin/users_list`)**:
diff --git a/MEMORY.md b/MEMORY.md
index 77a9e4d..7814381 100644
--- a/MEMORY.md
+++ b/MEMORY.md
@@ -9,11 +9,13 @@ 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: Contadores por Rol y Paginación Reforzada en Usuarios — v3.8.13**:
- - **Métricas y Contadores por Rol en Usuarios (`users_list`)**: Tarjetas KPI en cabecera con total global, administradores, bedeles, docentes y alumnos, con filtro rápido al hacer clic. Doble barra de paginación (superior e inferior) con indicador de rango (`Página X de Y · Mostrando Z de N usuarios`).
- - **Filtro Resiliente en FastAPI**: `get_users` acepta rol numérico o textual y retorna `role_counts` estructurado.
- - **Cero Diagnósticos en Pyright**: Eliminadas llamadas `str()` redundantes en routers FastAPI.
- - **Versión Consolidada**: `v3.8.13`.
+- **Sprint Activo: UX de Aulas, Filtro de Sesiones del Mes y Optimización de Navegación — v3.8.14**:
+ - **Filtro de Sesiones del Mes en `/schedule/list_reservations`**: Botón "Sesiones del Mes" precarga las fechas del mes y switch "Solo Aulas Virtuales", desplegando las 24 sesiones de inmediato mediante `scope=month&only_virtual=1` en backend y frontend.
+ - **Desglose Transparente de Espacios Áulicos**: En Dashboard se muestran separadas las 3 aulas físicas y 19 salas virtuales a demanda, con enlaces directos a sus catálogos respectivos. En `/classrooms/list_classrooms` se especifica "3 aulas presenciales" y "19 salas virtuales a demanda".
+ - **Persistencia de Submenús en Sidebar**: Removido `data-bs-parent`, auto-despliegue según URL activa y persistencia de submenús abiertos en `localStorage`.
+ - **Ergonomía de Tema y Contraste**: Botón de tema reubicado al header lateral y móvil, removido del login. Contraste de alta legibilidad en tarjeta de Administradores en `/admin/users_list`.
+ - **Internacionalización y Balance HTML**: Mapeo completo de `Admin` a `Administrador`, eliminación de textos en inglés, y 100% de tags HTML balanceados.
+ - **Versión Consolidada**: `v3.8.14`.
## 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.
diff --git a/backend/app/__init__.py b/backend/app/__init__.py
index afd6488..3c2243c 100644
--- a/backend/app/__init__.py
+++ b/backend/app/__init__.py
@@ -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.13"
+__version__ = "3.8.14"
class DummyContext:
def __enter__(self):
diff --git a/backend/app/repositories/reservation_repository.py b/backend/app/repositories/reservation_repository.py
index b724b07..8200f52 100644
--- a/backend/app/repositories/reservation_repository.py
+++ b/backend/app/repositories/reservation_repository.py
@@ -35,6 +35,8 @@ class ReservationRepository(BaseRepository[Reservation]):
def get_by_date_range(self, start_dt: datetime, end_dt: datetime,
classroom_id: Optional[int] = None,
is_hide_virtual: bool = False,
+ only_virtual: bool = False,
+ status: Optional[str] = None,
floor: Optional[str] = None,
shift: Optional[str] = None,
search: Optional[str] = None,
@@ -46,14 +48,28 @@ class ReservationRepository(BaseRepository[Reservation]):
joinedload(Reservation.user)
).filter(
Reservation.start_time >= start_dt,
- Reservation.start_time <= end_dt,
- Reservation.status != ReservationStatus.CANCELLED.value
+ Reservation.start_time <= end_dt
)
+ if status and status.strip() and status.strip().lower() != 'all':
+ s_val = status.strip()
+ query = query.filter(Reservation.status == s_val)
+ else:
+ query = query.filter(Reservation.status != ReservationStatus.CANCELLED.value)
+
if classroom_id:
query = query.filter(Reservation.classroom_id == classroom_id)
- if is_hide_virtual:
+ if only_virtual:
+ query = query.outerjoin(Classroom, Reservation.classroom_id == Classroom.id).filter(
+ or_(
+ Reservation.is_virtual == True,
+ Classroom.is_virtual == True,
+ Classroom.code.ilike('%VIRTUAL%'),
+ Classroom.building.ilike('%VIRTUAL%')
+ )
+ )
+ elif is_hide_virtual:
query = query.outerjoin(Classroom, Reservation.classroom_id == Classroom.id).filter(
or_(
Classroom.id.is_(None),
diff --git a/backend/app/services/reservation_service.py b/backend/app/services/reservation_service.py
index f0bfde8..8a6ae12 100644
--- a/backend/app/services/reservation_service.py
+++ b/backend/app/services/reservation_service.py
@@ -23,6 +23,8 @@ class ReservationService:
def list_reservations(self, start_dt: datetime, end_dt: datetime,
classroom_id: Optional[int] = None,
is_hide_virtual: bool = False,
+ only_virtual: bool = False,
+ status: Optional[str] = None,
floor: Optional[str] = None,
shift: Optional[str] = None,
search: Optional[str] = None,
@@ -32,6 +34,8 @@ class ReservationService:
start_dt, end_dt,
classroom_id=classroom_id,
is_hide_virtual=is_hide_virtual,
+ only_virtual=only_virtual,
+ status=status,
floor=floor,
shift=shift,
search=search,
diff --git a/backend/routers/admin.py b/backend/routers/admin.py
index 0758f9a..8d09a69 100644
--- a/backend/routers/admin.py
+++ b/backend/routers/admin.py
@@ -69,7 +69,7 @@ def get_users(
total = query.count()
roles = Role.query.order_by(Role.name.asc()).all()
- roles_data = [{'id': r.id, 'name': r.name} for r in roles]
+ roles_data = [{'id': r.id, 'name': 'Administrador' if (r.name or '').strip().lower() == 'admin' else r.name} for r in roles]
# Métricas agregadas de usuarios para contadores en la vista
total_users_count = db.session.query(func.count(User.id)).scalar() or 0
@@ -114,10 +114,21 @@ def get_users(
users_data = []
for u in users:
d = u.to_dict()
+ r_name = u.role_obj.name if u.role_obj else (u.role or 'Docente')
+ if (r_name or '').strip().lower() == 'admin':
+ r_name = 'Administrador'
d['role_obj'] = {
- 'id': u.role_obj.id,
- 'name': u.role_obj.name
- } if u.role_obj else {'id': 1, 'name': u.role or 'Admin'}
+ 'id': u.role_obj.id if u.role_obj else 1,
+ 'name': r_name
+ }
+ if d.get('name') == 'System Administrator':
+ d['name'] = 'Administrador del Sistema'
+ if d.get('first_name') == 'System' and d.get('last_name') == 'Administrator':
+ d['first_name'] = 'Administrador'
+ d['last_name'] = 'Sistema'
+ elif d.get('first_name') == 'Administrator' and d.get('last_name') == 'System':
+ d['first_name'] = 'Administrador'
+ d['last_name'] = 'Sistema'
users_data.append(d)
return {
diff --git a/backend/routers/reservations.py b/backend/routers/reservations.py
index e9d0bb6..f14d2a0 100644
--- a/backend/routers/reservations.py
+++ b/backend/routers/reservations.py
@@ -2,6 +2,7 @@
FastAPI Reservations Router (/api/v1/reservations)
Handles creation, listing, updating, cancelling, confirmation and full conflict matrix validation.
"""
+import calendar
from typing import Optional, Any, Dict
from datetime import datetime, timedelta, timezone
from fastapi import APIRouter, Depends, HTTPException, Query, status, Request
@@ -21,11 +22,17 @@ reservation_service = ReservationService()
@reservations_router.get("")
+@reservations_router.get("/")
def list_reservations(
start_date: Optional[str] = Query(None),
end_date: Optional[str] = Query(None),
+ date_from: Optional[str] = Query(None),
+ date_to: Optional[str] = Query(None),
+ scope: Optional[str] = Query(None),
classroom_id: Optional[str] = Query(None),
hide_virtual: Optional[str] = Query(None),
+ only_virtual: Optional[str] = Query(None),
+ status_filter: Optional[str] = Query(None, alias="status"),
floor: Optional[str] = Query(None),
shift: Optional[str] = Query(None),
search: Optional[str] = Query(None),
@@ -33,24 +40,47 @@ def list_reservations(
current_user: User = Depends(get_current_user)
):
"""Consulta de reservas por rango de fechas y/o aula con filtros en SQL."""
+ effective_start = (date_from or start_date or "").strip()
+ effective_end = (date_to or end_date or "").strip()
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)
- except ValueError:
- raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Formato inválido de start_date (debe ser YYYY-MM-DD).")
- try:
- end_dt = datetime.strptime(end_date, '%Y-%m-%d').replace(hour=23, minute=59, second=59) if end_date else start_dt + timedelta(days=7)
- except ValueError:
- raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Formato inválido de end_date (debe ser YYYY-MM-DD).")
+ # Resolución inteligente de rangos según scope o filtros
+ if scope == 'month' and not effective_start and not effective_end:
+ start_dt = now.replace(day=1, hour=0, minute=0, second=0, microsecond=0)
+ _, last_day = calendar.monthrange(now.year, now.month)
+ end_dt = now.replace(day=last_day, hour=23, minute=59, second=59, microsecond=999999)
+ elif scope == 'today' and not effective_start and not effective_end:
+ start_dt = now.replace(hour=0, minute=0, second=0, microsecond=0)
+ end_dt = now.replace(hour=23, minute=59, second=59, microsecond=999999)
+ elif scope == 'week' and not effective_start and not effective_end:
+ start_of_week = now - timedelta(days=now.weekday())
+ start_dt = start_of_week.replace(hour=0, minute=0, second=0, microsecond=0)
+ end_of_week = start_of_week + timedelta(days=6)
+ end_dt = end_of_week.replace(hour=23, minute=59, second=59, microsecond=999999)
+ elif not effective_start and not effective_end:
+ # Si no se especificó rango, abarcar desde inicio del mes actual hasta 90 días adelante para no dejar el listado vacío
+ start_dt = now.replace(day=1, hour=0, minute=0, second=0, microsecond=0)
+ end_dt = (start_dt + timedelta(days=90)).replace(hour=23, minute=59, second=59)
+ else:
+ try:
+ start_dt = datetime.strptime(effective_start, '%Y-%m-%d') if effective_start else now.replace(day=1, hour=0, minute=0, second=0)
+ except ValueError:
+ raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Formato inválido de fecha inicial (debe ser YYYY-MM-DD).")
+ try:
+ end_dt = datetime.strptime(effective_end, '%Y-%m-%d').replace(hour=23, minute=59, second=59) if effective_end else (start_dt + timedelta(days=60)).replace(hour=23, minute=59, second=59)
+ except ValueError:
+ raise HTTPException(status_code=status.HTTP_400_BAD_REQUEST, detail="Formato inválido de fecha final (debe ser YYYY-MM-DD).")
is_hide_virtual = str(hide_virtual).lower() in ['1', 'true']
+ is_only_virtual = str(only_virtual).lower() in ['1', 'true']
parsed_classroom_id = int(classroom_id.strip()) if classroom_id and classroom_id.strip().isdigit() else None
reservations = reservation_service.list_reservations(
start_dt, end_dt,
classroom_id=parsed_classroom_id,
is_hide_virtual=is_hide_virtual,
+ only_virtual=is_only_virtual,
+ status=status_filter,
floor=floor,
shift=shift,
search=search,
diff --git a/backend/setup.py b/backend/setup.py
index 20892ea..ec10790 100644
--- a/backend/setup.py
+++ b/backend/setup.py
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup(
name="edu-space-admin",
- version="3.8.13",
+ version="3.8.14",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team",
author_email="admin@edu-space.com",
diff --git a/frontend/package.json b/frontend/package.json
index f31e8aa..23ac6c8 100644
--- a/frontend/package.json
+++ b/frontend/package.json
@@ -1,6 +1,6 @@
{
"name": "frontend",
- "version": "3.8.13",
+ "version": "3.8.14",
"description": "",
"main": "index.js",
"scripts": {
diff --git a/frontend/src/app.js b/frontend/src/app.js
index 687f0ff..ba15ae1 100644
--- a/frontend/src/app.js
+++ b/frontend/src/app.js
@@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
});
// Versiones institucionales del sistema
-const APP_VERSION = '3.8.13';
-const FRONTEND_VERSION = '3.8.13';
-const BACKEND_VERSION = '3.8.13';
+const APP_VERSION = '3.8.14';
+const FRONTEND_VERSION = '3.8.14';
+const BACKEND_VERSION = '3.8.14';
env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION);
diff --git a/frontend/src/routes/schedule.js b/frontend/src/routes/schedule.js
index 8cfc260..f939547 100644
--- a/frontend/src/routes/schedule.js
+++ b/frontend/src/routes/schedule.js
@@ -265,10 +265,77 @@ function formatReservationDates(r) {
// 3. Vista de Lista de Reservas
const handleReservationsList = async (req, res) => {
try {
- const response = await req.apiClient.get('/reservations');
- const rawReservations = (response.data && response.data.reservations) || [];
+ let {
+ search = '',
+ status = 'all',
+ floor = '',
+ classroom_id = '',
+ shift = '',
+ date_from = '',
+ date_to = '',
+ hide_virtual = '',
+ only_virtual = '',
+ scope = ''
+ } = req.query;
+
+ // Si scope es 'month', calcular fechas del mes actual si no vienen explícitas
+ const now = new Date();
+ if (scope === 'month' && !date_from && !date_to) {
+ const y = now.getFullYear();
+ const m = String(now.getMonth() + 1).padStart(2, '0');
+ const lastDay = new Date(y, now.getMonth() + 1, 0).getDate();
+ date_from = `${y}-${m}-01`;
+ date_to = `${y}-${m}-${String(lastDay).padStart(2, '0')}`;
+ } else if (scope === 'today' && !date_from && !date_to) {
+ const todayStr = now.toISOString().split('T')[0];
+ date_from = todayStr;
+ date_to = todayStr;
+ } else if (scope === 'week' && !date_from && !date_to) {
+ const day = now.getDay();
+ const diff = now.getDate() - day + (day === 0 ? -6 : 1);
+ const mon = new Date(now.setDate(diff));
+ const sun = new Date(mon);
+ sun.setDate(mon.getDate() + 6);
+ date_from = mon.toISOString().split('T')[0];
+ date_to = sun.toISOString().split('T')[0];
+ }
+
+ const params = {};
+ if (date_from) params.date_from = date_from;
+ if (date_to) params.date_to = date_to;
+ if (scope) params.scope = scope;
+ if (search) params.search = search;
+ if (status && status !== 'all') params.status = status;
+ if (floor) params.floor = floor;
+ if (classroom_id) params.classroom_id = classroom_id;
+ if (shift) params.shift = shift;
+ if (hide_virtual === '1' || hide_virtual === 'true') params.hide_virtual = '1';
+ if (only_virtual === '1' || only_virtual === 'true') params.only_virtual = '1';
+
+ // Obtener reservas y catálogo de aulas en paralelo
+ const [resResponse, roomsResponse] = await Promise.all([
+ req.apiClient.get('/reservations', { params }).catch(err => {
+ console.error('Error fetching reservations:', err.message);
+ return { data: { reservations: [] } };
+ }),
+ req.apiClient.get('/classrooms').catch(err => {
+ console.error('Error fetching classrooms for filter:', err.message);
+ return { data: { classrooms: [] } };
+ })
+ ]);
+
+ const rawReservations = (resResponse.data && resResponse.data.reservations) || [];
const reservations = rawReservations.map(formatReservationDates);
+ const all_classrooms = (roomsResponse.data && roomsResponse.data.classrooms) || [];
+ const floorsSet = new Set();
+ all_classrooms.forEach(c => {
+ if (c.floor !== undefined && c.floor !== null && c.floor !== '') {
+ floorsSet.add(c.floor);
+ }
+ });
+ const available_floors = Array.from(floorsSet).sort((a, b) => String(a).localeCompare(String(b)));
+
res.render('schedule/list', {
title: 'Listado de Reservas - Edu-Space Admin',
reservations: {
@@ -280,8 +347,18 @@ const handleReservationsList = async (req, res) => {
has_next: false,
iter_pages: () => [1]
},
- classrooms: [],
- subjects: [],
+ search,
+ status_filter: status,
+ floor_filter: floor,
+ classroom_id,
+ shift_filter: shift,
+ date_from,
+ date_to,
+ hide_virtual: hide_virtual === '1' || hide_virtual === 'true',
+ only_virtual: only_virtual === '1' || only_virtual === 'true',
+ scope,
+ all_classrooms,
+ available_floors,
session: { get: (k, d) => d }
});
} catch (error) {
@@ -289,8 +366,18 @@ const handleReservationsList = async (req, res) => {
res.render('schedule/list', {
title: 'Listado de Reservas (Offline)',
reservations: { items: [], total: 0, pages: 1, page: 1, has_prev: false, has_next: false, iter_pages: () => [1] },
- classrooms: [],
- subjects: [],
+ search: '',
+ status_filter: 'all',
+ floor_filter: '',
+ classroom_id: '',
+ shift_filter: '',
+ date_from: '',
+ date_to: '',
+ hide_virtual: false,
+ only_virtual: false,
+ scope: '',
+ all_classrooms: [],
+ available_floors: [],
session: { get: (k, d) => d }
});
}
diff --git a/frontend/views/admin/users/list.html b/frontend/views/admin/users/list.html
index 7f5934f..424ae32 100644
--- a/frontend/views/admin/users/list.html
+++ b/frontend/views/admin/users/list.html
@@ -2,6 +2,45 @@
{% block title %}Gestión de Usuarios — Edu-Space Admin{% endblock %}
+{% block extra_css %}
+
+{% endblock %}
+
{% block content %}