fix(ui/ux): restore mobile header, fix collapsed session options, compact version badge and theme endpoint v3.8.16

This commit is contained in:
2026-10-26 14:52:22 -03:00
parent 6bf2a72d08
commit 91ea4bbfc7
7 changed files with 172 additions and 35 deletions
+14
View File
@@ -11,6 +11,20 @@ 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. - **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. - **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
## [3.8.16] - 2026-10-26
### Fixed
- **Restauración y UX Nativa del Menú en Dispositivos Celulares / Móviles**:
- Corregida la visibilidad de `.mobile-header` en pantallas menores a 992px resolviendo el conflicto de especificidad entre `@media` y reglas globales, restaurando el acceso al menú de navegación (`#mobileMenuBtn`) en celulares.
- Implementado backdrop interactivo con desenfoque (`.sidebar-backdrop`) y cierre automático del menú al tocar el fondo o pulsar cualquier enlace de navegación.
- Ocultación total blindada del sidebar fuera de pantalla en móvil (`left: -290px` con `width: 280px` y `overflow-x: hidden !important`).
- **Visibilidad Completa de Opciones de Sesión en Modo Colapsado**:
- Reemplazada la clase `.sidebar-submenu` por `.user-menu-list` en el menú de usuario, eliminando el ocultamiento accidental (`display: none !important`) en modo colapsado y asegurando que las opciones "Mi Perfil", "Cambiar Contraseña" y "Cerrar Sesión" permanezcan 100% visibles e interactivas.
- Coordinada la apertura del menú de usuario con el cierre de otros flyouts para prevenir superposiciones.
- **Corrección de Desborde y Superposición del Badge de Versión**:
- Reestructurado el indicador de versión en un badge vertical compacto con `text-truncate` en el sidebar (`v3.8.16` en píldora y desglose secundario en línea inferior), eliminando el desborde horizontal de más de 400px que sobresalía y se superponía con elementos de la interfaz.
- **Resolución de Error 404 en `/api/user/theme`**:
- Creado endpoint dedicado `app.post(['/api/user/theme', '/theme'])` en Express BFF para atender la persistencia rápida de tema visual de usuario por AJAX, sincronizando transparentemente con FastAPI sin arrojar errores en la consola del navegador.
## [3.8.15] - 2026-10-26 ## [3.8.15] - 2026-10-26
### Added ### Added
- **Diseño Ergonómico de Footer y Menú de Usuario (Sidebar & Flyout)**: - **Diseño Ergonómico de Footer y Menú de Usuario (Sidebar & Flyout)**:
+7 -8
View File
@@ -9,14 +9,13 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables. - Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación. - 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. - Reinicialización segura del sistema con contraseña de Administrador.
- **Sprint Activo: Ergonomía de Sidebar, Menú de Usuario y Hardening de Seguridad — v3.8.15**: - **Sprint Activo: UI/UX Móvil, Sesión en Sidebar Colapsado y Cero Errores — v3.8.16**:
- **Resolución de `@[current_problems]`**: Reemplazadas propiedades Python por expresiones nativas SQLAlchemy ColumnElement en `reservation_repository.py`. Cero errores de sintaxis y tipado. - **Móvil Restaurado & UX Nativa**: Restablecida la visibilidad de `.mobile-header` en pantallas `< 992px`, incorporado `.sidebar-backdrop` y cierre automático al navegar o tocar el fondo.
- **Ocultación Total de `mobile-header` en Desktop**: Eliminada la barra móvil superior en pantallas `>= 992px` mediante `d-lg-none` y `display: none !important;` en CSS. - **Menú de Usuario y Cierre de Sesión en Colapsado**: Sustituido `.sidebar-submenu` por `.user-menu-list` para evitar ocultamiento indeseado, asegurando acceso completo a "Mi Perfil", "Cambiar Contraseña" y "Cerrar Sesión".
- **Ergonomía de Footer y Botón de Tema**: Botón de tema reubicado al fondo del sidebar, directamente sobre el botón de usuario, con sincronización de label ("Modo Claro / Modo Oscuro") e icono centrado en modo colapsado. - **Corrección de Badge de Versión**: Estructurado en bloque vertical compacto con `text-truncate` y `overflow-x: hidden !important`, impidiendo que sobresalga o se superponga con otros componentes.
- **Menú de Usuario Prolijo**: Menú desplegable con header `.flyout-header`, datos de perfil, rol y acciones con estilo idéntico al resto de submenús. En sidebar colapsado se proyecta a la derecha como un flyout lateral unificado sin recortes. - **Resolución de Error 404 en `/api/user/theme`**: Endpoint registrado en Express BFF para guardar tema visual por AJAX sin errores.
- **Ajuste Dinámico contra Recortes**: Implementado `adjustFlyoutPosition` y `max-height: calc(100vh - 24px); overflow-y: auto;` en CSS y JS para evitar cualquier desborde vertical en pantallas pequeñas. - **QA & Seguridad Integral**: 100% tests aprobados (79 passed en pytest), 52 plantillas balanceadas, 0 issues en SAST/SCA (Bandit, pip-audit, njsscan, npm audit).
- **Auditoría de Seguridad Automatizada**: Actualizado `security_audit.bat` (rutas FastAPI y bandit en `routers`), 0 vulnerabilidades en npm y 100% aprobado (`SECURITY AUDIT SUITE COMPLETED SUCCESSFULLY [PASS]`). - **Versión Consolidada**: `v3.8.16`.
- **Versión Consolidada**: `v3.8.15`.
## Decisiones (y por qué) ## 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. - **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 database import db, get_db, engine, SessionLocal, session
from config.config import Config from config.config import Config
__version__ = "3.8.15" __version__ = "3.8.16"
class DummyContext: class DummyContext:
def __enter__(self): def __enter__(self):
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup( setup(
name="edu-space-admin", name="edu-space-admin",
version="3.8.15", version="3.8.16",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)", description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team", author="Edu-Space Development Team",
author_email="admin@edu-space.com", author_email="admin@edu-space.com",
+1 -1
View File
@@ -1,6 +1,6 @@
{ {
"name": "frontend", "name": "frontend",
"version": "3.8.15", "version": "3.8.16",
"description": "", "description": "",
"main": "index.js", "main": "index.js",
"scripts": { "scripts": {
+19 -3
View File
@@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
}); });
// Versiones institucionales del sistema // Versiones institucionales del sistema
const APP_VERSION = '3.8.15'; const APP_VERSION = '3.8.16';
const FRONTEND_VERSION = '3.8.15'; const FRONTEND_VERSION = '3.8.16';
const BACKEND_VERSION = '3.8.15'; const BACKEND_VERSION = '3.8.16';
env.addGlobal('app_version', APP_VERSION); env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION);
@@ -402,6 +402,22 @@ app.get(['/genetic_optimizer', '/genetic_algorithm_web/genetic_optimizer'], requ
}); });
}); });
// Sincronización rápida de tema visual de usuario por AJAX (evita 404 en /api/user/theme)
app.post(['/api/user/theme', '/theme'], async (req, res) => {
const theme = req.body.theme || req.body.theme_preference || 'auto';
try {
if (req.user) {
req.user.theme_preference = theme;
}
if (req.apiClient) {
await req.apiClient.post('/auth/theme', { theme });
}
return res.json({ status: 'success', theme });
} catch (err) {
return res.json({ status: 'ok', theme, notice: 'saved-locally' });
}
});
// Proxy transparente de peticiones /api a Flask // Proxy transparente de peticiones /api a Flask
app.use('/api', async (req, res) => { app.use('/api', async (req, res) => {
// Si es dashboard-stats mock directo // Si es dashboard-stats mock directo
+129 -21
View File
@@ -747,28 +747,43 @@
border-bottom-color: rgba(255, 255, 255, 0.08); border-bottom-color: rgba(255, 255, 255, 0.08);
background: rgba(255, 138, 182, 0.06); background: rgba(255, 138, 182, 0.06);
} }
.user-dropdown-menu .user-menu-list,
.user-dropdown-menu .sidebar-submenu {
display: block !important;
list-style: none !important;
padding: 0.35rem !important;
margin: 0 !important;
}
.user-dropdown-menu .user-menu-list .nav-link,
.user-dropdown-menu .sidebar-submenu .nav-link { .user-dropdown-menu .sidebar-submenu .nav-link {
padding: 0.55rem 0.85rem !important; padding: 0.55rem 0.85rem !important;
font-size: 0.85rem; font-size: 0.85rem;
white-space: nowrap; white-space: nowrap;
display: flex !important; display: flex !important;
align-items: center !important; align-items: center !important;
justify-content: flex-start !important;
border-radius: 8px !important; border-radius: 8px !important;
color: #1E293B !important; color: #1E293B !important;
text-decoration: none; text-decoration: none !important;
width: 100% !important;
height: auto !important;
transition: all 0.15s ease; transition: all 0.15s ease;
} }
[data-bs-theme="dark"] .user-dropdown-menu .user-menu-list .nav-link,
[data-bs-theme="dark"] .user-dropdown-menu .sidebar-submenu .nav-link { [data-bs-theme="dark"] .user-dropdown-menu .sidebar-submenu .nav-link {
color: #F8FAFC !important; color: #F8FAFC !important;
} }
.user-dropdown-menu .user-menu-list .nav-link:hover,
.user-dropdown-menu .sidebar-submenu .nav-link:hover { .user-dropdown-menu .sidebar-submenu .nav-link:hover {
background-color: rgba(180, 62, 142, 0.1) !important; background-color: rgba(180, 62, 142, 0.1) !important;
color: #B43E8E !important; color: #B43E8E !important;
} }
[data-bs-theme="dark"] .user-dropdown-menu .user-menu-list .nav-link:hover,
[data-bs-theme="dark"] .user-dropdown-menu .sidebar-submenu .nav-link:hover { [data-bs-theme="dark"] .user-dropdown-menu .sidebar-submenu .nav-link:hover {
background-color: rgba(255, 138, 182, 0.15) !important; background-color: rgba(255, 138, 182, 0.15) !important;
color: #FF8AB6 !important; color: #FF8AB6 !important;
} }
.user-dropdown-menu .user-menu-list .nav-link.hover-danger:hover,
.user-dropdown-menu .sidebar-submenu .nav-link.hover-danger:hover { .user-dropdown-menu .sidebar-submenu .nav-link.hover-danger:hover {
background-color: rgba(239, 68, 68, 0.12) !important; background-color: rgba(239, 68, 68, 0.12) !important;
color: #EF4444 !important; color: #EF4444 !important;
@@ -806,6 +821,22 @@
z-index: 1095 !important; z-index: 1095 !important;
transform: none !important; transform: none !important;
animation: flyoutSlideIn 0.18s cubic-bezier(0.16, 1, 0.3, 1) !important; animation: flyoutSlideIn 0.18s cubic-bezier(0.16, 1, 0.3, 1) !important;
max-height: calc(100vh - 24px) !important;
overflow-y: auto !important;
}
.sidebar.collapsed .user-dropdown-menu .user-menu-list,
.sidebar.collapsed .user-dropdown-menu .sidebar-submenu {
display: block !important;
padding: 0.35rem !important;
}
.sidebar.collapsed .user-dropdown-menu .user-menu-list .nav-link,
.sidebar.collapsed .user-dropdown-menu .sidebar-submenu .nav-link {
display: flex !important;
align-items: center !important;
justify-content: flex-start !important;
width: 100% !important;
height: auto !important;
padding: 0.55rem 0.85rem !important;
} }
/* --- BOTÓN DE TEMA SOBRE EL BOTÓN DE USUARIO --- */ /* --- BOTÓN DE TEMA SOBRE EL BOTÓN DE USUARIO --- */
@@ -924,20 +955,15 @@
margin-top: 0 !important; margin-top: 0 !important;
} }
/* Mobile Header: 100% oculto en Desktop, activo exclusivamente en pantallas móviles < 992px */ /* Mobile Header: Oculto en Desktop (>= 992px), activo exclusivamente en móviles (< 992px) */
.mobile-header { @media (min-width: 992px) {
display: none !important; .mobile-header {
display: none !important;
}
} }
@media (max-width: 991.98px) { @media (max-width: 991.98px) {
.sidebar {
position: fixed;
left: -260px;
}
.sidebar.mobile-open {
left: 0;
}
.mobile-header { .mobile-header {
display: flex; display: flex !important;
background: var(--bs-body-bg); background: var(--bs-body-bg);
border-bottom: 1px solid rgba(0, 0, 0, 0.08); border-bottom: 1px solid rgba(0, 0, 0, 0.08);
padding: 0.5rem 1rem; padding: 0.5rem 1rem;
@@ -951,6 +977,41 @@
[data-bs-theme="dark"] .mobile-header { [data-bs-theme="dark"] .mobile-header {
border-bottom-color: rgba(255, 255, 255, 0.08); border-bottom-color: rgba(255, 255, 255, 0.08);
} }
.sidebar {
position: fixed;
top: 0;
bottom: 0;
left: -290px;
width: 280px;
height: 100vh;
z-index: 1060;
transition: left 0.28s cubic-bezier(0.16, 1, 0.3, 1);
box-shadow: none;
overflow-x: hidden !important;
}
.sidebar.mobile-open {
left: 0 !important;
box-shadow: 4px 0 28px rgba(0, 0, 0, 0.35) !important;
}
}
/* Backdrop para oscurecer y cerrar menú al tocar en móvil */
.sidebar-backdrop {
display: none;
position: fixed;
top: 0;
left: 0;
right: 0;
bottom: 0;
background: rgba(15, 23, 42, 0.6);
backdrop-filter: blur(2px);
z-index: 1050;
opacity: 0;
transition: opacity 0.25s ease;
}
.sidebar-backdrop.show {
display: block;
opacity: 1;
} }
/* ======================================================= /* =======================================================
@@ -1043,6 +1104,8 @@
{% if auth_user and auth_user.is_authenticated %} {% if auth_user and auth_user.is_authenticated %}
<div class="app-wrapper"> <div class="app-wrapper">
<!-- Sidebar Backdrop (Móvil) -->
<div class="sidebar-backdrop" id="sidebarBackdrop"></div>
<!-- Sidebar --> <!-- Sidebar -->
<aside class="sidebar" id="sidebar"> <aside class="sidebar" id="sidebar">
<div class="sidebar-header border-bottom border-secondary-subtle d-flex align-items-center justify-content-between px-3"> <div class="sidebar-header border-bottom border-secondary-subtle d-flex align-items-center justify-content-between px-3">
@@ -1301,7 +1364,7 @@
{{ auth_user.role_badge_display.label if (auth_user and auth_user.role_badge_display) else (auth_user.role|capitalize if auth_user else 'Usuario') }} {{ auth_user.role_badge_display.label if (auth_user and auth_user.role_badge_display) else (auth_user.role|capitalize if auth_user else 'Usuario') }}
</span> </span>
</div> </div>
<ul class="sidebar-submenu p-1 m-0 list-unstyled"> <ul class="user-menu-list p-1 m-0 list-unstyled">
<li> <li>
<a class="nav-link py-2 px-3 d-flex align-items-center rounded-2" href="/auth/profile"> <a class="nav-link py-2 px-3 d-flex align-items-center rounded-2" href="/auth/profile">
<i class="bi bi-person text-primary me-2 fs-6"></i> <i class="bi bi-person text-primary me-2 fs-6"></i>
@@ -1325,10 +1388,15 @@
</div> </div>
</div> </div>
<div class="sidebar-footer-text mt-3 pt-2 border-top border-secondary-subtle text-center"> <!-- Versión Institucional sin desbordes -->
<span class="badge bg-secondary-subtle text-secondary-emphasis font-monospace px-2 py-1" style="font-size:0.68rem;" title="Versión Institucional de Edu-Space"> <div class="sidebar-footer-text mt-2 pt-2 border-top border-secondary-subtle text-center px-1">
<i class="bi bi-tag-fill me-1"></i>v{{ app_version or '3.4.9' }} <span class="opacity-75">(Frontend: v{{ frontend_version or '3.4.9' }} · Backend: v{{ backend_version or '3.4.9' }})</span> <div class="d-inline-flex align-items-center gap-1 badge bg-secondary-subtle text-secondary-emphasis font-monospace px-2 py-1 mb-1" style="font-size: 0.72rem;" title="Versión Institucional de Edu-Space">
</span> <i class="bi bi-tag-fill text-primary"></i>
<span>v{{ app_version or '3.4.9' }}</span>
</div>
<div class="text-muted text-truncate" style="font-size: 0.64rem; letter-spacing: -0.02em;" title="Frontend: v{{ frontend_version or '3.4.9' }} · Backend: v{{ backend_version or '3.4.9' }}">
Frontend: v{{ frontend_version or '3.4.9' }} · Backend: v{{ backend_version or '3.4.9' }}
</div>
</div> </div>
</div> </div>
</aside> </aside>
@@ -1336,7 +1404,7 @@
<!-- Main Content Wrapper --> <!-- Main Content Wrapper -->
<div class="main-content"> <div class="main-content">
<!-- Mobile Header (Visible EXCLUSIVAMENTE en dispositivos móviles y tablets < 992px) --> <!-- Mobile Header (Visible EXCLUSIVAMENTE en dispositivos móviles y tablets < 992px) -->
<div class="mobile-header shadow-sm d-lg-none align-items-center justify-content-between px-3"> <div class="mobile-header shadow-sm align-items-center justify-content-between px-3">
<a href="/dashboard" class="text-decoration-none brand-link d-flex align-items-center"> <a href="/dashboard" class="text-decoration-none brand-link d-flex align-items-center">
<img src="/img/logo_unicaba_mini.png" alt="Logo UniCABA" class="navbar-logo me-2" height="24"> <img src="/img/logo_unicaba_mini.png" alt="Logo UniCABA" class="navbar-logo me-2" height="24">
<span class="brand-text fw-bold fs-6">Edu-Space</span> <span class="brand-text fw-bold fs-6">Edu-Space</span>
@@ -1621,18 +1689,58 @@
}); });
} }
}); });
// Coordinar menú de usuario con flyouts en modo colapsado
const userMenuDropdown = document.getElementById("userMenuDropdown");
const userDropdownMenu = document.querySelector(".user-dropdown-menu");
if (userMenuDropdown) {
userMenuDropdown.addEventListener("click", function() {
document.querySelectorAll('#sidebarNav > .nav-item.show-flyout').forEach(function(item) {
item.classList.remove('show-flyout');
});
if (sidebar.classList.contains("collapsed") && userDropdownMenu) {
setTimeout(function() {
adjustFlyoutPosition(userDropdownMenu);
}, 10);
}
});
}
// Apertura, cierre y backdrop de sidebar móvil (UX Nativa)
const mobileBackdrop = document.getElementById("sidebarBackdrop");
function closeMobileSidebar() {
sidebar.classList.remove("mobile-open");
if (mobileBackdrop) mobileBackdrop.classList.remove("show");
document.body.style.overflow = "";
}
if (mobileBtn) { if (mobileBtn) {
mobileBtn.addEventListener("click", function() { mobileBtn.addEventListener("click", function(e) {
e.preventDefault();
sidebar.classList.add("mobile-open"); sidebar.classList.add("mobile-open");
if (mobileBackdrop) mobileBackdrop.classList.add("show");
document.body.style.overflow = "hidden";
}); });
} }
if (closeMobileBtn) { if (closeMobileBtn) {
closeMobileBtn.addEventListener("click", function() { closeMobileBtn.addEventListener("click", function(e) {
sidebar.classList.remove("mobile-open"); e.preventDefault();
closeMobileSidebar();
}); });
} }
if (mobileBackdrop) {
mobileBackdrop.addEventListener("click", closeMobileSidebar);
}
sidebar.querySelectorAll(".nav-link:not([data-bs-toggle])").forEach(function(link) {
link.addEventListener("click", function() {
if (window.innerWidth < 992) {
closeMobileSidebar();
}
});
});
}); });
</script> </script>