Estructura inicial funcional con documentación en el README.md de la FastAPI

This commit is contained in:
2026-09-25 11:20:50 -03:00
parent edc71742fa
commit 774e227642
2710 changed files with 1012769 additions and 0 deletions

36
app/schemas.py Normal file
View 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]