feat: complete Phases 2 to 5 inclusive - Access Core, Web Cockpit, Hardware enqueuing, Optical Scanner and QA (v0.5.0-beta)

This commit is contained in:
Carlos Tello
2026-10-13 15:47:43 -03:00
parent 78c1a306de
commit 1ba74f7929
53 changed files with 4000 additions and 279 deletions
+1
View File
@@ -0,0 +1 @@
# Schemas module
+81
View File
@@ -0,0 +1,81 @@
# ==============================================================================
# Esquemas Pydantic v2 para Control de Accesos (Ingreso y Salida)
# ==============================================================================
from typing import List, Optional
from datetime import datetime
from pydantic import BaseModel, Field
class CompanionDTO(BaseModel):
documento: str = Field(..., description="DNI del acompañante")
apellido: Optional[str] = None
nombre: Optional[str] = None
sexo: Optional[str] = "M"
es_menor: bool = False
rol_id: int = 2 # 2: Acompañante adulto, 3: Menor
class EntryRequest(BaseModel):
modulo_ingreso_id: int = Field(..., description="ID del módulo / barrera de entrada")
documento: str = Field(..., min_length=4, description="DNI del conductor o visitante principal")
apellido: Optional[str] = ""
nombre: Optional[str] = ""
sexo: Optional[str] = "M"
patente: Optional[str] = Field(None, description="Patente del vehículo (o None si es peatonal)")
lote_id: Optional[int] = Field(None, description="Lote de destino")
lote_codigo: Optional[str] = Field(None, description="Código de lote (ej: 142)")
motivo: Optional[str] = "VISITA"
entidad: Optional[str] = None
cantidad_ocupantes: int = Field(1, ge=1)
cantidad_menores: int = Field(0, ge=0)
cacheo_salida: bool = False
abrir_barrera: bool = True
foto_evidencia_b64: Optional[str] = None
integrantes: List[CompanionDTO] = Field(default_factory=list)
class ExitRequest(BaseModel):
ticket_id: int = Field(..., description="ID del ticket activo a cerrar")
modulo_salida_id: int = Field(..., description="ID del módulo / barrera de salida")
persona_id: Optional[int] = 0
rol_salida: Optional[int] = 1
entidad_salida: Optional[str] = None
patente_salida: Optional[str] = None
abrir_barrera: bool = True
personas_ids_permanecen: List[int] = Field(default_factory=list)
class TicketResponse(BaseModel):
status: str = "ok"
ticket_id: int
message: str
barrier_opened: bool = False
fecha_hora: str
class ActiveTicketDTO(BaseModel):
ticket_id: int
persona_id: int
documento: str
apellido: str
nombre: str
patente: Optional[str] = None
lote_codigo: Optional[str] = None
modulo_ingreso: str
fecha_ingreso: str
ocupantes: int = 1
class PersonSearchDTO(BaseModel):
persona_id: int
documento: str
apellido: str
nombre: str
sexo: Optional[str] = "M"
observaciones: Optional[str] = None
class LotSearchDTO(BaseModel):
lote_id: int
codigo: str
propietario: Optional[str] = None
+25
View File
@@ -0,0 +1,25 @@
# ==============================================================================
# Esquemas Pydantic v2 para Autenticación y Sesión
# ==============================================================================
from typing import Optional
from pydantic import BaseModel, Field
class LoginRequest(BaseModel):
username: str = Field(..., min_length=1, description="Nombre de usuario del operador")
password: str = Field(..., min_length=1, description="Contraseña de acceso")
workstation_name: Optional[str] = Field(None, description="Identificador de la estación de trabajo/tablet")
class UserSessionDTO(BaseModel):
user_id: int
username: str
role: str = "OPERADOR"
system_parameter: Optional[int] = None
class LoginResponse(BaseModel):
status: str = "ok"
message: str = "Autenticación exitosa"
user: UserSessionDTO
workstation: Optional[str] = None
+20
View File
@@ -0,0 +1,20 @@
# ==============================================================================
# Esquemas Pydantic v2 para Hardware y Telemetría
# ==============================================================================
from typing import Optional
from pydantic import BaseModel, Field
class ManualOpenRequest(BaseModel):
modulo_id: int = Field(..., description="ID del módulo a abrir")
motivo: str = Field("APERTURA_MANUAL_GUARDIA", description="Justificación de auditoría")
ticket_id: Optional[int] = Field(0, description="Ticket asociado si aplica")
class HardwareCommandResponse(BaseModel):
status: str = "ok"
modulo_id: int
address: int
payload: str
message: str
latencia_ms: float
+21
View File
@@ -0,0 +1,21 @@
# ==============================================================================
# Esquemas Pydantic v2 para Estaciones de Trabajo y Carriles
# ==============================================================================
from typing import List, Optional
from pydantic import BaseModel, Field
class LaneModuleDTO(BaseModel):
modulo_id: int
nombre: str
address: int
grupo_modulos: Optional[int] = None
es_entrada: bool = True
duracion_pulso: Optional[int] = None
class WorkstationStatusResponse(BaseModel):
workstation_name: str
is_control_post: bool
workstation_id: Optional[int] = None
modules: List[LaneModuleDTO] = Field(default_factory=list)