Estructura inicial funcional con documentación en el README.md de la FastAPI
This commit is contained in:
36
app/schemas.py
Normal file
36
app/schemas.py
Normal file
@@ -0,0 +1,36 @@
|
||||
"""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]
|
||||
Reference in New Issue
Block a user