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,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)
|
||||
@@ -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]
|
||||
Reference in New Issue
Block a user