public-clubsy

Importacao de jogadores placeholder por modelo (CSV)

Esta importacao cria convites pre-registados (pre_registered = true) na tabela invitations. Nao insere diretamente em team_members.

Objetivo

Permitir carga massiva de jogadores ou staff ainda nao registados na app, usando a mesma metodologia de placeholder manual.

Modelo CSV

Usa como base:

• players_placeholder_import_template_pt.csv

Colunas:

• full_name (obrigatoria)
• email (obrigatoria se nao existir phone)
• phone (obrigatoria se nao existir email)
• role (opcional, por defeito player)
• notes (opcional)
• jersey_number (opcional)
• position (opcional)
• dominance (opcional)
• jersey_name (opcional)
• medical_info (opcional)
• federation_license (opcional)

Fluxo na app

1. Ir para gestao de equipa (Manage Team).
2. Clicar Importar jogadores.
3. Selecionar CSV.
4. Confirmar importacao.
5. Rever resumo (inserted, skipped, error).

Dedupe e validacoes

O RPC aplica validacoes por linha:

• full_name obrigatorio.
• Deve existir email ou phone.
• role deve existir na tabela roles (caso contrario, erro da linha).
• Se ja existir placeholder pendente para a mesma equipa e contacto (email ou phone), a linha fica skipped.

Resultado

Devolve lista por linha com:

• row_no
• status (inserted, skipped, error)
• message
• invitation_id (quando aplicavel)

Notas

• A vinculacao final ao utilizador registado ocorre no fluxo normal de convites/claim.
• Esta importacao e compativel com a abordagem de pre-registo existente.