Documentação técnica do Toterus Worker

Um mapa de onboarding para entender apps, pacotes, Workers, workflows e D1 antes de mexer no monorepo.

Começar pelo setup Ver no GitHub
monorepo.txt
wrangler.jsonc 
packages/
  auth/          # Better Auth compartilhado
  db/            # Drizzle e D1
  ui/            # componentes React
  workflow-core/ # contratos de workflow
apps/
  api/
  monitor/
  workflows/

Comece Aqui

Visão geral

Documentação técnica do Toterus Worker

Este site é o ponto de entrada para novos desenvolvedores entenderem o monorepo. Use esta visão geral para localizar os runtimes, pacotes compartilhados e fluxos que sustentam o projeto antes de alterar código.

Setup local

Ambiente, comandos iniciais e validações para rodar o projeto em desenvolvimento.

Mapa do repositório

Como os apps, pacotes e documentos se organizam no monorepo.

API worker

Rotas HTTP, bindings e contratos expostos pelo Worker de API.

D1 compartilhado

Uso do banco D1 compartilhado, migrations e estado local de desenvolvimento.

Este bloco é uma ilha React usando componentes do pacote compartilhado @repo/ui.

Runtimes principais

O monorepo separa a interface operacional, as rotas públicas e a execução assíncrona em apps próprios. Comece pelo mapa do repositório e siga para os runtimes que você precisa alterar.

Monitor

Monitor é a aplicação usada para acompanhar execuções, estados e operações do ambiente. Ela é o melhor ponto de entrada para entender o comportamento do sistema em runtime.

API worker

API worker concentra as requisições HTTP e integra os clientes externos com os pacotes compartilhados. Consulte API worker para revisar rotas, contratos e dependências.

Workflows

Workflows executam processos assíncronos e preservam o ciclo de vida das operações de longa duração. A página Workflows worker explica o app responsável por essa execução.

Leitura recomendada

Depois da visão geral, siga para Setup local e para D1 compartilhado e migrations antes de mudar código que dependa de banco ou Workers.

Fluxos compartilhados

O onboarding também cobre autenticação, requisições de API, lifecycle de workflows e deploy. Essas páginas dão contexto suficiente para uma mudança pequena sem duplicar todos os detalhes que continuam pertencendo ao código-fonte.

Próximo
Setup local