--- title: Dicionário técnico description: >- Documenta campos físicos, seu contexto de repositório e seu vínculo verificável com atributos do catálogo de negócios. audiencia: >- Engenheiro de dados | Curador de dados | Responsável pelos dados | Administrador roles: >- Engenheiro de dados e Administrador para gestão técnica; Curador de dados e Responsável pelos dados para enriquecer o significado dentro do escopo modulo: Dicionário técnico revision: '2026-10-19' section: administrar-tecnicamente order: 20 sources: - CONTEXT.md - ARCHITECTURE.md - TESTING_GUIDE.md - Modelodeobjetosyrelaciones.md - Módulosydependencias.md - 'Roles,capacidadesyalcance.md' - Cómoleerelmapaderelaciones.md locale: pt-br --- # Dicionário técnico O **Dicionário técnico** conecta a linguagem de negócios às evidências físicas registradas em uma fonte. Cada campo do dicionário é contextualizado pelo seu Repositório e pode armazenar os dados técnicos disponíveis, como esquema, tabela, coluna, tipo e características físicas. Quando o vínculo é real, o campo é associado a um Atributo da taxonomia para tornar visível onde um conceito de negócio se materializa. O dicionário é editável: os metadados provenientes das fontes fornecem contexto físico, e as pessoas responsáveis podem completar ou corrigir descrições e definições de negócio. Ele não traduz nem modifica automaticamente os nomes dinâmicos que a organização já utiliza; o idioma da interface não altera esses dados. ## Antes de começar **Papel.** O **Engenheiro de dados** administra campos, metadados e associações técnicas com `technical.manage` nos Repositórios que lhe foram atribuídos. O **Administrador** tem esse escopo em toda a empresa. O Curador de dados e o Responsável pelos dados podem enriquecer descrições e definições nos Domínios ou Subdomínios autorizados; sua participação não substitui o escopo técnico do repositório. **Módulo.** **Dicionário técnico** e **Repositórios de dados** devem estar habilitados. O primeiro depende do segundo: não há um dicionário técnico útil sem um repositório registrado. Um módulo desativado não pode ser operado, mesmo que alguém conheça um caminho de acesso. **Pré-condições.** Comece com uma taxonomia que contenha o Domínio, a Entidade e o Atributo que se pretende documentar, e com um Repositório que represente a fonte física. Verifique também se a associação proposta é verificável; não a deduza apenas porque dois nomes são parecidos. ## Percurso recomendado 1. **Esclareça o significado antes de associar.** Localize o Atributo na sua Entidade e no contexto do Domínio ou Subdomínio. Revise seu nome e sua definição funcional com o Curador de dados ou o Responsável pelos dados responsável, quando necessário. 2. **Identifique o contexto físico.** Selecione ou registre o campo dentro do Repositório correspondente. Preserve os dados técnicos que permitam identificá-lo — por exemplo, esquema, tabela, coluna e tipo — sem incluir segredos nem detalhes de acesso. 3. **Registre a relação física verificada.** Associe o campo ao Atributo somente se ele representar esse elemento de informação. A associação direta documenta o vínculo; o contexto do Domínio e do Subdomínio pode ser obtido pela cadeia Atributo → Entidade → taxonomia. 4. **Enriqueça o registro.** Acrescente uma descrição que explique a correspondência entre o nome físico e o significado de negócio. Diferencie claramente uma convenção técnica de uma definição de negócio, para que o leitor saiba qual parte foi obtida da fonte e qual é mantida editorialmente. 5. **Revise no contexto das relações.** No detalhe técnico do mapa, é possível acompanhar o percurso Atributo ↔ Campo do Dicionário técnico ↔ Repositório, junto com esquema, tabela e coluna, quando registrados. A ausência de uma linha significa que não há uma relação documentada, não que uma relação deva ser inferida. > **Exemplo sintético.** O Atributo “Data de admissão” de uma Entidade Pessoa pode ser associado a um campo físico `fecha_ingreso` em uma tabela do Repositório Acadêmico. O registro deve explicar por que ambos representam o mesmo dado. Se outra tabela contiver uma data com uma finalidade diferente, ela não deve ser associada apenas por compartilhar parte do nome. ## Dicionário, qualidade e SQL As Regras de qualidade são definidas sobre Atributos e podem ser vinculadas a campos do Dicionário técnico. Para gerar SQL, o GovFrame exige **associações válidas a campos físicos** e um **dialeto configurado**. Se o campo físico ou o dialeto estiver ausente, o SQL não deve ser gerado. O SQL gerado limita-se a esse resultado documentado: não implica execução automática no repositório nem substitui a revisão da pessoa responsável. Essa rastreabilidade permite entender se uma regra se baseia em uma fonte específica, mas não transforma todos os campos de uma tabela em controles nem todos os controles em um catálogo independente de Riscos ou Controles. Conforme o caso, o controle é representado por uma Regra de qualidade, uma Política ou Procedimento, um Workflow, uma tarefa, uma aprovação, uma classificação ou uma certificação. ## Resultado esperado O resultado é um registro técnico legível que identifica um campo físico dentro do seu Repositório e, quando pertinente, mostra sua associação explícita com um Atributo. O registro preserva o contexto necessário para navegar do significado de negócio até a fonte, analisar o impacto e relacionar o campo a Regras, Contratos ou outros objetos que já tenham vínculos registrados. ## Limites do estado atual - A pertença de uma tabela a um Repositório não registra automaticamente todos os seus campos no Dicionário nem os associa a Atributos. - Um campo pode fornecer contexto técnico sem que ainda exista uma definição de negócio completa; essa ausência deve ser apresentada como tal, e não preenchida por inferência. - As relações, descrições e operações são isoladas por empresa e estão sujeitas a papéis, capacidades, módulos e escopo. - Os códigos técnicos servem à persistência, validação, importação ou geração de SQL; na documentação e na interface funcional, devem prevalecer nomes compreensíveis. ## Referências relacionadas - [Modelo de objetos e relações](/pt-br/explicaciones/modelo-de-objetos-y-relaciones/) - [Como ler o mapa de relações](/pt-br/guias/como-leer-mapa-de-relaciones/) - [Papéis, capacidades e escopo](/pt-br/referencia/roles-capacidades-y-alcance/) - [Módulos e dependências](/pt-br/referencia/modulos-y-dependencias/)