Guida Control

Guida Control es una aplicación alpha, propietaria e independiente para gestionar Guida Complete y Guida Node desde el navegador. Se conecta mediante la Remote Ops API y no lee directamente los archivos del espacio de trabajo ni las bases de datos de colas, registro o operaciones del nodo.

La imagen pública del contenedor puede usarse para evaluar y operar Guida según la licencia que la acompaña. Que la imagen sea pública no convierte Guida Control en software de código abierto.

Superficie y responsabilidades

Overview y Command Center reúnen avisos, capacidades, trabajo activo y acciones acotadas. Results gestiona resultados capturados, exportaciones y entregas. Pipelines y Extractors cubren contratos, planificación de certificaciones, borradores, diferencias, preflight y ejecuciones protegidas. Workspace, Browser, Workbench, Activity y Nodes completan la vista del nodo; Advanced es opcional. Remote View transmite una pestaña del navegador y permite controlarla cuando las reglas lo autorizan.

Guida sigue siendo responsable del espacio de trabajo, extractores, pipelines, colas, procesos de trabajo, ejecuciones, elementos, eventos y recuperación. Control solo guarda su registro de nodos, preferencias de conexión, historial propio y registros de exportación y entrega en su base SQLite. No es una réplica de los datos operativos de Guida.

Primero, solo lectura

La supervisión y la consulta de contratos funcionan sin control remoto. Para modificar estado deben estar habilitados tanto GUIDA_CONTROL_REMOTE_CONTROL=1 en Control como controlEnabled en el nodo elegido. Aun así, Guida toma la decisión final y aplica sus capacidades, dominios autorizados, reglas, confirmaciones, límites y tiempos de espera.

Remote Ops no autentica clientes en el MVP actual. Protege el canal con ACL de NetBird, firewall, reglas de proxy inverso, túneles localhost, mTLS o una medida externa equivalente. No expongas un puerto Remote Ops directamente a Internet.

Guida Node suele usar el puerto 9631 y Guida Control publica su interfaz web normalmente en 127.0.0.1:9632. Registra el nodo, comprueba su estado y compatibilidad, y deja desactivado el control remoto hasta que una operación concreta necesite cambios.

Control lee el índice compacto del esquema y solicita solo los contratos detallados necesarios. La edición de pipelines sigue la secuencia explícita: borrador, diferencias, guardado o eliminación, validación, preflight, plan y vista previa. Guardar no inicia una ejecución. Consulta Extractores y Pipelines semánticas.

Esta versión alpha requiere supervisión durante las operaciones. No promete identidad empresarial integrada, control de acceso por roles ni calificación automática de una flota instalada. Esas funciones siguen siendo trabajo futuro hasta que exista un contrato publicado.