# Visão do Domínio — Mud Sentinel

**Documento:** `dominio/00-visao-do-dominio.md`  
**Versão:** 1.0.0

---

## 1. Problema de domínio

Organizações precisam avaliar **integridade**, **conflitos de interesse**, **risco reputacional** e **conformidade** de contrapartes e atores públicos/privados. Dados relevantes estão dispersos em fontes públicas (cadastros empresariais, contratos, licitações, sanções, transparência, parlamentos, transferências) com qualidade heterogênea, temporalidade e ausência de um grafo unificado auditável.

O Mud Sentinel resolve o problema transformando esses dados em:

1. **Entidades resolvidas** (pessoas, empresas, órgãos) com identificadores e lineage;
2. **Fatos públicos tipados** (contratos, sanções, mandatos, etc.);
3. **Relacionamentos navegáveis** (grafo) e **linha do tempo**;
4. **Sinais de integridade** explicáveis;
5. **Casos/dossiês** com evidências e exports;
6. **Monitoramento contínuo** (watch) e assistência por **IA com citação**.

---

## 2. Classificação estratégica DDD

| Tipo | Contextos |
|------|-----------|
| **Core Domain** | Integrity, Graph, Cases, Evidence, Companies↔People resolution (Core), Watch |
| **Supporting** | Contracts, Procurement, Transfers, Sanctions, Transparency, Parliament, Government, Search, AI, RAG, Timeline, Reports, Documents, Maps |
| **Generic** | Identity, Administration, Settings, Notifications, Plugins, Analytics (uso), ETL/Crawler (infra de dados com regras próprias) |

**Justificativa:** o diferencial competitivo está em resolver identidade de atores + relacionar fatos + explicar risco + auditar análise — não em reinventar IAM genérico.

---

## 3. Subdomínios (agrupamento conceitual)

```text
┌─────────────────── ACTORS ───────────────────┐
│ Core │ Companies │ People │ Government │ Parliament │
└──────────────────────────────────────────────┘
┌──────────── PUBLIC TRANSACTIONS ─────────────┐
│ Contracts │ Procurement │ Transfers │ Transparency │ Sanctions │
└──────────────────────────────────────────────┘
┌──────────── ANALYSIS & INTEGRITY ────────────┐
│ Integrity │ Graph │ Timeline │ Maps │ Cases │ Documents │ Evidence │ Watch │ Reports │
└──────────────────────────────────────────────┘
┌──────────── INTELLIGENCE FABRIC ─────────────┐
│ Search │ Knowledge Base │ RAG │ AI │ Analytics │
└──────────────────────────────────────────────┘
┌──────────── DATA SUPPLY ─────────────────────┐
│ Crawler │ ETL │ Plugins (connectors)         │
└──────────────────────────────────────────────┘
┌──────────── PLATFORM ────────────────────────┐
│ Identity │ Administration │ Settings │ Notifications │
└──────────────────────────────────────────────┘
```

---

## 4. Princípios invariantes do domínio

1. **Todo fato público tem lineage** (fonte, coletado em, vigência, confiança).
2. **Party resolution é explícita** — “mesmo nome” ≠ mesma entidade sem evidência.
3. **Relacionamento é tipado, datado e direcionado** (quando aplicável).
4. **Score de integridade é decomponível** em fatores/regras.
5. **Caso é o aggregate de trabalho analítico** do tenant; fato público é compartilhado (read model), anotações são privadas ao tenant.
6. **IA não cria fatos** — apenas interpreta/resume/hipotetiza sobre contexto citado.
7. **Watch observa entidades/fatos**; alerta é consequência de mudança relevante.

---

## 5. Contagem-alvo desta versão

| Artefato | Quantidade aproximada |
|----------|------------------------|
| Bounded Contexts | 27 |
| Entidades / Aggregates documentados | 90+ |
| Termos no glossário | 120+ |