> ## 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.

# Cómo funciona

> Geometría → sources → checks → verdict.

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 `funai_tis`
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:

* `status` — `ok` o `degraded`. **Salud de ejecución.**
* `outcome` — `compliant`, `warning`, `non_compliant` o
  `degraded`. **Resultado de compliance.**

Ver [Verdicts](/es/concepts/verdicts) para la semántica completa.

## Tres estilos de uso

| Estilo               | Endpoint                            | Cuándo usar                                        |
| -------------------- | ----------------------------------- | -------------------------------------------------- |
| Descubrimiento crudo | `/v1/intersections`, `/v1/distance` | Exploración, depuración, queries puntuales         |
| Lookup de subject    | `/v1/subjects`                      | Sanciones / blacklist / registro por identificador |
| Compliance completo  | `/v1/evaluate`                      | Decisiones 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.