Busca en todas las páginas de la documentación
Los desarrolladores junior en equipos de Node.js se encuentran con las mismas dificultades: el flujo de control asíncrono, las métricas del pool de conexiones y dónde aparecen realmente los errores. Una mentoría estructurada convierte esas dificultades en crecimiento profesional.
Tarjeta de receta de referencia rápida - lista para copiar y pegar.
Semana 1-2: Leer la base de código - rastrear una solicitud HTTP + un trabajo de cola
Semana 3-4: Corregir un error con pruebas (emparejamiento en errores asíncronos)
Semana 5-6: Añadir un endpoint con validación Zod + prueba de integración
Semana 7-8: Lanzar una pequeña característica detrás de un feature flag
Semana 9+: Sombra en guardia; módulo propio con revisiónAgenda semanal de 1:1 de 30 minutos:
1. ¿Qué fue confuso esta semana?
2. Revisar una PR que escribieron (enseñar, no tomar el control)
3. Un enfoque de habilidad (ej. leer el panel de pool de Grafana)
4. Bloqueadores a escalarCuándo recurrir a esto:
// src/orders/get-order.ts - dar al junior la versión rota
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 } });
}Indicaciones del mentor:
customer a veces es undefined?no-floating-promises - ¿qué se dispara?await enrichWithCustomer(row)customer está pobladoTarea del panel de Grafana:
- pg_pool_total_count
- pg_pool_idle_count
- pg_pool_waiting_count
Preguntas:
- ¿Qué significa waiting_count > 0 durante 5 minutos?
- ¿Deberíamos aumentar el máximo o corregir las consultas lentas primero?| Error Común | Síntoma | Solución de Enseñanza |
|---|---|---|
| Modelo mental de callback | undefined aleatorio | Dibujar línea de tiempo async/await en la pizarra |
Depuración con console.log | Sin visibilidad en producción | req.log estructurado con requestId |
| Manejadores de ruta gigantes | PRs no testeables | Extraer función de servicio el primer día |
Ignorar package.json engines | "Funciona en mi máquina" | .nvmrc + verificación de versión en CI |
Copiar y pegar pg de Stack Overflow | Fugas de conexión | Plantilla try/finally en la wiki del equipo |
| Evento | Duración | Objetivo |
|---|---|---|
| Primera PR | 2h emparejamiento | Lograr una PR fusionada la misma semana |
| Primera migración | 1h emparejamiento | Cambio solo de expansión |
| Sombra en incidente | 1 incidente | Rol de escriba, leer línea de tiempo |
| Observar prueba de carga | 30m | Ver pool bajo k6 |
SBI: Situación - Comportamiento - Impacto
"SBI: En la PR de ayer, la consulta usó concatenación de cadenas (comportamiento),
lo que fallaría la revisión de seguridad y arriesga inyección SQL (impacto).
Vamos a corregirlo con parámetros $1 juntos."await faltante en la revisión"pg puro o métricas de Prisma.| Alternativa | Usar Cuándo | No Usar Cuándo |
|---|---|---|
| Aprendizaje formal | Gran cohorte de contratación | Junior solo en el equipo |
| Curso a tu propio ritmo | Presupuesto limitado | Necesidad de contexto de la base de código de producción |
| Rotar a otro equipo | Amplia exposición | API principal con poco personal |
2-3 meses para PRs pequeñas en solitario; 6 meses para la propiedad de características con revisión ligera.
Usa Ruta de Frontend a Node; enfatiza async y streams.
Contribuir con la sección de contexto; el líder técnico redacta la decisión. Buen aprendizaje a partir del mes 4+.
Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS Activo), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.
Revisado por Chris St. John·Última actualización: 19 jul 2026