Status: Approved · v2 · SPEC-UX-FIELD-SERVICE-001

depends_on: SPEC-DOMAIN-FIELD-001, SPEC-DOMAIN-SERVICE-001

used_by: IS-MVP-01.6, IS-MVP-01.7, IS-MVP-13.1, IS-MVP-13.2, IS-MVP-13.3

Páginas e gestão de campos e serviços

Campos e serviços precisam de presença pública útil sem simular reservas ou marketplace no MVP.

Objetivo

Campos e serviços precisam de presença pública útil sem simular reservas ou marketplace no MVP.

Pontos de entrada

• Busca/território.
• Partida.
• Página de entidade.
• Minha Gestão.

Hierarquia da tela

1. Campo: identidade, localização, contato, jogos, galeria, sobre e denúncia.
2. Serviço: identidade, tipo, território, portfólio, providers, eventos, contato e denúncia.
3. Gestão separada para dados, mídia/providers/eventos, permissões e status.

Componentes e comportamento

Contact Action

Abre telefone/WhatsApp/site externo com confirmação quando necessário.

Address Surface

Public/approximate/private. Sem mapa obrigatório.

Showcase

Galeria/catálogo com imagem, título, descrição e link.

Provider List

Registered/unregistered com vínculo aprovado.

Event Links

Partidas/campeonatos recentes e função prestada.

Unclaimed Banner

Revisar, reivindicar ou anonimizar.

Ações do usuário

Ação	Pré-condição	Resultado	Falha/alternativa
Entrar em contato	Dado público	App/site externo	Contato ausente
Abrir jogo	Público	Partida	Unavailable
Vincular provider	Permission	Requested	Duplicate
Vincular evento	Contextual	Requested/approved	Permission
Reivindicar	Abandoned/unclaimed	Support request	Not eligible

Estados obrigatórios

Estado	Representação	Ação disponível
No gallery/showcase	Empty contextual	Gestão adiciona
Address private	Texto aproximado	Contato
Unclaimed	Banner	Claim/privacy
Inactive/closed	Aviso	Histórico
Suspended	Limitado	—

Autenticação e permissões

• Leitura pública.
• Gestão por memberships.
• Provider cadastrado aceita.
• Sem wallet/sponsor.

Responsividade

• Mobile prioriza contato e conteúdo visual.
• Desktop usa colunas e grid de portfólio.

Acessibilidade

• Links externos identificados.
• Endereço e contatos legíveis.
• Galeria com alt.

Eventos de produto e observabilidade

• field_viewed
• service_viewed
• external_contact_clicked
• provider_link_started
• event_link_started
• entity_claim_started

Dados e endpoints

• Fields/services/providers/event links.

Critérios de aceite

• Sem CTA reserva/contratar interno.
• Privacy de endereço/provider.
• Páginas e gestão completas.

Pós-MVP

• Reservas/marketplace/avaliações.

Decisões registradas

• Contato externo resolve MVP.

Machine summary

spec: SPEC-UX-FIELD-SERVICE-001
screen_or_flow: Páginas e gestão de campos e serviços
required_states:
  - loading
  - success
  - empty
  - error
must_use:
  - contracts
  - service
  - hook
  - design_tokens
must_not:
  - direct_fetch
  - direct_fixture_import
  - hardcoded_brand_colors