36 lines
1.2 KiB
Python
36 lines
1.2 KiB
Python
|
|
"""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]
|