# Glossário Oficial — Mud Sentinel

**Documento:** `dominio/glossario.md`  
**Versão:** 1.0.0  
**Status:** Vigente  
**Idioma de interface preferencial:** Português (Brasil)  
**Identificadores de modelo:** Inglês técnico

---

## A

**Aditivo (ContractAmendment)** — Alteração formal de contrato público (prazo, valor, objeto).  
**Alerta (Alert)** — Notificação de mudança relevante em alvo monitorado.  
**Analista** — Papel que pesquisa, monta dossiês e usa IA.  
**Auditor** — Papel com ênfase em leitura e exportação de evidências.  
**Auditoria (AuditEvent)** — Registro append-only de ação sensível.

## B

**Beneficiário (Grantee)** — Party que recebe Transfer.  
**Bid / Proposta** — Participação em licitação.  
**BiddingProcess / Licitação** — Processo de seleção pública.  
**Bounded Context** — Limite explícito de modelo e linguagem.

## C

**Caso / Dossiê (Case)** — Aggregate analítico privado ao Tenant.  
**Citação (Citation)** — Ligação entre trecho de Completion e evidência/fonte.  
**CNPJ / Identificador** — Scheme de Identifier (exemplos; lista completa na ontology).  
**Completion** — Saída de um modelo de IA para um pedido.  
**Conflito de Interesse (COI Signal)** — Indício estrutural de possível conflito entre papéis/partes.  
**ConnectorPlugin** — Plugin de coleta/normalização de fonte.  
**Contrato Público (PublicContract)** — Ajuste administrativo modelado.  
**Core** — Contexto de Party, Identifier e SourceRecord.  
**CrawlJob** — Execução de coleta bruta.

## D

**DataQualityIssue** — Problema de qualidade detectado no ETL.  
**Documento (Document)** — Artefato versionado (upload ou espelho).  
**Domain Event** — Fato imutável relevante ocorrido no domínio.

## E

**Entitlement** — Capacidade de produto liberada ao Tenant.  
**EntityMatchCandidate** — Hipótese de que dois registros são o mesmo Party.  
**ETL** — Contexto de transformação e publicação de dados.  
**Evidence / Evidência (EvidenceItem)** — Unidade citável no Case.  
**EvidenceManifest** — Lista fechada de evidências de um export.  
**ExportPackage** — Pacote entregável (PDF/JSON/ZIP) com hash.

## F

**Fato público** — Afirmação tipada sustentada por SourceRecord.  
**Finding / Achado** — Conclusão estruturada dentro de um Case.  
**Fonte (SourceSystem)** — Origem lógica de dados (portal, base, lista).

## G

**GovernmentBody / Órgão** — Party do setor público.  
**Grafo (Graph)** — Projeção navegável de nós e arestas.  
**GraphEdge / Aresta** — Relacionamento tipado e datado.  
**GraphPath / Caminho** — Sequência de arestas entre dois nós (estrutural ≠ prova).  
**GraphView** — Subgrafo salvo para análise/evidência.  
**Grounding** — Restrição de IA a contexto citável.

## H

**Hipótese** — Interpretação analítica explícita, não fato publicado.  
**Homônimo** — Pessoas/empresas com nomes iguais sem Identifier compartilhjado.

## I

**Identifier** — Identificador tipado de um Party.  
**IngestRun** — Lote atômico de publicação no catálogo.  
**IntegrityFactor** — Fator explicável que compõe score.  
**IntegrityScore** — Pontuação agregada de integridade/risco.  
**Invitation** — Convite para membership no Tenant.

## K

**KnowledgeArticle** — Artigo metodológico/ajuda versionado.  

## L

**Lineage** — Rastreio de um atributo/fato até SourceRecord/RawPayload.  
**Lista de Sanção (SanctionList)** — Conjunto versionado de restrições.

## M

**Mandate / Mandato** — Período de função oficial/eletiva.  
**MapLayer** — Camada geográfica analítica.  
**MembershipInterest** — Vínculo de participação (conselho, associação, etc.).  
**Merge (Party)** — Unificação de Parties duplicados com redirect.

## N

**Notification** — Mensagem entregue a usuário/canal.  
**Nota (CaseNote)** — Anotação humana no Case.

## O

**OntologyTerm** — Termo controlado da taxonomia oficial.  
**Órgão** — Ver GovernmentBody.

## P

**Party** — Ator resolvido do catálogo (super-tipo).  
**PEP (PoliticallyExposedFlag)** — Marcação de pessoa politicamente exposta.  
**Person** — Pessoa física do catálogo (≠ UserAccount).  
**PluginInstallation** — Ativação operacional de um connector.  
**PromptTemplate** — Template versionado de prompt.  
**Prova** — Termo **evitar** na UX para caminhos de grafo; preferir “indício/caminho estrutural”.

## Q

**Quota** — Limite quantitativo de uso.

## R

**RAG** — Recuperação aumentada para grounding de IA.  
**RawPayload** — Artefato bruto imutável coletado.  
**RiskRule** — Regra versionada que gera fatores de integridade.  
**Role** — Papel de autorização.

## S

**SanctionEntry** — Entrada de restrição/impedimento.  
**SearchDocument** — Projeção indexada para busca.  
**Session** — Sessão autenticada.  
**Shareholding** — Participação societária.  
**Snapshot** — Versão imutável de atributos em um tempo/fonte.  
**SourceRecord** — Evidência de origem publicada no catálogo.  
**SoR (System of Record)** — Sistema/contexto dono da verdade de um conceito.

## T

**Tenant** — Organização cliente isolada.  
**TimelineEvent** — Evento na linha do tempo de um sujeito.  
**Transfer** — Transferência de recursos modelada.  
**TransparencyPublication** — Publicação em portal de transparência.

## U

**UsageEvent** — Evento de consumo mensurável.  
**UserAccount** — Conta de login na plataforma.  
**Ubiquitous Language** — Vocabulário oficial compartilhado time↔domínio.

## W

**Watchlist** — Lista de monitoramento.  
**WatchTarget** — Alvo monitorado.  
**Workspace** — Subespaço opcional dentro do Tenant.

---

## Termos proibidos / desencorajados na comunicação oficial

| Evitar | Preferir |
|--------|----------|
| “Prova de vínculo” (grafo) | Caminho estrutural / indício de relacionamento |
| “Culpa” / “corrupto” automático | Indício, alerta, fator de integridade |
| “Cliente” para UserAccount | Usuário / conta |
| “Entidade” sem qualificar | Party / Company / Person / … |
| “Documento” para qualquer PDF de portal | TransparencyPublication ou SourceRecord conforme o caso |
| “IA descobriu fato” | IA resumiu/hipotetizou com base em fontes citadas |