Guia de configuração
Checklist beta mínima para donativos Stripe Checkout, onboarding Stripe Connect, widgets Convex, overlays OBS e chat relay com taxa de plataforma 0%.
1. Runtime
- Define o URL Convex e as chaves Clerk para o painel.
- Define CLERK_JWT_ISSUER_DOMAIN no dashboard Convex.
- Executa Convex codegen depois de configurar o issuer.
2. Pagamentos
- Define STRIPE_SECRET_KEY e STRIPE_WEBHOOK_SECRET no Convex.
- Conclui o onboarding Stripe Connect no painel e confirma que os pagamentos estão prontos.
- Na beta MVP-1, mantém a taxa de plataforma em 0% (as taxas de processamento Stripe continuam a aplicar-se).
- Trata reembolsos e disputas como responsabilidade do streamer, com escalamento para o suporte da plataforma quando necessário.
- Usa o modo de teste Stripe antes dos donativos live.
3. OBS
- Cria ou reutiliza os widgets predefinidos no painel.
- Emite um token de overlay para cada browser source.
- Usa a pré-visualização do painel e um evento de teste antes de copiar o URL para OBS.
4. Chat relay
- Publica o relay com CHAT_RELAY_INTERNAL_SECRET definido.
- Aponta NEXT_PUBLIC_CHAT_RELAY_URL, VITE_CHAT_RELAY_URL e VITE_OVERLAY_FANOUT_URL para o relay alojado.
- Expõe /health para verificações de disponibilidade no painel.
- Publica mensagens de chat apenas pelo endpoint interno bearer-auth.
5. Verificação
- Executa pnpm check:runtime-config, check:vercel-env-shape e check:deployed-auth-config.
- Executa pnpm check:convex-http-smoke, check:public-web-smoke e check:local-drills.
- Trata pnpm check:backlog-completion como a gate final antes da beta.