Conceitos fundamentais

O ConnXL é um pequeno conjunto de objetos que se aninham de forma limpa: uma organização detém suplementos, cada suplemento é servido por um agent e dividido em ambientes, e cada ambiente contém ligações e funções. Perceber esta hierarquia torna tudo o resto óbvio.

Organização

O teu tenant. Utilizadores, webhooks de notificação e membros vivem ao nível da organização. Uma organização contém muitos suplementos.

Suplemento

Um suplemento é aquilo que entregas aos teus utilizadores finais: uma entrada no centro de administração do Microsoft 365, um espaço de nomes de fórmulas, um painel de tarefas. Sirvo-lo correndo o binário connxl-agent no teu próprio host — um agent por ambiente (ver abaixo). No dashboard, o suplemento é a coisa de topo que crias, nomeias e entre a qual alternas.

Ambiente

Um suplemento detém um conjunto ordenado de ambientes nomeados — até cinco, configurados a partir do dashboard. Um suplemento novo começa com um único ambiente Development.

Cada ambiente corre o seu próprio agent — o seu próprio processo connxl-agent, autenticado através de um token de inscrição de utilização única trocado por um certificado de cliente mTLS limitado a esse ambiente. É o certificado que decide que ambiente um agent serve. Um suplemento com ambientes Development e Production é servido por dois agents, ativos em paralelo, e um agent pode escalar para várias réplicas que partilham o certificado e a configuração do ambiente.
O ambiente mais baixo (Development) é a fonte — o único sítio onde a estrutura (funções, definições de ligação, botões do friso, o painel de tarefas) é criada ou editada.
Todos os outros ambientes são um alvo de promoção: aí editas apenas valores específicos do ambiente — credenciais, hosts, cache. As edições estruturais são rejeitadas (o backend impõe isto, não apenas a interface).
Promover copia a estrutura da fonte para um ambiente a jusante preservando os valores próprios desse ambiente, por isso podes mover uma alteração para QA ou produção sem tocar nas suas credenciais.

Ligação

Um ponteiro para uma das tuas fontes de dados — uma base de dados, uma HTTP API, uma cloud function, um ficheiro remoto ou uma cache. As ligações são definidas no dashboard (credenciais por referência secret://) e resolvidas pelo agent no momento da execução. Ver Ligações para o catálogo completo.

Função

Uma função mapeia uma ligação para uma fórmula que os teus utilizadores escrevem, por exemplo =CONNXL.SALES.TOP_CUSTOMERS(10). As funções variam ao longo de dois eixos:

Forma do resultado — o aspeto que o resultado tem na grelha: um único valor, uma linha, uma tabela (derrama para um intervalo) ou uma entidade (um tipo de dados ligado com acessores de campo como =A2.Price).
Modelo de execução — sync (calculado localmente), async (o padrão; corre no agent) ou streaming (atualização ao vivo).

A divisão dashboard / agent

O dashboard é a configuração de referência — guarda o que os teus suplementos fazem e envia as alterações para os teus agents por um canal em streaming. O agent é o plano de execução — serve o suplemento ao Excel e executa cada chamada de função contra os teus dados. O dashboard fala apenas com este backend; nunca fala diretamente com o teu agent e nunca toca nas tuas fontes de dados.

A invariante do produto

Os dados do cliente nunca atravessam o nosso backend. As tuas credenciais e os dados das tuas células ficam dentro da tua rede — a única forma de usar o ConnXL é correr um agent. O dashboard vê apenas metadados: latência, estado, resultado de cache e emails de utilizador com hash SHA-256.

Ligações

Os dezasseis tipos de fonte, a autenticação e as referências secret://.

Funções

Tipos, modelos de execução, o construtor e o versionamento com Promover.