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:
@@ -0,0 +1,98 @@
|
||||
# ==============================================================================
|
||||
# Rutas de Control de Accesos (Ingreso, Egreso, Tickets y Búsquedas)
|
||||
# ==============================================================================
|
||||
from typing import List
|
||||
from fastapi import APIRouter, Depends, Query, HTTPException, status
|
||||
from pydantic import BaseModel, Field
|
||||
from app.schemas.access_schema import (
|
||||
EntryRequest,
|
||||
ExitRequest,
|
||||
TicketResponse,
|
||||
ActiveTicketDTO,
|
||||
PersonSearchDTO,
|
||||
LotSearchDTO,
|
||||
)
|
||||
from app.services.access_service import AccessService
|
||||
from app.services.dni_parser_service import DNIParsingService, DNIParsedResult
|
||||
from app.api.v1.auth import obtener_usuario_actual
|
||||
|
||||
from app.api.v1.websockets import ws_manager
|
||||
|
||||
router = APIRouter(prefix="/access", tags=["Control de Accesos"])
|
||||
|
||||
|
||||
class DNIParseRequest(BaseModel):
|
||||
raw_data: str = Field(..., description="Cadena de texto escaneada del PDF417 o QR")
|
||||
|
||||
|
||||
@router.post("/entry", response_model=TicketResponse, summary="Registrar ingreso de visita/vehículo")
|
||||
async def registrar_ingreso(
|
||||
req: EntryRequest,
|
||||
current_user: dict = Depends(obtener_usuario_actual),
|
||||
):
|
||||
"""Registra atómicamente el ingreso, valida antipassback y dispara apertura de barrera."""
|
||||
res = AccessService.procesar_ingreso(req)
|
||||
await ws_manager.broadcast_all({
|
||||
"type": "ticket_created",
|
||||
"ticket_id": res.ticket_id,
|
||||
"modulo_id": req.modulo_ingreso_id,
|
||||
"documento": req.documento,
|
||||
"patente": req.patente,
|
||||
})
|
||||
return res
|
||||
|
||||
|
||||
@router.post("/exit", response_model=TicketResponse, summary="Registrar egreso de visita/vehículo")
|
||||
async def registrar_salida(
|
||||
req: ExitRequest,
|
||||
current_user: dict = Depends(obtener_usuario_actual),
|
||||
):
|
||||
"""Cierra el ticket activo, archiva en histórico y acciona la barrera de salida."""
|
||||
res = AccessService.procesar_salida(req)
|
||||
await ws_manager.broadcast_all({
|
||||
"type": "ticket_closed",
|
||||
"ticket_id": req.ticket_id,
|
||||
"modulo_id": req.modulo_salida_id,
|
||||
})
|
||||
return res
|
||||
|
||||
|
||||
@router.get("/tickets/active", response_model=List[ActiveTicketDTO], summary="Listar tickets activos en predio")
|
||||
def listar_tickets_activos(
|
||||
current_user: dict = Depends(obtener_usuario_actual),
|
||||
):
|
||||
"""Obtiene todos los ingresos que permanecen dentro del predio."""
|
||||
return AccessService.obtener_tickets_activos()
|
||||
|
||||
|
||||
@router.get("/people/search", response_model=List[PersonSearchDTO], summary="Búsqueda predictiva de personas")
|
||||
def buscar_personas(
|
||||
q: str = Query(..., min_length=2, description="Texto de búsqueda por apellido o documento"),
|
||||
current_user: dict = Depends(obtener_usuario_actual),
|
||||
):
|
||||
"""Búsqueda autocompletada rápida para agilizar el ingreso."""
|
||||
return AccessService.buscar_personas(q)
|
||||
|
||||
|
||||
@router.get("/lots/search", response_model=List[LotSearchDTO], summary="Búsqueda predictiva de lotes")
|
||||
def buscar_lotes(
|
||||
q: str = Query(..., min_length=1, description="Texto de búsqueda por código de lote"),
|
||||
current_user: dict = Depends(obtener_usuario_actual),
|
||||
):
|
||||
"""Búsqueda autocompletada de unidades funcionales / lotes de destino."""
|
||||
return AccessService.buscar_lotes(q)
|
||||
|
||||
|
||||
@router.post("/parse-dni", response_model=DNIParsedResult, summary="Parsear código de barras DNI")
|
||||
def parsear_codigo_dni(
|
||||
req: DNIParseRequest,
|
||||
current_user: dict = Depends(obtener_usuario_actual),
|
||||
):
|
||||
"""Decodifica texto crudo de PDF417 o QR Mi Argentina y extrae DNI, apellidos, nombres y sexo."""
|
||||
res = DNIParsingService.parsear_codigo(req.raw_data)
|
||||
if not res.valido:
|
||||
raise HTTPException(
|
||||
status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
|
||||
detail="No se pudo interpretar el formato del código escaneado.",
|
||||
)
|
||||
return res
|
||||
Reference in New Issue
Block a user