Onboarding de um novo aluno

Objetivo: levar um atleta novo do cadastro até a produção, sem pendência crítica escondida. O onboarding é uma fila operacional, não uma tarefa única — o aluno só entra em produção quando o checklist fecha.

A fila e os status

O onboarding vive numa fila no backoffice (a fonte de verdade é o Firestore). Cada aluno percorre estes status:

Status	O que significa
lead	Aluno identificado, sem estrutura ainda.
setup	Assessoria e responsável definidos; estrutura em montagem.
waiting_athlete	Depende de uma ação do atleta (autorizar acesso, etc).
validation	Acessos configurados; falta a validação final.
ready_for_prod	Os 4 checks fecharam — apto a promover.
active	Onboarding concluído, aluno em produção.
blocked	Travado por um gargalo (com motivo obrigatório).

O checklist mínimo (os 3 gates)

O aluno só é promovido a ativo quando estes três estão verdes (o sistema recomputa automaticamente):

Intervals vinculado (intervals_linked) — a assessoria consegue ler os dados do atleta via Intervals.
OAuth autorizado (oauth_authorized) — o atleta autorizou o acesso à própria conta no Intervals.
PWA reivindicada (pwa_claimed) — o atleta entrou no app pelo link de convite e vinculou a conta.

Passo a passo no backoffice

Abrir o item com nome, athlete_key, assessoria (ou NOVA ASSESSORIA) e a origem.
Preencher os dados — tier, modo de coaching, prova-alvo, nível, ID do Intervals, etc. Use “Salvar parcial” para não perder o progresso e voltar depois.
Capturar o envelope de disponibilidade (horas/semana, dias/semana, dias de longo) — obrigatório antes de periodizar; sem ele o motor não prescreve. Para aluno de coaching completo, este passo também ativa os controles de capacidade e metodologia no motor.
Acompanhar os 3 gates — o sistema recomputa automaticamente; os gates viram verdes conforme o atleta concluir a autorização e o acesso ao app.
“Promover para active” — com os gates fechados, o aluno entra em produção.

O passo a passo técnico completo (criar a estrutura do atleta, bootstrap, validações) está no processo ONBOARDING_NOVO_ALUNO.md. Esta página é a visão operacional.