feat: user personalization, role-exact UI hierarchy and spotlight auto-expand (v3.8.29)

This commit is contained in:
2026-10-27 09:13:15 -03:00
parent 7668c3d92f
commit 96d8618157
15 changed files with 381 additions and 157 deletions
+85 -53
View File
@@ -8,26 +8,28 @@ from typing import Dict, Any, List, Optional
CANONICAL_ROUTES = [
{"name": "Dashboard Principal", "path": "/dashboard", "roles": ["ADMIN", "DOCENTE", "ALUMNO", "BEDELIA"]},
{"name": "Paso 1: Sedes y Edificios", "path": "/buildings", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 1: Sedes / Edificios", "path": "/buildings/list_buildings", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 2: Aulas Físicas y Virtuales", "path": "/classrooms/list_classrooms", "roles": ["ADMIN", "BEDELIA", "DOCENTE"]},
{"name": "Paso 3: Ciclos Lectivos", "path": "/admin/academic_periods", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 4: Carreras", "path": "/admin/careers", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 5: Asignaturas", "path": "/admin/subjects", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 6: Comisiones", "path": "/admin/commissions", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 7: Profesores y Docentes", "path": "/admin/professors", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 8: Alumnos y Matrícula", "path": "/admin/students", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 9: Reserva de Espacios Áulicos", "path": "/schedule", "roles": ["ADMIN", "BEDELIA", "DOCENTE"]},
{"name": "Mis Materias", "path": "/my_subjects", "roles": ["ALUMNO", "DOCENTE"]},
{"name": "Cartelera de Cursada de Hoy", "path": "/schedule/today_schedule", "roles": ["ALUMNO", "DOCENTE", "BEDELIA"]},
{"name": "Libro de Calificaciones (Gradebook)", "path": "/gradebook", "roles": ["DOCENTE", "ADMIN", "BEDELIA"]},
{"name": "Paso 3: Ciclos Lectivos", "path": "/admin/academic_terms_list", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 4: Carreras", "path": "/admin/careers_list", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 5: Asignaturas", "path": "/admin/subjects_list", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 6: Comisiones & Cursadas", "path": "/admin/commissions_list", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 7: Profesores y Docentes", "path": "/admin/users_list", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 8: Alumnos y Matrícula", "path": "/admin/users_list", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Paso 9: Reserva de Espacios Áulicos", "path": "/schedule/list_reservations", "roles": ["ADMIN", "BEDELIA", "DOCENTE"]},
{"name": "Mis Materias", "path": "/my_subjects/my_subjects_list", "roles": ["ALUMNO", "DOCENTE"]},
{"name": "Cartelera de Clases del Día", "path": "/schedule/today_schedule", "roles": ["ALUMNO", "DOCENTE", "BEDELIA"]},
{"name": "Libro de Calificaciones (Gradebook)", "path": "/schedule/gradebook", "roles": ["DOCENTE", "ADMIN", "BEDELIA"]},
{"name": "Optimizador Genético IA", "path": "/genetic_algorithm_web/genetic_optimizer", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Importador Google Sheets", "path": "/admin/google_sheets_import", "roles": ["ADMIN", "BEDELIA"]},
{"name": "Configuración Global", "path": "/admin/settings", "roles": ["ADMIN"]}
]
CANONICAL_9_STEPS = [
{
"step": 1,
"name": "Sedes",
"route": "/buildings",
"name": "Sedes / Edificios",
"route": "/buildings/list_buildings",
"description": "Dar de alta la sede física o campus con nombre, dirección y código.",
"prerequisite": None
},
@@ -35,55 +37,55 @@ CANONICAL_9_STEPS = [
"step": 2,
"name": "Aulas",
"route": "/classrooms/list_classrooms",
"description": "Crear espacios físicos (con aforo y equipamiento) o virtuales (Google Meet).",
"description": "Crear aulas físicas (con aforo y piso) o virtuales (Campus Virtual / Meet).",
"prerequisite": "Sede física existente"
},
{
"step": 3,
"name": "Ciclos Lectivos",
"route": "/admin/academic_periods",
"description": "Definir el período académico (ej. 2026-1C) con fechas de inicio y fin.",
"route": "/admin/academic_terms_list",
"description": "Definir el período académico (ej. 2026-2) con fechas de inicio y fin.",
"prerequisite": None
},
{
"step": 4,
"name": "Carreras",
"route": "/admin/careers",
"description": "Registrar planes de estudio y carreras institucionales.",
"route": "/admin/careers_list",
"description": "Registrar planes de estudio y carreras oficiales de UniCABA.",
"prerequisite": None
},
{
"step": 5,
"name": "Asignaturas",
"route": "/admin/subjects",
"route": "/admin/subjects_list",
"description": "Dar de alta las materias y asociarlas a una o más carreras.",
"prerequisite": "Carrera existente"
},
{
"step": 6,
"name": "Comisiones",
"route": "/admin/commissions",
"route": "/admin/commissions_list",
"description": "Crear las divisiones/comisiones de cada materia para el ciclo lectivo.",
"prerequisite": "Asignatura y Ciclo Lectivo activos"
},
{
"step": 7,
"name": "Profesores",
"route": "/admin/professors",
"route": "/admin/users_list",
"description": "Asignar docentes titulares o adjuntos a las comisiones.",
"prerequisite": "Comisión activa"
},
{
"step": 8,
"name": "Alumnos",
"route": "/admin/students",
"route": "/admin/users_list",
"description": "Matricular a los estudiantes en sus respectivas comisiones.",
"prerequisite": "Comisión activa"
},
{
"step": 9,
"name": "Reserva de Espacio",
"route": "/schedule",
"route": "/schedule/list_reservations",
"description": "Asignar aula y banda horaria validando la matriz de conflictos y aforo.",
"prerequisite": "Aula y Comisión completas"
}
@@ -91,25 +93,31 @@ CANONICAL_9_STEPS = [
STEP_GUIDES = {
"crear_sede": {
"title": "Guía: Cómo registrar una nueva Sede",
"target_url": "/buildings",
"title": "Guía: Cómo registrar una nueva Sede o Edificio",
"target_url": "/buildings/list_buildings",
"steps": [
{
"step_number": 1,
"selector": "#btnNewBuildingModal, button[data-bs-target='#newBuildingModal'], a[href*='building']",
"message": "Paso 1: Haz clic en el botón '+ Nueva Sede' para abrir el formulario.",
"selector": "a[href*='/buildings/add_building'], a[href*='add_building'], a[href*='list_buildings']",
"message": "Paso 1: Haz clic en el botón 'Nuevo Edificio' para abrir el formulario.",
"expected_action": "click"
},
{
"step_number": 2,
"selector": "#buildingName, input[name='name']",
"selector": "#buildingNameInput, input[name='name']",
"message": "Paso 2: Escribe el nombre institucional de la sede (ej. 'Sede Central').",
"expected_action": "input"
},
{
"step_number": 3,
"selector": "#btnSaveBuilding, button[type='submit']",
"message": "Paso 3: Haz clic en 'Guardar Sede' para confirmar el registro.",
"selector": "#buildingCodeInput, input[name='code']",
"message": "Paso 3: Ingresa el código identificador de la sede (ej. 'CENTRAL').",
"expected_action": "input"
},
{
"step_number": 4,
"selector": "#buildingForm button[type='submit'], button[type='submit']",
"message": "Paso 4: Haz clic en 'Crear Edificio' para confirmar el alta.",
"expected_action": "click"
}
]
@@ -120,44 +128,44 @@ STEP_GUIDES = {
"steps": [
{
"step_number": 1,
"selector": "#btnOpenCreateClassroomModal, button[data-bs-target='#createClassroomModal'], .btn-create-classroom, a[href*='classrooms/new']",
"message": "Paso 1: Haz clic en el botón '+ Nueva Aula' para iniciar la creación.",
"selector": "a[href*='/classrooms/add_classroom'], a[href*='add_classroom'], a[href*='list_classrooms']",
"message": "Paso 1: Haz clic en el botón 'Agregar Aula Física' para iniciar la creación.",
"expected_action": "click"
},
{
"step_number": 2,
"selector": "#classroomName, input[name='name']",
"message": "Paso 2: Ingresa el nombre o número de aula (ej. 'Aula 204') y define el aforo máximo de alumnos.",
"selector": "#building_id, select[name='building_id']",
"message": "Paso 2: Selecciona la Sede o Edificio correspondiente.",
"expected_action": "input"
},
{
"step_number": 3,
"selector": "#btnSaveClassroom, form#createClassroomForm button[type='submit'], .modal-footer .btn-primary",
"message": "Paso 3: Haz clic en 'Guardar Aula' para confirmar el alta.",
"selector": "#room_number, input[name='room_number']",
"message": "Paso 3: Ingresa el número o nombre del aula (ej. 'Aula 204').",
"expected_action": "input"
},
{
"step_number": 4,
"selector": "#capacity, input[name='capacity']",
"message": "Paso 4: Define la capacidad de alumnos para el aforo.",
"expected_action": "input"
},
{
"step_number": 5,
"selector": "#classroom-form button[type='submit'], button[type='submit']",
"message": "Paso 5: Haz clic en 'Crear Aula' para confirmar el guardado.",
"expected_action": "click"
}
]
},
"crear_ciclo": {
"title": "Guía: Cómo dar de alta un Ciclo Lectivo",
"target_url": "/admin/academic_periods",
"target_url": "/admin/academic_terms_list",
"steps": [
{
"step_number": 1,
"selector": "#btnNewPeriod, button[data-bs-target='#newPeriodModal'], .btn-new-period",
"message": "Paso 1: Haz clic en '+ Nuevo Ciclo Lectivo' para configurar el período académico.",
"expected_action": "click"
},
{
"step_number": 2,
"selector": "#periodCode, input[name='code']",
"message": "Paso 2: Ingresa el código del ciclo (ej. '2026-1C') y las fechas de inicio y fin.",
"expected_action": "input"
},
{
"step_number": 3,
"selector": "#btnSavePeriod, button[type='submit']",
"message": "Paso 3: Haz clic en 'Guardar Período' para habilitar la cursada.",
"selector": "button[data-bs-target='#modalAddTerm'], a[href*='academic_terms_list']",
"message": "Paso 1: Haz clic en '+ Nuevo Ciclo Lectivo' para abrir la ventana de carga.",
"expected_action": "click"
}
]
@@ -168,11 +176,35 @@ STEP_GUIDES = {
"steps": [
{
"step_number": 1,
"selector": ".today-class-card, #todayScheduleContainer, .table-schedule",
"message": "Aquí puedes ver tus clases del día con el aula física asignada o el botón para unirte a Google Meet.",
"selector": "a[href*='today_schedule'], .today-class-card, #todayScheduleContainer",
"message": "Aquí puedes ver tus clases del día con el aula física asignada y enlace a Google Meet.",
"expected_action": "view"
}
]
},
"gradebook": {
"title": "Guía: Libro de Calificaciones y Actas",
"target_url": "/schedule/gradebook",
"steps": [
{
"step_number": 1,
"selector": "a[href*='gradebook']",
"message": "Accede al Libro de Calificaciones desde el menú lateral para registrar parciales y regularidades.",
"expected_action": "click"
}
]
},
"importar_sheets": {
"title": "Guía: Importador Masivo de Google Sheets",
"target_url": "/admin/google_sheets_import",
"steps": [
{
"step_number": 1,
"selector": "a[href*='google_sheets_import']",
"message": "Accede al Importador de Google Sheets desde el menú lateral para sincronizar planillas.",
"expected_action": "click"
}
]
}
}