Organização

Para quem: produtor, organizador, curador, escola

Última revisão: 2026-07-13

Rotas relacionadas: /seller, /seller/new-organization, /seller/new-curation, /hub/seller/new-school, /seller/dashboard/[id]

O que você consegue fazer

Criar e editar perfil da organização (casa, produtora, curadoria ou escola)

Acessar dashboard com métricas

Gerenciar equipe (colaboradores)

Configurar bar, loja e outras extensões conforme o tipo

Pré-requisitos

Conta ativa com role adequada (ver Onboarding)

Stripe Connect configurado para vender ingressos (produtoras e casas)

Tipos de organização

O tipo é definido por flags booleanas, não por um campo único:

Tipo	Flag no banco	Slug prefix	Label na UI
Casa (venue)	`isVenue: true`	`prod-`	casa
Produtora	todas false	`prod-`	produtora
Curadoria	`isCuration: true`	`curation-`	curadoria
Escola	`isSchool: true`	`school-`	escola

Ordem de resolução no código: school → venue → curation → producer (default).

Passo a passo — Criar organização

Casa ou produtora

Acesse /seller/new-organization?type=venue (casa) ou ?type=producer (produtora)

Preencha nome, descrição, imagem e demais campos do formulário

Salve — a org é criada com slug prod-{nome}-{4dígitos}

Curadoria

Acesse /seller/new-curation

Preencha o formulário de curadoria

Slug gerado: curation-{nome}-{4dígitos}

Escola

Acesse /hub/seller/new-school

Preencha dados da escola

Slug gerado: school-{nome}-{4dígitos}

Formulário compartilhado: OrganizationForm → mutation api.organizations.create.

Passo a passo — Gerenciar organização

Hub principal

/seller lista todas as suas organizações via OrganizationsPanel e OrganizationCard.

Visão geral do hub, mapa de rotas e funções do dia a dia: 00 — Hub do produtor.

Editar perfil

Tipo	Rota de edição
Casa, produtora, escola	`/seller/organizations/[id]/edit`
Curadoria	`/seller/organizations/curation/[id]/edit`

Dashboard

Tipo	Rota
Casa / produtora / escola	`/seller/dashboard/[id]`
Curadoria	`/seller/dashboard/curation/[id]`

O dashboard mostra métricas em tempo real (vendas, eventos, engajamento).

Página pública

Cada org tem página pública em https://subcena.com/{slug}.

Equipe e colaboradores

No card da organização (OrganizationCard), o dono pode:

Convidar colaboradores

Definir roles por org: admin, manager

Remover membros

Role na org	Permissões
owner	Dono (`organization.userId`) — acesso total
`admin`	Gestão completa da equipe
`manager`	Criar eventos, métricas, editar perfil

Colaboradores não substituem o dono no Stripe — pagamentos continuam vinculados ao stripeConnectId do usuário dono.

Recursos por tipo

Recurso	Casa	Produtora	Curadoria	Escola
Eventos próprios	Sim	Sim	Eventos curados	Aulas
Bar digital	Sim	—	—	—
Loja	Sim	Sim	—	—
Crowdfunding	Sim	Sim	—	—
Programa fidelidade	Sim	—	—	—
Instrutores	—	—	—	`/hub/seller/instructors`

Status da organização

Status	Significado
`active`	Operando normalmente
`inactive`	Inativa
`suspended`	Suspensa pela plataforma

O que acontece nos bastidores

O userId da org é quem criou; eventos criados por colaboradores ficam vinculados ao dono da org

Seguidores da org recebem push quando um evento público novo é publicado

Curadorias têm fluxo de ciclos (curatorCycles) separado de eventos de produção direta

Problemas comuns

Sintoma	Causa provável	O que fazer
Não consigo criar evento	Stripe do dono inativo	Dono deve completar `/guides`
Colaborador não vê org	Não foi adicionado à equipe	Dono adiciona via OrganizationCard
Dashboard vazio	Sem eventos/vendas ainda	Crie e publique um evento
Tipo errado na UI	Flags conflitantes	Escola/venue/curation têm prioridade na resolução

Referências de código (time interno)

components/organization/OrganizationForm.tsx — formulário de criação

components/organization/OrganizationCard.tsx — ações e tipo

components/organization/OrganizationsPanel.tsx — lista no seller

components/seller/dashboard/OrganizationDashboard.tsx — dashboard

convex/organizations.ts — CRUD e colaboradores

convex/schema/organizations.ts — schema e flags