Vocabulário
Define o significado oficial dos termos.
1. Propósito
Este documento converte o modelo conceitual de dados e metadados em uma especificação operacional e verificável.
Definição: o dicionário de dados e metadados é o catálogo normativo dos elementos de informação usados pela Máquina de Conhecimento, indicando significado, estrutura, domínio, obrigatoriedade, integridade, autoria e uso.
Ele não define ainda tabelas físicas, propriedades específicas do Memgraph ou um JSON Schema definitivo. Esses artefatos devem derivar deste dicionário, preservando seu significado.
2. Autoridade e dependência
Modelo conceitual
Define entidades, relações e fronteiras.
Dicionário
Define os campos e suas regras de uso.
Vocabulário → Modelo Conceitual → Dicionário → Modelo Lógico → Persistência Física
Regra de precedência: conflito semântico deve ser resolvido no Vocabulário ou no Modelo Conceitual; conflito de implementação deve ser resolvido nos modelos lógicos, sem alterar silenciosamente este dicionário.
3. Convenções do dicionário
| Coluna | Significado |
|---|---|
| Campo | Nome canônico em português, usado na documentação. |
| Nome técnico | Identificador recomendado em snake_case. |
| Definição | Significado semântico do dado ou metadado. |
| Tipo conceitual | Texto, identificador, data, data-hora, número, booleano, URI, enumeração, referência ou estrutura. |
| Cardinalidade | Quantidade mínima e máxima de ocorrências. |
| Obrigatoriedade | Obrigatório, opcional ou condicional. |
| Domínio | Valores válidos ou vocabulário controlado. |
| Regra | Restrição de integridade ou validação. |
| Exemplo | Valor ilustrativo, não necessariamente definitivo. |
| Autoridade | Documento, papel ou processo responsável pela definição e manutenção. |
Obrigatório necessário para a existência válida do registro. Condicional exigido quando uma condição se verifica. Opcional recomendado quando disponível.
4. Padrões de nomenclatura e identificação
- Nomes canônicos de entidades usam singular e iniciais maiúsculas: Objeto de Conhecimento.
- Nomes técnicos usam
snake_case:objeto_conhecimento_id. - Identificadores são estáveis, opacos e independentes do título ou caminho físico.
- Datas usam ISO 8601:
AAAA-MM-DD; data-hora inclui fuso. - URI e caminho físico não substituem o identificador conceitual.
- Enumerações devem ser mantidas por vocabulário controlado e possuir código estável.
Identidade conceitual ≠ Título ≠ Nome de arquivo ≠ Caminho ≠ URL
5. Catálogo de entidades
| Código | Entidade | Definição | Identificador | Responsabilidade principal |
|---|---|---|---|---|
| OC | Objeto de Conhecimento | Unidade conceitual identificável que reúne significado, relações, versões e representações. | objeto_conhecimento_id | Autor / Curador |
| REP | Representação | Forma concreta pela qual um objeto de conhecimento é expresso. | representacao_id | Autor / Sistema |
| CON | Conceito | Unidade semântica definida e controlada pelo vocabulário. | conceito_id | Curadoria terminológica |
| REL | Relação | Ligação tipada entre entidades ou conceitos. | relacao_id | Autor / Curador |
| JOR | Jornada | Unidade organizadora da transformação orientada por pergunta ou necessidade. | jornada_id | Gestor / Autor |
| AGE | Agente | Pessoa, organização, sistema ou agente de IA que atua sobre o conhecimento. | agente_id | Governança |
| FON | Fonte | Origem documental, observacional ou informacional utilizada. | fonte_id | Autor / Curador |
| EVI | Evidência | Trecho, dado, observação ou registro que sustenta uma afirmação ou validação. | evidencia_id | Autor / Validador |
| VER | Versão | Estado registrado de um objeto ou representação em determinado momento. | versao_id | Sistema / Autor |
| EST | Estado | Situação controlada no ciclo de vida de uma entidade. | estado_id | Governança |
| VAL | Validação | Avaliação registrada segundo critérios explícitos. | validacao_id | Validador / Curador |
| PUB | Publicação | Disponibilização de uma versão em um ambiente e endereço definidos. | publicacao_id | Gestor / Sistema |
| DEC | Decisão | Escolha governada com contexto, alternativas, justificativa e consequência. | decisao_id | Gestor |
| VOC | Vocabulário Controlado | Conjunto governado de termos, códigos e relações semânticas. | vocabulario_id | Curadoria terminológica |
| MET | Registro de Metadados | Conjunto estruturado de propriedades descritivas, administrativas, técnicas e de proveniência. | metadado_id | Sistema / Autor |
6. Entidade Objeto de Conhecimento
| Campo | Nome técnico | Definição | Tipo | Card. | Obrig. | Domínio / regra | Exemplo |
|---|---|---|---|---|---|---|---|
| Identificador | objeto_conhecimento_id | Identidade estável e única do objeto. | Identificador | 1..1 | Obrigatório | Único; imutável; padrão OC-[A-Z0-9-]+. | OC-MC-0001 |
| Título preferido | titulo_preferido | Nome principal de apresentação. | Texto | 1..1 | Obrigatório | Não vazio; até 250 caracteres. | Modelo da Máquina de Conhecimento do LAC |
| Título alternativo | titulo_alternativo | Nome adicional ou histórico. | Texto | 0..n | Opcional | Não duplicar título preferido. | Modelo MC-LAC |
| Descrição | descricao | Síntese do conteúdo e finalidade. | Texto longo | 1..1 | Obrigatório | Deve explicar o objeto sem depender da representação. | Formaliza os elementos... |
| Tipo de objeto | tipo_objeto_codigo | Classe funcional do objeto. | Enumeração | 1..1 | Obrigatório | Vocabulário VOC-TIPO-OC. | modelo_conceitual |
| Domínio | dominio_id | Domínio principal ao qual pertence. | Referência | 0..1 | Condicional | Obrigatório para objetos aplicados a domínio. | DOM-FUNDACAO |
| Idioma | idioma_codigo | Idioma principal do conteúdo conceitual. | Enumeração | 1..n | Obrigatório | BCP 47. | pt-BR |
| Estado vigente | estado_codigo | Estado atual no ciclo de vida. | Enumeração | 1..1 | Obrigatório | Vocabulário de estados. | publicado |
| Responsável | responsavel_id | Agente responsável pela manutenção. | Referência | 1..1 | Obrigatório | Deve referenciar agente ativo. | AGE-WD-001 |
| Jornada de origem | jornada_origem_id | Jornada que produziu ou formalizou o objeto. | Referência | 0..1 | Condicional | Obrigatório para objetos produzidos após adoção do modelo. | JOR-MC-001 |
| Data de criação | criado_em | Data-hora de criação do registro conceitual. | Data-hora | 1..1 | Obrigatório | ISO 8601; imutável. | 2026-07-27T14:30:00-03:00 |
| Data de atualização | atualizado_em | Última alteração relevante. | Data-hora | 1..1 | Obrigatório | Maior ou igual a criado_em. | 2026-07-27T17:10:00-03:00 |
| Versão vigente | versao_vigente_id | Versão conceitual atualmente válida. | Referência | 0..1 | Condicional | Obrigatória a partir do primeiro versionamento. | VER-OC-MC-0001-1.0 |
| Palavras-chave | palavra_chave | Termos de recuperação não necessariamente normativos. | Texto | 0..n | Opcional | Preferir termos do vocabulário controlado. | máquina; conhecimento; modelo |
7. Entidade Representação
| Campo | Nome técnico | Definição | Tipo | Card. | Obrig. | Domínio / regra | Exemplo |
|---|---|---|---|---|---|---|---|
| Identificador | representacao_id | Identidade da representação. | Identificador | 1..1 | Obrigatório | Único e imutável. | REP-MC-HTML-001 |
| Objeto representado | objeto_conhecimento_id | Objeto conceitual exteriorizado. | Referência | 1..1 | Obrigatório | Deve existir. | OC-MC-0001 |
| Tipo de representação | tipo_representacao_codigo | Forma de expressão. | Enumeração | 1..1 | Obrigatório | HTML, texto, imagem, knowgrama, JSON, grafo, banco, áudio, vídeo etc. | html |
| Formato | formato_mime | Formato técnico. | Texto controlado | 1..1 | Obrigatório | MIME type quando aplicável. | text/html |
| Localização | localizacao_uri | URI ou caminho de acesso. | URI | 1..n | Obrigatório | Deve ser resolvível no ambiente indicado. | fundacao/modelo_da_maquina... |
| Idioma | idioma_codigo | Idioma da representação. | Enumeração | 1..1 | Obrigatório | BCP 47. | pt-BR |
| Checksum | checksum | Resumo para verificação de integridade. | Texto | 0..1 | Opcional | Informar algoritmo separadamente. | sha256:... |
| Tamanho | tamanho_bytes | Tamanho físico em bytes. | Inteiro | 0..1 | Opcional | Maior ou igual a zero. | 55279 |
| Acessibilidade | acessibilidade_nota | Recursos e limitações de acessibilidade. | Texto | 0..1 | Opcional | Registrar texto alternativo, contraste e navegação. | HTML semântico e navegação por teclado. |
| Versão da representação | versao_id | Versão específica do arquivo ou forma. | Referência | 1..1 | Obrigatório | Deve pertencer à própria representação. | VER-REP-MC-HTML-1.0 |
8. Entidade Conceito
| Campo | Nome técnico | Definição | Tipo | Obrig. | Regra | Exemplo |
|---|---|---|---|---|---|---|
| Identificador | conceito_id | Identidade estável do conceito. | Identificador | Obrigatório | Único no vocabulário. | CON-MAQUINA-CONHECIMENTO |
| Termo preferido | termo_preferido | Rótulo oficial. | Texto | Obrigatório | Único por idioma e vocabulário. | Máquina de Conhecimento |
| Definição | definicao | Descrição normativa do conceito. | Texto longo | Obrigatório | Não circular; indicar fronteira. | Sistema sociotécnico... |
| Vocabulário | vocabulario_id | Vocabulário que governa o conceito. | Referência | Obrigatório | Vocabulário vigente. | VOC-LAC-001 |
| Termos alternativos | termo_alternativo | Sinônimos, siglas ou formas históricas. | Texto | Opcional | Não usar como termo preferido sem decisão. | MC-LAC |
| Nota de escopo | nota_escopo | Orientação de uso e exclusões. | Texto | Opcional | Explicitar diferenças relevantes. | Não se confunde com agente de IA. |
| Estado terminológico | estado_termo_codigo | Situação no vocabulário. | Enumeração | Obrigatório | proposto, aprovado, obsoleto, histórico. | aprovado |
9. Entidade Relação
| Campo | Nome técnico | Definição | Tipo | Obrig. | Regra | Exemplo |
|---|---|---|---|---|---|---|
| Identificador | relacao_id | Identidade da ocorrência de relação. | Identificador | Obrigatório | Único. | REL-000147 |
| Origem | entidade_origem_id | Entidade de partida. | Referência polimórfica | Obrigatório | Deve existir. | OC-MC-0001 |
| Tipo | tipo_relacao_codigo | Predicado controlado. | Enumeração | Obrigatório | Vocabulário de relações. | deriva_de |
| Destino | entidade_destino_id | Entidade de chegada. | Referência polimórfica | Obrigatório | Deve existir; não pode repetir origem em relações irreflexivas. | OC-TEORIA-MC-001 |
| Direção | direcao_codigo | Direcionalidade semântica. | Enumeração | Obrigatório | direcionada ou simétrica. | direcionada |
| Validade | vigencia_inicio / vigencia_fim | Período de validade. | Data-hora | Opcional | Fim posterior ao início. | 2026-07-27 |
| Fonte da relação | fonte_id | Fonte ou decisão que sustenta a ligação. | Referência | Condicional | Obrigatória para relações inferidas ou normativas. | DEC-MC-004 |
10. Entidade Jornada
| Campo | Nome técnico | Definição | Tipo | Obrig. | Regra | Exemplo |
|---|---|---|---|---|---|---|
| Identificador | jornada_id | Identidade da jornada. | Identificador | Obrigatório | Único. | JOR-MC-001 |
| Título | titulo | Nome da jornada. | Texto | Obrigatório | Deve expressar finalidade. | Formalização da Máquina de Conhecimento |
| Pergunta ativadora | pergunta_ativadora | Pergunta ou necessidade que inicia o percurso. | Texto longo | Obrigatório | Clara e verificável. | Como formalizar... |
| Objetivo | objetivo | Resultado pretendido. | Texto longo | Obrigatório | Coerente com a pergunta. | Produzir teoria, modelo... |
| Estado | estado_codigo | Situação da jornada. | Enumeração | Obrigatório | proposta, ativa, suspensa, concluída, cancelada. | ativa |
| Responsável | responsavel_id | Agente que coordena. | Referência | Obrigatório | Agente ativo. | AGE-WD-001 |
| Critérios de aceitação | criterio_aceitacao | Condições para considerar a jornada concluída. | Estrutura | Obrigatório | Ao menos um critério. | Modelo publicado e validado. |
| Entregas | objeto_entrega_id | Objetos produzidos. | Referência | Condicional | Obrigatório ao concluir. | OC-MC-0001 |
11. Entidade Agente
| Campo | Nome técnico | Definição | Tipo | Obrig. | Regra | Exemplo |
|---|---|---|---|---|---|---|
| Identificador | agente_id | Identidade do agente. | Identificador | Obrigatório | Único. | AGE-WD-001 |
| Tipo | tipo_agente_codigo | Natureza do agente. | Enumeração | Obrigatório | pessoa, organização, sistema, agente_ia. | pessoa |
| Nome | nome_exibicao | Nome usado nas interfaces. | Texto | Obrigatório | Não vazio. | Walter Dominguez |
| Papéis | papel_codigo | Funções desempenhadas. | Enumeração | Obrigatório | Vocabulário de papéis; múltiplos permitidos. | autor; gestor |
| Identificador externo | identificador_externo | ORCID, e-mail institucional ou ID de sistema. | Texto/URI | Opcional | Registrar esquema. | ORCID... |
| Estado | estado_agente_codigo | Situação de participação. | Enumeração | Obrigatório | ativo, inativo, suspenso. | ativo |
12. Entidades Fonte e Evidência
| Campo | Nome técnico | Definição | Obrig. | Regra | Exemplo |
|---|---|---|---|---|---|
| Identificador | fonte_id | Identidade da fonte. | Obrigatório | Único. | FON-LIVRO-001 |
| Tipo | tipo_fonte_codigo | Natureza da fonte. | Obrigatório | livro, artigo, página, documento interno, entrevista, observação, base de dados. | documento_interno |
| Citação | citacao | Descrição suficiente para identificação. | Obrigatório | Padrão bibliográfico quando aplicável. | DOMINGUEZ... |
| Localização | localizacao_uri | Endereço ou referência física. | Condicional | Obrigatória quando acessível digitalmente. | fundacao/... |
| Data de acesso | acessado_em | Data de consulta. | Condicional | Obrigatória para conteúdo mutável. | 2026-07-27 |
| Campo | Nome técnico | Definição | Obrig. | Regra | Exemplo |
|---|---|---|---|---|---|
| Identificador | evidencia_id | Identidade da evidência. | Obrigatório | Único. | EVI-MC-001 |
| Fonte | fonte_id | Origem da evidência. | Obrigatório | Fonte existente. | FON-DOC-001 |
| Localizador | localizador | Página, seção, linha, intervalo ou coordenada. | Obrigatório | Preciso o suficiente para recuperação. | Seção 4, §2 |
| Conteúdo resumido | conteudo_resumido | Paráfrase ou descrição da evidência. | Obrigatório | Não substituir indevidamente o original. | O modelo distingue objeto... |
| Força | forca_evidencia_codigo | Grau atribuído à evidência. | Opcional | fraca, moderada, forte; requer critério declarado. | forte |
13. Entidade Versão
| Campo | Nome técnico | Definição | Obrig. | Regra | Exemplo |
|---|---|---|---|---|---|
| Identificador | versao_id | Identidade da versão. | Obrigatório | Único. | VER-OC-MC-0001-1.0 |
| Entidade versionada | entidade_id | Objeto, representação ou vocabulário versionado. | Obrigatório | Deve existir. | OC-MC-0001 |
| Número | numero_versao | Rótulo ordenável da versão. | Obrigatório | SemVer quando aplicável; caso contrário política declarada. | 1.0 |
| Tipo de mudança | tipo_mudanca_codigo | Natureza predominante da alteração. | Obrigatório | editorial, corretiva, ampliativa, estrutural, conceitual, ruptura. | conceitual |
| Descrição da mudança | descricao_mudanca | Resumo das alterações. | Obrigatório | Clara e verificável. | Inclusão do modelo formal. |
| Versão anterior | versao_anterior_id | Predecessora imediata. | Condicional | Obrigatória exceto na primeira versão. | VER-...-0.9 |
| Criada por | criado_por_id | Agente responsável. | Obrigatório | Agente existente. | AGE-WD-001 |
| Criada em | criado_em | Data-hora da versão. | Obrigatório | ISO 8601. | 2026-07-27T17:00:00-03:00 |
14. Entidade Validação
| Campo | Nome técnico | Definição | Obrig. | Regra | Exemplo |
|---|---|---|---|---|---|
| Identificador | validacao_id | Identidade do ato de validação. | Obrigatório | Único. | VAL-MC-001 |
| Objeto avaliado | entidade_id | Entidade ou versão examinada. | Obrigatório | Preferir versão específica. | VER-OC-MC-0001-1.0 |
| Critério | criterio_codigo | Critério aplicado. | Obrigatório | Vocabulário de qualidade. | coerencia |
| Resultado | resultado_codigo | Conclusão da avaliação. | Obrigatório | aprovado, aprovado_com_ressalva, reprovado, inconclusivo. | aprovado |
| Observação | observacao | Justificativa e achados. | Obrigatório | Deve sustentar o resultado. | Não foram identificadas... |
| Validador | validador_id | Agente que realizou. | Obrigatório | Agente com papel adequado. | AGE-WD-001 |
| Data | validado_em | Momento da validação. | Obrigatório | ISO 8601. | 2026-07-27 |
15. Entidade Publicação
| Campo | Nome técnico | Definição | Obrig. | Regra | Exemplo |
|---|---|---|---|---|---|
| Identificador | publicacao_id | Identidade do ato de publicação. | Obrigatório | Único. | PUB-MC-001 |
| Versão publicada | versao_id | Versão disponibilizada. | Obrigatório | Versão existente e validada quando exigido. | VER-REP-MC-HTML-1.0 |
| Ambiente | ambiente_codigo | Ambiente de disponibilização. | Obrigatório | desenvolvimento, validacao, producao, legado. | producao |
| Localização | localizacao_uri | Endereço publicado. | Obrigatório | Único por ambiente e período. | https://meulivro.info/... |
| Público | publico_codigo | Grupo autorizado. | Obrigatório | publico, restrito, privado. | publico |
| Publicado por | publicado_por_id | Agente responsável. | Obrigatório | Agente com permissão. | AGE-WD-001 |
| Publicado em | publicado_em | Data-hora de início. | Obrigatório | ISO 8601. | 2026-07-27T18:00:00-03:00 |
| Retirado em | retirado_em | Fim da vigência pública. | Opcional | Posterior à publicação. | — |
16. Entidade Decisão
| Campo | Nome técnico | Definição | Obrig. | Regra | Exemplo |
|---|---|---|---|---|---|
| Identificador | decisao_id | Identidade da decisão. | Obrigatório | Único. | DEC-MC-004 |
| Título | titulo | Resumo da escolha. | Obrigatório | Objetivo e conciso. | Separar objeto e representação |
| Contexto | contexto | Situação que exigiu a decisão. | Obrigatório | Explicitar problema e restrições. | O mesmo conteúdo possui... |
| Alternativas | alternativa | Opções consideradas. | Obrigatório | Duas ou mais, salvo impossibilidade justificada. | Identidade por arquivo; identidade conceitual. |
| Escolha | escolha | Alternativa adotada. | Obrigatório | Deve corresponder a uma alternativa. | Identidade conceitual independente. |
| Justificativa | justificativa | Razões da escolha. | Obrigatório | Relacionar critérios e consequências. | Permite múltiplas representações... |
| Estado | estado_decisao_codigo | Situação da decisão. | Obrigatório | proposta, aprovada, substituída, revogada. | aprovada |
17. Entidade Vocabulário Controlado
| Campo | Nome técnico | Definição | Obrig. | Regra | Exemplo |
|---|---|---|---|---|---|
| Identificador | vocabulario_id | Identidade do vocabulário. | Obrigatório | Único. | VOC-LAC-001 |
| Título | titulo | Nome oficial. | Obrigatório | Não vazio. | Vocabulário do LAC |
| Escopo | escopo | Campo semântico coberto. | Obrigatório | Delimitar inclusões e exclusões. | Termos estruturais e... |
| Versão vigente | versao_vigente_id | Versão atualmente válida. | Obrigatório | Versão publicada. | VER-VOC-LAC-2026.07 |
| Responsável | responsavel_id | Agente curador. | Obrigatório | Papel de curadoria. | AGE-WD-001 |
| Política de mudança | politica_mudanca | Procedimento de inclusão, alteração e obsolescência. | Obrigatório | Deve prever rastreabilidade. | Novos termos passam por... |
18. Classes de metadados
| Classe | Finalidade | Campos típicos | Autoridade |
|---|---|---|---|
| Descritivos | Identificação, descoberta e compreensão. | título, descrição, tipo, assunto, idioma, palavras-chave. | Autor / Curador |
| Estruturais | Composição e relações internas. | parte_de, possui_parte, ordem, dependência, representação. | Autor / Arquitetura |
| Administrativos | Gestão e responsabilidade. | responsável, estado, acesso, retenção, licença. | Governança |
| Técnicos | Processamento e preservação. | formato, MIME, tamanho, checksum, software, requisitos. | Sistema / Arquitetura |
| Proveniência | Origem e histórico. | criado_por, derivado_de, fonte, atividade, data. | Sistema / Autor |
| Qualidade | Avaliação e confiança. | critério, resultado, validador, completude, atualidade. | Validador / Qualidade |
| Uso e aprendizagem | Aplicação, interação e retorno. | jornada, público, uso, feedback, resultado, lacuna. | Gestão / Aprendizagem |
| Governança e decisão | Regras, conformidade e mudança. | decisão, política, risco, aprovação, auditoria. | Gestor |
19. Domínios controlados iniciais
| Domínio | Código | Valores iniciais | Observação |
|---|---|---|---|
| Tipo de objeto | VOC-TIPO-OC | teoria, princípio, método, modelo, arquitetura, política, jornada, página, knowgrama, relatório, decisão, vocabulário, índice, mapa, aplicação. | Extensível por governança. |
| Tipo de representação | VOC-TIPO-REP | texto, html, imagem, knowgrama, tabela, json, grafo, banco_relacional, áudio, vídeo, apresentação. | Não confundir com formato MIME. |
| Estado do objeto | VOC-ESTADO-OC | proposto, em_construcao, em_validacao, aprovado, publicado, suspenso, substituido, obsoleto, arquivado. | Transições devem ser controladas. |
| Tipo de relação | VOC-TIPO-REL | deriva_de, especializa, orienta, implementa, representa, parte_de, relaciona_se_com, substitui, sustenta, evidencia, produzido_por, usado_em. | Cada tipo deve declarar direção e inversa. |
| Papel | VOC-PAPEL | visitante, aprendiz, colaborador, autor, curador, mentor, gestor, validador, sistema, agente_ia. | Agente pode exercer múltiplos papéis. |
| Ambiente | VOC-AMBIENTE | desenvolvimento, validacao, producao, legado. | Alinhado à arquitetura de implantação. |
| Resultado de validação | VOC-RESULTADO-VAL | aprovado, aprovado_com_ressalva, reprovado, inconclusivo. | Resultado exige observação. |
| Nível de acesso | VOC-ACESSO | publico, restrito, privado. | Pode ser refinado futuramente. |
20. Regras globais de integridade
- Todo registro deve possuir identificador estável e único.
- Todo objeto de conhecimento publicado deve possuir ao menos uma representação publicada.
- Toda representação deve referenciar exatamente um objeto de conhecimento.
- Todo objeto publicado deve possuir responsável, versão vigente, estado e data de atualização.
- Toda relação deve possuir origem, tipo e destino válidos.
- Relações normativas ou inferidas devem possuir fonte, evidência ou decisão associada.
- Termos normativos devem pertencer a vocabulário controlado vigente.
- Versões não podem ser apagadas quando já utilizadas em publicação, decisão ou validação.
- Publicação em produção deve apontar para versão aprovada ou justificar exceção.
- Recursos substituídos devem indicar sucessor e data de encerramento.
- Dados pessoais e restritos devem possuir finalidade, nível de acesso e prazo de retenção.
- Alterações conceituais devem registrar versão e, quando relevantes, decisão.
21. Perfil mínimo de metadados
O perfil mínimo permite registrar objetos antes da implementação completa.
| Campo mínimo | Objeto | Representação | Publicação |
|---|---|---|---|
| Identificador | Obrigatório | Obrigatório | Obrigatório |
| Título ou tipo | Título obrigatório | Tipo obrigatório | Ambiente obrigatório |
| Descrição | Obrigatória | Opcional | Opcional |
| Responsável | Obrigatório | Herdado ou explícito | Obrigatório |
| Estado / versão | Obrigatórios | Versão obrigatória | Versão publicada obrigatória |
| Localização | Opcional | Obrigatória | Obrigatória |
| Datas | Criação e atualização | Criação | Publicação |
| Jornada de origem | Condicional | Herdada | Opcional |
Perfil mínimo = identidade + título + descrição + tipo + estado + responsável + versão + datas + representação
22. Exemplo de registro integrado
OC-MC-0001 → REP-MC-HTML-001 → VER-REP-MC-HTML-1.0 → PUB-MC-001
| Entidade | Campos principais |
|---|---|
| Objeto de Conhecimento | objeto_conhecimento_id=OC-MC-0001; título=Modelo da Máquina de Conhecimento do LAC; tipo=modelo_conceitual; estado=publicado. |
| Representação | representacao_id=REP-MC-HTML-001; tipo=html; formato=text/html; localização=fundacao/modelo_da_maquina_de_conhecimento_lac.html. |
| Versão | versao_id=VER-REP-MC-HTML-1.0; número=1.0; tipo de mudança=conceitual. |
| Publicação | publicacao_id=PUB-MC-001; ambiente=produção; público=público; domínio=meulivro.info. |
| Relação | Modelo deriva_de Teoria da Máquina de Conhecimento e orienta Arquitetura da Máquina de Conhecimento. |
23. Orientação para modelos lógicos
Relacional
Entidades principais tornam-se tabelas; relações n:n usam tabelas associativas; domínios controlados tornam-se tabelas de referência.
Grafo
Objetos, agentes, conceitos, jornadas e fontes tornam-se nós; relações tipadas tornam-se arestas com proveniência.
JSON
Objeto de conhecimento pode ser documento raiz, com referências para representações, versões, relações e metadados.
Regra: o mesmo nome técnico deve ser reutilizado sempre que o significado for equivalente, evitando traduções divergentes entre SQL, Cypher, JSON e HTML.
24. Critérios de qualidade do dicionário
Clareza
Cada campo possui uma única interpretação principal.
Completude
Entidades críticas possuem identidade, responsabilidade, estado e histórico.
Consistência
Nomes, tipos e domínios não se contradizem.
Rastreabilidade
Campo e regra podem ser relacionados à sua autoridade.
Implementabilidade
A especificação pode derivar para SQL, grafo e JSON.
Evolutividade
Novos campos e domínios podem ser incorporados por versão e governança.
25. Governança do dicionário
| Mudança | Tratamento | Impacto de versão |
|---|---|---|
| Correção ortográfica sem mudança semântica | Revisão editorial. | Patch. |
| Nova descrição ou exemplo | Revisão documental. | Patch ou minor. |
| Novo campo opcional | Avaliação de compatibilidade. | Minor. |
| Novo campo obrigatório | Plano de migração e decisão. | Major. |
| Alteração de definição, domínio ou cardinalidade | Decisão de governança e análise de impacto. | Major. |
| Obsolescência de campo | Marcar como obsoleto, indicar sucessor e prazo. | Minor ou major. |
26. Documentos relacionados
Antecedentes
Derivações
- Perfil de Aplicação de Metadados do LAC
- Modelo Lógico Relacional
- Modelo Lógico de Grafo para Memgraph
- JSON Schema dos Objetos de Conhecimento
- Catálogo de Vocabulários Controlados
- Regras automatizadas de validação
27. Síntese
O dicionário transforma entidades e relações conceituais em especificações de dados suficientemente precisas para orientar implementação, integração, validação e governança.
Conclusão: cada objeto de conhecimento deve possuir identidade própria; cada representação deve ser vinculada ao objeto que expressa; cada mudança deve ser versionada e rastreável; e cada publicação deve indicar versão, ambiente, endereço, público e responsabilidade.
28. Estado do documento
Versão 1.0 — dicionário inicial consolidado
FundaçãoDocumento apto a orientar o perfil mínimo de metadados, o modelo lógico relacional, o modelo lógico de grafo, o JSON Schema e as regras automatizadas de validação.
Próximas derivações recomendadas
- Formalizar o Perfil de Aplicação de Metadados do LAC.
- Produzir o modelo lógico relacional.
- Produzir o modelo lógico de grafo para Memgraph.
- Produzir o JSON Schema dos objetos de conhecimento.
- Criar o catálogo de vocabulários controlados.
- Atualizar o índice da Fundação.