Pular para o conteúdo 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.

Toda chamada segue o mesmo fluxo: 
sua geometria  ─┐
                ├─→  match contra reference sources
seu ruleset    ─┘    (áreas protegidas, sanções, registros, ...)
                          │
                          ▼
                    executa checks (count, área, distância,
                                    subject match, ...)
                          │
                          ▼
                    compõe um verdict

​
Os quatro primitivos

​
Sets

Um set é uma coleção de feições (polígonos, pontos, linhas ou registros de subject). Sets são ou ancorados em um source — por exemplo, “todas as feições em br:funai:indigenous-territories que intersectam minha geometria de input” — ou construídos via operações de conjunto (union, intersection, difference) sobre outros sets.

​
Projections

Uma projection computa um valor a partir de um set: count, total_area_m2, min_distance_m, um agregado sobre uma propriedade da feição, ou um merge de geometrias. Projections produzem números e geometrias — não contribuem para o verdict por si só.

​
Checks

Um check verifica algo sobre um set ou uma projection e produz um resultado booleano com uma severity. Dois sabores:
  • exists — o set é não-vazio?
  • threshold — o valor de uma projection passa por uma comparação op + value? (ex.: count >= 1, total_area_m2 > 50000)

​
Verdict

O verdict combina os resultados dos checks pela severity. A resposta carrega dois enums propositadamente:
  • status — ok ou degraded. Saúde de execução.
  • outcome — compliant, warning, non_compliant ou degraded. Resultado de compliance.
Veja Verdicts para a semântica completa.

​
Três estilos de uso

EstiloEndpointQuando usar
Descoberta crua/v1/intersections, /v1/distanceExploração, debug, queries pontuais
Lookup de subject/v1/subjectsSanções / blacklist / registro por identificador
Compliance completo/v1/evaluateDecisões de produção contra um ruleset
A maioria dos clientes começa com descoberta e migra para /v1/evaluate quando a política se estabiliza.