Definição

O que é a Arquitetura Tecnológica do LAC?

É a arquitetura que especifica as tecnologias usadas para materializar a Máquina de Conhecimento, o Banco de Dados, o Banco de Conhecimento em grafo, as APIs, as interfaces e os ambientes do LAC.

Função central

A Arquitetura Tecnológica traduz decisões conceituais e lógicas em uma combinação governada de ferramentas, plataformas e padrões de integração.

Ela não substitui a Fundação, o Modelo Conceitual ou a Arquitetura da Máquina de Conhecimento. Seu papel é responder como esses modelos serão implementados de forma prática.

Critérios de escolha

Princípios tecnológicos do LAC

Baixa curva de aprendizagem

As ferramentas devem reduzir a complexidade operacional desnecessária para o autor e o gestor do LAC.

Predomínio de interface gráfica

O uso cotidiano deve depender pouco do Terminal e privilegiar ambientes visuais compreensíveis.

Abertura e sustentabilidade

Os componentes centrais devem, sempre que possível, utilizar tecnologias open source e formatos portáveis.

Adequação arquitetural

A facilidade de uso não pode comprometer requisitos de dados, grafos, integração, governança ou segurança.

Separação de responsabilidades

Cada tecnologia deve assumir a função para a qual é mais adequada, evitando sobreposição e acoplamento excessivo.

Evolução reversível

As decisões devem permitir substituição futura de ferramentas sem perda do modelo conceitual e dos dados.

Visão de conjunto

Componentes tecnológicos principais

Interface Web HTML, CSS, JavaScript e D3.js
API do LAC Serviços de consulta, decisão e atualização
Motor de Inferência Regras, pontuação e explicação
Base de Dados PostgreSQL
Base de Conhecimento Neo4j Community

Interface Web

Páginas HTML, SPAs, knowgramas e visualizações interativas usadas pelos diferentes papéis do LAC.

API do LAC

Camada de serviços que recebe solicitações, consulta as bases, aplica regras e devolve respostas estruturadas.

Motor de Inferência

Componente lógico responsável por interpretar contexto, selecionar candidatos e explicar decisões.

Base de Dados

Armazena usuários, perfis, estados, jornadas, metadados, versões, auditoria e transações.

Base de Conhecimento em grafo

Representa conceitos, relações semânticas, pré-requisitos, caminhos e possibilidades de navegação.

Ambientes e ferramentas

Organizam desenvolvimento, teste, publicação, documentação, instalação e manutenção.

Escolhas atuais

Decisões tecnológicas do LAC

As decisões abaixo refletem o melhor equilíbrio atual entre capacidade técnica, abertura, curva de aprendizagem e uso de interface gráfica.

Função Tecnologia escolhida Justificativa Observação
Base de dados relacional PostgreSQL
Escolha atual
SGBD open source, robusto, estável, adequado a dados transacionais, metadados, governança, auditoria e versionamento. O uso cotidiano deve ser apoiado por interface gráfica.
Administração da base de dados pgAdmin
Escolha atual
Interface gráfica para criação, consulta e administração do PostgreSQL, reduzindo a dependência do Terminal. Pode ser complementado por DBeaver em atividades de consulta e comparação.
Base de conhecimento em grafo Neo4j Community Edition
Escolha atual
Banco de grafos open source, ampla documentação, uso de Cypher, forte ecossistema e boa adequação à malha de conhecimento do LAC. O modelo do LAC deve permanecer independente da tecnologia.
Administração e visualização do grafo Neo4j Desktop
Escolha prática
Permite criar, iniciar, parar, consultar e visualizar grafos por interface gráfica, com pouco uso do Terminal. É gratuito, mas não é open source; possui licença própria.
Alternativa totalmente open source para grafos ArcadeDB + ArcadeDB Studio
Alternativa
Reúne grafo, documentos, chave-valor, vetores, SQL, Cypher e Gremlin, com interface gráfica acessada pelo navegador. Pode exigir maior contato inicial com scripts e Terminal.
Alternativa integrada ao PostgreSQL Apache AGE + pgAdmin
Alternativa futura
Permite combinar SQL e Cypher no PostgreSQL. Possui maior curva de aprendizagem e maior complexidade operacional.
Visualização de conhecimento na Web D3.js
Escolha atual
Permite construir grafos, mapas e knowgramas interativos diretamente nas páginas do LAC. É uma camada de representação, não substitui o banco de grafos.

Arquitetura híbrida

Integração entre Base de Dados e Base de Conhecimento

O LAC adota duas bases complementares porque dados transacionais e relações semânticas possuem naturezas diferentes.

PostgreSQL — memória transacional

  • usuários e perfis;
  • estados das jornadas;
  • histórico e auditoria;
  • metadados administrativos;
  • versões e publicação;
  • governança e autorização.

Neo4j — memória semântica e navegável

  • conceitos e objetos de conhecimento;
  • relações semânticas;
  • pré-requisitos;
  • níveis de abstração;
  • caminhos e alternativas;
  • estrutura das jornadas.

Regras de integração

Identificadores compartilhados

Objetos relevantes devem possuir identificadores estáveis, usados nas duas bases.

Fonte oficial definida

Cada tipo de dado deve possuir uma fonte oficial para evitar duplicidade e divergência.

API como mediadora

As aplicações não devem depender diretamente da estrutura interna das duas bases.

Sincronização controlada

Mudanças entre dados administrativos e relações semânticas devem ser registradas e validadas.

Decisão explicável

O motor deve registrar quais dados e relações sustentaram cada recomendação.

Portabilidade

Os modelos e exportações devem permitir reconstrução futura em outras plataformas.

Organização operacional

Ambiente de desenvolvimento e instaladores

A documentação pública da tecnologia deve permanecer separada dos instaladores, configurações locais e artefatos privados do ambiente.

Documentação pública

arquitetura/
├── arquitetura_tecnologica_lac.html
└── tecnologia/
    ├── ambiente_desenvolvimento_lac.html
    ├── banco_dados_lac.html
    ├── banco_conhecimento_grafo_lac.html
    └── ferramentas_desenvolvimento_lac.html

Artefatos privados do ambiente

privado/
└── ambiente_desenvolvimento/
    ├── instaladores/
    │   ├── neo4j/
    │   ├── postgresql/
    │   ├── pgadmin/
    │   └── outros/
    ├── configuracoes/
    ├── licencas/
    └── scripts/
Regra prática para arquivos .dmg

O navegador pode baixar inicialmente em Downloads/. Após a instalação, o arquivo pode ser apagado ou preservado em privado/ambiente_desenvolvimento/instaladores/ quando for importante manter a versão usada no LAC.

Integração documental

Relação com outros documentos do LAC

Modelo Conceitual de Referência

Define o que precisa ser representado e operado pela arquitetura tecnológica.

Arquitetura da Máquina de Conhecimento

Define componentes e responsabilidades que serão materializados tecnologicamente.

Modelo Lógico Relacional

Orienta a implementação da base de dados PostgreSQL.

Modelo do Banco de Conhecimento

Orientará a estrutura lógica do grafo no Neo4j.

Roteiro de Evolução

Indica quando cada tecnologia deve entrar em prototipação, validação e operação.

Governança Tecnológica

Controlará versões, licenças, riscos, atualizações e substituições.

Cuidados arquiteturais

Riscos tecnológicos

Complexidade operacional

Ferramentas tecnicamente poderosas podem dificultar a continuidade do projeto se exigirem uso excessivo do Terminal.

Dependência de fornecedor

Interfaces proprietárias não devem aprisionar os modelos, dados ou processos do LAC.

Duplicidade entre bases

PostgreSQL e Neo4j podem divergir se não houver fonte oficial e regras claras de sincronização.

Escolha prematura

A tecnologia não deve ser implantada antes de requisitos, casos de uso e modelos estarem suficientemente claros.

Infraestrutura sem documentação

Instaladores, configurações e versões não registrados dificultam a reprodução do ambiente.

Modelo preso à ferramenta

O conhecimento do LAC deve permanecer compreensível e exportável mesmo que a plataforma seja substituída.

Próximos movimentos

Evolução prevista da arquitetura tecnológica

Curto prazo

  • consolidar PostgreSQL + pgAdmin;
  • instalar e testar Neo4j Community + Desktop;
  • definir identificadores comuns;
  • modelar um pequeno grafo piloto;
  • implementar consultas e casos de teste.

Médio prazo

  • criar a API do LAC;
  • integrar as duas bases;
  • implementar o Motor de Seleção Dinâmica;
  • registrar explicações das decisões;
  • validar uma jornada real.

Longo prazo

  • avaliar agentes de IA autorizados;
  • incorporar vetores e busca semântica;
  • automatizar validações de consistência;
  • ampliar interoperabilidade entre domínios;
  • avaliar substituições tecnológicas quando necessário.

Critério de revisão

  • a tecnologia deixou de atender ao propósito;
  • a curva operacional tornou-se excessiva;
  • há risco relevante de dependência;
  • uma alternativa oferece ganho comprovado;
  • a migração preserva os modelos e os dados.

Decisão arquitetural atual

O LAC adotará uma arquitetura híbrida: PostgreSQL + pgAdmin para a Base de Dados e Neo4j Community + Neo4j Desktop para a Base de Conhecimento em grafo. A API e o Motor de Inferência integrarão ambas, preservando identificadores, governança, explicabilidade e possibilidade de evolução futura.