SuperdindaDocs

Rodando os apps

Comandos de dev, build e ci de cada app.

Todos os apps usam bun. Cada pasta é independente: bun install dentro dela.

Backend

backend/
cp .env.example .env
bun install
docker compose up -d   # postgres 5432, postgres-test 5433, redis, WAHA 3001, MinIO 9000
bun run migrate
bun run seed
bun run dev            # api em http://localhost:3000 (Scalar em /docs)
bun run gateway        # :3002, webhooks do WAHA
bun run workers        # pareamentos
bun run ci             # prettier, tsc, drift do openapi.json, testes

Platform, backoffice e site

apps/platform (3100) · apps/backoffice (3200) · apps/site (3200)
bun install
bun run dev
bun run ci             # prettier, eslint, typecheck, testes, build

O platform também expõe /__ds (com DS_ROUTE_ENABLED=1): a matriz de paridade com o Figma, usada pelas lanes do design system.

Site e backoffice usam a mesma porta

apps/site e apps/backoffice sobem os dois na 3200. Rode um de cada vez, ou passe outra porta (bun run dev -- -p 3201).

Docs

apps/docs (3300)
bun install
bun run dev            # http://localhost:3300
bun run ci             # prettier, eslint, typecheck, build

O docs importa os componentes e os tokens do pacote @superdinda/ui (packages/ui) e lê design-system/ no build, então ele precisa do layout do monorepo (não dá pra publicar a pasta sozinha). O playground da API chama o servidor escolhido na página; o padrão é http://localhost:3000. Para pôr outro servidor em primeiro, use DOCS_API_URL.

Atualizar a referência da API

backend/
bun run openapi:export   # reescreve apps/docs/openapi.json, sem banco
bun run openapi:check    # falha se o arquivo commitado estiver velho (roda no ci)

On this page