Unicidade
Um código não deve identificar dois elementos diferentes.
Norma de identificação e rastreabilidade
Sistema de Codificação e Identificação do LAC
Define como elementos controlados do LAC recebem identificação estável, legível e rastreável, distinguindo código, título, nome de arquivo, caminho, versão, estado e posição arquitetural.
1. Conceito central
O que é o sistema de codificação
O sistema de codificação é um mecanismo de governança documental e arquitetural. Ele atribui identificadores estáveis aos elementos que precisam ser localizados, relacionados, versionados, auditados ou acompanhados ao longo da evolução do LAC.
Definição: o Sistema de Codificação e Identificação do LAC é o conjunto de regras
para criar, atribuir, registrar, interpretar, preservar e descontinuar identificadores de elementos controlados.
2. Princípios
Regras fundamentais
Estabilidade
O código permanece, mesmo se título, arquivo ou caminho forem alterados.
Legibilidade
O prefixo deve permitir reconhecer a família do elemento.
Rastreabilidade
O código deve ligar origem, relações, versões, estados e evidências.
Códigos não devem conter informação excessiva ou sujeita a mudança frequente.
A hierarquia completa do elemento deve ficar nos metadados, não necessariamente no código.
Códigos cancelados ou obsoletos não devem ser reutilizados.
A atribuição de código deve ser registrada no inventário documental correspondente.
3. Identificação composta
Código, título, arquivo e caminho não são a mesma coisa
| Identificador | Função | Exemplo |
|---|---|---|
| Código | Identidade lógica, estável e governada. | JOR-AUT-001 |
| Título | Nome humano e semântico do elemento. | Jornada de Revisão da Pasta Autor |
| Nome do arquivo | Nome técnico do artefato físico. | jornada_revisao_pasta_autor_lac.html |
| Caminho | Localização atual no projeto. | governanca/gestao_do_lac/jornadas/... |
| Versão | Estado evolutivo de uma mesma identidade. | v1.2.0 |
Regra: arquivo e caminho podem mudar; o código deve permanecer estável enquanto a identidade do elemento for a mesma.
4. Estrutura sintática
Formato geral recomendado
PREFIXO-[QUALIFICADOR]-NÚMERO
PREFIXO
→ identifica a família do elemento
QUALIFICADOR
→ identifica área, domínio ou contexto estável, quando necessário
NÚMERO
→ sequência única com preenchimento à esquerda
Exemplo simples
POL-GOV-001
Política de Governança nº 001.
Exemplo composto
JOR-AUT-001-EXE-001
Primeira execução da Jornada JOR-AUT-001.
Exemplo de objeto
OC-MC-0009
Objeto de conhecimento nº 0009 da Máquina de Conhecimento.
Evitar: códigos muito longos, com datas, estados, versões ou caminhos completos.
Esses dados devem permanecer em metadados próprios.
5. Famílias de códigos
Prefixos recomendados
| Prefixo | Elemento | Exemplo | Situação |
|---|---|---|---|
JOR | Jornada | JOR-AUT-001 | Já utilizado |
EXE | Execução de Jornada | JOR-AUT-001-EXE-001 | Já utilizado |
OC | Objeto de conhecimento | OC-MC-0009 | Já utilizado |
DEM | Demanda | DEM-GOV-001 | Proposto |
DEC | Decisão | DEC-ARC-001 | Proposto |
POL | Política | POL-GOV-001 | Proposto |
REG | Regra | REG-DOC-001 | Proposto |
AUD | Auditoria | AUD-AMB-001 | Proposto |
INC | Incidente | INC-OPS-001 | Proposto |
SUB | Subsistema | SUB-JOR-001 | Proposto |
MOD | Módulo | MOD-INF-001 | Proposto |
COM | Componente | COM-INF-001 | Proposto |
ART | Artefato controlado | ART-GOV-001 | Proposto |
DOC | Documento estruturante | DOC-GOV-001 | Proposto |
Observação: os prefixos marcados como “Proposto” devem ser validados antes de adoção geral.
Esta página formaliza a estrutura e prepara a consolidação do vocabulário oficial.
6. Jornadas e execuções
Codificação de Jornadas
JOR-[ÁREA]-[NÚMERO]
Exemplos:
JOR-AUT-001 → Jornada da área Autor
JOR-GOV-001 → Jornada da área Governança
JOR-ARC-001 → Jornada da área Arquitetura
JOR-VIS-001 → Jornada da área Visitante
| Elemento | Formato | Exemplo |
|---|---|---|
| Jornada | JOR-[ÁREA]-[NNN] | JOR-AUT-001 |
| Execução | [CÓDIGO-DA-JORNADA]-EXE-[NNN] | JOR-AUT-001-EXE-001 |
| Entrega da execução | Relacionada por metadado, sem exigir novo encadeamento no código. | DOC-AUT-001 ligado à execução |
Regra: uma Jornada pode possuir várias execuções. A identidade da Jornada permanece;
a execução registra uma ocorrência concreta, com datas, responsáveis, entregas e evidências próprias.
7. Relação com a arquitetura
Código não substitui a posição arquitetural
A posição na cadeia Ecossistema → Sistema → Subsistema → Módulo → Componente deve ser registrada em metadados. O código pode indicar a família, mas não precisa carregar toda a hierarquia.
Código: COM-INF-001
Título: Motor de seleção dinâmica de nós
Nível arquitetural: Componente
Sistema: LAC
Subsistema: Máquina de Conhecimento
Módulo: Inferência
Jornada de origem: JOR-ARC-002
Estado: Implantado
Versão: v1.0.0
Princípio: o código identifica; os metadados contextualizam; a arquitetura posiciona;
a Jornada explica a origem ou mudança; e a governança controla validade e evolução.
8. Versão, estado e obsolescência
Separar identidade de evolução
| Aspecto | Regra |
|---|---|
| Código | Permanece estável enquanto a identidade do elemento for a mesma. |
| Versão | Indica evolução de conteúdo ou implementação, preferencialmente em campo próprio. |
| Estado | Proposto, em elaboração, em validação, aprovado, implantado, obsoleto ou cancelado. |
| Substituição | O novo elemento recebe novo código se tiver identidade diferente; caso contrário, mantém o código e altera versão. |
| Obsolescência | O código permanece reservado e rastreável, sem reutilização. |
9. Papéis e responsabilidades
Quem cria, valida e mantém códigos
| Responsabilidade | Papel predominante |
|---|---|
| Solicitar identificação | Responsável pela Jornada, autor ou gestor da área. |
| Atribuir código | Gestor documental ou responsável autorizado pela governança. |
| Validar família e qualificador | Gestor documental, arquitetura ou curadoria. |
| Registrar no inventário | Autor, gestor documental ou agente autorizado. |
| Manter relações e estado | Responsável pela Jornada e gestor documental. |
| Impedir duplicação ou reutilização | Governança do LAC. |
Agentes de IA: podem sugerir códigos, detectar duplicações e atualizar registros,
mas a atribuição normativa deve permanecer sob autorização explícita.
10. Implantação progressiva
Como aplicar ao acervo existente
1. Inventariar
Localizar códigos já utilizados e identificar inconsistências.
2. Normalizar
Confirmar prefixos, qualificadores e sequências oficiais.
3. Registrar
Adicionar código e metadados ao mapa documental e às Jornadas.
4. Governar
Controlar novas atribuições, versões, estados e obsolescência.
Ponto pendente: códigos já existentes como
OR-ARC-001 precisam ter seu prefixo
oficialmente interpretado antes de serem incorporados à norma definitiva.
Síntese normativa
Formulação consolidada
Todo elemento controlado do LAC deve possuir identificação humana, identificação técnica,
classificação, contexto arquitetural e controle evolutivo. O código fornece identidade estável;
o título comunica significado; o arquivo materializa; o caminho localiza; a versão registra evolução;
e o estado informa validade.
Páginas relacionadas