feat(puesto-control): paridad completa de busqueda/seleccion de lote, validaciones estrictas y control de cacheo de garita

This commit is contained in:
Carlos Tello
2026-10-14 09:09:39 -03:00
parent 1f2b029e39
commit ffa8a2a684
10 changed files with 1030 additions and 100 deletions
+10
View File
@@ -11,6 +11,7 @@ from app.schemas.access_schema import (
ActiveTicketDTO,
PersonSearchDTO,
LotSearchDTO,
LotResidentDTO,
LotPermissionDTO,
TicketOccupantDTO,
PersonPoliciesDTO,
@@ -122,6 +123,15 @@ def validar_permiso_lote(
return AccessService.obtener_permiso_lote(lote_id, persona_id)
@router.get("/lots/{lote_id}/residents", response_model=List[LotResidentDTO], summary="Listar padrón de residentes de un lote")
def listar_residentes_lote(
lote_id: int,
current_user: dict = Depends(obtener_usuario_actual),
):
"""Retorna el padrón de residentes y teléfonos asignados al lote (LotPer JOIN Per)."""
return AccessService.obtener_residentes_lote(lote_id)
@router.get("/tickets/{ticket_id}/occupants", response_model=List[TicketOccupantDTO], summary="Listar ocupantes de un ticket")
def listar_ocupantes_ticket(
ticket_id: int,
+129 -9
View File
@@ -435,7 +435,8 @@ class AccessRepository:
COALESCE(p.Nombre, '') AS Nombre,
COALESCE(d.Documento, '') AS Documento,
pat.Valor AS Patente,
lot.Valor AS LoteCodigo
lot.Valor AS LoteCodigo,
COALESCE(cch.Valor, '0') AS CacheoSalida
FROM tck t
LEFT JOIN mdl m ON t.ModuloIngresoID = m.ModuloID
LEFT JOIN tckper tp ON t.TicketID = tp.TicketID
@@ -443,6 +444,7 @@ class AccessRepository:
LEFT JOIN PerDocCatVal d ON p.PersonaID = d.PersonaID
LEFT JOIN tckprx pat ON t.TicketID = pat.TicketID AND pat.PropiedadID = 4
LEFT JOIN tckprx lot ON t.TicketID = lot.TicketID AND lot.PropiedadID = 7
LEFT JOIN tckprx cch ON t.TicketID = cch.TicketID AND cch.PropiedadID = 6
ORDER BY t.FechaHoraIngreso DESC
"""
with db_session() as conn:
@@ -503,18 +505,136 @@ class AccessRepository:
return cursor.fetchall()
@staticmethod
def buscar_lotes_predictivo(term: str) -> List[Dict[str, Any]]:
"""Búsqueda predictiva de lotes por código."""
patron = f"%{term.strip()}%"
def buscar_lote_por_codigo(codigo: str) -> Optional[Dict[str, Any]]:
"""Busca un lote por coincidencia exacta o normalizada de código/número o LoteID."""
query = """
SELECT TOP 15 l.LoteID, l.Lote AS Codigo
FROM lot l
WHERE l.Lote LIKE %s
ORDER BY l.Lote
SELECT TOP 1 l.LoteID, l.Lote AS Codigo
FROM lot l
WHERE UPPER(LTRIM(RTRIM(l.Lote))) = UPPER(%s)
OR (ISNUMERIC(%s) = 1 AND l.LoteID = CAST(%s AS INT))
"""
with db_session() as conn:
cursor = conn.cursor(as_dict=True)
cursor.execute(query, (patron,))
cod_clean = codigo.strip()
cursor.execute(query, (cod_clean, cod_clean, cod_clean))
return cursor.fetchone()
@staticmethod
def buscar_lotes_predictivo(term: str) -> List[Dict[str, Any]]:
"""
Búsqueda completa de lotes por número, UF, calle o residentes asociados.
Padrón enriquecido y ponderado idéntico a DialogoBuscarLote (pct_dialogs.py).
"""
f_clean = term.strip() if term else ""
if not f_clean:
query = """
SELECT TOP 50
l.LoteID,
l.Lote AS Codigo,
l.UF,
l.Calle,
l.Numero,
COALESCE(
(SELECT TOP 1 cv.Nombre FROM LotCatVal lcv JOIN CatVal cv ON lcv.ValorID = cv.ValorID AND cv.CategoriaID = 26 WHERE lcv.LoteID = l.LoteID),
'Habilitado'
) AS Estado,
(
SELECT TOP 1 CONCAT(p.Apellido, ', ', p.Nombre)
FROM LotPer lp
JOIN Per p ON lp.PersonaID = p.PersonaID
WHERE lp.LoteID = l.LoteID
ORDER BY lp.PerfilID
) AS Propietario
FROM lot l
ORDER BY
CASE WHEN ISNUMERIC(l.Lote) = 1 THEN 1 ELSE 2 END,
CASE WHEN ISNUMERIC(l.Lote) = 1 THEN CAST(l.Lote AS INT) ELSE 0 END,
l.Lote
"""
params = ()
else:
f_exact = f_clean
f_start = f"{f_clean}%"
f_contains = f"%{f_clean}%"
query = """
SELECT TOP 50
l.LoteID,
l.Lote AS Codigo,
l.UF,
l.Calle,
l.Numero,
COALESCE(
(SELECT TOP 1 cv.Nombre FROM LotCatVal lcv JOIN CatVal cv ON lcv.ValorID = cv.ValorID AND cv.CategoriaID = 26 WHERE lcv.LoteID = l.LoteID),
'Habilitado'
) AS Estado,
(
SELECT TOP 1 CONCAT(p.Apellido, ', ', p.Nombre)
FROM LotPer lp
JOIN Per p ON lp.PersonaID = p.PersonaID
WHERE lp.LoteID = l.LoteID
ORDER BY lp.PerfilID
) AS Propietario
FROM lot l
WHERE l.Lote LIKE %s OR l.Calle LIKE %s OR l.UF LIKE %s
OR EXISTS (
SELECT 1 FROM LotPer lp
JOIN Per p ON lp.PersonaID = p.PersonaID
WHERE lp.LoteID = l.LoteID
AND (p.Nombre LIKE %s OR p.Apellido LIKE %s)
)
ORDER BY
CASE
WHEN UPPER(LTRIM(RTRIM(l.Lote))) = UPPER(%s) THEN 1
WHEN UPPER(LTRIM(RTRIM(l.UF))) = UPPER(%s) THEN 2
WHEN UPPER(l.Lote) LIKE UPPER(%s) THEN 3
WHEN UPPER(l.UF) LIKE UPPER(%s) THEN 4
WHEN UPPER(l.Lote) LIKE UPPER(%s) THEN 5
WHEN UPPER(l.Calle) LIKE UPPER(%s) THEN 6
ELSE 7
END,
CASE WHEN ISNUMERIC(l.Lote) = 1 THEN 1 ELSE 2 END,
CASE WHEN ISNUMERIC(l.Lote) = 1 THEN CAST(l.Lote AS INT) ELSE 0 END,
l.Lote
"""
params = (
f_contains, f_contains, f_contains, f_contains, f_contains,
f_exact, f_exact, f_start, f_start, f_contains, f_contains
)
with db_session() as conn:
cursor = conn.cursor(as_dict=True)
cursor.execute(query, params)
return cursor.fetchall()
@staticmethod
def obtener_residentes_lote(lote_id: int) -> List[Dict[str, Any]]:
"""
Obtiene el padrón de residentes y teléfonos vinculados a un lote (LotPer JOIN Per).
Paridad exacta con pct_repository.py:1752.
"""
query = """
SELECT TOP 100
p.PersonaID,
p.Apellido,
p.Nombre,
(SELECT TOP 1 pd.Documento FROM PerDocCatVal pd WHERE pd.PersonaID = p.PersonaID) AS Documento,
COALESCE(pr.Nombre, 'Residente') AS Perfil,
COALESCE(c.Nombre, 'Activo') AS Estado,
(
SELECT STRING_AGG(pt.Telefono, ' / ')
FROM PerTelCatVal pt
WHERE pt.PersonaID = p.PersonaID
) AS Telefonos
FROM LotPer lp
JOIN Per p ON lp.PersonaID = p.PersonaID
LEFT JOIN Prf pr ON lp.PerfilID = pr.PerfilID
LEFT JOIN CatVal c ON lp.ValorID = c.ValorID AND c.CategoriaID = 18
WHERE lp.LoteID = %s
ORDER BY p.Apellido, p.Nombre
"""
with db_session() as conn:
cursor = conn.cursor(as_dict=True)
cursor.execute(query, (lote_id,))
return cursor.fetchall()
@staticmethod
+17 -1
View File
@@ -29,7 +29,8 @@ class EntryRequest(BaseModel):
entidad: Optional[str] = None
cantidad_ocupantes: int = Field(1, ge=1)
cantidad_menores: int = Field(0, ge=0)
cacheo_salida: bool = False
cacheo_salida: bool = True
baul_inspeccionado: bool = False
abrir_barrera: bool = True
foto_evidencia_b64: Optional[str] = None
integrantes: List[CompanionDTO] = Field(default_factory=list)
@@ -136,6 +137,7 @@ class ActiveTicketDTO(BaseModel):
modulo_ingreso: str
fecha_ingreso: str
ocupantes: int = 1
cacheo_salida: bool = False
class PersonSearchDTO(BaseModel):
@@ -150,9 +152,23 @@ class PersonSearchDTO(BaseModel):
class LotSearchDTO(BaseModel):
lote_id: int
codigo: str
uf: Optional[str] = None
calle: Optional[str] = None
numero: Optional[str] = None
estado: Optional[str] = "Habilitado"
propietario: Optional[str] = None
class LotResidentDTO(BaseModel):
persona_id: int
apellido: str
nombre: str
documento: Optional[str] = None
perfil: str = "Residente"
estado: str = "Activo"
telefonos: Optional[str] = None
class MovementHistoryDTO(BaseModel):
mvt_hist_id: int
ticket_id: int
+37 -6
View File
@@ -13,6 +13,7 @@ from app.schemas.access_schema import (
LotSearchDTO,
PersonPoliciesDTO,
VehicleDetailsDTO,
LotResidentDTO,
)
from app.repositories.access_repository import AccessRepository
from app.services.hardware_service import HardwareService
@@ -48,12 +49,19 @@ class AccessService:
detail="Falta el nombre de la persona (campo obligatorio).",
)
# 3. Validar Lote de Destino
if not req.lote_id and not (req.lote_codigo and req.lote_codigo.strip()):
raise HTTPException(
status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
detail="Falta seleccionar el lote de destino.",
)
# 3. Validar Lote de Destino (Paridad estricta pct_view.py:3183 `if self.lote_id <= 0: return False`)
if not req.lote_id or req.lote_id <= 0:
if req.lote_codigo and req.lote_codigo.strip():
lote_encontrado = AccessRepository.buscar_lote_por_codigo(req.lote_codigo.strip())
if lote_encontrado:
req.lote_id = lote_encontrado["LoteID"]
elif req.lote_codigo.strip().isdigit() and int(req.lote_codigo.strip()) > 0:
req.lote_id = int(req.lote_codigo.strip())
if not req.lote_id or req.lote_id <= 0:
raise HTTPException(
status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
detail="Falta Seleccionar Lote de Destino (obligatorio según normativa de guardia).",
)
# 4. Validar restricción del lote (Categoría 26 en LotCatVal)
if req.lote_id and req.lote_id > 0:
@@ -136,6 +144,11 @@ class AccessService:
# 9. Generación del TicketID
ticket_id = AccessRepository.generar_ticket_id()
# Inspección de baúl en garita (Paridad pct_view.py:2739)
if getattr(req, 'baul_inspeccionado', False) and es_conductor:
if "[BAUL INSPECCIONADO - OK]" not in (req.motivo or ""):
req.motivo = f"{(req.motivo or '').strip()} [BAUL INSPECCIONADO - OK]".strip()
# 10. Registro transaccional en base de datos
AccessRepository.registrar_ticket_ingreso(req, persona_id, ticket_id)
@@ -227,6 +240,23 @@ class AccessService:
"""Verifica restricciones de lote (Cat 26) y relación de persona (LotPer)."""
return AccessRepository.obtener_permiso_lote(lote_id, persona_id)
@staticmethod
def obtener_residentes_lote(lote_id: int) -> List[LotResidentDTO]:
"""Obtiene el padrón de residentes y teléfonos vinculados a un lote (LotPer JOIN Per)."""
filas = AccessRepository.obtener_residentes_lote(lote_id)
return [
LotResidentDTO(
persona_id=int(r.get("PersonaID") or r.get("persona_id") or 0),
apellido=str(r.get("Apellido") or r.get("apellido") or "").strip(),
nombre=str(r.get("Nombre") or r.get("nombre") or "").strip(),
documento=str(r.get("Documento") or r.get("documento") or "").strip(),
perfil=str(r.get("Perfil") or r.get("perfil") or "Residente").strip(),
estado=str(r.get("Estado") or r.get("estado") or "Activo").strip(),
telefonos=str(r.get("Telefonos") or r.get("telefonos") or "").strip() or None,
)
for r in filas
]
@staticmethod
def obtener_ocupantes_ticket(ticket_id: int) -> list:
"""Obtiene la lista de ocupantes (conductor y acompañantes) vinculados a un ticket."""
@@ -253,6 +283,7 @@ class AccessService:
modulo_ingreso=str(f.get("ModuloIngreso") or "Módulo Desconocido"),
fecha_ingreso=f_ing_str,
ocupantes=1,
cacheo_salida=str(f.get("CacheoSalida") or "0") == "1",
)
)
return resultado