Files
API-WINDNAS/app/schemas.py

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]