Status: Approved · v2 · SPEC-UX-TORCIDA-MGMT-001
depends_on: SPEC-DOMAIN-TORCIDA-001, SPEC-UX-MANAGEMENT-001
used_by: IS-MVP-08.1, IS-MVP-08.2, IS-MVP-08.3
Gestão da torcida
Gestão de identidade, aprovação, membros, conteúdo, carteira, sponsors e acessos da torcida.
Objetivo
Gestão de identidade, aprovação, membros, conteúdo, carteira, sponsors e acessos da torcida.
Pontos de entrada
- Minha Gestão.
- Notificação de aprovação do time.
- Página pública.
Hierarquia da tela
- Dashboard com status de aprovação.
- Dados/identidade e time vinculado.
- Membros e pedidos.
- Convites.
- Publicações.
- Carteira e transfers.
- Patrocínios.
- Permissões/auditoria.
- Configurações.
Componentes e comportamento
Approval Checklist
Enquanto pending/rejected, mostra o que pode ser editado e o que está bloqueado.
Member Queue
Pedidos pending com contexto e ações; lista active e histórico removido.
Join Mode Settings
Open, approval_required e invite_only com explicação de efeito público.
Transfer Panel
Somente time vinculado, saldo/custo e confirmação.
Public Preview
Visualiza página sem fingir aprovação.
Ações do usuário
| Ação | Pré-condição | Resultado | Falha/alternativa |
|---|---|---|---|
| Reenviar aprovação | Owner | Pending | Sem alterações/limite |
| Aprovar membro | manageMembers | Active | Já resolvido |
| Convidar | manageMembers | Invite | Duplicado |
| Transferir créditos | manageWallet | Ledger em ambas | Saldo/vínculo |
| Publicar | managePosts | Post | Status não approved |
Estados obrigatórios
| Estado | Representação | Ação disponível |
|---|---|---|
| Pending team approval | Módulos financeiros bloqueados | Editar/revisar |
| Rejected | Motivo e reenviar | Corrigir |
| Approved | Completa | — |
| No members | Empty | Convidar |
| Suspended/ended | Read-only | Suporte |
Autenticação e permissões
- Roles da torcida independem das do time.
- Gestor do time aprova existência, não ganha gestão automática.
- Financeiro restrito.
Responsividade
- Mobile listas e bottom sheets.
- Desktop tabelas de membros e side panel de detalhes.
Acessibilidade
- Estado de aprovação em texto.
- Ações de membro confirmadas.
- Transferência descreve valores.
Eventos de produto e observabilidade
- torcida_management_viewed
- torcida_resubmitted
- member_approved
- join_mode_changed
- wallet_transfer_started
Dados e endpoints
- Torcida management, members, wallet, sponsors, feed e management.
Critérios de aceite
- Pending/rejected bem tratados.
- JoinMode completo.
- Transfers somente time vinculado.
- Acessos independentes.
Pós-MVP
- Votações e eventos.
Decisões registradas
- Torcida possui gestão própria após aprovação.
Machine summary
spec: SPEC-UX-TORCIDA-MGMT-001
screen_or_flow: Gestão da torcida
required_states:
- loading
- success
- empty
- error
must_use:
- contracts
- service
- hook
- design_tokens
must_not:
- direct_fetch
- direct_fixture_import
- hardcoded_brand_colors