Status: Approved · v2 · SPEC-UX-CHAMP-MGMT-001
depends_on: SPEC-DOMAIN-CHAMPIONSHIP-001, SPEC-UX-MANAGEMENT-001
used_by: IS-MVP-07.1, IS-MVP-07.2, IS-MVP-07.3, IS-MVP-07.4, IS-MVP-07.5
Gestão do campeonato
Fluxo orientado por etapas para construir e operar uma edição sem esconder a complexidade real.
Objetivo
Fluxo orientado por etapas para construir e operar uma edição sem esconder a complexidade real.
Pontos de entrada
- Minha Gestão.
- Página pública → Gerenciar.
- Pendências de inscrição, resultado ou disciplina.
Hierarquia da tela
- Dashboard da edição.
- Identidade e publicação.
- Edições.
- Regulamento.
- Inscrições e atletas.
- Formato e fases.
- Fixtures e calendário.
- Partidas/resultados.
- Classificação/estatísticas.
- Disciplina.
- Permissões/auditoria.
Componentes e comportamento
Publication Gate
Draft, preço, Pix, expiração e checklist mínimo para publicar.
Edition Builder
Dados, janelas, categoria e status.
Regulation Editor
Texto livre, regras estruturadas, PDF e lock/versionamento.
Registration Board
Invites, requests, approved/rejected e listas de atletas.
Format Wizard
Mostra formatos MVP, requisitos e preview da estrutura.
Fixture Generator
Configura, gera em preview, valida duplicidade e confirma. Datas podem ficar pendentes.
Discipline Center
Regras, cartões, pendurados, suspensões e overrides com motivo.
Standings Preview
Explica que somente validated entra.
Ações do usuário
| Ação | Pré-condição | Resultado | Falha/alternativa |
|---|---|---|---|
| Publicar | championship.publish | Payment waiting | Checklist/payment |
| Criar edição | manageEdition | Draft edition | Duplicidade |
| Salvar regulamento | manageRegulation | Version | Locked |
| Aprovar inscrição | manageRegistrations | Approved | Elegibilidade |
| Gerar fixtures | manageFixtures | Preview | Formato/participants |
| Confirmar fixtures | manageFixtures | Created | Conflito |
| Override disciplina | manageDiscipline | Audit | Motivo obrigatório |
Estados obrigatórios
| Estado | Representação | Ação disponível |
|---|---|---|
| Draft | Fluxo livre | Publicar |
| Waiting payment | QR e timer | Checar/novo Pix |
| Registration open | Fila e prazo | Gerir |
| In progress | Config crítica locked | Operar |
| No participants | Bloqueia geração | Inscrever |
| Contested match | Classificação com aviso | Resolver |
| Finished | Read-only parcial | Histórico |
Autenticação e permissões
- Módulos por role.
- Publish financeiro.
- Discipline separada.
- Time gestor só vê inscrição própria.
Responsividade
- Mobile usa steps, cards e tabelas compactas.
- Desktop usa sidebar da edição e tabelas densas.
- Fixture/bracket tem alternativa textual.
Acessibilidade
- Wizard sem dependência de drag-and-drop.
- Tabelas semânticas.
- Locks e overrides explicados.
Eventos de produto e observabilidade
- champ_management_viewed
- publish_started
- edition_created
- regulation_saved
- registration_resolved
- fixtures_generated
- discipline_override
Dados e endpoints
- Championship API completa e payments.
Critérios de aceite
- Todos os formatos e módulos MVP.
- Publish realista.
- Regulation lock.
- Fixtures preview/confirm.
- Discipline audit.
Pós-MVP
- Bilheteria, arbitragem e sorteios.
Decisões registradas
- Configuração avançada progressiva.
- Draft gratuito.
- Edição é contexto principal.
Machine summary
spec: SPEC-UX-CHAMP-MGMT-001
screen_or_flow: Gestão do campeonato
required_states:
- loading
- success
- empty
- error
must_use:
- contracts
- service
- hook
- design_tokens
must_not:
- direct_fetch
- direct_fixture_import
- hardcoded_brand_colors