Fonte: SDRs/sdr-0024-cmdb-taxonomia-referencia-projeto.md
SDR-0024 — CMDB: taxonomia (CI, componente, serviço, papel, documento), referência do projeto e matriz C1/C2/C3
Eixo:
Ambos(Modelo de Serviços | Arquitetura Contratual | Ambos)
1. Metadados
| Campo | Valor |
|---|---|
| ID | sdr-0024-cmdb-taxonomia-referencia-projeto |
| Pai | — |
| Título | CMDB: taxonomia de entidades, referência curada do repositório (facility / TI / software), gestão versus remunerabilidade e matriz de ações por contrato |
| Versão | v0.1 |
| Data | 2026-05-04 |
| Autor | Elias Cotrim |
| Revisores | (pendente) |
| Status | Em validação |
| Substitui | — |
| Substituído por | — |
| Classificação | Interno |
| Eixo | Ambos |
| Domínio | Metamodelo CMDB, listas de referência em Informacoes-gerais/, alinhamento a IMR e catálogo remunerável |
| Stakeholders | Contratação; C1-GOV, C2-OPR, C3-SEC; gestão de configuração; curadoria do repositório |
| SDRs relacionados | sdr-0011a, sdr-0020, sdr-0023, sdr-0023a, sdr-0023c, sdr-0001, sdr-0002, sdr-0022 |
2. Controle de Revisão
| Versão | Data | Autor | Mudanças |
|---|---|---|---|
| v0.1 | 2026-05-04 | Elias Cotrim | Criação: taxonomia, meta de 800 itens em três arquivos, modelo de linha, matriz C1/C2/C3, remissões |
3. Objetivo
Normatizar a taxonomia de entidades relacionadas à CMDB e à gestão de TI (CI, Componente, Serviço, Papel, Documento), a referência curada do projeto em ../Informacoes-gerais/ (três escopos: facility, TI/infra, software/entrega), a separação entre gestão (inventário necessário) e remuneração (catálogo/opt-in), o colapso de dimensões em atributos e a matriz de tipos de ação dos contratos C1-GOV, C2-OPR e C3-SEC sobre categorias de itens — sem substituir o TR/ANS nem duplicar o catálogo remunerável (sdr-0023a).
4. Escopo e Abstração
4.1 Dentro do escopo
- Definições operacionais dos cinco tipos de metamodelo (§8.1).
- Modelo de linha obrigatório para itens da referência do repositório (§8.2).
- Meta de curadoria: 800 itens no total nos três arquivos; repartição flexível entre escopos (orientação indicativa: até 250 facility, até 150 software/plataforma, restante TI/infra — ajustável por versão deste SDR se a curadoria justificar).
- Deferência: o TR/ANS pode prever contagens, catálogos ou listas diferentes por especialidade contratual; a referência do repositório é base normativa de modelo, não substitui cláusula negociada.
- Caráter referencial (~800 itens): a soma-alvo de linhas nos três arquivos em
Informacoes-gerais/é taxonomia e inventário de referência do projeto para modelagem, auditoria e alinhamento ao metamodelo — não é, por si só, lista exaustiva remunerável nem catálogo opt-in de IC; estes permanecem em sdr-0023a e no instrumento. - Matriz C1/C2/C3 como padrão do modelo de serviços do repositório (§8.3).
- Remissão a premissas de IC faturável versus cliente e componente constitutivo: ADR-0001.
4.2 Fora do escopo
- Split, fatores de preço-IC, lista exaustiva remunerável e admissão extraordinária — donos: sdr-0023, sdr-0023a, sdr-0023b, sdr-0023c.
- Dados Ibama, KML, mapa web — dono: sdr-0020 (
itens-configuracao-cmdb-top100.mdcomo referência de tipos, não como substituto desta taxonomia). - Implementação de software de CMDB ou ITSM.
4.3 Nível de abstração
Regras de modelagem e de redação de listas; valores monetários e percentuais ficam nos instrumentos.
4.4 Proposta e revisão de itens da referência
- Proposta (C2-OPR): o operador pode propor inclusão, exclusão ou alteração de linhas na referência, com justificativa e, quando couber, métricas de uso, incidente ou relevância de gestão.
- Avaliação (C1-GOV): consolida consistência com o metamodelo deste SDR (§8.1–8.2), qualidade de dado e impacto em medição/IMR — sem substituir decisão da Administração sobre remunerabilidade.
- Deliberação da Administração: decisão para efeito de instrumento (TR/ANS), inclusão no catálogo remunerável quando aplicável (sdr-0023a) e comunicação aos três polos contratuais.
- Revisão periódica: recomenda-se ciclo de curadoria em 6 e 12 meses (ou conforme TR) para evitar obsolescência da referência sem confundir revisão de inventário com revisão de preço ou split.
5. Contexto e Síntese Executiva
5.1 Problema
Listas extensas geradas sem metamodelo misturam CI, componente, papel e documento, inflam contagens e conflitam com remuneração por IC e com a gestão real da CMDB.
5.2 Solução proposta (resumo)
Taxonomia única neste SDR; três arquivos de referência curada totalizando 800 linhas com justificativa; dimensões (ambiente, criticidade, etc.) como atributos; vínculo explícito à matriz C1/C2/C3; gestão independe de remunerabilidade.
5.3 Benefícios esperados
Menos dívida de dados, alinhamento ao sdr-0011a e ao catálogo sdr-0023a, e defesa em auditoria.
5.4 Riscos se não implementado
Ambiguidade entre inventário “cheio” e base pagável; litígio sobre o que é IC.
6. Slides Executivos
- 5 tipos de metamodelo — não tudo é CI pagável.
- 800 linhas curadas — 3 arquivos (facility / TI / software).
- Atributos em vez de explosão combinatória.
- C1 / C2 / C3 — papéis típicos por categoria.
- TR/ANS prevalece sobre números do repositório quando divergir.
7. Restrições Globais, Não-Funcionais e Critérios de Sucesso
7.1 Restrições técnicas
- Identificadores estáveis na CMDB quando o item for CI ou Componente versionável.
7.2 Restrições de negócio / compliance
- LGPD: dados pessoais em Papel ou Documento seguem sdr-0014 quando aplicável.
7.3 Critérios de sucesso mensuráveis
- Três arquivos em
Informacoes-gerais/somam 800 linhas de tabela + justificativa. - Nenhuma linha da referência contradiz explicitamente ADR-0001 sem nota de exceção pactuada.
8. Design / Arquitetura
8.1 Metamodelo (definições)
| Tipo | Definição | Uso típico na CMDB | Remuneração (regra geral) |
|---|---|---|---|
| CI | Item de configuração com identidade própria, ciclo de vida e relacionamentos na base | Sim | Só se opt-in / catálogo / lista exaustiva (sdr-0023a) |
| Componente | Parte que compõe um CI para entregar função; sem autonomia de serviço distinta | Sim (como filho/relacionado) | Não como segundo IC do mesmo serviço (ADR-0001; sdr-0023c) |
| Serviço | Serviço de TI entregue ao negócio; pode mapear a um ou vários CIs | Opcional (como CI de serviço ou como registro em ITSM) | Conforme instrumento; muitas vezes não IC faturável isolado |
| Papel | Função organizacional (pessoa/equipe/fornecedor) | RACI, dono, aprovador — não substitui CI | Não |
| Documento | Norma interna, diagrama, mapa de alto nível, procedimento | Anexo, link, versão — não confundir com CI físico | Não |
8.2 Modelo de linha (referência Informacoes-gerais/)
Cada linha das tabelas dos três arquivos deve conter as colunas:
| Coluna | Conteúdo |
|---|---|
| ID | Identificador curto estável (ex.: FAC-001, TI-042) |
| Nome | Nome do item |
| TipoMeta | CI | Componente | Serviço | Papel | Documento |
| Atributos_chave | Ex.: ambiente=Prod,Homolog; criticidade=Alta; remoto=Sim — sem duplicar linha por valor |
| Gestão_CMDB | Sim se o registro é exigido para gestão de TI no escopo do projeto |
| Remun_tipico | Se catálogo | Não | Opcional — não vincula pagamento; remete a sdr-0023a |
| C1-GOV | Tipo de ação típica (medição, ateste, qualidade de dado, congelamento) |
| C2-OPR | Tipo de ação típica (operação, mudança, incidente) |
| C3-SEC | Tipo de ação típica (proteção, detecção, continuidade aplicável) |
| Justificativa | 1–3 frases: por que o item existe na referência e como evita redundância |
8.3 Matriz de ações por contrato (padrão do repositório)
Texto orientativo para preenchimento das colunas C1/C2/C3 por categoria de item (detalhe no TR/ANS):
| Categoria exemplo | C1-GOV (típico) | C2-OPR (típico) | C3-SEC (típico) |
|---|---|---|---|
| Facility / predial | Medição de disponibilidade ambiental; evidência em fiscalização | Operação e manutenção de infra física | Controles quando houver segurança física/lógica do perímetro |
| TI / infra | Congelamento; IMR; qualidade do dado da CMDB | Operação N1–N3; mudança; capacidade | Patch, segmentação, monitoramento de segurança em ativos sob escopo C3 |
| Software / plataforma | Ateste de release; consistência de dados de aplicação | SRE; deploy; suporte a app | Segurança de aplicação; segredos; conformidade |
Deferência: se o TR/ANS atribuir ações diferentes, prevalece o instrumento.
8.4 Arquivos de referência do repositório
| Arquivo | Escopo |
|---|---|
Informacoes-gerais/referencia-cmdb-facility.md |
Energia, climatização, segurança física, infra física de TI estrutural |
Informacoes-gerais/referencia-cmdb-ti-infra.md |
Rede, servidores, virtualização, storage, backup, SO, segurança cibernética operacional em infra |
Informacoes-gerais/referencia-cmdb-software-entrega.md |
Containers, middleware, apps, observabilidade, dados/BI, entrega |
Geração: script ../scripts/gerar_referencia_cmdb_informacoes_gerais.py a partir do legado cmdb_datacenter_itens_configuracao-LEGADO-IA.md (curadoria mecânica v0.1; revisões humanas devem ajustar TipoMeta e justificativas).
9. Processos e Integrações
9.1 Processos afetados
Modelagem de CMDB, elaboração de TR/ANS, implantação, fiscalização.
9.2 Integrações
9.3 SLAs / tempos
Definidos no ANS; este SDR não fixa prazos numéricos.
10. Dados, Modelos e Classificações
10.1 Entidades / glossário
- Referência do repositório: conjunto versionado dos três arquivos Markdown em
Informacoes-gerais/+README.md. - Legado IA: lista não curada preservada apenas como fonte histórica de extração.
10.2 Modelos de dados
Campos mínimos: ver §8.2.
10.3 Classificações (LGPD, criticidade, etc.)
Atributos; não duplicar linhas por valor de classificação.
11. Controles de Exclusividade e Risco
11.1 Exclusividade / fonte única
Este SDR é dono, entre sdr-*.md, da taxonomia de cinco tipos (CI, Componente, Serviço, Papel, Documento) para a referência do projeto, do modelo de linha das tabelas em Informacoes-gerais/ e da matriz orientadora C1/C2/C3 sobre categorias de itens da referência.
11.2 Riscos e mitigação
| Risco | Mitigação |
|---|---|
| Confundir referência com lista exaustiva remunerável | Remissão explícita a sdr-0023a |
| Reinflar listas | Teto 800; revisão de versão do SDR |
12. Segurança, LGPD e Auditoria
12.1 Controles de segurança
Não publicar credenciais nas tabelas de referência.
12.2 LGPD / privacidade
Papel com pessoas: minimização e base legal no instrumento do órgão.
12.3 Auditoria / evidências
Versão do sdr-0024 e commit Git das alterações em Informacoes-gerais/.
13. Rastreabilidade e Validação
13.1 Critérios de aceite globais
- sdr-0003 aponta este SDR como dono do tópico.
- Soma das linhas das três tabelas = 800 (ver rodapé de cada arquivo).
13.2 Validações automáticas (quando existirem)
python scripts/check_sdr_conformity.py
13.3 Validações manuais
Curadoria humana de TipoMeta e justificativas após a primeira geração a partir do legado.
14. Matriz de Implementações Dependentes e Riscos
| Implementação | Depende de | Risco se atrasar |
|---|---|---|
| Curadoria das 800 linhas | Tempo da equipe | TipoMeta genérico demais |
15. Histórico de Mudanças Governadas
| Data | Mudança | SDR / proposta |
|---|---|---|
| 2026-05-04 | Criação v0.1 | sdr-0024 |
16. Propostas Governadas (alternativas)
- Quatro arquivos (separar segurança cibernética) — se o ANS exigir; atualizar meta de linhas neste SDR.
17. Requisitos
17.1 Requisitos funcionais
| ID | Requisito | Prioridade | Aceite quando |
|---|---|---|---|
| RF-001 | Publicar taxonomia de cinco tipos | Alta | §8.1 deste SDR |
| RF-002 | Publicar modelo de linha das tabelas | Alta | §8.2 |
| RF-003 | Manter três arquivos + soma 800 linhas | Alta | Contagem nos rodapés |
| RF-004 | Colapsar dimensões em atributos | Alta | Coluna Atributos_chave sem combinatória proibida no §8.2 |
| RF-005 | Matriz C1/C2/C3 orientadora | Média | §8.3 |
17.2 Rastreabilidade implementação ↔ requisito
| Requisito | Arquivo / componente | Observação |
|---|---|---|
| RF-001–RF-005 | Informacoes-gerais/*.md, scripts/gerar_referencia_cmdb_informacoes_gerais.py |
Script não substitui revisão humana |
17.3 Requisitos não-funcionais
| ID | Requisito | Métrica |
|---|---|---|
| RNF-001 | Versionamento do SDR e dos arquivos de referência | Data + versão em README.md |
18. Checklist de Governança
- [x] Metadados completos (seção 1)
- [x] Status
Em validação - [x] Fonte única entre SDRs respeitada
- [x] Sem exigir código de produto além do script de geração documental
- [ ] Revisores quando
Aprovado
18.1 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).
Ligações
Consumidores
TR, ANS, Informacoes-gerais/, curadoria do repositório, agentes (Cursor).