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

71
app/routers/archivos.py Normal file
View File

@@ -0,0 +1,71 @@
"""GET /archivos?cedula=...&nombres=...&apellidos=...
Busca DENTRO del contenido de los archivos (y en sus rutas) consultando el índice
de Elasticsearch que mantiene FSCrawler.
"""
import logging
from fastapi import APIRouter, Depends, HTTPException, Query, Request
from sqlalchemy.orm import Session
from app.busqueda import buscar, validar
from app.database import get_db
from app.elastic import ElasticError
from app.models import LogBusqueda
from app.schemas import ArchivoOut, BusquedaOut, CriteriosOut
from app.security import Usuario, generar_url_descarga, usuario_actual
router = APIRouter(tags=["archivos"])
log = logging.getLogger("api")
@router.get("/archivos", response_model=BusquedaOut)
def buscar_archivos(
request: Request,
cedula: str | None = Query(None, max_length=20, description="Cédula, con o sin puntos"),
nombres: str | None = Query(None, max_length=100, description="Nombres (ej. Juan Carlos)"),
apellidos: str | None = Query(None, max_length=100, description="Apellidos (ej. Pérez González)"),
limite: int = Query(100, ge=1, le=500, description="Máximo de archivos a devolver"),
db: Session = Depends(get_db),
usuario: Usuario = Depends(usuario_actual),
):
try:
ced, nom, ape = validar(cedula, nombres, apellidos)
except ValueError as e:
raise HTTPException(422, str(e))
try:
coincidencias, total_coincidencias = buscar(ced, nom, ape, limite)
except ElasticError as e:
log.error("Búsqueda fallida: %s", e)
raise HTTPException(503, "El buscador no está disponible en este momento")
resultados = [
ArchivoOut(
id=c.doc_id,
nombre=c.nombre,
carpeta=c.carpeta,
extension=c.extension,
tamano_bytes=c.tamano_bytes,
modificado_en=c.modificado_en,
coincide_cedula=c.coincide_cedula,
coincide_nombre=c.coincide_nombre,
fragmento=c.fragmento,
url_descarga=generar_url_descarga(c.doc_id, usuario.id),
)
for c in coincidencias
]
criterio = "+".join(n for n, v in (("cedula", ced), ("nombre", nom)) if v)
valor = " | ".join(v for v in (ced, " ".join(p.normal for p in nom), " ".join(p.normal for p in ape)) if v)
ip = request.client.host if request.client else ""
db.add(LogBusqueda(usuario=usuario.id, criterio=criterio, valor=valor[:300], resultados=total_coincidencias, ip=ip))
db.commit()
log.info("BUSQUEDA usuario=%s %s=%s archivos=%s ip=%s", usuario.id, criterio, valor, total_coincidencias, ip)
return BusquedaOut(
criterios=CriteriosOut(cedula=ced or None, nombres=nombres, apellidos=apellidos),
total=len(resultados),
total_coincidencias=total_coincidencias,
resultados=resultados,
)