Ruta de Frontend → Node

Q: ¿Express o Fastify para aprender?

Fastify 5 para nuevos contratados: schema-first, pruebas inject(), Pino integrado. Express si el estándar de producción del equipo es Express - alinea con ADR.

Una rampa de cinco etapas para que los ingenieros de frontend se conviertan en expertos en Node: bucle de eventos, streams, primera API con pruebas y un PR final en la segunda semana.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

Ruta de aprendizaje de la Semana 1 (frontend → Node)
Día 1-2  Bucle de eventos + E/S no bloqueante ([Cómo funciona Node.js](../node-fundamentals/how-node-js-works.md))
Día 3    Primera ruta de Fastify + Zod + curl smoke
Día 4    Prueba de integración node:test con inject()
Día 5    Proyecto final: POST /items con Postgres + migración

Cuándo usarlo:

Ingeniero de React/Vue que se une a la rotación de backend
Contratación full-stack fuerte en UI, débil en transacciones de Postgres
Ingeniero de personal que diseña el plan de estudios de incorporación

Etapa 1: Bucle de Eventos (No Hilos)

Los desarrolladores de frontend conocen el hilo único del navegador. Node es similar con un giro: pool de hilos de libuv para algunas operaciones de E/S.

// MAL: bloquea el bucle de eventos ~2s en trabajo síncrono grande
import fs from "node:fs";
const data = fs.readFileSync("./huge.json", "utf8");
JSON.parse(data);
 
// BIEN: asíncrono + stream o worker
import fs from "node:fs/promises";
const data = await fs.readFile("./huge.json", "utf8");

Navegador	Servidor Node
`fetch` en componente	`await fetch` o consulta DB en manejador
La UI se congela en trabajos síncronos largos	Todos los clientes se detienen en el bloqueo del bucle
Web Workers	Proceso worker de BullMQ

Ejercicio: añade logs de tiempo antes/después de bcrypt.hashSync síncrono vs bcrypt.hash asíncrono bajo curl concurrente

Relacionado: Cómo funciona Node.js

Etapa 2: Streams (Archivos y HTTP)

import { createReadStream, createWriteStream } from "node:fs";
import { pipeline } from "node:stream/promises";
import { createGzip } from "node:zlib";
 
await pipeline(
  createReadStream("export.csv"),
  createGzip(),
  createWriteStream("export.csv.gz")
);

FileReader de frontend carga a memoria; los streams de Node limitan el RSS en cargas/descargas
Las rutas multipart de Fastify/Express deben hacer stream a disco o S3, no buffer entire file

Etapa 3: Primera API con Pruebas

// test/items.test.ts
import { test } from "node:test";
import assert from "node:assert/strict";
import { buildApp } from "../src/app.js";
 
test("GET /items devuelve un array", async () => {
  const app = await buildApp();
  const res = await app.inject({ method: "GET", url: "/items" });
  assert.equal(res.statusCode, 200);
  assert.ok(Array.isArray(res.json()));
  await app.close();
});

inject() es como Testing Library para HTTP - sin navegador, sin puerto abierto
El conocimiento de Jest de frontend se transfiere; la sintaxis es node:test + assert

Relacionado: Conceptos básicos de Fastify | Prueba de aplicaciones Fastify

Etapa 4: Errores Asíncronos y Transacciones

// MAL: promesa flotante en fire-and-forget
sendWelcomeEmail(user.id);
 
// BIEN: await o cola explícita
await emailQueue.add("welcome", { userId: user.id });

await db.transaction(async (tx) => {
  await tx.order.create({ data: order });
  await tx.inventory.decrement({ where: { sku }, data: { qty: 1 } });
});

Los rechazos no manejados bloquean Node 24 por política en muchos equipos
Las transacciones de DB son nuevas para los contratados de frontend - empareja en el primer bloque transaction()

Etapa 5: PR Final (Semana Uno)

## Proyecto final: segmento de API de ítems
- [ ] Migración: tabla de ítems
- [ ] GET /items, POST /items con Zod
- [ ] Cobertura node:test para 400 y 201
- [ ] curl smoke en la descripción del PR
- [ ] Sin secretos en el diff

Fusiona el proyecto final antes de asignar tickets de backlog de producción
Revisa con la lista de verificación Emparejamiento en PRs de API

Cambios de Mentalidad

Hábito de frontend	Ajuste de Node
Retroalimentación instantánea en el navegador	Lee logs y `curl`, no solo hot reload
Validación del lado del cliente suficiente	El servidor debe validar con Zod
Estado en el contexto de React	Estado en Postgres + invalidación de caché
Despliegue de activos estáticos	Despliegue de API + el orden de migración importa

Preguntas Frecuentes

¿Express o Fastify para aprender?

Fastify 5 para nuevos contratados: schema-first, pruebas inject(), Pino integrado. Express si el estándar de producción del equipo es Express - alinea con ADR.

¿Qué tan profundo en Postgres la primera semana?

CRUD + una migración + ejemplo de transacción es suficiente. La profundidad del ORM llega en la semana 2-3 con el emparejamiento del mentor.

Relacionado

Conceptos básicos de incorporación - configuración de la máquina
Matriz de habilidades - competencias junior
Conceptos básicos de Node.js - primeros comandos
zod - validación en los límites

Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS activa), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

Ruta de aprendizaje de la Semana 1 (frontend → Node)
Día 1-2  Bucle de eventos + E/S no bloqueante ([Cómo funciona Node.js](../node-fundamentals/how-node-js-works.md))
Día 3    Primera ruta de Fastify + Zod + curl smoke
Día 4    Prueba de integración node:test con inject()
Día 5    Proyecto final: POST /items con Postgres + migración

Cuándo usarlo:

Ingeniero de React/Vue que se une a la rotación de backend
Contratación full-stack fuerte en UI, débil en transacciones de Postgres
Ingeniero de personal que diseña el plan de estudios de incorporación

Etapa 1: Bucle de Eventos (No Hilos)

Los desarrolladores de frontend conocen el hilo único del navegador. Node es similar con un giro: pool de hilos de libuv para algunas operaciones de E/S.

// MAL: bloquea el bucle de eventos ~2s en trabajo síncrono grande
import fs from "node:fs";
const data = fs.readFileSync("./huge.json", "utf8");
JSON.parse(data);
 
// BIEN: asíncrono + stream o worker
import fs from "node:fs/promises";
const data = await fs.readFile("./huge.json", "utf8");

Navegador	Servidor Node
`fetch` en componente	`await fetch` o consulta DB en manejador
La UI se congela en trabajos síncronos largos	Todos los clientes se detienen en el bloqueo del bucle
Web Workers	Proceso worker de BullMQ

Ejercicio: añade logs de tiempo antes/después de bcrypt.hashSync síncrono vs bcrypt.hash asíncrono bajo curl concurrente

Relacionado: Cómo funciona Node.js

Etapa 2: Streams (Archivos y HTTP)

import { createReadStream, createWriteStream } from "node:fs";
import { pipeline } from "node:stream/promises";
import { createGzip } from "node:zlib";
 
await pipeline(
  createReadStream("export.csv"),
  createGzip(),
  createWriteStream("export.csv.gz")
);

FileReader de frontend carga a memoria; los streams de Node limitan el RSS en cargas/descargas
Las rutas multipart de Fastify/Express deben hacer stream a disco o S3, no buffer entire file

Etapa 3: Primera API con Pruebas

// test/items.test.ts
import { test } from "node:test";
import assert from "node:assert/strict";
import { buildApp } from "../src/app.js";
 
test("GET /items devuelve un array", async () => {
  const app = await buildApp();
  const res = await app.inject({ method: "GET", url: "/items" });
  assert.equal(res.statusCode, 200);
  assert.ok(Array.isArray(res.json()));
  await app.close();
});

inject() es como Testing Library para HTTP - sin navegador, sin puerto abierto
El conocimiento de Jest de frontend se transfiere; la sintaxis es node:test + assert

Relacionado: Conceptos básicos de Fastify | Prueba de aplicaciones Fastify

Etapa 4: Errores Asíncronos y Transacciones

// MAL: promesa flotante en fire-and-forget
sendWelcomeEmail(user.id);
 
// BIEN: await o cola explícita
await emailQueue.add("welcome", { userId: user.id });

await db.transaction(async (tx) => {
  await tx.order.create({ data: order });
  await tx.inventory.decrement({ where: { sku }, data: { qty: 1 } });
});

Los rechazos no manejados bloquean Node 24 por política en muchos equipos
Las transacciones de DB son nuevas para los contratados de frontend - empareja en el primer bloque transaction()

Etapa 5: PR Final (Semana Uno)

## Proyecto final: segmento de API de ítems
- [ ] Migración: tabla de ítems
- [ ] GET /items, POST /items con Zod
- [ ] Cobertura node:test para 400 y 201
- [ ] curl smoke en la descripción del PR
- [ ] Sin secretos en el diff

Fusiona el proyecto final antes de asignar tickets de backlog de producción
Revisa con la lista de verificación Emparejamiento en PRs de API

Cambios de Mentalidad

Hábito de frontend	Ajuste de Node
Retroalimentación instantánea en el navegador	Lee logs y `curl`, no solo hot reload
Validación del lado del cliente suficiente	El servidor debe validar con Zod
Estado en el contexto de React	Estado en Postgres + invalidación de caché
Despliegue de activos estáticos	Despliegue de API + el orden de migración importa

Preguntas Frecuentes

¿Express o Fastify para aprender?

Fastify 5 para nuevos contratados: schema-first, pruebas inject(), Pino integrado. Express si el estándar de producción del equipo es Express - alinea con ADR.

¿Qué tan profundo en Postgres la primera semana?

CRUD + una migración + ejemplo de transacción es suficiente. La profundidad del ORM llega en la semana 2-3 con el emparejamiento del mentor.

Relacionado

Conceptos básicos de incorporación - configuración de la máquina
Matriz de habilidades - competencias junior
Conceptos básicos de Node.js - primeros comandos
zod - validación en los límites

Versiones de la pila: Esta página fue escrita para Node.js 24.18.0 (LTS activa), npm 10+, TypeScript 5.6+, Express 5, Fastify 5 y NestJS 11.

Ruta de Frontend → Node

Buscar en la documentación

Ruta de Frontend → Node