# 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-0011a-c1-itsm-cmdb-noc-medicao.md), [sdr-0020](./sdr-0020-dados-ibama-mapa-ativos-cmdb-kml.md), [sdr-0023](./sdr-0023-remuneracao-por-ic-modelo.md), [sdr-0023a](./sdr-0023a-catalogo-ic-por-contrato.md), [sdr-0023c](./sdr-0023c-aninhamento-ic-isolado-contrapesos.md), [sdr-0001](./sdr-0001-arquitetura-tres-contratos.md), [sdr-0002](./sdr-0002-imr-unidades-e-evidencias.md), [sdr-0022](./sdr-0022-repositorio-convencoes-e-construcao.md) | --- ## 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/`](../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](./sdr-0023a-catalogo-ic-por-contrato.md)). --- ## 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](./sdr-0023a-catalogo-ic-por-contrato.md) 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](../docs/architecture/adrs/0001-ic-servidor-do-servico-vs-cliente.md). ### 4.2 Fora do escopo - **Split**, fatores de preço-IC, lista exaustiva remunerável e admissão extraordinária — donos: [sdr-0023](./sdr-0023-remuneracao-por-ic-modelo.md), [sdr-0023a](./sdr-0023a-catalogo-ic-por-contrato.md), [sdr-0023b](./sdr-0023b-fatores-remuneracao-ic.md), [sdr-0023c](./sdr-0023c-aninhamento-ic-isolado-contrapesos.md). - **Dados Ibama**, KML, mapa web — dono: [sdr-0020](./sdr-0020-dados-ibama-mapa-ativos-cmdb-kml.md) (`itens-configuracao-cmdb-top100.md` como 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 1. **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. 2. **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**. 3. **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](./sdr-0023a-catalogo-ic-por-contrato.md)) e comunicação aos três polos contratuais. 4. **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](./sdr-0011a-c1-itsm-cmdb-noc-medicao.md) e ao catálogo [sdr-0023a](./sdr-0023a-catalogo-ic-por-contrato.md), 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](./sdr-0014-ppsi-lgpd-conformidade.md) 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](../docs/architecture/adrs/0001-ic-servidor-do-servico-vs-cliente.md) 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](./sdr-0023a-catalogo-ic-por-contrato.md)) | | **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](./sdr-0023c-aninhamento-ic-isolado-contrapesos.md)) | | **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](./sdr-0023a-catalogo-ic-por-contrato.md) | | **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`](../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`](../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`](../Informacoes-gerais/referencia-cmdb-software-entrega.md) | Containers, middleware, apps, observabilidade, dados/BI, entrega | **Geração:** script [`../scripts/gerar_referencia_cmdb_informacoes_gerais.py`](../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 - ITSM / CMDB ([sdr-0011a](./sdr-0011a-c1-itsm-cmdb-noc-medicao.md)). - Catálogo remunerável ([sdr-0023a](./sdr-0023a-catalogo-ic-por-contrato.md)). ### 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](./sdr-0023a-catalogo-ic-por-contrato.md) | | 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](./sdr-0003-indice-fonte-unica.md) 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`](../.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). --- ## Ligações - [sdr-0003-indice-fonte-unica.md](./sdr-0003-indice-fonte-unica.md) ## Consumidores TR, ANS, `Informacoes-gerais/`, curadoria do repositório, agentes (Cursor).