Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs-attestly.code4source.com/llms.txt

Use this file to discover all available pages before exploring further.

Cada llamada sigue el mismo flujo:
tu geometría   ─┐
                ├─→  match contra reference sources
tu ruleset     ─┘    (áreas protegidas, sanciones, registros, ...)


                    ejecuta checks (count, área, distancia,
                                    subject match, ...)


                    compone un verdict

Los cuatro primitivos

Sets

Un set es una colección de features (polígonos, puntos, líneas o registros de subject). Los sets están anclados a un source — por ejemplo, “todas las features en br:funai:indigenous-territories que intersectan mi geometría de input” — o construidos mediante operaciones de conjunto (union, intersection, difference) sobre otros sets.

Projections

Una projection computa un valor a partir de un set: count, total_area_m2, min_distance_m, un agregado sobre una propiedad de la feature, o un merge de geometrías. Las projections producen números y geometrías — no contribuyen al verdict por sí mismas.

Checks

Un check verifica algo sobre un set o una projection y produce un resultado booleano con una severity. Dos sabores:
  • exists — ¿el set es no-vacío?
  • threshold — ¿el valor de una projection pasa una comparación op + value? (ej.: count >= 1, total_area_m2 > 50000)

Verdict

El verdict combina los resultados de los checks por severity. La respuesta lleva dos enums a propósito:
  • statusok o degraded. Salud de ejecución.
  • outcomecompliant, warning, non_compliant o degraded. Resultado de compliance.
Ver Verdicts para la semántica completa.

Tres estilos de uso

EstiloEndpointCuándo usar
Descubrimiento crudo/v1/intersections, /v1/distanceExploración, depuración, queries puntuales
Lookup de subject/v1/subjectsSanciones / blacklist / registro por identificador
Compliance completo/v1/evaluateDecisiones de producción contra un ruleset
La mayoría de los clientes empieza con descubrimiento y migra a /v1/evaluate cuando la política se estabiliza.