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)