Skip to main content

Arquitetura

BuildZero é um monorepo com 6 serviços e 3 packages compartilhados, conectados via event bus (QStash).

Fluxo de uma mensagem

1

Telegram recebe mensagem

O webhook do Telegram Worker recebe a mensagem do usuário.
2

Gate autentica

O Telegram Worker chama o AI gate (Vercel) que valida o canal, identifica o usuário, e retorna tokens de sessão.
3

Bus publica evento

O Telegram Worker publica message.received via QStash para o AI Worker.
4

AI Worker processa

O AI Worker carrega histórico da sessão, cria o contexto com tools, e chama o Claude com streaming.
5

Streaming para Telegram

As respostas são enviadas em tempo real via edits progressivos na mensagem do Telegram.
6

Callback de conclusão

Ao finalizar, o AI Worker publica message.response de volta pro Telegram Worker para limpar a fila.

Mapa de serviços