2026-01-18_onboarding-player-registration

🧭 Contexto

Precisávamos transformar a base (CPF + Player) em um fluxo real de onboarding, onde o usuário se cadastra e já nasce com um perfil de Player. Além disso, o endereço deve ser preenchido via CEP usando o endpoint interno GET /api/cep/{cep}.

✅ Decisão

• Criar a tela Livewire Onboarding/RegisterPlayer em /cadastro.
• Ao enviar o formulário, executar uma Action única (RegisterPlayerOnboardingAction) que cria User + Player e atribui a role player.
• Buscar endereço no front via fetch('/api/cep/{cep}') e preencher rua/bairro/cidade/UF; o usuário digita apenas o número (e complemento opcional).
• Captura de GPS opcional via navigator.geolocation para já popular latitude/longitude.

🛠️ Passos (comandos via Sail)

• sail artisan migrate
• sail artisan test

🧪 Validação

• Acesse http://localhost/cadastro e preencha:
  • CPF válido
  • CEP + botão "Buscar CEP" (autopreenche rua/bairro/cidade/UF)
  • Número manual
• Submeter deve autenticar e redirecionar para o Dashboard.

📦 Impacto

• Onboarding funcional para Player (sem depender de scaffolding externo de auth).
• Player agora suporta endereço e coordenadas para features futuras (“perto de mim”, matchmaking, ranking por região).