Pular para o conteúdo

Para mantenedores

Arquitetura para mantenedores

Responsabilidades do Engine, Contracts, compilador e Runtime.

Nesta página

Três projetos, uma plataforma

Engine reúne interface Next.js, autenticação, persistência Prisma e coordenação das execuções. Contracts contém os tipos, schemas, catálogo e validações compartilhados. Runtime executa os fluxos e integra as operações com o Discord.

A documentação descreve interfaces existentes, não cria uma segunda implementação do catálogo. Versão de produto, versão do pacote Contracts e revisão publicada de um bot são identidades diferentes.

Do Canvas à execução

Salvar um rascunho não altera automaticamente a revisão em execução. A posição de um cartão no Canvas não substitui uma conexão válida.

  1. O Builder produz um documento com entradas, etapas, conexões de execução e referências de dados.

  2. A validação confere tipos, alcance das etapas, caminhos, assinatura das entradas e capacidades do plano.

  3. A publicação cria uma revisão do bot. O compilador transforma a representação autoral em FlowIR, a representação usada pela execução.

  4. O Runtime autorizado recebe uma atribuição e executa essa revisão com o contexto real do Discord.

Compatibilidade e isolamento

Mudanças em contratos compartilhados precisam de revisão conjunta de Builder, compilador, Engine e Runtime. Não renomeie campos de documentos publicados sem uma estratégia explícita de compatibilidade.

O controle de acesso do proprietário, o isolamento por bot e os limites do plano continuam no servidor; validação visual não substitui esses controles.