feat(reception,udeci): v3.8.48 - forced scanner focus, spanish keyboard gun normalization, reception default dashboard, and udeci commission listings

This commit is contained in:
2026-10-28 13:01:44 -03:00
parent e84a236d54
commit 3dbd22cc3c
18 changed files with 444 additions and 70 deletions
+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.47"
__version__ = "3.8.48"
class DummyContext:
def __enter__(self):
+97 -9
View File
@@ -495,6 +495,12 @@ class LiveContextService:
sample_un = [f"{c.subject.name if c.subject else c.code} ({c.code})" for c in unassigned_teacher[:3]]
lines.append(f" (Sin docente asignado: {', '.join(sample_un)})")
lines.append(f"- Comisión con más alumnos: {top_comm_str}")
if active_comms and len(active_comms) <= 25:
lines.append("COMISIONES ACTIVAS REGISTRADAS:")
for ac in active_comms:
s_name = ac.subject.name if ac.subject else ac.code
t_name = ac.teacher_name if (ac.teacher or ac.teachers) else "Sin docente asignado"
lines.append(f"• {s_name} [{ac.code} - {ac.shift or 'S/T'}]: Prof. {t_name} ({ac.current_students or 0} al.)")
# Reservas
total_res_today = (
@@ -562,7 +568,7 @@ class LiveContextService:
w for w in re.findall(r'[a-zA-Z0-9áéíóúñÁÉÍÓÚÑ]+', q_lower)
if len(w) >= 3 and w not in {
'donde', 'como', 'cuando', 'para', 'hola', 'buenas', 'cursar',
'materia', 'materias', 'clase', 'clases', 'aula', 'aulas', 'que', 'cual',
'clase', 'clases', 'aula', 'aulas', 'que', 'cual',
'esta', 'estan', 'unos', 'algunos', 'ellos', 'tiene'
}
]
@@ -591,14 +597,84 @@ class LiveContextService:
lines.append("• Métodos actualmente ACTIVOS: Ninguno habilitado.")
lines.append("• Gestión: El Administrador puede habilitar o deshabilitar estos métodos en Gobierno & Sistema ➔ Config. Global.")
# C. Búsqueda de Docentes / Profesores por Nombre (SOLO si la consulta trata sobre docentes)
teacher_keywords = ['profesor', 'profesores', 'docente', 'docentes', 'profe', 'profes', 'quien dicta', 'quien ensena']
# C1. Búsqueda y Listado de Comisiones / Cursadas
comm_keywords = [
'comision', 'comisiones', 'cursada', 'cursadas', 'comision c1',
'comisiones activas', 'cuales comisiones', 'que comisiones'
]
list_keywords = ['listado', 'lista', 'listar', 'todas', 'todos', 'dame', 'cuales']
asking_comm_list = (
any(ck in q_lower for ck in comm_keywords) or
(any(lk in q_lower for lk in list_keywords) and any(w in q_lower for w in ['comision', 'comisiones', 'cursada', 'cursadas']))
)
if asking_comm_list:
all_active_comms = (
Commission.query
.filter_by(active=True)
.join(Subject, Commission.subject_id == Subject.id)
.order_by(Subject.name.asc(), Commission.code.asc())
.all()
)
if all_active_comms:
lines.append(f"\nLISTADO COMPLETO DE COMISIONES ACTIVAS ({len(all_active_comms)} en total):")
for ac in all_active_comms:
s_name = ac.subject.name if ac.subject else "Materia"
s_code = ac.subject.code if ac.subject else ""
c_car = ac.career_names if hasattr(ac, 'career_names') else (ac.career_name or "UniCABA")
c_shift = f"Turno {ac.shift}" if ac.shift else "Turno a confirmar"
t_assigned = ac.teacher_names if hasattr(ac, 'teacher_names') else ac.teacher_name
lines.append(
f"• {s_name} (Código: {s_code} | Carrera: {c_car}) - Comisión {ac.code} ({c_shift}): "
f"Docente: {t_assigned} | Inscriptos: {ac.current_students or 0} alumnos"
)
else:
lines.append("\nCOMISIONES: No se registran comisiones activas actualmente en el sistema.")
# C2. Búsqueda de Docentes / Profesores y Asignaciones Áulicas
teacher_keywords = [
'profesor', 'profesores', 'docente', 'docentes', 'profe', 'profes', 'proferes',
'quien dicta', 'quien ensena', 'quien da', 'titular', 'adjunto', 'prof'
]
if any(w in q_lower for w in teacher_keywords):
all_docentes = User.query.filter(User.is_active == True, func.lower(User.role).like('%docent%')).all()
# Chequear si la consulta pide la nómina o profesores de las comisiones
asking_teacher_list = any(w in q_lower for w in [
'comision', 'comisiones', 'esas', 'estos', 'estas', 'cuales', 'quienes',
'lista', 'listado', 'todos', 'todas', 'nombre', 'nombres', 'asignados', 'que profesores', 'que docentes'
])
if asking_teacher_list:
active_comms_for_teachers = (
Commission.query
.filter_by(active=True)
.join(Subject, Commission.subject_id == Subject.id)
.order_by(Subject.name.asc())
.all()
)
teacher_assignments = {}
for c in active_comms_for_teachers:
t_disp = c.teacher_names if hasattr(c, 'teacher_names') and c.teacher_names != "Sin asignar" else c.teacher_name
s_name = c.subject.name if c.subject else c.code
if t_disp not in teacher_assignments:
teacher_assignments[t_disp] = []
teacher_assignments[t_disp].append(f"{s_name} (Com. {c.code})")
lines.append(f"\nASIGNACIÓN DE DOCENTES A COMISIONES ACTIVAS ({len(active_comms_for_teachers)} comisiones):")
for t_name, comm_list in teacher_assignments.items():
if len(comm_list) > 6:
lines.append(f"• {t_name}: Dicta {len(comm_list)} comisiones ({', '.join(comm_list[:4])} y {len(comm_list)-4} más).")
else:
lines.append(f"• {t_name}: Dicta {', '.join(comm_list)}")
# Búsqueda de docente por nombre específico
ignored_tokens = {
'profesor', 'profesores', 'docente', 'docentes', 'llamado', 'alguno', 'estan',
'registrados', 'cuantos', 'cual', 'quien', 'nombre', 'tipo', 'login', 'logins',
'google', 'moodle', 'sistema', 'acceso', 'cuentas', 'habilitados', 'activos'
'profesor', 'profesores', 'docente', 'docentes', 'profe', 'profes', 'proferes',
'llamado', 'alguno', 'estan', 'registrados', 'cuantos', 'cual', 'cuales', 'quien',
'quienes', 'nombre', 'nombres', 'tipo', 'login', 'logins', 'google', 'moodle',
'sistema', 'acceso', 'cuentas', 'habilitados', 'activos', 'comision', 'comisiones',
'esas', 'estos', 'estas', 'dame', 'dime', 'decime', 'lista', 'listado', 'todos',
'todas', 'ver', 'mostrar', 'hay', 'dictan', 'ensenan', 'materias', 'asignaturas'
}
meaningful_tokens = [tok for tok in tokens if tok not in ignored_tokens]
if meaningful_tokens:
@@ -613,12 +689,24 @@ class LiveContextService:
c_list = [c.code for c in fd.taught_commissions if c.active]
c_str = f"Comisiones: {', '.join(c_list)}" if c_list else "Sin comisiones activas"
lines.append(f"• {fd.name} ({fd.email}) | {c_str}")
elif any(len(mt) >= 4 for mt in meaningful_tokens):
elif not asking_teacher_list and any(len(mt) >= 4 for mt in meaningful_tokens):
searched_name = meaningful_tokens[0].capitalize()
lines.append(f"\nBÚSQUEDA DE DOCENTES: No se encontraron profesores registrados con el nombre '{searched_name}' entre los {len(all_docentes)} docentes activos.")
# D. Búsqueda de Asignaturas
if tokens:
# C3. Búsqueda y Listado de Asignaturas / Materias
subj_keywords = ['materia', 'materias', 'asignatura', 'asignaturas', 'catedra', 'catedras']
asking_subj_list = (
any(sk in q_lower for sk in subj_keywords) and
any(lk in q_lower for lk in ['que', 'cuales', 'lista', 'listado', 'todas', 'todos', 'hay', 'activas', 'dame', 'ver'])
)
if asking_subj_list:
all_subjects = Subject.query.filter(Subject.is_active == True).order_by(Subject.name.asc()).all()
if all_subjects:
lines.append(f"\nLISTADO DE ASIGNATURAS ACTIVAS DEL SISTEMA ({len(all_subjects)} en total):")
for s in all_subjects:
c_names = s.career_obj.name if s.career_obj else "Carrera General"
lines.append(f"• {s.name} (Código: {s.code} | Carrera: {c_names})")
elif tokens and not asking_comm_list and not any(w in q_lower for w in teacher_keywords):
search_filter = or_(
*[Subject.name.ilike(f"%{tok}%") for tok in tokens],
*[Subject.code.ilike(f"%{tok}%") for tok in tokens]
+54 -16
View File
@@ -1,3 +1,4 @@
import re
import hmac
import hashlib
import json
@@ -62,8 +63,9 @@ class QRSecurityService:
"""
Decodifica y valida el token escaneado. Soporta:
1. Token JWT firmado institucional.
2. Formato prefijado 'UNICABA:QR:<token>'.
3. Formato fallback por DNI 'DNI:<documento>' o número de documento directo.
2. Formato prefijado 'UNICABA:QR:<token>' (o con 'Ñ' por pistola en teclado español).
3. Formato institucional por ID o DNI 'UNICABA:USR:<id>:DNI:<doc>' (o 'UNICABAÑUSRÑ<id>ÑDNIÑ<doc>').
4. Formato fallback por DNI 'DNI:<documento>' o número de documento directo.
Retorna: (User or None, status: 'AUTORIZADO' | 'DENEGADO' | 'RESTRINGIDO', reason: str)
"""
@@ -72,15 +74,44 @@ class QRSecurityService:
clean = raw_input.strip()
# Si viene con prefijo UNICABA:QR:
if clean.startswith("UNICABA:QR:"):
clean = clean[len("UNICABA:QR:"):].strip()
# Normalizar pistola óptica en teclado en español:
# Los lectores ópticos emulan teclado US, por lo que envían 'Ñ' en lugar de ':' en sistemas operativos con distribución en español.
clean_normalized = clean.replace("Ñ", ":").replace("ñ", ":")
# 1. Intentar validar como JWT institucional
if clean.count(".") == 2:
# Si viene con prefijo UNICABA:QR:
if clean_normalized.startswith("UNICABA:QR:"):
clean_normalized = clean_normalized[len("UNICABA:QR:"):].strip()
# A. Intentar extraer patrón institucional UNICABA:USR:<id>
usr_match = re.search(r"USR:(\d+)", clean_normalized)
if usr_match:
try:
u_id = int(usr_match.group(1))
if u_id > 0:
user_by_id = User.query.get(u_id)
if user_by_id:
if not user_by_id.is_active:
return user_by_id, "RESTRINGIDO", "Usuario inactivo o suspendido en el sistema institucional."
return user_by_id, "AUTORIZADO", f"Credencial institucional validada por ID #{user_by_id.id}."
except Exception:
pass
# B. Intentar extraer patrón institucional DNI:<doc>
dni_match = re.search(r"DNI:([a-zA-Z0-9]+)", clean_normalized)
if dni_match:
doc = dni_match.group(1).strip()
if doc and doc.upper() != "N/A":
user_by_dni = User.query.filter_by(document_number=doc).first()
if user_by_dni:
if not user_by_dni.is_active:
return user_by_dni, "RESTRINGIDO", "Usuario inactivo en el sistema institucional."
return user_by_dni, "AUTORIZADO", f"Identificación validada por documento de identidad (DNI {doc})."
# C. Intentar validar como JWT institucional
if clean_normalized.count(".") == 2:
try:
payload = jwt.decode(
clean,
clean_normalized,
cls._get_secret(),
algorithms=["HS256"],
options={"verify_exp": True}
@@ -102,18 +133,25 @@ class QRSecurityService:
except jwt.PyJWTError as e:
return None, "DENEGADO", f"Firma criptográfica inválida: {str(e)}"
# 2. Fallback: Lectura de pistola óptica o documento directo (ej: 'DNI:12345678' o '12345678')
doc_num = clean
# D. Fallback: Lectura de pistola óptica o documento directo (ej: 'DNI:12345678' o '12345678')
doc_num = clean_normalized
if doc_num.upper().startswith("DNI:"):
doc_num = doc_num[4:].strip()
user = User.query.filter_by(document_number=doc_num).first()
if user:
if not user.is_active:
return user, "RESTRINGIDO", "Usuario inactivo en el sistema institucional."
return user, "AUTORIZADO", "Identificación validada por documento de identidad."
# Quitar cualquier carácter residual no alfanumérico si es número de DNI
clean_doc = re.sub(r'[^a-zA-Z0-9]', '', doc_num)
if clean_doc:
user = User.query.filter_by(document_number=clean_doc).first()
if not user and clean_doc.isdigit():
# Si no coincide con documento, verificar si coincide con ID institucional directo
user = User.query.get(int(clean_doc))
return None, "DENEGADO", f"No se encontró ningún estudiante o docente con DNI {doc_num}."
if user:
if not user.is_active:
return user, "RESTRINGIDO", "Usuario inactivo en el sistema institucional."
return user, "AUTORIZADO", f"Identificación validada por documento de identidad ({user.document_number or user.id})."
return None, "DENEGADO", f"No se encontró ningún estudiante o docente con DNI o credencial '{raw_input.strip()}'."
@classmethod
def get_todays_classes_for_user(cls, user: User, target_date: Optional[date] = None) -> List[TodayClassDTO]:
+6 -3
View File
@@ -113,14 +113,17 @@ def generate_system_prompt_for_role(
"REGLAS ESTRICTAS DE RESPUESTA Y CERO ALUCINACIONES:\n"
"1. PERSONALIZACIÓN Y TRATO: Menciona el nombre del usuario ({user_name if user_name else 'Usuario'}) en tu saludo o respuesta. "
"Adapta el contenido a su rol exacto; no menciones acciones reservadas para otros perfiles.\n"
"2. PROHIBIDO DATOS MOCK O FICTICIOS: Está TERMINANTEMENTE PROHIBIDO inventar nombres de asignaturas, códigos inventados (como 'ID: 1898', 'Introducción a la Programación', 'Matemática Discreta') o notas simuladas. Si te preguntan por materias o calificaciones, responde ÚNICA Y EXCLUSIVAMENTE con la información provista en la sección 'ESTADO EN VIVO DEL SISTEMA'. Si no tiene materias o notas registradas, di textualmente que no figuran en el sistema.\n"
"2. VERACIDAD FÁCTICA Y DATOS EN VIVO: Toda la información provista en 'ESTADO EN VIVO DEL SISTEMA' proviene directamente de la base de datos PostgreSQL institucional en tiempo real. Son datos 100% REALES, VIGENTES Y FACTUALES (NO son datos mock, ni simulados, ni inventados). NUNCA inventes nombres de asignaturas, códigos inexistentes ni calificaciones ficticias. Si el usuario duda o afirma que una materia o comisión 'no existe' o que 'deben ser datos mock', NO te disculpes ni digas que inventaste datos: aclárale con cordialidad y seguridad que son registros reales activos del sistema y reconfirma sus datos exactos (código, asignatura, turno y docente asignado).\n"
"3. NAVEGACIÓN Y ELEMENTOS REALES: NUNCA menciones URLs técnicas con barra '/' (como /buildings o /admin/...). "
"Indica SIEMPRE los nombres EXACTOS de los menús y botones según la estructura de la aplicación:\n"
f"{menu_hierarchy}\n"
"4. HIPERVÍNCULOS Y MAPAS: Cuando proporciones un enlace a Google Maps o servicio externo, utilízalo SIEMPRE en formato Markdown con texto descriptivo, por ejemplo: [Calcular ruta a UniCABA](URL). NUNCA dejes URLs crudas sueltas en texto plano.\n"
"5. PRIVACIDAD ESTRICTA: Los alumnos NUNCA deben ser remitidos al 'Gradebook' ni a la 'Sábana de Calificaciones', ya que ese panel contiene datos de todos los compañeros. Para consultar notas, un alumno debe dirigirse a 'Mis Calificaciones e Hitos' en 'Mi Trayectoria'.\n"
"6. BREVEDAD Y PRECISIÓN: Responde en máximo 2 a 3 oraciones concisas o pasos directos sin rodeos ni introducciones vacías.\n"
"7. DATOS REALES EN VIVO, CALIFICACIONES E HITOS: Utiliza la sección 'ESTADO EN VIVO DEL SISTEMA' para responder con total fidelidad:\n"
"6. LISTADOS DIRECTOS Y COMPLETOS: Cuando el usuario solicite un listado o nómina (de comisiones, asignaturas, docentes, aulas o reservas) y la información esté disponible en 'ESTADO EN VIVO DEL SISTEMA', PROPORCIONA EL LISTADO COMPLETO Y ESTRUCTURADO directamente en tu respuesta (usando viñetas limpias con asignatura, comisión, turno y profesor asignado). ESTÁ TERMINANTEMENTE PROHIBIDO evadir la respuesta diciendo 'para ver el listado ve al menú'. Entrega los datos solicitados de inmediato en la conversación. Solo sugiere la ruta de menú como complemento si el usuario desea editar o realizar gestiones operativas. Para consultas conceptuales o preguntas breves, responde de forma concisa (2 a 3 oraciones).\n"
"7. DATOS REALES EN VIVO, CALIFICACIONES, DOCENTES Y COMISIONES: Utiliza la sección 'ESTADO EN VIVO DEL SISTEMA' para responder con total fidelidad:\n"
" - Si el usuario usa expresiones coloquiales o saludos breves (como 'tu dime ?', 'que paso', 'hola', 'que hay de nuevo'), salúdalo por su nombre institucional ({user_name if user_name else 'Usuario'}), comenta un resumen ejecutivo del estado del sistema y ofrece ayuda en sus tareas habituales.\n"
" - Si preguntan 'qué comisiones hay', 'dame un listado' o 'lista todas', presenta la lista completa de comisiones activas con su asignatura, turno y docente asignado.\n"
" - Si preguntan por los profesores de las comisiones, quiénes son los docentes o qué docentes dictan cada comisión, responde citando los nombres de los docentes y sus materias/comisiones asignadas según 'ESTADO EN VIVO DEL SISTEMA'.\n"
" - Si preguntan a qué información tienes acceso o qué puedes responder, aclara con amabilidad que tienes acceso a:\n"
" * Datos académicos y de cursada del usuario según su rol (materias, comisiones, notas, regularidad y próximas clases presenciales).\n"
" * Estado de ocupación de sedes y aulas (presenciales y virtuales) y cartelera del día.\n"
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup(
name="edu-space-admin",
version="3.8.47",
version="3.8.48",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team",
author_email="admin@edu-space.com",
@@ -95,6 +95,21 @@ def test_qr_security_service_generate_and_decode(init_database):
assert status_d == "AUTORIZADO"
assert resolved_dni.id == student.id
# Fallback por formato institucional UNICABA:USR:<id>:DNI:<doc>
res_fallback, status_fb, _ = QRSecurityService.decode_and_resolve_user(f"UNICABA:USR:{student.id}:DNI:{student.document_number}")
assert status_fb == "AUTORIZADO"
assert res_fallback.id == student.id
# Pistola óptica en teclado en español (sustituye : por Ñ)
res_gun, status_gun, _ = QRSecurityService.decode_and_resolve_user(f"UNICABAÑUSRÑ{student.id}ÑDNIÑ{student.document_number}")
assert status_gun == "AUTORIZADO"
assert res_gun.id == student.id
# Pistola óptica con DNI vacío
res_gun_nodni, status_gn, _ = QRSecurityService.decode_and_resolve_user(f"UNICABAÑUSRÑ{student.id}ÑDNIÑ")
assert status_gn == "AUTORIZADO"
assert res_gun_nodni.id == student.id
# Token corrupto o inválido
res_fake, status_f, reason_f = QRSecurityService.decode_and_resolve_user("token_invalido_corrupto")
assert status_f == "DENEGADO"
@@ -0,0 +1,115 @@
import pytest
from app import create_app, db
from app.models.user import User
from app.models.career import Career
from app.models.subject import Subject, Commission
from app.services.live_context_service import LiveContextService
@pytest.fixture
def app_with_commissions():
app = create_app('testing')
with app.app_context():
db.create_all()
# Seed sample career, subject, teacher, commission
admin_user = User(
name="Admin Test",
email="admin@unicaba.edu.ar",
password_hash="hashed_pw_test",
role="ADMIN",
is_active=True
)
docente_user = User(
name="Profesor Carlos Sanchez",
email="csanchez@unicaba.edu.ar",
password_hash="hashed_pw_test",
role="DOCENTE",
is_active=True
)
db.session.add_all([admin_user, docente_user])
db.session.commit()
career = Career(name="Tecnologías Digitales", code="TEC. DIG. (CCC)")
db.session.add(career)
db.session.commit()
subject1 = Subject(
code="ASIG00120",
name="Gestión de sistemas de información",
career_id=career.id,
is_active=True
)
subject2 = Subject(
code="ASIG00121",
name="Análisis de Datos I",
career_id=career.id,
is_active=True
)
db.session.add_all([subject1, subject2])
db.session.commit()
comm1 = Commission(
code="C1",
subject_id=subject1.id,
teacher_id=docente_user.id,
semester="2",
year=2026,
shift="Tarde",
max_students=30,
current_students=5,
active=True
)
comm2 = Commission(
code="C1",
subject_id=subject2.id,
teacher_id=admin_user.id,
semester="2",
year=2026,
shift="Tarde",
max_students=30,
current_students=0,
active=True
)
db.session.add_all([comm1, comm2])
db.session.commit()
yield app
db.session.remove()
db.drop_all()
def test_live_context_commission_listing(app_with_commissions):
with app_with_commissions.app_context():
# 1. Consulta explícita por listado de comisiones
snapshot = LiveContextService.get_system_snapshot(
role="admin",
user_name="Administrador",
query="dame un listado de comisiones"
)
assert "LISTADO COMPLETO DE COMISIONES ACTIVAS" in snapshot
assert "Gestión de sistemas de información" in snapshot
assert "ASIG00120" in snapshot
assert "Profesor Carlos Sanchez" in snapshot
assert "Análisis de Datos I" in snapshot
# 2. Consulta de docentes de las comisiones
teacher_snapshot = LiveContextService.get_system_snapshot(
role="admin",
user_name="Administrador",
query="dime el nombre de los proferes de esas comisiones"
)
assert "ASIGNACIÓN DE DOCENTES A COMISIONES ACTIVAS" in teacher_snapshot
assert "Profesor Carlos Sanchez" in teacher_snapshot
assert "Gestión de sistemas de información" in teacher_snapshot
# 3. Consulta de materias/asignaturas
subj_snapshot = LiveContextService.get_system_snapshot(
role="admin",
user_name="Administrador",
query="que materias hay en el sistema"
)
assert "LISTADO DE ASIGNATURAS ACTIVAS DEL SISTEMA" in subj_snapshot
assert "Gestión de sistemas de información" in subj_snapshot
assert "Análisis de Datos I" in subj_snapshot