from datetime import datetime from typing import Optional, List from pydantic import BaseModel, Field, ConfigDict class TodayClassDTO(BaseModel): subject_name: str = Field(..., description="Nombre de la asignatura") commission_name: str = Field(..., description="Nombre o código de la comisión") classroom_name: str = Field(..., description="Aula asignada (física o virtual)") building_name: str = Field(..., description="Sede o edificio") floor: Optional[int] = Field(None, description="Piso del aula") start_time: str = Field(..., description="Hora de inicio (HH:MM)") end_time: str = Field(..., description="Hora de finalización (HH:MM)") teacher_name: Optional[str] = Field(None, description="Docente a cargo de la clase") class QRVerificationRequestDTO(BaseModel): qr_token: str = Field(..., min_length=4, description="Token seguro o contenido del código QR") building_id: Optional[int] = Field(None, ge=1, description="ID de sede donde se ubica el punto de acceso") notes: Optional[str] = Field(None, max_length=200, description="Observaciones opcionales del operador de recepción") class QRVerificationResponseDTO(BaseModel): status: str = Field("AUTORIZADO", description="Resultado: AUTORIZADO, DENEGADO o RESTRINGIDO") message: str = Field(..., description="Mensaje explicativo del resultado del escaneo") user_id: Optional[int] = None user_name: Optional[str] = None user_dni: Optional[str] = None user_role: Optional[str] = None matricula_status: Optional[str] = None photo_url: Optional[str] = None todays_classes: List[TodayClassDTO] = Field(default_factory=list, description="Clases presenciales o virtuales asignadas para hoy") scanned_at: str = Field(..., description="Timestamp de registro del escaneo") scanned_time: Optional[str] = Field(None, description="Hora formateada en zona horaria local de Buenos Aires (HH:MM hs)") class AccessLogResponseDTO(BaseModel): id: int user_name: str user_dni: Optional[str] = None user_role: Optional[str] = None building_name: str scanned_by_name: str scanned_at: str scanned_time: Optional[str] = None status: str reason: Optional[str] = None model_config = ConfigDict(from_attributes=True) class AccessLogListResponseDTO(BaseModel): total: int items: List[AccessLogResponseDTO]