Fonte: SDRs/sdr-0025-propagacao-sdr-consumidores-site-contratacao.md
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 arquivossdr-*.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, REGRAS-AGENTE-E-PROMPTS.md, sdr-0017-site-html-rastreabilidade.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-*.mdem sdr-0021 §8.4.
4.2 Fora do escopo
- Fonte única entre arquivos
sdr-*.md— REGRAS-AGENTE-E-PROMPTS.md e sdr-0003. - Detalhe de busca estática, siglas, mapa Ibama, gate de acesso — donos temáticos (ex.: sdr-0017, sdr-0020).
- 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). 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 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
[ 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 temático |
| Documento ampliado (modelo central) | arquitetura-contratual/modelo-central-servicos.html |
Síntese ou navegação precisa refletir o SDR | sdr-0017 |
| ANS modelo | arquitetura-contratual/ANS-Acordo-de-Niveis-de-Servico-modelo.md |
SLA, medição, indicadores | sdr-0007 e hubs correlatos (ex.: sdr-0023) |
Demais minutas em arquitetura-contratual/ |
*.md de apoio (PPSI, análises, etc.) |
Coluna Documentos relacionados do sdr-0003 | 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 passo 4 |
| Índice de processo | processo-contratacao/00_controle_geral/INDICE_PROCESSO.md |
Quando o processo exigir | REGRAS §4 |
| Espelho estático / Firebase | arquitetura-contratual/scripts/sync_site_repositorio.py → site/repositorio/ |
Deploy ou necessidade de leitura offline espelhada | sdr-0017 |
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 (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 — 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 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 + Fase A/B |
Esquecer sync ou índice de busca |
Checklist sdr-0017 |
12. Segurança, LGPD e Auditoria
12.1 Controles de segurança
Não publicar credenciais; seguir gate do site conforme sdr-0017.
12.2 LGPD / privacidade
Não aplicável diretamente a este SDR.
12.3 Auditoria / evidências
PRs e planos de agente (sdr-0021).
13. Rastreabilidade e Validação
13.1 Critérios de aceite globais
- Índice sdr-0003 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 | 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 |
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 §4 | Ordem de trabalho |
| RF-003 | .cursor/rules/sdr-edicao-exclusiva-fonte-verdade.mdc, .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 |
sdr-conformity-checker.md |
| Detector de implementação sem vínculo SDR | implementation-without-sdr-detector.mdc |
implementation-without-sdr-detector.md |
| Anti-vibecoding sem SDR | no-vibecoding-without-sdr.mdc |
no-vibecoding-without-sdr.md |
Processo: governance/README.md · Rastreabilidade código: traceability.md · Checagem: python scripts/check_sdr_conformity.py (na raiz do repositório).