Status: Approved · v2 · SPEC-UX-TERRITORY-001
depends_on: SPEC-DOMAIN-TERRITORY-001
used_by: IS-MVP-03.3
Telas de distrito e bairro/quebrada
Território deve contextualizar descoberta e ranking sem criar governança fictícia de comunidade no MVP.
Objetivo
Território deve contextualizar descoberta e ranking sem criar governança fictícia de comunidade no MVP.
Pontos de entrada
- Busca.
- Perfil/entidades.
- Links territoriais.
Hierarquia da tela
- Hero com nome, município/estado e label regional.
- Resumo de atividade.
- Times, jogos, campeonatos, torcidas, jogadores/serviços públicos e rankings.
- Neighborhoods dentro do distrito.
- Feed/cards territoriais limitados.
Componentes e comportamento
Territory Header
Não usa mapa obrigatório. Mostra hierarquia e label regional.
Discovery Sections
Coleções com Ver todos e filtros.
Rankings
Times, torcidas e artilharia com período.
Neighborhood List
Links e contagens públicas; sem botão Gerenciar.
Vocabulary
UI exibe Bairro/Quebrada/Comunidade conforme resolver.
Ações do usuário
| Ação | Pré-condição | Resultado | Falha/alternativa |
|---|---|---|---|
| Seguir território | Autenticado | Follow | AuthIntent |
| Abrir entidade | Público | Página | Unavailable |
| Trocar período | — | Ranking atualizado | — |
Estados obrigatórios
| Estado | Representação | Ação disponível |
|---|---|---|
| No activity | Explica início do território | Buscar município/distrito |
| Merged/inactive | Redirect/banner | Abrir canônico |
| Loading/partial | Skeleton por seção | Retry |
Autenticação e permissões
- Leitura pública.
- Neighborhood não gerenciável.
Responsividade
- Mobile seções verticais.
- Desktop grid e ranking lateral.
Acessibilidade
- Hierarquia geográfica em texto.
- Rankings/tabelas acessíveis.
Eventos de produto e observabilidade
- district_viewed
- neighborhood_viewed
- territory_followed
- territory_section_opened
Dados e endpoints
- GET districts/neighborhoods e discovery/rankings.
Critérios de aceite
- Hierarquia clara.
- Label regional.
- Sem gestão/carteira/sponsor de neighborhood.
- Descoberta completa.
Pós-MVP
- Mapas, raio e governança.
Decisões registradas
- Distrito obrigatório e Neighborhood agregador.
Machine summary
spec: SPEC-UX-TERRITORY-001
screen_or_flow: Telas de distrito e bairro/quebrada
required_states:
- loading
- success
- empty
- error
must_use:
- contracts
- service
- hook
- design_tokens
must_not:
- direct_fetch
- direct_fixture_import
- hardcoded_brand_colors