Ucotron Cortex
Guías por flujo

Buscador

/v1/search — lotes, lugares, coordenadas y jurisdicciones en una sola lista.

Diagrama: BuscadorFlujo de la búsqueda unificada: una consulta se resuelve contra carteras, AOIs, siniestros y reportes con un solo endpoint.

no

query

¿≥ 2 caracteres?

lista vacía, sin red

Coordenadas pegadas

AOIs, carteras y siniestros del tenant

Lugares y jurisdicciones

Una lista, lo del tenant primero

Diagrama: BuscadorFlujo de la búsqueda unificada: una consulta se resuelve contra carteras, AOIs, siniestros y reportes con un solo endpoint.

no

query

¿≥ 2 caracteres?

lista vacía, sin red

Coordenadas pegadas

AOIs, carteras y siniestros del tenant

Lugares y jurisdicciones

Una lista, lo del tenant primero

Fuente del diagrama (mermaid)
flowchart TD
    Q[query] --> L{¿≥ 2 caracteres?}
    L -- no --> Z[lista vacía, sin red]
    L -- sí --> C[Coordenadas pegadas]
    L --> T[AOIs, carteras y siniestros del tenant]
    L --> G[Lugares y jurisdicciones]
    C & T & G --> R[Una lista, lo del tenant primero]
bash
curl -sS "$SBOX/v1/search?q=Pergamino" -H "authorization: Bearer $TOKEN"
curl -sS "$SBOX/v1/search?q=-33.8921,%20-60.5736" -H "authorization: Bearer $TOKEN"
curl -sS "$SBOX/v1/cortex/geocode?q=Rojas" -H "authorization: Bearer $TOKEN"

Coordenadas pegadas

Se devuelven las dos lecturas cuando ambas son válidas. En Argentina −60,−33 y −33,−60 son los dos puntos legítimos: elegir uno en silencio manda al usuario a mirar el mar.

Lo que se rompe

  • Menos de dos caracteres no dispara. Cada tecla lanzando una búsqueda devolvería la cartera entera y haría parpadear la lista.
  • El geocoder caído no se lleva los resultados locales. La respuesta trae degraded: true y lo del tenant igual aparece: lo propio es lo que más se busca, y degradar a cero convierte una molestia en una caída. Podés ejercitarlo con ?geocoder=down.
  • Los resultados respetan el permiso de su área. Un siniestro no aparece para quien sólo tiene permiso de cartera: sería la misma fuga que el copiloto, con otra ventana.
  • La query nunca entra al log. Se registra largo y digest. Alguien pega el CUIT de un cliente el primer día, y si eso queda en un log la PII salió por la puerta que nadie mira.

Endpoints de esta guía

On this page