feat(benefits-reception): add institutional benefits, QR digital card & reception access control (SDD-012 v3.8.39)
This commit is contained in:
@@ -0,0 +1,159 @@
|
||||
from datetime import datetime, timezone
|
||||
from typing import Optional, List
|
||||
from fastapi import APIRouter, Depends, HTTPException, Query, status
|
||||
|
||||
from app import db
|
||||
from app.models.user import User
|
||||
from app.models.building import Building
|
||||
from app.models.access_log_qr import AccessLogQR
|
||||
from app.services.audit_service import AuditService
|
||||
from app.services.qr_security_service import QRSecurityService
|
||||
from dependencies import get_current_user, require_roles
|
||||
from schemas.reception_dto import (
|
||||
QRVerificationRequestDTO,
|
||||
QRVerificationResponseDTO,
|
||||
AccessLogResponseDTO,
|
||||
AccessLogListResponseDTO
|
||||
)
|
||||
|
||||
router = APIRouter(prefix="/api/v1/reception", tags=["Reception & Access Control"])
|
||||
|
||||
|
||||
@router.post("/verify-qr", response_model=QRVerificationResponseDTO)
|
||||
def verify_qr_and_register_access(
|
||||
payload: QRVerificationRequestDTO,
|
||||
current_user: User = Depends(require_roles(["ADMIN", "BEDELIA", "RECEPCION"]))
|
||||
):
|
||||
"""
|
||||
Verifica un código QR institucional en la mesa de entrada o torniquete de acceso.
|
||||
Registra el ingreso en AccessLogQR y retorna la identidad del alumno/docente
|
||||
junto con sus clases y aulas asignadas para el día de hoy.
|
||||
"""
|
||||
now_utc = datetime.now(timezone.utc).replace(tzinfo=None)
|
||||
user, auth_status, reason = QRSecurityService.decode_and_resolve_user(payload.qr_token)
|
||||
|
||||
# Si se identificó un usuario
|
||||
if user:
|
||||
classes = QRSecurityService.get_todays_classes_for_user(user)
|
||||
|
||||
# Registro en la base de accesos
|
||||
access_log = AccessLogQR(
|
||||
user_id=user.id,
|
||||
building_id=payload.building_id,
|
||||
scanned_by_user_id=current_user.id,
|
||||
scanned_at=now_utc,
|
||||
status=auth_status,
|
||||
reason=payload.notes or reason
|
||||
)
|
||||
db.session.add(access_log)
|
||||
db.session.commit()
|
||||
|
||||
AuditService.log(
|
||||
user_id=current_user.id,
|
||||
action="QR_ACCESS_SCAN",
|
||||
module="reception",
|
||||
entity_id=access_log.id,
|
||||
details={
|
||||
"target_user_id": user.id,
|
||||
"status": auth_status,
|
||||
"building_id": payload.building_id,
|
||||
"classes_today_count": len(classes)
|
||||
}
|
||||
)
|
||||
|
||||
message = (
|
||||
f"Acceso autorizado para {user.name}."
|
||||
if auth_status == "AUTORIZADO"
|
||||
else f"Acceso observado: {reason}"
|
||||
)
|
||||
|
||||
return QRVerificationResponseDTO(
|
||||
status=auth_status,
|
||||
message=message,
|
||||
user_id=user.id,
|
||||
user_name=user.name,
|
||||
user_dni=user.document_number,
|
||||
user_role=(user.role or "ALUMNO").upper(),
|
||||
matricula_status="REGULAR / ACTIVO" if user.is_active else "SUSPENDIDO / INACTIVO",
|
||||
photo_url=None,
|
||||
todays_classes=classes,
|
||||
scanned_at=now_utc.isoformat()
|
||||
)
|
||||
|
||||
# Si el código QR es inválido o el usuario no existe
|
||||
AuditService.log(
|
||||
user_id=current_user.id,
|
||||
action="QR_ACCESS_FAILED",
|
||||
module="reception",
|
||||
entity_id=None,
|
||||
details={"reason": reason, "raw_snippet": payload.qr_token[:15]}
|
||||
)
|
||||
|
||||
return QRVerificationResponseDTO(
|
||||
status="DENEGADO",
|
||||
message=reason,
|
||||
user_id=None,
|
||||
user_name=None,
|
||||
user_dni=None,
|
||||
user_role=None,
|
||||
matricula_status="NO REGISTRADO",
|
||||
photo_url=None,
|
||||
todays_classes=[],
|
||||
scanned_at=now_utc.isoformat()
|
||||
)
|
||||
|
||||
|
||||
@router.get("/recent-logs", response_model=AccessLogListResponseDTO)
|
||||
def get_recent_access_logs(
|
||||
building_id: Optional[int] = Query(None, description="Filtrar por sede específica"),
|
||||
limit: int = Query(50, ge=1, le=200, description="Cantidad máxima de registros a recuperar"),
|
||||
current_user: User = Depends(require_roles(["ADMIN", "BEDELIA", "RECEPCION"]))
|
||||
):
|
||||
"""
|
||||
Retorna los últimos ingresos registrados en el punto de acceso.
|
||||
Permite monitoreo en tiempo real para el personal de Recepción y Seguridad.
|
||||
"""
|
||||
query = AccessLogQR.query
|
||||
if building_id:
|
||||
query = query.filter_by(building_id=building_id)
|
||||
|
||||
logs: List[AccessLogQR] = query.order_by(AccessLogQR.scanned_at.desc()).limit(limit).all()
|
||||
|
||||
items = []
|
||||
for l in logs:
|
||||
items.append(AccessLogResponseDTO(
|
||||
id=l.id,
|
||||
user_name=l.user.name if l.user else "Usuario no disponible",
|
||||
user_dni=l.user.document_number if l.user else None,
|
||||
user_role=l.user.role if l.user else None,
|
||||
building_name=l.building.name if l.building else "Sede no especificada",
|
||||
scanned_by_name=l.scanned_by.name if l.scanned_by else "Recepción",
|
||||
scanned_at=l.scanned_at.isoformat(),
|
||||
status=l.status,
|
||||
reason=l.reason
|
||||
))
|
||||
|
||||
return AccessLogListResponseDTO(
|
||||
total=len(items),
|
||||
items=items
|
||||
)
|
||||
|
||||
|
||||
@router.get("/my-qr-token")
|
||||
def get_my_credential_qr_token(
|
||||
current_user: User = Depends(get_current_user)
|
||||
):
|
||||
"""
|
||||
Genera y entrega el token criptográfico del código QR para la credencial digital
|
||||
del usuario autenticado (estudiante o docente).
|
||||
"""
|
||||
token = QRSecurityService.generate_qr_token(current_user)
|
||||
return {
|
||||
"status": "success",
|
||||
"qr_token": token,
|
||||
"user_id": current_user.id,
|
||||
"user_name": current_user.name,
|
||||
"user_dni": current_user.document_number,
|
||||
"user_role": (current_user.role or "ALUMNO").upper(),
|
||||
"expires_in_hours": QRSecurityService.DEFAULT_VALID_HOURS
|
||||
}
|
||||
Reference in New Issue
Block a user