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.
O Builder produz um documento com entradas, etapas, conexões de execução e referências de dados.
A validação confere tipos, alcance das etapas, caminhos, assinatura das entradas e capacidades do plano.
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.
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.