feat(benefits-reception): add institutional benefits, QR digital card & reception access control (SDD-012 v3.8.39)

This commit is contained in:
2026-10-27 23:34:57 -03:00
parent e45eb972dd
commit e5e6bfa094
30 changed files with 2994 additions and 11 deletions
+56
View File
@@ -0,0 +1,56 @@
from datetime import date, datetime
from typing import Optional, List
from pydantic import BaseModel, Field, ConfigDict
class BenefitBaseDTO(BaseModel):
title: str = Field(..., min_length=3, max_length=150, description="Título del beneficio o promoción")
partner_name: str = Field(..., min_length=2, max_length=120, description="Comercio o entidad adherida")
category: str = Field("GENERAL", max_length=50, description="Categoría: GASTRONOMIA, LIBRERIA, TECNOLOGIA, SALUD_DEPORTE, IDIOMAS, etc.")
discount_label: str = Field(..., min_length=2, max_length=80, description="Etiqueta visible del descuento (ej: '20% OFF', '2x1')")
description: Optional[str] = Field(None, description="Detalle del convenio y cómo aprovecharlo")
terms_conditions: Optional[str] = Field(None, description="Términos, condiciones y restricciones")
target_roles: str = Field("ALL", max_length=100, description="Roles habilitados: ALL, ALUMNO, DOCENTE, BEDELIA")
building_id: Optional[int] = Field(None, ge=1, description="ID de sede aplicable, o null para todas")
coupon_code: Optional[str] = Field(None, max_length=50, description="Código de cupón o promoción alfanumérico")
valid_from: date = Field(default_factory=date.today, description="Fecha de inicio de vigencia")
valid_until: Optional[date] = Field(None, description="Fecha de vencimiento (null si es indefinido)")
is_active: bool = Field(True, description="Estado de publicación activo/inactivo")
image_url: Optional[str] = Field(None, max_length=255, description="URL de logotipo o imagen del comercio")
class BenefitCreateDTO(BenefitBaseDTO):
pass
class BenefitUpdateDTO(BaseModel):
title: Optional[str] = Field(None, min_length=3, max_length=150)
partner_name: Optional[str] = Field(None, min_length=2, max_length=120)
category: Optional[str] = Field(None, max_length=50)
discount_label: Optional[str] = Field(None, min_length=2, max_length=80)
description: Optional[str] = None
terms_conditions: Optional[str] = None
target_roles: Optional[str] = Field(None, max_length=100)
building_id: Optional[int] = Field(None, ge=1)
coupon_code: Optional[str] = Field(None, max_length=50)
valid_from: Optional[date] = None
valid_until: Optional[date] = None
is_active: Optional[bool] = None
image_url: Optional[str] = Field(None, max_length=255)
class BenefitResponseDTO(BenefitBaseDTO):
id: int
building_name: Optional[str] = None
is_currently_valid: bool = True
created_by_user_id: Optional[int] = None
created_at: Optional[datetime] = None
updated_at: Optional[datetime] = None
model_config = ConfigDict(from_attributes=True)
class BenefitListResponseDTO(BaseModel):
total: int = Field(..., ge=0)
items: List[BenefitResponseDTO]
categories: List[str] = Field(default_factory=list)
+52
View File
@@ -0,0 +1,52 @@
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")
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
status: str
reason: Optional[str] = None
model_config = ConfigDict(from_attributes=True)
class AccessLogListResponseDTO(BaseModel):
total: int
items: List[AccessLogResponseDTO]