Máquina de Estados da Máquina de Conhecimento do LAC

1. Propósito

A Máquina de Estados da Máquina de Conhecimento é o modelo comportamental que define as situações possíveis de uma entidade, os eventos que podem alterá-las, as condições que autorizam cada mudança e as ações produzidas pelas transições.

Seu papel é tornar explícito como jornadas, objetos, representações, versões e publicações evoluem ao longo do tempo. O documento complementa o Modelo Conceitual de Dados e Metadados, que responde o que existe, indicando como cada entidade pode evoluir.

2. Posicionamento na cadeia da Máquina de Conhecimento

Teoria ↓ Modelo ↓ Arquitetura ↓ Modelo Conceitual de Dados e Metadados ↓ Máquina de Estados ↓ Dicionário de Dados e Metadados ↓ Perfil de Aplicação ↓ Modelo Lógico ↓ Modelo Físico ↓ Implementação

Modelo estrutural

Declara entidades, atributos, relações, identificadores e metadados.

Modelo comportamental

Declara estados, eventos, guardas, ações, transições e histórico.

3. Elementos da Máquina de Estados

Elemento	Definição	Exemplo no LAC
Estado	Situação persistente de uma entidade em determinado momento.	Publicado
Evento	Fato interno ou externo que pode solicitar uma mudança.	Solicitação de publicação
Transição	Mudança autorizada de um estado para outro.	Validado → Publicado
Guarda	Condição lógica que precisa ser verdadeira para permitir a transição.	Metadados mínimos completos
Ação	Operação executada durante ou após a transição.	Atualizar índice e gerar JSON
Estado inicial	Primeiro estado reconhecido no ciclo de vida.	Identificado
Estado final	Estado de encerramento controlado do ciclo.	Arquivado
Histórico	Registro temporal das transições realizadas.	Quem publicou, quando e por quê

4. Princípios comportamentais

Toda transição deve possuir origem, destino e evento explícitos.

Toda mudança relevante deve registrar data, agente, contexto e justificativa.

Nenhuma publicação deve ocorrer sem validação e autorização.

Estados terminais não devem apagar o histórico anterior.

Arquivamento é preferido à exclusão física.

Automação não elimina responsabilidade humana quando houver risco conceitual, legal ou operacional.

Estados de objetos, versões e representações devem permanecer coerentes entre si.

5. Máquina de Estados das Jornadas

Proposta→ Planejada→ Em execução→ Em revisão→ Validada→ Concluída→ Encerrada

Estado	Significado	Saídas possíveis
Proposta	Jornada reconhecida, ainda sem planejamento aprovado.	Planejada, Cancelada
Planejada	Objetivo, responsáveis, etapas e critérios definidos.	Em execução, Suspensa, Cancelada
Em execução	Atividades e tarefas em andamento.	Em revisão, Suspensa
Em revisão	Resultados submetidos à análise.	Validada, Em execução
Validada	Critérios de aceitação atendidos.	Concluída, Em execução
Concluída	Entregas finalizadas e registradas.	Encerrada, Reaberta
Encerrada	Jornada encerrada com histórico preservado.	Reaberta por decisão formal
Suspensa	Execução temporariamente interrompida.	Planejada, Em execução, Cancelada
Cancelada	Jornada encerrada sem conclusão planejada.	Estado terminal controlado

6. Máquina de Estados dos Objetos de Conhecimento

Identificado→ Em elaboração→ Registrado→ Em validação→ Validado→ Publicado→ Em manutenção→ Substituído→ Arquivado

Estado	Condição	Transições permitidas
Identificado	Objeto reconhecido e com identidade reservada.	Em elaboração, Cancelado
Em elaboração	Conteúdo ou estrutura sendo produzidos.	Registrado, Suspenso
Registrado	Ficha e metadados mínimos existentes.	Em validação, Em elaboração
Em validação	Objeto submetido aos critérios definidos.	Validado, Em elaboração
Validado	Conteúdo e metadados aprovados.	Publicado, Em elaboração
Publicado	Objeto oficial disponível no ambiente de produção.	Em manutenção, Substituído, Suspenso
Em manutenção	Objeto publicado em atualização controlada.	Em validação, Publicado
Substituído	Existe sucessor vigente.	Arquivado
Arquivado	Objeto preservado apenas para memória e rastreabilidade.	Restaurado por decisão formal

7. Máquina de Estados das Representações

Criada→ Em edição→ Sincronizada→ Validada→ Publicada→ Obsoleta→ Arquivada

As representações incluem HTML, JSON, SQL, Cypher, knowgramas, imagens, PDFs, grafos, APIs e outras formas concretas de expressão.

Uma representação pode mudar de versão sem alterar a identidade do Objeto de Conhecimento. Mudanças conceituais, porém, podem exigir nova versão do próprio objeto.

8. Máquina de Estados das Versões

Rascunho→ Em revisão→ Aprovada→ Vigente→ Substituída→ Histórica

Versão conceitual

Registra mudança no significado, estrutura, escopo ou função do objeto.

Versão da representação

Registra mudança de formato, layout, tecnologia ou suporte.

9. Máquina de Estados das Publicações

Preparada→ Em validação→ Autorizada→ Publicada→ Retirada

A publicação relaciona uma versão a um ambiente, localização, público, regra de acesso, vigência e responsável.

10. Eventos padronizados

Evento	Finalidade	Entidades afetadas
Criar	Iniciar uma nova entidade ou representação.	Jornada, objeto, representação
Planejar	Definir objetivo, responsáveis, etapas e critérios.	Jornada
Iniciar	Ativar execução.	Jornada, atividade
Editar	Alterar conteúdo ou estrutura.	Objeto, representação
Registrar	Atribuir identidade persistente e metadados mínimos.	Objeto
Revisar	Submeter a análise de coerência e completude.	Jornada, objeto, versão
Validar	Aplicar critérios e registrar resultado.	Objeto, versão, representação
Aprovar	Autorizar a passagem para publicação ou vigência.	Versão, publicação
Publicar	Disponibilizar oficialmente.	Objeto, representação, versão
Sincronizar	Atualizar representações e repositórios.	HTML, JSON, PostgreSQL, Memgraph
Suspender	Interromper temporariamente o uso ou execução.	Jornada, objeto
Rejeitar	Devolver para correção.	Objeto, versão, publicação
Substituir	Indicar sucessor vigente.	Objeto, versão
Arquivar	Encerrar uso ativo preservando histórico.	Jornada, objeto, representação
Restaurar	Retomar entidade arquivada ou suspensa.	Jornada, objeto

11. Guardas e condições

Publicar

estado = VALIDADO

Metadados mínimos completos, responsável identificado e autorização registrada.

Arquivar

dependencias_ativas = 0

Ou existência de sucessor formalmente indicado.

Concluir jornada

criterios_aceitacao = atendidos

Entregas, evidências e responsáveis registrados.

Sincronizar

identidade_consistente = true

HTML, JSON, PostgreSQL e Memgraph utilizam o mesmo identificador.

Substituir

sucessor_id != null

Objeto ou versão sucessora precisa estar validado ou publicado.

Excluir

proibido_para_publicados = true

Objetos publicados devem ser arquivados, não apagados.

12. Ações automáticas por transição

Transição	Ações automáticas recomendadas
Registrado → Em validação	Verificar links, metadados, identificadores, responsável e documento principal.
Validado → Publicado	Atualizar índice, gerar JSON, atualizar PostgreSQL, registrar no Memgraph, gerar checksum e registrar proveniência.
Publicado → Em manutenção	Abrir nova versão, preservar versão vigente e registrar demanda de mudança.
Em manutenção → Publicado	Encerrar versão anterior, ativar nova versão e sincronizar ambientes.
Publicado → Substituído	Registrar sucessor, atualizar links e manter redirecionamento ou aviso.
Substituído → Arquivado	Retirar do fluxo operacional e preservar histórico, relações e evidências.

13. Matriz principal de transições

Entidade	Estado atual	Evento	Guarda	Próximo estado	Responsável
Jornada	Proposta	Planejar	Objetivo e responsável definidos	Planejada	Gestor
Jornada	Planejada	Iniciar	Recursos e prioridade confirmados	Em execução	Gestor
Jornada	Em execução	Revisar	Entregas preliminares existentes	Em revisão	Autor
Jornada	Em revisão	Validar	Critérios atendidos	Validada	Curador
Jornada	Validada	Concluir	Entregas registradas	Concluída	Gestor
Objeto	Identificado	Elaborar	ID reservado	Em elaboração	Autor
Objeto	Em elaboração	Registrar	Ficha e metadados mínimos	Registrado	Autor
Objeto	Registrado	Validar	Documento principal existente	Em validação	Curador
Objeto	Em validação	Aprovar	Critérios atendidos	Validado	Curador
Objeto	Validado	Publicar	Autorização e sincronização	Publicado	Gestor
Objeto	Publicado	Atualizar	Demanda de mudança registrada	Em manutenção	Autor
Objeto	Publicado	Substituir	Sucessor vigente	Substituído	Gestor
Objeto	Substituído	Arquivar	Dependências atualizadas	Arquivado	Gestor

14. Coerência entre estados relacionados

Um Objeto de Conhecimento só pode estar publicado se possuir ao menos uma representação publicada.

Uma representação publicada deve apontar para uma versão vigente do objeto.

Uma jornada só pode ser concluída quando suas entregas estiverem registradas.

Uma versão substituída não pode permanecer marcada como vigente.

Um objeto arquivado não pode receber nova publicação sem restauração formal.

Estados em HTML, JSON, PostgreSQL e Memgraph devem convergir para o mesmo valor normativo.

15. Integração conceitual com PostgreSQL

O modelo comportamental deve ser refletido por tabelas ou estruturas equivalentes para:

Estado vigente

Campo controlado como estado_codigo.

Histórico de transições

Registro de entidade, estado anterior, evento, estado seguinte, agente e data.

Guardas

Regras, constraints, funções ou procedimentos de validação.

Ações

Triggers, serviços de aplicação ou rotinas transacionais.

Transição = entidade + estado_anterior + evento + estado_novo + guarda + ação + agente + data + contexto

16. Integração conceitual com Memgraph

O grafo pode representar a situação atual e o histórico de evolução.

(:ObjetoConhecimento)-[:ESTA_EM]->(:Estado) (:ObjetoConhecimento)-[:MUDOU_PARA { evento, data, agente_id, jornada_id, justificativa }]->(:Estado)

Para preservar o histórico, uma transição não deve ser representada apenas pela alteração de uma propriedade. Recomenda-se registrar o evento de transição como relação ou nó temporal.

17. Automação e governança

Transições automáticas

Podem ocorrer quando as guardas forem objetivas, verificáveis e de baixo risco.

Transições assistidas

Agentes de IA podem preparar evidências, detectar inconsistências e sugerir mudanças.

Transições autorizadas

Publicação, substituição, arquivamento e mudança normativa exigem autoridade definida.

Auditoria

Toda transição relevante deve ser reconstruível por histórico e proveniência.

18. Relação com os Objetos de Conhecimento

OC-MC-0004 — Arquitetura da Máquina de Conhecimento ↓ orienta OC-MC-0005 — Modelo Conceitual de Dados e Metadados ↓ fundamenta OC-MC-0006 — Máquina de Estados da Máquina de Conhecimento ↓ orienta OC-MC-0007 — Dicionário de Dados e Metadados ↓ orienta OC-MC-0008 — Perfil de Aplicação de Metadados ↓ orienta OC-MC-0009 — Modelo Lógico Relacional ↓ realiza OC-MC-0010 — Modelo Físico PostgreSQL

Esta sequência reserva OC-MC-0006 para o modelo comportamental e desloca os objetos posteriores para preservar a ordem lógica da cadeia.

19. Critérios de validação deste modelo

Os estados possuem significado distinto e não sobreposto.

Toda transição possui evento e responsável identificáveis.

As guardas são verificáveis ou explicitamente humanas.

Os fluxos permitem correção, suspensão, rejeição e retomada.

Estados terminais preservam rastreabilidade.

A máquina pode ser implementada em banco relacional, grafo ou serviço de workflow.

O modelo é coerente com jornadas, Objetos de Conhecimento, representações e versões.

20. Derivações para implementação

Vocabulário de estados

Códigos, definições e escopos de uso.

Vocabulário de eventos

Eventos normativos e suas entidades-alvo.

Matriz de transições

Origem, evento, guarda, destino e ação.

Modelo lógico relacional

Tabelas de estado, evento, transição e histórico.

Modelo de grafo

Nós de estado, eventos e relações temporais.

Serviço de workflow

API ou motor responsável por aplicar as transições.

21. Síntese

A Máquina de Estados torna a evolução do conhecimento explícita, controlável e auditável. Ela conecta estrutura, comportamento, governança e implementação, garantindo que toda mudança de situação possua causa, condição, responsável, efeito e memória.

22. Estado do documento

Versão 1.0 — modelo comportamental inicial

Documento apto a orientar o vocabulário de estados e eventos, a matriz formal de transições, o dicionário de dados, os modelos lógicos e os mecanismos de workflow da Máquina de Conhecimento.

Fundação

Próximos passos recomendados

Criar a ficha maquina_estados_maquina_conhecimento_oc.html.
Registrar o objeto como OC-MC-0006.
Atualizar o inventário de Objetos de Conhecimento.
Produzir o vocabulário controlado de estados e eventos.
Produzir a matriz de transições em JSON, SQL e Cypher.
Revisar a numeração dos objetos posteriores.