Onboarding
Para quem: novo produtor, organizador, curador ou escola
Última revisão: 2026-07-13
Rotas relacionadas: /guides, /guides?code=, /seller
O que você consegue fazer
Pré-requisitos
?code=) ou acesso admin/manager para auto-ativaçãoPasso a passo
Passo 1 — Criar conta
O checklist marca este passo como concluído quando você está autenticado.
Passo 2 — Ativar perfil como organizador
https://subcena.com/guides?code={código}Isso define seu users.role na plataforma e remove o convite usado.
Se o convite não aparecer, verifique se o link está completo e se você está logado com a conta correta.
Passo 3 — Criar organização
Com role ativa, escolha o tipo de organização:
| Tipo | Quem pode criar | Rota |
|---|---|---|
| Casa (venue) | admin, manager, organizer | /seller/new-organization?type=venue |
| Produtora | admin, manager, organizer | /seller/new-organization?type=producer |
| Curadoria | admin, manager, curator | /seller/new-curation |
| Escola | admin, manager, school | /hub/seller/new-school |
Os botões aparecem no passo 3 do checklist em /guides quando você tem permissão e ainda não tem organização.
Após criar com source=onboarding, você volta para /guides. Caso contrário, vai para a página pública da org (/{slug}).
Passo 4 — Ativar pagamentos (Stripe)
Curadores: este passo é omitido do checklist — curadoria não exige Stripe no onboarding.
Para os demais:
/guides, clique em criar perfil comercialGuia completo: Stripe e taxas.
Roles da plataforma
| Role | Label | Pode criar |
|---|---|---|
admin |
administrador | Tudo + painel admin |
manager |
gerente | Convites, orgs, curadorias, escolas |
organizer |
produtora/casa | Casa e produtora |
curator |
curadoria | Curadoria |
school |
escola | Escola |
collaborator |
colaboradora | Acesso limitado (sem criação de org) |
Convites são gerados em /seller por admin (manager, curator, organizer, school) ou manager (curator, organizer, school).
O que acontece nos bastidores
password único usado na URL ?code=updateUserRole valida o código, define users.role e apaga o conviteusers.stripeConnectId), não à organização/guides é calculado em tempo real com queries ConvexProblemas comuns
| Sintoma | Causa provável | O que fazer |
|---|---|---|
| "Convite não encontrado" | Código inválido ou já usado | Peça novo convite à equipe Subcena |
| Não vejo botão de criar org | Role ainda não ativa | Aceite o convite no passo 2 |
| Não vejo opção de curadoria | Role não é curator/manager/admin | Peça convite com role correta |
| Escola não abre pelo /guides | Link incorreto na UI | Use /hub/seller/new-school diretamente |
| Passo 4 não completa | Stripe pendente | Complete configuração no Stripe |
Referências de código (time interno)
app/guides/page.tsx — checklist interativoapp/seller/page.tsx — hub e geração de convitesconvex/users.ts — updateUserRole, createInviteForUser, getInvitationByPasswordconvex/schema/social.ts — roles e invitations