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

┌─────────────────────────────────────────────────┐
│                   Telegram Bot                   │
│              (Cloudflare Worker)                  │
└──────────┬──────────────────┬───────────────────┘
           │ gate             │ QStash
           ▼                  ▼
┌──────────────────┐  ┌──────────────────────────┐
│    AI Service    │  │      AI Worker           │
│    (Vercel)      │  │  (Cloudflare Worker)     │
│  auth + sessões  │  │  Claude + tools + stream │
└──────────────────┘  └────────┬─────────────────┘
                               │
                    ┌──────────┼──────────┐
                    ▼          ▼          ▼
              ┌─────────┐ ┌────────┐ ┌────────┐
              │ Daemon  │ │Sandbox │ │Meta API│
              │(WebSocket)│(Container)│(Graph) │
              └─────────┘ └────────┘ └────────┘