Status: Approved · v2 · SPEC-UX-GAMES-001

depends_on: SPEC-DOMAIN-MATCH-001, SPEC-UX-SHELL-001

used_by: IS-MVP-06.1

Aba Jogos e fluxos de partida

Aba Jogos reúne agenda e resultados do usuário sem misturar gestão complexa com consumo público.

Objetivo

Aba Jogos reúne agenda e resultados do usuário sem misturar gestão complexa com consumo público.

Pontos de entrada

• Aba Jogos.
• Atalhos de time/campeonato.
• Notificações.

Hierarquia da tela

1. Segmentos Próximos, Resultados e Pendências quando autenticado/gestor.
2. Filtros por data, time seguido/gerido, campeonato, categoria e status.
3. Lista agrupada por data.
4. Cards compactos com times, status, placar/data, campo e contexto.
5. CTA criar partida somente em contexto de gestão.

Componentes e comportamento

Match List Card

Não parece brinquedo: tipografia clara, escudos pequenos, metadata e status textual.

Date Group

Cabeçalho sticky opcional e timezone local.

Pending Section

Somente ações relevantes ao usuário: validar resultado, informar placar, contestação ou convidado.

Create Match Entry

Abre seleção da entidade gerida antes do formulário.

Ações do usuário

Ação	Pré-condição	Resultado	Falha/alternativa
Abrir partida	Público	Página	Unavailable
Filtrar	—	Lista atualizada	Empty
Criar partida	match.create	Fluxo de gestão	Sem entidade/permissão
Resolver pendência	Permission contextual	Ação do domínio	Conflito

Estados obrigatórios

Estado	Representação	Ação disponível
No followed entities	Orientação para buscar/seguir	Buscar
No games	Mensagem por período	Alterar filtros
Pending expired	CTA desabilitado	Ver contexto
Loading/error	Skeleton/list retry	Retry

Autenticação e permissões

• Lista pública/seguida conforme contexto.
• Pendências filtradas por permission.
• Criar só em entidade gerida.

Responsividade

• Mobile lista de uma coluna e filtros sheet.
• Desktop calendário/lista opcional, mas MVP prioriza lista consistente.

Acessibilidade

• Datas completas.
• Placar e status anunciados.
• Filtros acessíveis.

Eventos de produto e observabilidade

• games_tab_viewed
• games_filter_changed
• match_opened
• match_create_started
• pending_action_opened

Dados e endpoints

• GET /matches com filtros.
• GET /notifications?category=matches_events para pendências.

Critérios de aceite

• Agenda e resultados completos.
• Pendências autorizadas.
• Sem calendário complexo obrigatório.
• Card profissional.

Pós-MVP

• Calendário avançado, exportação e live.

Decisões registradas

• Aba Jogos serve consumo e entrada de pendências, não substitui painel da entidade.

Machine summary

spec: SPEC-UX-GAMES-001
screen_or_flow: Aba Jogos e fluxos de partida
required_states:
  - loading
  - success
  - empty
  - error
must_use:
  - contracts
  - service
  - hook
  - design_tokens
must_not:
  - direct_fetch
  - direct_fixture_import
  - hardcoded_brand_colors