"""Forma exacta del JSON que devuelve la API (lo que consume el frontend).""" from datetime import datetime, timezone from pydantic import BaseModel, field_validator class ArchivoOut(BaseModel): id: str # _id del documento en Elasticsearch nombre: str carpeta: str extension: str tamano_bytes: int modificado_en: datetime | None coincide_cedula: bool coincide_nombre: str | None # "completo" | "parcial" | null fragmento: str # texto alrededor de la coincidencia, marcada con « » url_descarga: str # enlace firmado, válido por DOWNLOAD_LINK_TTL_MINUTES @field_validator("modificado_en") @classmethod def _en_utc(cls, v: datetime | None) -> datetime | None: # Si la fecha viene sin zona horaria, se asume UTC return v if v is None or v.tzinfo else v.replace(tzinfo=timezone.utc) class CriteriosOut(BaseModel): cedula: str | None nombres: str | None apellidos: str | None class BusquedaOut(BaseModel): criterios: CriteriosOut total: int # archivos devueltos (como máximo `limite`) total_coincidencias: int # todos los archivos que coinciden resultados: list[ArchivoOut]