# Roadmap — Mud Sentinel

**Documento:** `produto/03-roadmap.md`  
**Versão:** 1.0.0  
**Status:** Vigente  
**Horizonte:** 24 meses (revisão trimestral)

---

## 1. Princípios do roadmap

1. **Fundação antes de features espelhadas** — identidade, multi-tenant, auditoria e ingestão precedem “telas bonitas sem dado confiável”.
2. **Valor vertical cedo** — um caminho completo: buscar → ficha → grafo → dossiê → export → auditoria.
3. **IA com guarda-corpos** — assistente só após contexto citável estável.
4. **Decisões via ADR** — mudanças de plataforma registradas.

---

## 2. Fases

### Fase 0 — Fundação (semanas 0–6)

**Objetivo:** Base documental, repositório, ambientes, skeleton arquitetural e pipelines CI.

| Entrega | Justificativa |
|---------|---------------|
| Documentação fundacional (este conjunto) | Alinha produto e engenharia |
| Monorepo / estrutura de módulos vazia (após aprovação) | Evita dívida estrutural |
| Ambientes: local, staging, produção | Separação de dados e segredos |
| CI: lint, testes, SAST básicos | Qualidade desde o dia 1 |
| Escolha e hardening de IdP / auth blueprint | Segurança transversal |
| Modelo de dados conceitual + glossário DDD | Linguagem ubíqua |

**Saída:** Green light para implementação do MVP sem reabrir stack core sem ADR.

> Nesta fase **não** há código de domínio de negócio obrigatório além do skeleton quando formalmente iniciado; a etapa atual (deste documento) é **somente documentação**.

---

### Fase 1 — MVP Auditável (meses 1–4)

**Objetivo:** Tenants reais em piloto com fluxo analítico mínimo confiável.

| Epico | Casos | Resultado |
|-------|-------|-----------|
| Identidade & tenancy | UC-001, 002, 012, 016 | Contas isoladas, papéis, quotas básicas |
| Catálogo & busca | UC-003, 004 | Busca + ficha com lineage de fonte |
| Grafo básico | UC-005 | Exploração com limites de profundidade |
| Casos / dossiês | UC-007, 011 | Ciclo de vida + export auditável |
| Ingestão 1–N fontes piloto | UC-013 | Pipeline idempotente com métricas |
| IA assistida v1 | UC-008 | Resumo com citação, modelo versionado |
| Observabilidade & auditoria | — | Trilha + logs + dashboards operacionais |

**Critério de saída do MVP:** piloto com ≥ N analistas, dossiês exportados, zero incidente de vazamento cross-tenant, SLOs iniciais medidos.

---

### Fase 2 — Inteligência e escala analítica (meses 4–9)

| Epico | Justificativa |
|-------|---------------|
| Path finding (UC-006) | Diferencial investigativo |
| Regras de risco configuráveis (UC-009) | Explicabilidade e adaptação setorial |
| Watchlists & alertas (UC-010) | Monitoramento contínuo = retenção |
| API enterprise (UC-014) | Canal B2B e sticky integrations |
| Mais conectores de fontes | Cobertura competitiva |
| SSO SAML/OIDC | Vendas enterprise |
| Melhorias de grafo (performance, particionamento) | Escala de dados |

---

### Fase 3 — Plataforma (meses 9–18)

| Epico | Justificativa |
|-------|---------------|
| Feature store / scoring avançado | Risco mais sofisticado |
| Orquestração de IA multi-modelo | Custo/qualidade |
| Webhooks e event catalog público | Ecossistema |
| Políticas ABAC / atributos de sensibilidade | Compliance fino |
| Multi-região / residência de dados (se demanda) | Requisitos contratuais |
| White-label seletivo | Novos canais |

---

### Fase 4 — Expansão (meses 18–24+)

- Mercado internacional / i18n completo.
- Marketplace interno de regras/conectores (com sandbox).
- Analytics de produto avançado e data warehouse analítico separado.
- Certificações (ex.: ISO 27001) conforme estratégia comercial.

---

## 3. Priorização (framework)

Usar **RICE** leve + **risco regulatório** como veto:

- Se a feature aumenta risco LGPD/segurança sem controles, não entra na sprint.
- Preferir entregas que aumentem **dado confiável + trilha** em vez de cosméticos.

---

## 4. Dependências externas

| Dependência | Impacto | Mitigação |
|-------------|---------|-----------|
| Disponibilidade/ToS de fontes públicas | Bloqueia cobertura | Conectores pluggáveis + fontes múltiplas |
| Custo de LLM / embeddings | Margem | Cache, roteamento de modelos, quotas |
| Ciclo de vendas enterprise | Cashflow | Piloto MVP + pricing claro |
| Talento em grafos + compliance | Execução | Documentação forte + hiring seletivo |

---

## 5. Marcos de revisão

| Marco | Frequência | Dono |
|-------|------------|------|
| Revisão de roadmap | Trimestral | Produto + Arquitetura |
| Revisão de ADRs abertos | Mensal | Tech lead |
| Revisão de SLOs / incidentes | Mensal | Engenharia + Ops |
| Revisão LGPD / retenção | Semestral | DPO / Segurança |

---

## 6. Explicitamente não comprometido neste roadmap

Datas de calendário absolutas comerciais; números de receita; nomes de fontes específicas sob NDA; detalhamento de pricing.

O roadmap é **direção**, não contrato de entrega fixa. Alterações materiais de plataforma exigem ADR.