# SDR-0025 — Propagação de SDRs para consumidores (site e documentos de contratação)

> **Nomenclatura:** arquivo físico `sdr-0025-propagacao-sdr-consumidores-site-contratacao.md`. Norma para **refletir** nos **consumidores** (HTML, minutas, `processo-contratacao/`, espelhos) o que já foi estabilizado nos arquivos `sdr-*.md`, **sem** inverter a ordem “SDR dono → consumidor”.

---

## 1. Metadados

| Campo | Valor |
|-------|--------|
| **ID** | `sdr-0025-propagacao-sdr-consumidores-site-contratacao` |
| **Título** | Propagação de SDRs para consumidores (site e documentos de contratação) |
| **Versão** | `v0.1` |
| **Data** | `2026-05-03` |
| **Autor** | Equipe do repositório |
| **Revisores** | *(pendente)* |
| **Status** | `Em validação` |
| **Substitui** | — |
| **Substituído por** | — |
| **Classificação** | `Interno` |
| **Eixo** | `Ambos` |
| **Domínio** | Alinhamento editorial entre especificação (`sdr-*.md`) e artefatos de divulgação/contratação |
| **Stakeholders** | Quem edita SDRs, site, TR, ANS, Proposta, IMR e pasta de processo; revisores de PR |
| **SDRs relacionados** | [sdr-0003-indice-fonte-unica.md](./sdr-0003-indice-fonte-unica.md), [REGRAS-AGENTE-E-PROMPTS.md](./REGRAS-AGENTE-E-PROMPTS.md), [sdr-0017-site-html-rastreabilidade.md](./sdr-0017-site-html-rastreabilidade.md), [sdr-0021-planejamento-pre-alteracao-agente.md](./sdr-0021-planejamento-pre-alteracao-agente.md) |

---

## 2. Controle de Revisão

| Versão | Data | Autor | Mudanças |
|--------|------|-------|----------|
| v0.1 | 2026-05-03 | Equipe do repositório | Criação: fases de propagação, matriz de consumidores, vínculo com edição exclusiva de SDR (0021) |

---

## 3. Objetivo

Garantir que **site**, **modelos** em `arquitetura-contratual/` e **documentos** em `processo-contratacao/` **reflitem** as definições dos SDRs quando o pedido ou o processo exigirem atualização — com **ordem explícita**: primeiro o **SDR dono** (e índice, quando couber), depois os **consumidores**, salvo **exceção** declarada pelo solicitante na conversa.

---

## 4. Escopo e Abstração

### 4.1 Dentro do escopo

- **Quando** propagar (gatilhos) e **para quais** pastas/arquivos típicos.
- **Ordem** em duas fases: (1) texto canônico entre SDRs estável no dono; (2) consumidores alinhados.
- Remissão à política de **edição exclusiva** de `sdr-*.md` em [sdr-0021 §8.4](./sdr-0021-planejamento-pre-alteracao-agente.md#84-alteração-exclusiva-de-sdrs-normativos).

### 4.2 Fora do escopo

- **Fonte única entre** arquivos `sdr-*.md` — [REGRAS-AGENTE-E-PROMPTS.md](./REGRAS-AGENTE-E-PROMPTS.md) e [sdr-0003](./sdr-0003-indice-fonte-unica.md).
- Detalhe de **busca estática**, **siglas**, **mapa Ibama**, **gate de acesso** — donos temáticos (ex.: [sdr-0017](./sdr-0017-site-html-rastreabilidade.md), [sdr-0020](./sdr-0020-dados-ibama-mapa-ativos-cmdb-kml.md)).
- Aprovação institucional de minutas fora do repositório.

### 4.3 Nível de abstração

**Política de processo editorial** e mapa de consumidores; não substitui cláusulas assinadas nem revisão jurídica.

### 4.4 Implementação de software

Scripts (`sync_site_repositorio.py`, `gerar_site_search_index.py`, etc.) são **meios**; o **o quê** propagar continua definido pelo SDR temático e por este SDR quanto à **ordem** e **escopo** dos consumidores listados na §8.

---

## 5. Contexto e Síntese Executiva

### 5.1 Problema

Consumidores (HTML, ANS modelo, TR) podem **atrasar** em relação ao SDR ou serem editados **antes** do dono, gerando divergência e dupla manutenção.

### 5.2 Solução proposta (resumo)

**Fase A — SDR:** alterar só o(s) `sdr-*.md` pertinentes e o índice quando necessário, em pedido **dedicado** (ver [sdr-0021 §8.4](./sdr-0021-planejamento-pre-alteracao-agente.md#84-alteração-exclusiva-de-sdrs-normativos)). **Fase B — Propagação:** novo objetivo (nova mensagem ou plano) atualiza consumidores conforme matriz §8.2.

### 5.3 Benefícios esperados

Uma **fonte da verdade** normativa entre SDRs e consumidores **alinhados** de forma rastreável.

### 5.4 Riscos se não implementado

Site e minutas **desmentem** o SDR; revisores não sabem qual versão prevalece.

---

## 6. Slides Executivos

- **SDR primeiro** — consumidor depois.
- **Propagação** — fase separada da edição exclusiva do SDR.
- **Matriz §8.2** — onde olhar para cada tipo de artefato.

---

## 7. Restrições Globais, Não-Funcionais e Critérios de Sucesso

### 7.1 Restrições técnicas

- Não colar segredos (tokens) em planos ou HTML.
- Após mudança em HTML do `site/` que afete busca, seguir [sdr-0017](./sdr-0017-site-html-rastreabilidade.md) para regeneração do índice.

### 7.2 Restrições de negócio / compliance

Consumidores podem conter **redação completa** de cláusulas; o SDR continua sendo o **desenho** e a **âncora** de revisão interna do repositório.

### 7.3 Critérios de sucesso mensuráveis

- Para cada mudança normativa relevante: evidência no Git de commit/PR que tocou **SDR dono** antes ou em PR separado **documentado** do consumidor.
- Lista de consumidores da §8.2 verificada no checklist do pedido de propagação.

---

## 8. Design / Arquitetura

### 8.1 Visão geral

```text
[ Pedido alterar norma ]
       |
       v
[ Fase A: sdr-*.md dono + sdr-0003 se preciso ]  <-- edição exclusiva / sdr-0021 §8.4
       |
       v
[ Fase B: consumidores ]  <-- este SDR (0025)
```

### 8.2 Matriz de consumidores (referência)

| Consumidor | Caminhos típicos | Gatilho típico | Norma / dono do desenho |
|------------|------------------|----------------|-------------------------|
| Site multipágina | `arquitetura-contratual/site/**/*.html` | Mudança de regra exibida ao público interno | [sdr-0017](./sdr-0017-site-html-rastreabilidade.md) + SDR temático |
| Documento ampliado (modelo central) | `arquitetura-contratual/modelo-central-servicos.html` | Síntese ou navegação precisa refletir o SDR | [sdr-0017](./sdr-0017-site-html-rastreabilidade.md) |
| ANS modelo | `arquitetura-contratual/ANS-Acordo-de-Niveis-de-Servico-modelo.md` | SLA, medição, indicadores | [sdr-0007](./sdr-0007-ans-parametros-sla.md) e hubs correlatos (ex.: [sdr-0023](./sdr-0023-remuneracao-por-ic-modelo.md)) |
| Demais minutas em `arquitetura-contratual/` | `*.md` de apoio (PPSI, análises, etc.) | Coluna *Documentos relacionados* do [sdr-0003](./sdr-0003-indice-fonte-unica.md) | SDR indicado na linha do tópico |
| Processo de contratação | `processo-contratacao/**` (DFD, ETP, TR, estimativas, seleção) | Pedido explícito ou etapa do processo | SDRs da linha correspondente no índice + [REGRAS](./REGRAS-AGENTE-E-PROMPTS.md) passo 4 |
| Índice de processo | `processo-contratacao/00_controle_geral/INDICE_PROCESSO.md` | Quando o processo exigir | [REGRAS §4](./REGRAS-AGENTE-E-PROMPTS.md) |
| Espelho estático / Firebase | `arquitetura-contratual/scripts/sync_site_repositorio.py` → `site/repositorio/` | Deploy ou necessidade de leitura offline espelhada | [sdr-0017](./sdr-0017-site-html-rastreabilidade.md) |

### 8.3 Exceção (plano conjunto)

Se o usuário **declarar por escrito** na conversa que aceita **um único** plano cobrindo SDR **e** consumidores, o plano deve **listar** explicitamente cada arquivo `sdr-*.md` **e** cada consumidor — responsabilidade assumida pelo solicitante. O agente ainda deve **obedecer** [sdr-0021](./sdr-0021-planejamento-pre-alteracao-agente.md) (modo Planejamento, modo Agente, confirmações).

---

## 9. Processos e Integrações

### 9.1 Processos afetados

- Elaboração e revisão de TR, ANS, Proposta, IMR e páginas do site.

### 9.2 Integrações

- [REGRAS-AGENTE-E-PROMPTS.md](./REGRAS-AGENTE-E-PROMPTS.md) — ordem de trabalho (planejar → localizar dono → editar SDR → propagação).
- Comando `/alterar-sdr` — isola **Fase A**; propagação costuma ser **outro** objetivo.

### 9.3 SLAs / tempos

*Não prescrito* — proporcional ao tamanho da divergência e ao número de consumidores tocados.

---

## 10. Dados, Modelos e Classificações

### 10.1 Entidades / glossário

| Termo | Significado |
|--------|-------------|
| **Consumidor** | Artefato fora do conjunto `sdr-*.md` que **deve** refletir o desenho normativo (HTML, minutas, índices de processo). |
| **Propagação** | Fase **B**: editar consumidores **depois** do SDR dono estável, salvo exceção §8.3. |

### 10.2 Modelos de dados

*Não aplicável.*

### 10.3 Classificações (LGPD, criticidade, etc.)

*Não aplicável.*

---

## 11. Controles de Exclusividade e Risco

### 11.1 Exclusividade / fonte única

Este arquivo é o **único** dono, entre `sdr-*.md`, da política **“propagação SDR → site e contratação”**. [sdr-0017](./sdr-0017-site-html-rastreabilidade.md) permanece dono do **como** manter HTML, busca e espelho; **0025** define **quando** e **ordem** em relação aos SDRs.

### 11.2 Riscos e mitigação

| Risco | Mitigação |
|-------|-----------|
| Propagar antes do SDR | [sdr-0021 §8.4](./sdr-0021-planejamento-pre-alteracao-agente.md#84-alteração-exclusiva-de-sdrs-normativos) + Fase A/B |
| Esquecer `sync` ou índice de busca | Checklist [sdr-0017](./sdr-0017-site-html-rastreabilidade.md) |

---

## 12. Segurança, LGPD e Auditoria

### 12.1 Controles de segurança

Não publicar credenciais; seguir gate do site conforme [sdr-0017](./sdr-0017-site-html-rastreabilidade.md).

### 12.2 LGPD / privacidade

*Não aplicável* diretamente a este SDR.

### 12.3 Auditoria / evidências

PRs e planos de agente ([sdr-0021](./sdr-0021-planejamento-pre-alteracao-agente.md)).

---

## 13. Rastreabilidade e Validação

### 13.1 Critérios de aceite globais

- Índice [sdr-0003](./sdr-0003-indice-fonte-unica.md) referencia este SDR como dono do tópico “propagação”.
- Pedidos de alinhamento citam **Fase A** e **Fase B** quando tocarem norma **e** consumidor.

### 13.2 Validações automáticas (quando existem)

`python scripts/check_sdr_conformity.py` — estrutura e metadados deste arquivo.

### 13.3 Validações manuais

Revisor confere se HTML/minuta cita ou reflete o SDR dono sem contradizer o índice.

---

## 14. Matriz de Implementações Dependentes e Riscos

| Implementação | Depende de | Risco se atrasar |
|---------------|------------|------------------|
| Site alinhado | SDR temático + [sdr-0017](./sdr-0017-site-html-rastreabilidade.md) | Mensagem contraditória ao visitante |
| Espelho `site/repositorio/` | `sync_site_repositorio.py` | Leitura offline desatualizada |

---

## 15. Histórico de Mudanças Governadas

| Data | Mudança | SDR / proposta |
|------|---------|----------------|
| 2026-05-03 | Criação do SDR-0025 | v0.1 |

---

## 16. Propostas Governadas (alternativas)

- **Propagação automática em todo commit de SDR:** **não** adotado — custo e ruído; propagação continua **pedido** ou **processo** explícito.

---

## 17. Requisitos

### 17.1 Requisitos funcionais

| ID | Requisito | Prioridade | Aceite quando |
|----|-----------|------------|---------------|
| RF-001 | Quando o pedido exigir refletir norma nos consumidores, seguir **Fase A** (SDR) antes da **Fase B**, salvo exceção §8.3 | Alta | Ordem documentada no plano ou em PRs separados justificados |
| RF-002 | O plano de propagação deve considerar a matriz §8.2 para o tema alterado | Média | Lista de caminhos tocados no plano |
| RF-003 | Edição de `sdr-*.md` normativo em pedido dedicado conforme [sdr-0021 §8.4](./sdr-0021-planejamento-pre-alteracao-agente.md#84-alteração-exclusiva-de-sdrs-normativos) | Alta | Uso de `/alterar-sdr` ou exceção explícita |

### 17.2 Rastreabilidade implementação ↔ requisito

| Requisito | Arquivo / componente | Observação |
|-----------|----------------------|------------|
| RF-001–RF-003 | [REGRAS-AGENTE-E-PROMPTS.md](./REGRAS-AGENTE-E-PROMPTS.md) §4 | Ordem de trabalho |
| RF-003 | [`.cursor/rules/sdr-edicao-exclusiva-fonte-verdade.mdc`](../.cursor/rules/sdr-edicao-exclusiva-fonte-verdade.mdc), [`.cursor/commands/alterar-sdr.md`](../.cursor/commands/alterar-sdr.md) | Reforço operacional no Cursor |

### 17.3 Requisitos não-funcionais

| ID | Requisito | Métrica |
|----|-----------|---------|
| RNF-001 | Plano proporcional | Revisor julga adequação ao número de consumidores |

---

## 18. Checklist de Governança

- [x] Metadados completos (seção 1)
- [x] Status coerente com o ciclo de vida (`Em validação`)
- [x] Sem duplicar norma já dona em outro `sdr-*.md` (fonte única *entre* SDRs)
- [x] Política “somente documentação” para código de produto declarada na seção 4.4
- [ ] Revisores e data de aprovação quando **Status: Aprovado**

---

## Agentes de conformidade (Cursor)

| Agente | Regra Cursor | Norma em `SDRs/governance/rules/` |
|--------|----------------|-------------------------------------|
| Verificador de conformidade SDR | [`sdr-conformity-checker.mdc`](../.cursor/rules/sdr-conformity-checker.mdc) | [`sdr-conformity-checker.md`](./governance/rules/sdr-conformity-checker.md) |
| Detector de implementação sem vínculo SDR | [`implementation-without-sdr-detector.mdc`](../.cursor/rules/implementation-without-sdr-detector.mdc) | [`implementation-without-sdr-detector.md`](./governance/rules/implementation-without-sdr-detector.md) |
| Anti-vibecoding sem SDR | [`no-vibecoding-without-sdr.mdc`](../.cursor/rules/no-vibecoding-without-sdr.mdc) | [`no-vibecoding-without-sdr.md`](./governance/rules/no-vibecoding-without-sdr.md) |

**Processo:** [`governance/README.md`](./governance/README.md) · **Rastreabilidade código:** [`traceability.md`](./traceability.md) · **Checagem:** `python scripts/check_sdr_conformity.py` (na raiz do repositório).