Orientação por jornadas
A pergunta ou demanda ativa um percurso governado, observável e concluído por uma entrega.
1. Propósito
Esta página formaliza a arquitetura de referência da Máquina de Conhecimento do LAC. Seu objetivo é transformar o modelo conceitual em uma organização coerente de camadas, componentes, interfaces, fluxos, serviços, repositórios, agentes e mecanismos de controle.
Definição arquitetural: a Arquitetura da Máquina de Conhecimento é o conjunto
de decisões estruturais que determina como as capacidades de entrada, orientação, transformação,
representação, validação, disponibilização, uso, feedback e evolução são distribuídas e integradas.
Ela não é uma implementação específica. É uma referência estável para orientar páginas HTML, aplicações SPA, APIs, arquivos JSON, bancos de dados, grafos, agentes de IA, rotinas humanas e ambientes de desenvolvimento e produção.
2. Papel entre modelo e implementação
| Documento | Pergunta principal | Resultado |
|---|---|---|
| Teoria | O que é e por que existe? | Natureza, princípios e fundamentos. |
| Modelo | Quais elementos e relações devem existir? | Entidades, estados, transformações, controles e invariantes. |
| Arquitetura | Como organizar esses elementos para que cooperem? | Camadas, componentes, interfaces, fluxos e decisões estruturais. |
| Implementação | Com quais tecnologias e artefatos concretos? | Código, páginas, dados, serviços, automações e implantação. |
Teoria → Modelo → Arquitetura → Implementação → Operação → Feedback → Evolução
3. Direcionadores arquiteturais
Separação de responsabilidades
Conhecimento, representação, aplicação, armazenamento e infraestrutura não devem ser confundidos.
Rastreabilidade
Entradas, fontes, decisões, versões, agentes, transformações e saídas precisam permanecer relacionáveis.
Interoperabilidade
Pessoas, páginas, documentos, APIs, grafos, bancos e agentes devem cooperar por contratos explícitos.
Integridade evolutiva
A mudança local deve preservar coerência conceitual, estrutural, semântica e operacional do conjunto.
Centralidade humana
A automação amplia autoria, aprendizagem e gestão, sem eliminar validação e responsabilidade humanas.
4. Visões da arquitetura
A arquitetura deve ser lida por visões complementares, pois nenhuma representação isolada explica o sistema inteiro.
| Visão | Objeto observado | Pergunta respondida |
|---|---|---|
| Conceitual | Conceitos, entidades e relações. | O que constitui a máquina? |
| Funcional | Capacidades e responsabilidades. | O que a máquina deve realizar? |
| Lógica | Camadas, componentes e interfaces. | Como as responsabilidades são organizadas? |
| Informacional | Objetos, metadados, versões, grafos e memória. | Como o conhecimento é registrado e relacionado? |
| Aplicacional | Páginas, serviços, agentes e aplicações. | Quais unidades implementam as capacidades? |
| Tecnológica | Protocolos, linguagens, plataformas e infraestrutura. | Com quais mecanismos a arquitetura pode ser realizada? |
| Implantação | Ambientes, publicação, segurança e operação. | Onde e sob quais condições os componentes funcionam? |
5. Camadas lógicas
Experiência e acessoPortais, páginas, SPA, busca, visualizações e interfaces de interação.
Orquestração de jornadasAtivação, estados, papéis, tarefas, critérios e coordenação do percurso.
Transformação do conhecimentoAnálise, contextualização, modelagem, síntese, inferência e revisão.
Representação e publicaçãoTexto, knowgrama, HTML, JSON, grafo, dados, serviços e versões.
Memória e integraçãoRepositórios, índices, metadados, relações, APIs e eventos.
Governança e infraestruturaPolíticas, qualidade, segurança, observabilidade, ambientes e evolução.
Regra: as camadas representam responsabilidades predominantes, não silos rígidos.
Uma jornada atravessa várias camadas e deve manter identidade e rastreabilidade de ponta a ponta.
6. Componentes arquiteturais principais
Portal e interfaces
Recebem pessoas, perguntas, arquivos e ações; apresentam conhecimento e caminhos disponíveis.
Gerenciador de jornadas
Registra ativação, estado, responsáveis, etapas, dependências, critérios e conclusão.
Orquestrador
Coordena agentes humanos e computacionais, serviços, tarefas e eventos.
Motor de transformação
Aplica métodos, regras, modelos, algoritmos e operações cognitivas sobre entradas e estados.
Gerenciador de representações
Produz, converte, relaciona e versiona formas textuais, visuais, formais e computacionais.
Serviço de validação
Aplica critérios de coerência, evidência, completude, utilidade, conformidade e aceitação.
Memória de conhecimento
Preserva objetos, fontes, decisões, versões, metadados, relações e histórico de uso.
Catálogo e busca
Indexa, localiza, classifica e recupera objetos, jornadas, conceitos, páginas e evidências.
Gestor de governança
Controla papéis, políticas, decisões, riscos, auditoria, publicação e evolução.
Integração e eventos
Permite comunicação entre páginas, APIs, bancos, grafos, serviços e agentes.
Observabilidade
Registra estados, falhas, métricas, logs, alterações, qualidade e uso.
Infraestrutura
Oferece execução, armazenamento, rede, segurança, disponibilidade e desempenho.
7. Mapeamento do modelo para a arquitetura
| Elemento do modelo | Realização arquitetural predominante | Evidência esperada |
|---|---|---|
| Entrada | Interfaces, formulários, importadores, APIs e eventos. | Registro identificável da origem e do contexto. |
| Contexto | Metadados, perfil, domínio, ambiente e parâmetros da jornada. | Condições de interpretação preservadas. |
| Jornada | Gerenciador de jornadas e máquina de estados. | Estado, etapas, responsáveis e critérios observáveis. |
| Transformação | Motor de transformação e agentes especialistas. | Operações e decisões rastreáveis. |
| Representação | Gerenciador de representações e publicação. | Artefato versionado e relacionado ao conhecimento. |
| Validação | Serviço de validação e governança. | Critérios, avaliador, resultado e pendências registrados. |
| Saída | Catálogo, páginas, APIs, relatórios e entregas. | Objeto acessível e associado à demanda. |
| Memória | Repositórios, grafo, índices e histórico. | Persistência de objetos, relações e versões. |
| Feedback | Eventos de uso, métricas, comentários e novas demandas. | Retorno capaz de ativar revisão ou evolução. |
| Governança | Políticas, papéis, auditoria, decisão e gestão de mudanças. | Responsabilidade e autorização explícitas. |
8. Fluxo arquitetural principal
Receber → Contextualizar → Abrir jornada → Orquestrar → Transformar → Representar → Validar → Publicar → Usar → Observar → Evoluir
- Recepção: toda entrada recebe identidade, origem, contexto e finalidade inicial.
- Orientação: a demanda é vinculada a uma jornada, papel, escopo e critérios de aceitação.
- Execução: tarefas humanas e computacionais são coordenadas por estados e eventos.
- Exteriorização: o conhecimento produzido é associado a uma ou mais representações.
- Validação: a saída somente é promovida quando satisfaz critérios definidos.
- Uso e retorno: acesso, aplicação e feedback alimentam memória e evolução.
9. Arquitetura orientada por jornadas
A jornada é a unidade de coordenação arquitetural. Ela conecta a intenção humana à execução, às representações produzidas, à governança e à aprendizagem da máquina.
| Elemento da jornada | Responsabilidade arquitetural |
|---|---|
| Pergunta ativadora | Identificar a necessidade e iniciar a instância da jornada. |
| Estado | Indicar a situação atual e as transições possíveis. |
| Papel | Definir autorização, responsabilidade e capacidade esperada. |
| Atividade e tarefa | Decompor a transformação em unidades coordenáveis e executáveis. |
| Critério de aceitação | Determinar quando uma etapa ou entrega pode avançar. |
| Entrega | Associar saída, representação, versão e destinatário à demanda inicial. |
| Feedback | Registrar uso, avaliação, lacunas e possíveis jornadas subsequentes. |
10. Agentes, papéis e responsabilidade
Visitante e aprendiz
Exploram, formulam perguntas, percorrem jornadas, usam objetos e fornecem retorno.
Autor e colaborador
Constroem, estruturam, representam, documentam e relacionam conhecimento.
Curador e validador
Avaliam coerência, evidência, qualidade, adequação semântica e prontidão de publicação.
Gestor
Prioriza demandas, governa decisões, acompanha ambientes e coordena evolução.
Agente de orquestração
Coordena fluxo, chama serviços, distribui tarefas e mantém o estado da jornada.
Agentes especialistas
Executam análise, classificação, modelagem, geração, revisão, busca ou validação específica.
Princípio de responsabilidade: um agente pode executar uma operação, mas a arquitetura deve registrar quem responde pela decisão e pela publicação.
11. Arquitetura da informação e da memória
A memória da máquina deve preservar tanto os objetos quanto o contexto de sua produção e evolução.
| Conjunto informacional | Conteúdo principal | Forma possível |
|---|---|---|
| Objetos de conhecimento | Conceitos, explicações, modelos, regras, exemplos e decisões. | HTML, Markdown, documentos, JSON. |
| Representações | Textos, knowgramas, tabelas, grafos, imagens, interfaces e código. | Arquivos e objetos versionados. |
| Metadados | Identidade, autoria, estado, domínio, versão, datas e qualidade. | JSON, front matter, banco relacional. |
| Relações | Derivação, composição, referência, dependência, evidência e uso. | Grafo de conhecimento. |
| Jornadas e execuções | Estados, tarefas, responsáveis, eventos, decisões e entregas. | Registros transacionais e histórico. |
| Governança | Políticas, critérios, riscos, aprovações, auditorias e mudanças. | Matrizes, registros e painéis. |
Regra de memória: armazenar apenas o artefato final não é suficiente; é necessário preservar relações, proveniência, contexto, versões e decisões.
12. Interfaces e contratos
Os componentes cooperam por interfaces explícitas. Um contrato arquitetural deve declarar:
Identidade
Nome, versão, origem e responsável pelo serviço ou objeto.
Entrada
Formato, campos obrigatórios, contexto e pré-condições.
Saída
Formato, significado, estado e garantias oferecidas.
Regras
Validações, permissões, limites e critérios de erro.
Eventos
Fatos emitidos, assinantes possíveis e efeitos esperados.
Rastreabilidade
Identificadores que ligam chamada, jornada, transformação e entrega.
13. Arquitetura das representações
O conhecimento e sua representação são relacionados, mas não idênticos. A arquitetura deve permitir múltiplas representações de um mesmo objeto.
Objeto de conhecimento→Texto+Knowgrama+HTML+JSON+Grafo
- Cada representação deve declarar a qual objeto ou conjunto de objetos se refere.
- Conversões entre representações devem preservar significado ou registrar perdas e adaptações.
- Versões distintas podem coexistir quando atendem públicos, contextos ou finalidades diferentes.
- A publicação não elimina a representação-fonte nem seu histórico de transformação.
14. Integração e comunicação
| Mecanismo | Uso arquitetural | Exemplo no LAC |
|---|---|---|
| Hiperlinks | Navegação e referência entre páginas e objetos. | Breadcrumbs, documentos relacionados e jornadas. |
| Arquivos compartilhados | Troca simples e portátil de conteúdo estruturado. | HTML, JSON, imagens, planilhas e relatórios. |
| APIs | Comunicação síncrona entre aplicações e serviços. | Busca, catálogo, gestão de estado e publicação. |
| Eventos | Comunicação desacoplada por fatos ocorridos. | Jornada iniciada, entrega validada, página publicada. |
| Grafo | Integração semântica e navegação relacional. | Conceitos, objetos, fontes, jornadas e dependências. |
| Protocolos web | Transporte, identificação e acesso. | HTTP, URLs, MIME e autenticação. |
15. Governança como camada transversal
Políticas
Definem limites, obrigações, padrões e condições de uso.
Papéis e autorizações
Controlam quem pode propor, executar, validar, aprovar, publicar e manter.
Decisões
Registram alternativas, justificativas, impactos e responsáveis.
Qualidade
Aplica critérios conceituais, semânticos, técnicos, editoriais e operacionais.
Riscos
Trata erro, obsolescência, inconsistência, indisponibilidade, viés e perda de rastreabilidade.
Mudança
Coordena desenvolvimento, validação, produção, legado e reversão.
16. Atributos de qualidade
| Atributo | Significado arquitetural | Evidência |
|---|---|---|
| Coerência | Componentes e representações preservam o modelo e o vocabulário oficial. | Revisões e testes de consistência. |
| Modularidade | Responsabilidades podem evoluir sem alteração desnecessária do todo. | Interfaces estáveis e baixo acoplamento. |
| Rastreabilidade | É possível seguir da pergunta à entrega e retornar às fontes e decisões. | Identificadores, histórico e relações. |
| Interoperabilidade | Representações e componentes cooperam por padrões reconhecíveis. | Contratos e formatos documentados. |
| Usabilidade cognitiva | A apresentação reduz carga, orienta leitura e respeita diferentes níveis. | Jornadas claras, feedback e testes de uso. |
| Segurança | Acesso, integridade, privacidade e responsabilidade são protegidos. | Controles, registros e segregação. |
| Observabilidade | Estados, falhas, mudanças e desempenho podem ser examinados. | Logs, métricas, painéis e auditoria. |
| Evolutividade | A arquitetura admite expansão sem perder integridade. | Versionamento, decisões e compatibilidade. |
17. Segurança, ética e responsabilidade
- Autorização: ações sensíveis exigem papéis e permissões explícitos.
- Integridade: alterações de conteúdo, estado e decisão devem ser registradas.
- Privacidade: dados pessoais e conteúdos restritos devem ser separados e protegidos.
- Proveniência: fontes humanas, documentais e computacionais precisam ser identificáveis.
- Supervisão: resultados de agentes de IA devem ser validados conforme risco e finalidade.
- Responsabilidade: publicação e decisão permanecem atribuídas a agentes autorizados.
18. Observabilidade e aprendizagem operacional
A arquitetura deve produzir evidências de seu próprio funcionamento.
Logs
Eventos de execução, alterações, chamadas e falhas.
Métricas
Tempo, volume, qualidade, uso, retrabalho e conclusão.
Traços de jornada
Sequência completa da pergunta à entrega.
Auditoria
Quem fez, aprovou, publicou ou alterou cada elemento.
Feedback de uso
Dificuldades, avaliações, resultados e novas necessidades.
Lacunas
Ausências conceituais, operacionais ou tecnológicas que ativam evolução.
Observação + Avaliação + Decisão → Demanda interna → Jornada de evolução → Nova capacidade
19. Arquitetura de implantação
Desenvolvimento
Criação, experimentação, edição, testes e integração inicial.
Validação
Revisão conceitual, funcional, editorial, técnica e de segurança.
Produção
Publicação estável, monitorada, acessível e recuperável.
Dados e memória
Repositórios versionados, cópias de segurança e políticas de retenção.
Serviços
Execução de APIs, buscas, agentes, integrações e automações.
Legado e recuperação
Preservação histórica, reversão e continuidade após falhas.
Desenvolvimento→Validação→Produção→Observação→Evolução
20. Tecnologias possíveis no LAC
As tecnologias são opções de realização e não fazem parte da definição essencial da arquitetura.
| Capacidade | Tecnologias possíveis |
|---|---|
| Interface e publicação | HTML, CSS, JavaScript, SPA por hash e componentes web. |
| Visualização | SVG, Canvas, D3.js e imagens de knowgramas. |
| Estruturação e intercâmbio | JSON, CSV, XML e metadados embutidos. |
| Persistência | Arquivos, bancos relacionais, documentos e armazenamento de objetos. |
| Relações semânticas | Memgraph ou outro banco de grafos. |
| Serviços e automação | APIs, PHP, Python, JavaScript de servidor e tarefas agendadas. |
| Inteligência artificial | Modelos de linguagem, busca semântica e agentes governados. |
| Versionamento e implantação | Git, ambientes separados, auditoria de paridade e hospedagem web. |
21. Decisões arquiteturais fundamentais
- Jornada como unidade de coordenação: processos de conhecimento são rastreados por jornadas.
- Vocabulário como autoridade semântica: termos oficiais não são redefinidos isoladamente por componentes.
- Separação entre objeto e representação: múltiplas representações podem realizar o mesmo conhecimento.
- Grafo como estrutura relacional complementar: relações semânticas não dependem apenas da árvore de diretórios.
- Agentes de IA como componentes governados: autonomia é limitada por contexto, permissões e validação.
- Ambientes separados: desenvolvimento, validação e produção possuem critérios de promoção.
- Evolução orientada por evidências: mudanças estruturais devem decorrer de demanda, uso, falha ou aprendizagem observada.
22. Materialização atual no LAC
| Elemento arquitetural | Materialização atual ou prevista |
|---|---|
| Experiência de entrada | index.html, portal.html e jornadas iniciais. |
| Fundação semântica | fundacao/ e fundamentos/vocabulario_lac.html. |
| Orquestração por jornadas | Páginas de jornadas, matrizes de decisão e planos de execução. |
| Representações | Páginas HTML, knowgramas, JSON, tabelas, mapas e documentos. |
| Memória documental | Diretórios, índices, metadados, referências e histórico. |
| Memória relacional | Memgraph e experimentos de grafo do projeto PPD-MC-001. |
| Governança | governanca/gestao_do_lac/, qualidade, decisões e auditorias. |
| Ambientes | Desenvolvimento local e produção em meulivro.info. |
23. Roteiro incremental de implementação
1. DocumentarConsolidar teoria, modelo, arquitetura, vocabulário e decisões.
2. IdentificarDefinir IDs, metadados e relações mínimas dos objetos.
3. OrquestrarFormalizar estados e registros das jornadas.
4. IntegrarConectar páginas, JSON, busca, grafo e serviços.
5. AutomatizarIntroduzir agentes e rotinas sob governança.
6. ObservarMedir uso, qualidade, falhas e evolução.
Estratégia: a complexidade deve aumentar conforme necessidades comprovadas, sem antecipar infraestrutura que ainda não resolve um problema real.
24. Validação da arquitetura
Conformidade com o modelo
Todos os elementos essenciais possuem realização ou responsabilidade arquitetural.
Cenários de jornada
A arquitetura suporta percursos reais de criação, revisão, publicação e uso.
Rastreabilidade
É possível navegar da entrada às decisões, representações, entregas e feedback.
Qualidade
Os atributos arquiteturais possuem critérios e evidências verificáveis.
Experimentação
Componentes podem ser prototipados e avaliados no PPD-MC-001.
Evolução
A arquitetura admite mudança documentada sem ruptura indevida.
25. Documentos relacionados
Antecedentes
Derivados e implementadores
- Sistema Operacional do Conhecimento
- Arquitetura Orientada por Jornadas
- Modelo conceitual de dados da Máquina de Conhecimento
- Grafo da Máquina de Conhecimento
- Arquitetura de agentes de IA do LAC
- Arquitetura de implantação e publicação
26. Síntese
A Arquitetura da Máquina de Conhecimento organiza as capacidades do modelo em camadas, componentes e interfaces capazes de sustentar jornadas completas de transformação do conhecimento.
Experiência → Jornada → Transformação → Representação → Memória → Uso → Feedback, sob Governança e Infraestrutura
Conclusão: o modelo determina o que a Máquina de Conhecimento deve preservar;
a arquitetura determina como distribuir e integrar essas responsabilidades; a implementação escolherá
as tecnologias e artefatos concretos adequados a cada etapa de evolução do LAC.
27. Estado do documento
Versão 1 formalizada
Arquitetura de referência
Documento apto a orientar modelos de dados, grafos, estados de jornadas, serviços, agentes, implantação e experimentos da Máquina de Conhecimento.
Próximas derivações recomendadas
- Produzir o modelo conceitual de dados e metadados da Máquina de Conhecimento.
- Formalizar a máquina de estados das jornadas.
- Definir o grafo de conhecimento mínimo do LAC.
- Especificar contratos entre gerenciador de jornadas, memória, validação e publicação.
- Relacionar os componentes aos experimentos do PPD-MC-001.
- Atualizar o índice da Fundação e o mapa arquitetural do LAC.