Frontend → Caminho Node

Q: Express ou Fastify para aprender?

Fastify 5 para novas contratações: schema-first, testes com inject(), Pino integrado. Express se o padrão de produção da equipe for Express - alinhe-se com o ADR.

Uma rampa de cinco estágios para engenheiros frontend se tornarem SMEs de Node: event loop, streams, primeira API com testes e um PR de capstone na segunda semana.

Receita

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

Caminho de aprendizado da Semana 1 (frontend → Node)
Dia 1-2  Event loop + IO não bloqueante ([Como o Node.js Funciona](../node-fundamentals/how-node-js-works.md))
Dia 3    Primeira rota Fastify + Zod + smoke test com curl
Dia 4    Teste de integração node:test com inject()
Dia 5    Capstone: POST /items com Postgres + migração

Quando usar isso:

Engenheiro React/Vue ingressando na rotação de backend
Contratação full-stack forte em UI, fraca em transações Postgres
Engenheiro staff projetando currículo de onboarding

Estágio 1: Event Loop (Não Threads)

Desenvolvedores frontend conhecem a thread única do navegador. Node é semelhante com uma reviravolta: pool de threads libuv para algumas operações de IO.

// RUIM: bloqueia o event loop ~2s em trabalho síncrono grande
import fs from "node:fs";
const data = fs.readFileSync("./huge.json", "utf8");
JSON.parse(data);
 
// BOM: async + stream ou worker
import fs from "node:fs/promises";
const data = await fs.readFile("./huge.json", "utf8");

Navegador	Servidor Node
`fetch` no componente	`await fetch` ou consulta DB no manipulador
UI congela com trabalho síncrono longo	Todos os clientes travam com bloqueio do loop
Web Workers	Processo worker BullMQ

Exercício: adicione logs de tempo antes/depois de bcrypt.hashSync síncrono vs bcrypt.hash assíncrono sob curl concorrente

Relacionado: Como o Node.js Funciona

Estágio 2: Streams (Arquivos e 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 do frontend carrega na memória; streams do Node limitam o RSS em uploads/downloads
Rotas multipart do Fastify/Express devem fazer stream para disco ou S3, não bufferizar o arquivo inteiro

Estágio 3: Primeira API com Testes

// test/items.test.ts
import { test } from "node:test";
import assert from "node:assert/strict";
import { buildApp } from "../src/app.js";
 
test("GET /items retorna 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() é como Testing Library para HTTP - sem navegador, sem porta aberta
Conhecimento de Jest do frontend é transferível; a sintaxe é node:test + assert

Relacionado: Fastify Basics | Testing Fastify Apps

Estágio 4: Erros Assíncronos e Transações

// ERRADO: promessa flutuante em fire-and-forget
sendWelcomeEmail(user.id);
 
// CERTO: await ou fila 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 } });
});

Rejeições não tratadas derrubam o Node 24 por política em muitas equipes
Transações de banco de dados são novidade para contratações de frontend - pare em seu primeiro bloco transaction()

Estágio 5: PR de Capstone (Semana Um)

## Capstone: Fatia da API de Itens
- [ ] Migração: tabela items
- [ ] GET /items, POST /items com Zod
- [ ] Cobertura de node:test para 400 e 201
- [ ] Smoke test com curl na descrição do PR
- [ ] Sem segredos no diff

Mesclar o capstone antes de atribuir tickets do backlog de produção
Revisar com a lista de verificação Pairing on API PRs

Mudanças de Mentalidade

Hábito Frontend	Ajuste Node
Feedback instantâneo no navegador	Ler logs e `curl`, não apenas hot reload
Validação no lado do cliente é suficiente	Servidor deve validar com Zod
Estado no contexto React	Estado no Postgres + invalidação de cache
Implantar assets estáticos	Implantar API + ordem de migração importa

FAQs

Express ou Fastify para aprender?

Fastify 5 para novas contratações: schema-first, testes com inject(), Pino integrado. Express se o padrão de produção da equipe for Express - alinhe-se com o ADR.

Quão a fundo no Postgres na primeira semana?

CRUD + uma migração + exemplo de transação é o suficiente. A profundidade do ORM vem na semana 2-3 com pareamento de mentor.

Relacionados

Onboarding Basics - configuração de máquina
Skills Matrix - competências juniores
Node.js Basics - primeiros comandos
zod - validação em limites

Versões do 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.

Receita

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

Caminho de aprendizado da Semana 1 (frontend → Node)
Dia 1-2  Event loop + IO não bloqueante ([Como o Node.js Funciona](../node-fundamentals/how-node-js-works.md))
Dia 3    Primeira rota Fastify + Zod + smoke test com curl
Dia 4    Teste de integração node:test com inject()
Dia 5    Capstone: POST /items com Postgres + migração

Quando usar isso:

Engenheiro React/Vue ingressando na rotação de backend
Contratação full-stack forte em UI, fraca em transações Postgres
Engenheiro staff projetando currículo de onboarding

Estágio 1: Event Loop (Não Threads)

Desenvolvedores frontend conhecem a thread única do navegador. Node é semelhante com uma reviravolta: pool de threads libuv para algumas operações de IO.

// RUIM: bloqueia o event loop ~2s em trabalho síncrono grande
import fs from "node:fs";
const data = fs.readFileSync("./huge.json", "utf8");
JSON.parse(data);
 
// BOM: async + stream ou worker
import fs from "node:fs/promises";
const data = await fs.readFile("./huge.json", "utf8");

Navegador	Servidor Node
`fetch` no componente	`await fetch` ou consulta DB no manipulador
UI congela com trabalho síncrono longo	Todos os clientes travam com bloqueio do loop
Web Workers	Processo worker BullMQ

Exercício: adicione logs de tempo antes/depois de bcrypt.hashSync síncrono vs bcrypt.hash assíncrono sob curl concorrente

Relacionado: Como o Node.js Funciona

Estágio 2: Streams (Arquivos e 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 do frontend carrega na memória; streams do Node limitam o RSS em uploads/downloads
Rotas multipart do Fastify/Express devem fazer stream para disco ou S3, não bufferizar o arquivo inteiro

Estágio 3: Primeira API com Testes

// test/items.test.ts
import { test } from "node:test";
import assert from "node:assert/strict";
import { buildApp } from "../src/app.js";
 
test("GET /items retorna 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() é como Testing Library para HTTP - sem navegador, sem porta aberta
Conhecimento de Jest do frontend é transferível; a sintaxe é node:test + assert

Relacionado: Fastify Basics | Testing Fastify Apps

Estágio 4: Erros Assíncronos e Transações

// ERRADO: promessa flutuante em fire-and-forget
sendWelcomeEmail(user.id);
 
// CERTO: await ou fila 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 } });
});

Rejeições não tratadas derrubam o Node 24 por política em muitas equipes
Transações de banco de dados são novidade para contratações de frontend - pare em seu primeiro bloco transaction()

Estágio 5: PR de Capstone (Semana Um)

## Capstone: Fatia da API de Itens
- [ ] Migração: tabela items
- [ ] GET /items, POST /items com Zod
- [ ] Cobertura de node:test para 400 e 201
- [ ] Smoke test com curl na descrição do PR
- [ ] Sem segredos no diff

Mesclar o capstone antes de atribuir tickets do backlog de produção
Revisar com a lista de verificação Pairing on API PRs

Mudanças de Mentalidade

Hábito Frontend	Ajuste Node
Feedback instantâneo no navegador	Ler logs e `curl`, não apenas hot reload
Validação no lado do cliente é suficiente	Servidor deve validar com Zod
Estado no contexto React	Estado no Postgres + invalidação de cache
Implantar assets estáticos	Implantar API + ordem de migração importa

FAQs

Express ou Fastify para aprender?

Fastify 5 para novas contratações: schema-first, testes com inject(), Pino integrado. Express se o padrão de produção da equipe for Express - alinhe-se com o ADR.

Quão a fundo no Postgres na primeira semana?

CRUD + uma migração + exemplo de transação é o suficiente. A profundidade do ORM vem na semana 2-3 com pareamento de mentor.

Relacionados

Onboarding Basics - configuração de máquina
Skills Matrix - competências juniores
Node.js Basics - primeiros comandos
zod - validação em limites

Versões do 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.

Frontend → Caminho Node

Buscar na documentação

Frontend → Caminho Node