Checklist de Onboarding de Desenvolvedores

Uma progressão cronológica do clone ao primeiro PR mesclado para engenheiros Rust novos (ou novos neste sistema).

Como Usar Este Checklist

• Percorra os itens em ordem cronológica - itens anteriores desbloqueiam os posteriores.
• O colega é o responsável por marcar as caixas com o novo desenvolvedor, não por ele.
• Cumpra o piso exigido antes do dia 2; os itens de teto polêm a primeira semana.
• Qualquer item que exceda o tempo alocado é um bug de ferramenta ou documentação - corrija para a próxima contratação.

Fase 1 - Antes da Chegada

1. Acesso pré-arquivo: Organização GitHub, CI, console de nuvem (staging somente leitura), rastreador de erros, wiki de documentação.
2. Envie o README + link do documento de onboarding: docs/onboarding.md canônico com o nome do proprietário.
3. Atribua um colega: Colega nomeado com check-in diário de 15 minutos na semana 1.
4. Modelo de ambiente de desenvolvimento: rustup 1.97.0 documentado + configuração do editor.
5. Primeiro ticket pronto: Boa primeira issue com escopo para 1-2 arquivos com critérios de aceitação claros.

Fase 2 - Dia 1

6. Clone e bootstrap: git clone, cargo test -q verde conforme Checklist de Configuração de Ferramentas.
7. Execute o serviço localmente: cargo run ou make run; acesse /health com curl.
8. Configuração do IDE: rust-analyzer, rustfmt ao salvar, diagnósticos clippy habilitados.
9. Conheça a equipe: Visão geral da arquitetura de 30 minutos - crates, armazenamentos de dados, cadência de implantação.
10. Orientação sobre o código-fonte: Orientação do Código-Fonte com perguntas e respostas do colega.

Fase 3 - Semana 1

11. Rastreie uma requisição de ponta a ponta: Rota HTTP para o DB e de volta - desenhe um diagrama pessoal.
12. Leia as convenções: Convenções e Guia de Estilo.
13. Shadow de revisão de código: O colega revisa um PR aberto - expectativas de Diretrizes de Revisão de Código.
14. Primeiro PR mesclado: Pequena alteração real (teste, doc, correção de clippy) - não um branch descartável.
15. Registre lacunas na documentação: Cada "tive que perguntar" se torna um PR para o documento de onboarding na mesma semana.

Fase 4 - Contínuo (30-90 Dias)

16. Shadow de plantão (se aplicável): Pareja em incidente de staging ou simulação de exercício.
17. Assuma um pequeno recurso: Ticket dimensionado para 2-3 dias com nota de design, se necessário.
18. Apresente o aprendizado: Demonstração de 5 minutos em um subsistema descoberto.
19. Contribua para rust-rules ou ADR: Proponha um esclarecimento a partir de confusão no onboarding.
20. Retro de feedback: Novo contratado + colega + gerente - atualize este checklist.

FAQs

Relacionados

• Checklist de Configuração de Ferramentas
• Orientação do Código-Fonte
• Melhores Práticas da Equipe
• Comandos Essenciais de Git

Versões da Stack: Esta página foi escrita para Rust 1.97.0 (edição 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4 e Polars 0.46+.