Primeira semana

Checklist concreto. Tudo aqui é assíncrono — você faz no seu tempo. No final de cada dia, posta no WhatsApp o que andou.

Dia 1 — setup + ambiente local

Objetivo: todos os apps rodando na sua máquina + você acessou tudo que precisa.

Acessos

• Aceitar invite do GitHub na org treinogo (permissão write em todos os repos)
• Confirmar entrada no grupo de WhatsApp do time
• Abrir o Project TreinoGO Launch e ver as Issues atribuídas ao seu @
• Ler árvore estratégica (10 min)

Setup do ambiente

1. Configura /etc/hosts (uma vez só):

   127.0.0.1 api.treinogo.local
   127.0.0.1 auth.treinogo.local
   127.0.0.1 app.treinogo.local
   127.0.0.1 portal.treinogo.local
   127.0.0.1 console.treinogo.local

2. Clona os 6 repos principais:

   mkdir -p ~/Projects/TreinoGO && cd ~/Projects/TreinoGO
   gh repo clone treinogo/treinogo-dev-tools
   gh repo clone treinogo/treinogo-backend
   gh repo clone treinogo/treinogo-ui
   gh repo clone treinogo/treinogo-athlete-app
   gh repo clone treinogo/treinogo-coach-dashboard
   gh repo clone treinogo/treinogo-landing

3. Em cada repo, configura Node e instala:

   cd <repo>
   nvm use            # usa Node v24 do .nvmrc
   npm install

   Se nvm use falhar, instale a versão com nvm install.

4. Configura os .env de cada repo. Pede no WhatsApp ao @zanlucathiago os valores. Cada repo tem .env.example como referência.

5. Sobe tudo de uma vez via treinogo-dev-tools:

   cd treinogo-dev-tools
   npm run dev

   Isso inicia backend, auth, app do professor, app do aluno e console. Detalhes em Desenvolvimento Local.

Prova de setup

• Acessa http://auth.treinogo.local:8080 → vê as telas de login/cadastro
• Acessa http://app.treinogo.local:3001 → redireciona pra auth (esperado, sem sessão). Loga e vê o dashboard do coach
• Acessa http://portal.treinogo.local:3000 → redireciona pra auth. Loga e vê o app do atleta
• Acessa http://console.treinogo.local:3002 → console (com login admin se aplicável)
• Acessa http://api.treinogo.local:8000/api/health (ou rota equivalente) → vê 200
• Grava um Loom curto (2-3 min) mostrando todos rodando local
• Posta o Loom no grupo do WhatsApp marcando @zanlucathiago

Isso fecha a Issue de onboarding correspondente em treinogo-ops.

Dia 2-3 — leitura + primeiro PR pequeno

Leitura

• Bem-vindo, Como trabalhamos, Code style — se ainda não leu
• Workflow de desenvolvimento — convenções de commit, PR, deploy
• Infraestrutura — onde cada coisa está hospedada
• Abrir o Storybook do treinogo-ui (npm run storybook dentro do repo) e navegar pelos componentes

Primeiro PR

Pegar uma Issue pequena do Project atribuída ao seu @ e com priority:medium ou priority:low. Exemplos típicos:

• [A1] Testes de componentes parte 1 (15 primitivos) em treinogo-ui — começar com 1-2 componentes pra alinhar padrão antes de fazer os 15
• Algum bug severity:low já catalogado

Avisar no grupo qual issue foi pega. Mover o card pra In progress no Project.

PRs devem ser pequenos (idealmente menos de 300 linhas de diff). Review por @zanlucathiago em até 24h.

Dia 4-5 — ritmo de execução

• Daily async todo dia útil até 22h no WhatsApp (3 linhas: feito / fazer / bloqueio)
• Move cards no Project pra refletir status real
• Atende code review no mesmo dia (não acumula)
• Se houver weekly planning na quarta 20h, comparece

Critério de "primeira semana ok"

No final dos 7 dias, espera-se que:

• ✅ Todos os apps rodando local + Loom mandado
• ✅ Pelo menos 1 PR mergeado (ainda que pequeno)
• ✅ Árvore estratégica e os 4 docs de onboarding lidos
• ✅ Identificadas as próximas 2-3 Issues a pegar
• ✅ Daily postada todos os dias úteis

Se algum desses não fechou, postar no grupo o que travou. Não sumir.