Backstream

Plataforma para streamers gerenciarem doações vinculadas a metas de mídia ("reagir a isso quando bater X em doações"). Doadores pagam via PIX (Pagar.me, com split de comissão para a plataforma); a mídia sobe de "aguardando meta" para "meta atingida" e depois "reagida". Ver escopo-mvp.md para o que entra/fica fora da primeira versão e a hipótese de negócio por trás.

Arquitetura

Monorepo turborepo com um único serviço hoje:

• apps/api — API HTTP (Fastify + Drizzle/Postgres), monolito modular por bounded context (auth, profile, streamer, media, donation). Ver arquitetura-modulos.md para os módulos, seus contratos públicos e as regras de comunicação entre eles.
• packages/core, packages/shared — utilitários e tipos compartilhados entre módulos/apps (id generation, eventos, tipos comuns).

Decisões arquiteturais significativas ficam registradas como ADRs em apps/api/docs/adr/. Visão de contexto (quem usa o sistema e com quais sistemas externos ele troca dado) em apps/api/docs/c4-context.md.

Estado atual

Ainda não há decisão de deploy/infra de produção.

Rodando localmente

Pré-requisitos: Node >= 18, Postgres acessível via DATABASE_URL.

Outros comandos úteis (rodam em todos os workspaces via turbo):

./kill-8000.sh <porta> mata o processo preso numa porta (default 3333) em dev, se o tsx watch ficar travado.

Banco de dados

Timezone (UTC)

Todas as colunas de data usam timestamptz e a aplicação assume UTC em toda conexão (ver apps/api/src/lib/drizzle.ts, que passa options: '-c timezone=UTC' no startup da Pool).

⚠️ Lembrete: se em algum ambiente você tiver o arquivo de compose do banco sob seu controle, fixe o timezone do Postgres também no servidor, adicionando ao serviço do banco:

Isso garante UTC para qualquer cliente que conecte (app, drizzle-kit, psql, BI), não só para a aplicação. Alternativa server-side persistente: ALTER DATABASE <db> SET timezone TO 'UTC';.