KOLOS — Play Card Beach Tennis 2026: metodologia, categorias e estratégia de módulo

Documento de referência (pedido de produto + estratégia técnica). O layout visual final do Play Card será detalhado numa mensagem seguinte; este ficheiro fixa critérios, regras de negócio e plano de evolução no stack Laravel / Livewire / Flux Pro (área jogador e área treinador, incluindo o formulário de avaliação).

1. Objetivos

Reduzir subjetividade: notas ancoradas em KPIs técnicos e táticos (metodologia 2026), alinhada a referências de alto rendimento e estrutura tipo CBT/ITF.
Treinador credenciado (academy.coach.credentialed ou equivalente no ACL) regista avaliações; o sistema sugere evolução de categoria com base nas métricas.
Futuro: critérios de torneios para promoção automática (fora do âmbito imediato).
Play Card visual (atleta): gráfico radar / spider com Flux Pro (ex.: my-card, play card público).
Avaliação (treinador credenciado): fluxo na área Academy do coach — Livewire + Flux Pro (ex.: extensão do roster da turma ou rota dedicada sob academy.*), com o mesmo design system que o resto do shell do treinador; não como formulário primário em Filament, salvo ferramentas internas de admin se forem necessárias mais tarde.

2. Modelo de critérios (fundamentos)

Cada eixo principal é avaliado numa escala 0–99 (estilo RPG/FIFA). Para evitar nota “aleatória”, cada critério é conceptualmente composto por 3 sub-pilares:

Sub-pilar	Significado
C	Consistência
P	Precisão / Direção
PO	Potência

Eixos (códigos)

Código	Fundamento
SRV	Serviço
DEV	Devolução
VOL	Vólei
SMA	Smash
DEF	Defesa
FIS	Físico

Faixas de interpretação por eixo (0–99)

Estas faixas servem de rubrica para o treinador e para copy na UI (tooltips, manual in-app). A nota final por eixo continua a ser um número; os intervalos abaixo descrevem o que esse número representa.

SRV — Serviço

0–30: Apenas coloca a bola em jogo; muitas faltas de saque.
31–60: Saque com direção (curto/longo) e consistência ~70% de acerto.
61–85: Uso de efeito (slice), busca extremidades e “T”; faltas raras.
86–99: Saque como arma de ponto direto (>120 km/h ou efeito extremo).

DEV — Devolução

0–30: Devolve balões ou ao meio; dificuldade com saques potentes.
31–60: Bloqueia saques e direciona aos pés do sacador.
61–85: Devolução agressiva, acelera ou short-angle.
86–99: Antecipação profissional; defesa do saque vira ataque imediato.

VOL — Vólei

0–30: Movimento tipo “ping-pong”; sem firmeza no pulso.
31–60: Vólei de bloqueio e construção de ponto.
61–85: Vólei curto (amortie), ângulos; erros mínimos em bolas fáceis.
86–99: Reflexos de elite; acelera vôleis baixos.

SMA — Smash

0–30: Erra ou sem força; medo de bolas altas.
31–60: Finaliza bolas altas ao meio; boa movimentação de pernas.
61–85: Gancho/smash com salto; direcionamento para fora (ângulos).
86–99: Letalidade >90% em bolas acima da cabeça.

DEF — Defesa

0–30: Reação lenta; não alcança laterais.
31–60: Boa leitura; “levanta” para o parceiro.
61–85: Recuperações acrobáticas; contra-ataque sob pressão.
86–99: Muralha; ralis intensos por longos períodos.

FIS — Físico

0–30: Cansaço rápido após 2 sets; pouca explosão na areia.
31–60: Resistência para torneio de um dia; boa mobilidade lateral.
61–85: Alta explosão e recuperação rápida entre pontos.
86–99: Elite; VO2 alto e força explosiva específica para areia profunda.

3. Categorização global (0–99 agregado)

A categoria exibida no Play Card (e regras de “promoção”) deve derivar de uma pontuação global (ex.: média dos 6 eixos, ou média ponderada — pesos a definir em produto).

Faixa (global)	Categoria	Descrição resumida
0–19	D — Iniciante	Passar a bola; pouco controlo de direção/profundidade.
20–45	C — Intermédio	Início de jogo estratégico; saque com direção; vólei consistente.
46–70	B — Avançado	Efeitos (slice/top spin); transição defesa-ataque rápida.
71–90	A — Especialista	Alta potência; poucos erros não forçados; leitura tática.
91–99	PRO	Nível competição internacional (ITF); preparo físico/técnico de elite.

Nota de coexistência com o código atual: hoje o KOLOS usa players.level (inteiro) e PlayCardLetterTier (D/C/B/A) por faixas de nível, mais skill_rating (elo). A metodologia 2026 introduz categoria por média 0–99 e possivelmente PRO. Plano: manter level/elo como legado até migração; passar a fonte de verdade da categoria oficial para o agregado da avaliação credenciada + regras de promoção, com período de convivência documentado em migração de dados.

4. Filosofia do formulário (Flux Pro — área treinador)

UI construída com Flux Pro (flux:field, flux:input, sliders, steppers ou inputs fraccionários “acertos/tentativas”, flux:callout para rubricas, etc.), orquestrada por Livewire (validação, authorize, estado por aluno/turma).
Não pedir “nota final” aberta por fundamento.
Preferir frequência de acerto em tarefas observáveis, depois mapear para 0–99 no domínio (Action) — ex.: 8/10 áreas corretas em saques forçados → 80 naquele eixo ou sub-pilar.
Opcional (fase 2+): guardar raw (acertos/tentativas) além do score derivado, para auditoria e relatórios.

5. Trava de promoção (“promover para B / A / PRO”)

Requisitos combinados (parametrizáveis):

Média global ≥ teto definido para o alvo (ex.: média ≥ 70 para elegível a B, ≥ 71 para A, etc. — ajustar tabela com produto).
Homogeneidade: desvio padrão entre as 6 notas ≤ limiar (ex.: não promover se um eixo estiver muito aquém — “jogador torto” no radar).
Papel: só treinador credenciado vê ações de promoção; o sistema pode mostrar “Sugestão: elegível a B” mesmo quando o botão está desativado, com motivo (média, dispersão, avaliação em falta).

Futuro: regras paralelas baseadas em resultados de torneios para promoção automática.

6. UI sugerida (Flux Pro / Livewire)

Treinador — ecrã de avaliação: layout responsivo alinhado ao app-shell do coach (sidebar Academia); pré-visualização opcional do radar com os valores em edição antes de gravar.
Atleta — radar (spider chart) nos eixos SRV, DEV, VOL, SMA, DEF, FIS — fraquezas vs pontos fortes (ex.: DEV 69 vs DEF 87).
Verificar em Flux Pro 2.x componentes de chart; se não houver radar nativo, encapsular Chart.js / similar num componente Blade/Livewire com tokens KOLOS (stone/amber).
My Card e Play Card público: mesma linguagem visual; público pode omitir detalhe de sub-pilares se política de privacidade exigir.

7. Estratégia de implementação em módulo (fases)

Fase	Entrega	Notas técnicas
0	Este documento + enums/DTOs stub	`CriterionCode` (SRV…FIS), `PlayCardCategory2026` (D,C,B,A,PRO), constantes de faixas.
1	Persistência	Tabela(s) `player_beach_evaluations` ou `player_criterion_scores` (evaluation_id, criterion, score 0–99, optional C/P/PO breakdown JSON); FK para `users`/`players`; `evaluated_by`, `evaluated_at`.
2	UI treinador (Flux Pro)	Livewire na área coach (middleware + `academy.coach.credentialed`): fluxo “Avaliar Play Card” por aluno/turma — frequência → scores; histórico e rascunhos conforme produto.
3	Agregação + sugestão	Action `SuggestPlayCardCategoryAction`; política de promoção (média + stdev); integrar com roster existente (stats oficiais) sem quebrar fluxo atual.
4	Front jogador	Livewire + Flux: radar no `my-card` e ajuste do Play Card público.
5	Torneios	Eventos de resultado → regras automáticas de elegibilidade/promoção.

8. Testes e qualidade

Pest: matriz de conversão frequência → score; limites de categoria; trava de promoção (média OK + stdev alto = não promove).
Políticas: apenas credenciado cria/edita avaliação que altera categoria oficial.

9. Próximo passo (dependência de produto)

Aguardar especificação visual do Play Card (layout, hierarquia PRO vs A, copy exata). Esse desenho alimentará tokens, componentes Flux e o que é público vs privado.

Documento gerado a partir do briefing “Metodologia de Avaliação Beach Tennis 2026” e complementos sobre avaliação na área treinador (Flux Pro), travas de promoção e roadmap de torneios.