Mentoria para Desenvolvedores Júnior de Node.js

Desenvolvedores juniores em equipes Node.js encontram os mesmos obstáculos: fluxo de controle assíncrono, métricas do pool de conexões e onde os erros realmente aparecem. Uma mentoria estruturada transforma esses obstáculos em crescimento na carreira.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

Semana 1-2: Ler codebase - rastrear uma requisição HTTP + um job de fila
Semana 3-4: Corrigir bug com testes (fazer par em erros assíncronos)
Semana 5-6: Adicionar endpoint com validação Zod + teste de integração
Semana 7-8: Entregar pequena feature atrás de feature flag
Semana 9+: Sombra de plantão; possuir módulo com revisão

Agenda semanal de 1:1 de 30 minutos:

1. O que foi confuso esta semana?
2. Revisar um PR que eles escreveram (ensine, não assuma o controle)
3. Um foco de habilidade (ex: ler painel de pool do Grafana)
4. Bloqueios para escalar

Quando usar:

• Novo contratado na equipe de API
• Estagiário se tornando efetivo
• Desenvolvedor intermediário mudando de frontend para o caminho Node.js

Exemplo de Trabalho

Exercício: Rastrear Falha Assíncrona

// src/orders/get-order.ts - dar versão quebrada para o júnior
export async function getOrder(id: string) {
  const row = await db.order.findUnique({ where: { id } });
  if (!row) return null;
  enrichWithCustomer(row); // BUG: falta await
  return row;
}
 
async function enrichWithCustomer(order: { customerId: string; customer?: unknown }) {
  order.customer = await db.customer.findUnique({ where: { id: order.customerId } });
}

Prompts do mentor:

1. Executar teste - por que customer às vezes é undefined?
2. Adicionar ESLint no-floating-promises - o que aparece?
3. Corrigir com await enrichWithCustomer(row)
4. Adicionar teste afirmando que customer foi preenchido

Exercício: Ler Métricas do Pool

Trabalho de casa no painel Grafana:
  - pg_pool_total_count
  - pg_pool_idle_count
  - pg_pool_waiting_count
 
Perguntas:
  - waiting_count > 0 por 5 min significa o quê?
  - Devemos aumentar o max ou corrigir consultas lentas primeiro?

• Juniores aprendem Postgres antes de culpar o event loop do Node
• Link Ajuste de Pool de Conexões

Mergulho Profundo

Armadilhas Específicas do Node.js para Juniores

Calendário de Pares

Estrutura de Feedback

SBI: Situação - Comportamento - Impacto
"SBI: No PR de ontem, a consulta usou concatenação de strings (comportamento),
 o que falharia na revisão de segurança e arrisca injeção de SQL (impacto).
 Vamos corrigir com parâmetros $1 juntos."

• Elogie o crescimento específico: "Você pegou o await ausente na revisão"

Lista de Leitura (Ordenada)

1. Básicos de Node.js
2. Básicos de Express ou Básicos de Fastify
3. Básicos de Testes
4. IDs de Correlação de Requisição
5. Básicos de Filas

Armadilhas

• "Afunde ou nade" no plantão - Ansiedade sem contexto. Correção: Fazer sombra em duas rotações antes de estar de plantão sozinho.
• Apenas correções de bugs - Sem narrativa de crescimento. Correção: Plano de propriedade de feature graduado.
• Mentor sempre assume o PR - Júnior aprende dependência. Correção: Comentar; o júnior envia a correção.
• Pular fundamentos do pool - ORM esconde demais. Correção: Uma semana de exercício com pg puro ou métricas Prisma.
• Sem metas escritas - Surpresas na promoção. Correção: Documento compartilhado com checklist de habilidades trimestrais.

Alternativas

FAQs

Relacionados

• Básicos de Tech Lead em Node - Responsabilidades do TL
• Padrões de Revisão de Código - como são bons PRs
• Básicos de Onboarding - configuração do dia um
• Matriz de Habilidades - rastreamento de habilidades
• Fazer Par em PRs de API - normas de par

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.