Melhores Práticas de Equipe e Onboarding
Um resumo condensado das 25 práticas mais importantes de equipe e onboarding para equipes de backend Node.js - conteúdo portátil compartilhado; adapte ao seu domínio.
//
Busque em todas as páginas da documentação
Um resumo condensado das 25 práticas mais importantes de equipe e onboarding para equipes de backend Node.js - conteúdo portátil compartilhado; adapte ao seu domínio.
Configuração da máquina antes dos tickets: Node 24.18.0, npm ci, docker compose up, curl /health verde no primeiro dia - Noções Básicas de Onboarding.
Fixar LTS explicitamente em CONTRIBUTING.md: .nvmrc, engines, Docker FROM node:24.18.0 - novos contratados não atualizam o Node na primeira semana.
CONTRIBUTING.md é canônico: Caminho de clone, template de ambiente, regras de branch, comandos de teste - não pins espalhados no Slack.
Mesmos scripts localmente e em CI: typecheck, lint, test - uma única superfície de comando - Integração com GitHub Actions.
Projeto final da primeira semana é obrigatório: Uma fatia E2E - rota, migração, teste, PR mesclado - Caminho Frontend → Node.
Tour pelo event loop no início: Explique blocking vs async antes das opiniões do framework - Como o Node.js Funciona.
Atribuição de colega no primeiro dia: Colega nomeado para tour pelo codebase e primeiros dois PRs - não "pergunte a qualquer um".
Checklist de codebase em níveis: Nível 1 no primeiro dia (entrada da aplicação, rotas, env), Nível 2 antes do projeto final (workers, migrações).
Rastreie uma fatia de requisição juntos: HTTP → handler → DB → response - um quadro branco supera a leitura de todos os arquivos.
Postgres/Redis local via Docker Compose: Paridade com a topologia de produção - Noções Básicas de Onboarding.
.env.example commitado: Segredos de produção apenas em injeção na plataforma.
curl de verificação em todo primeiro PR: Ensina logs + pensamento HTTP para contratados de frontend.
Evidência de PR para mudanças de API: Exemplo de curl ou diff OpenAPI - "funciona na minha máquina" é insuficiente.
Alterne o driver a cada 25 minutos no pair programming: Pair Programming em PRs de API.
Pair programming em autenticação, pagamentos, primeira transação: Envolvimento obrigatório de nível intermediário+ - fator ônibus e conformidade.
Matriz de nivelamento em vez de tempo de serviço: Júnior vs. pleno definidos por competências - Matriz de Habilidades.
Uma competência por plano de crescimento de sprint: Fechamento de lacunas focado - não "aprender backend".
Pequeno PR mesclado até o segundo dia: Correção de documentação ou adição de teste - alfabetização em CI antes do escopo do projeto final.
Registre a confusão da primeira semana como PRs de documentação: Mapeamentos de caminho no README melhoram o próximo contratado - onboarding é um produto.
Pair programming no primeiro worker BullMQ: Workers não são "apenas mais um arquivo" - disciplina de processo separado.
Adie atualizações de LTS e framework na primeira semana: Modo de leitura e envio; mudanças na plataforma exigem pair programming com a equipe.
Acompanhe o plantão antes da rotação solo: Observador em um incidente com Habilidade de Triagem de Incidentes.
Pair programming de release para acompanhamento do primeiro deploy de produção: Comando de rollback digitado uma vez com um mentor observando.
Retrospectiva escrita da primeira semana para o líder: Três pontos - documentação mais clara, módulo mais confuso, correção de documentação proposta.
Sênior de Frontend / Júnior de Node é explícito: Trilha dupla na matriz de habilidades evita expectativas incorretas de plantão.
Capacidade de sprint completa até a terceira semana. A primeira semana tem formato de aprendizado - projeto final, não avalanche de backlog.
Documente o ambiente de desenvolvimento na nuvem ou um host Docker remoto. health verde em staging compartilhado é aceitável se CONTRIBUTING.md assim o indicar.
Mesma máquina e checklist do projeto final; escopo da matriz de habilidades de acordo com a duração do contrato. Alfabetização em CI ainda é necessária.
Tickets de produção antes do health verde e do guia do event loop - produz luta silenciosa e PRs com muitos reverte.
Versões da Stack: Esta página foi escrita para Node.js 24.18.0 (Active LTS), npm 10+, TypeScript 5.6+, Express 5, Fastify 5, e NestJS 11.
Revisado por Chris St. John·Última atualização: 16 de jul. de 2026