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.models.setting import SystemSetting 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). Soporta rotación dinámica periódica (default 3s) configurada en SystemSetting. """ renewal_seconds = int(SystemSetting.get_value('qr_renewal_interval_seconds', 3) or 3) grace_seconds = int(SystemSetting.get_value('qr_token_grace_period_seconds', 60) or 60) token = QRSecurityService.generate_qr_token(current_user, valid_seconds=grace_seconds) 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, "renewal_interval_seconds": renewal_seconds, "grace_period_seconds": grace_seconds }