Guida Control

O Guida Control é um aplicativo alpha, proprietário e separado para operar o Guida Complete e o Guida Node no navegador. Ele se conecta pela Remote Ops API e não lê diretamente os arquivos do espaço de trabalho nem os bancos de filas, registro ou operações do nó.

A imagem pública do contêiner pode ser usada para avaliar e operar o Guida nos termos da licença que a acompanha. A disponibilidade da imagem não transforma o Guida Control em software de código aberto.

Interface e responsabilidades

Overview e Command Center reúnem avisos, capacidades, trabalho ativo e ações limitadas. Results administra resultados capturados, exportações e entregas. Pipelines e Extractors abrangem contratos, planejamento de certificação, rascunhos, diferenças, preflight e execução protegida. Workspace, Browser, Workbench, Activity e Nodes completam a visão do nó; Advanced é opcional. Remote View transmite uma aba do navegador e permite controlá-la quando as regras autorizam.

O Guida continua responsável pelo espaço de trabalho, extratores, pipelines, filas, processos de trabalho, execuções, itens, eventos e recuperação. O Control armazena apenas seu cadastro de nós, preferências de conexão, histórico próprio e registros de exportação e entrega no banco SQLite. Esses dados não são uma cópia dos dados operacionais do Guida.

Primeiro, somente leitura

Monitoramento e consulta de contratos funcionam sem controle remoto. Para alterar estado, é preciso habilitar GUIDA_CONTROL_REMOTE_CONTROL=1 no Control e controlEnabled no nó escolhido. Mesmo assim, o Guida toma a decisão final e aplica capacidades, domínios autorizados, regras, confirmações, limites e tempos de espera.

No MVP atual, Remote Ops não autentica clientes. Proteja o canal com ACLs do NetBird, firewall, regras de proxy reverso, túneis localhost, mTLS ou uma medida externa equivalente. Não exponha uma porta Remote Ops diretamente à Internet.

O Guida Node normalmente usa a porta 9631, enquanto o Guida Control serve sua interface em 127.0.0.1:9632. Cadastre o nó, verifique seu estado e compatibilidade e mantenha o controle remoto desativado até que uma operação específica precise alterar dados.

O Control lê o índice compacto do esquema e solicita apenas os contratos detalhados necessários. A edição de pipelines segue a sequência explícita: rascunho, diferenças, salvar ou excluir, validar, preflight, planejar e visualizar. Salvar não inicia uma execução. Consulte Extratores e Pipelines semânticas.

Esta versão alpha exige supervisão nas operações. Ela não promete identidade Enterprise integrada, controle de acesso por função ou qualificação automática de uma frota instalada. Esses recursos continuam futuros até que um contrato publicado os confirme.