Files
API-WINDNAS/app/schemas.py

36 lines
1.2 KiB
Python
Raw Normal View History

"""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]