Fullstack Node.js & React
Trang chủ / Module 9
⚡ Module 9 / 19 · 5 ngày 📅 Tuần 7 ●●●○ Khó

Realtime, GraphQL/tRPC, file upload & tích hợp thanh toán

Những tính năng làm sản phẩm 'trông xịn': realtime trên nhiều instance, GraphQL có DataLoader, tRPC, upload thẳng lên S3 bằng presigned URL, webhook an toàn, tích hợp thanh toán.

WebSocketSSEGraphQLDataLoadertRPCS3 presignedStripe
📌 Vì sao module này quan trọng

JD fullstack $5000 hầu như luôn có một trong các dòng "realtime collaboration", "payment integration", "GraphQL". Chúng khó không phải vì API thư viện mà vì vấn đề phân tán đi kèm: WebSocket trên 3 instance sau load balancer, webhook đến hai lần hoặc sai thứ tự, file 2GB làm sập server, GraphQL query lồng nhau sinh 500 query DB.

🎯 Mục tiêu học tập

  • Chọn giữa polling, SSE, WebSocket; scale realtime bằng Redis adapter
  • Xây GraphQL API có DataLoader, giới hạn độ sâu/độ phức tạp; biết khi nào chọn tRPC
  • Upload trực tiếp lên object storage bằng presigned URL, xử lý file bất đồng bộ
  • Nhận webhook: xác minh chữ ký, idempotent, xử lý bất đồng bộ
  • Tích hợp thanh toán/subscription (Stripe) đúng luồng

Realtime: polling, SSE, WebSocket

PollingSSEWebSocket
ChiềuClient hỏiServer → clientHai chiều
Hạ tầngHTTP thườngHTTP thường, tự reconnectProxy hỗ trợ upgrade, cần adapter khi nhiều instance
Hợp vớiCập nhật mỗi vài chục giâyThông báo, tiến trình job, stream token AIChat, cộng tác, game, presence
// Socket.IO trên nhiều instance: sự kiện phát ở instance A tới được client ở instance B
import { createAdapter } from '@socket.io/redis-adapter';
io.adapter(createAdapter(pubClient, subClient));

io.use(authenticateSocket);                         // xác thực khi kết nối (cookie/token)
io.on('connection', (socket) => {
  socket.on('project:join', async (projectId) => {
    if (!(await canView(socket.data.user, projectId))) return;   // kiểm tra quyền cho mỗi room
    socket.join(`project:${projectId}`);
  });
});

// Sau khi task cập nhật (từ API hoặc worker):
io.to(`project:${task.projectId}`).emit('task:updated', task);

Cộng tác chỉnh sửa cùng lúc (kiểu Google Docs) dùng CRDT (Yjs) thay vì tự giải xung đột — mức cực khó, chỉ cần biết tồn tại và khi nào cần.

GraphQL đúng cách, và khi nào chọn tRPC

type Query {
  project(id: ID!): Project
  projects(first: Int = 20, after: String): ProjectConnection!
}
type Project { id: ID!  name: String!  tasks(status: TaskStatus): [Task!]!  owner: User! }

// Không có DataLoader: 20 project → 20 query lấy owner (N+1)
// Có DataLoader: gom thành 1 query WHERE id IN (...)
const userLoader = new DataLoader<string, User>(async (ids) => {
  const rows = await prisma.user.findMany({ where: { id: { in: [...ids] } } });
  const map = new Map(rows.map((u) => [u.id, u]));
  return ids.map((id) => map.get(id) ?? new Error('not found'));
});
// Tạo loader MỚI cho mỗi request (cache theo request, không rò dữ liệu giữa user)
  • Bảo vệ: giới hạn độ sâu và độ phức tạp query, persisted queries, tắt introspection nếu là API nội bộ.
  • Phân quyền ở tầng resolver/business cho từng field nhạy cảm.
  • Chọn GraphQL khi nhiều client (web, mobile, đối tác) cần hình dạng dữ liệu khác nhau.
  • tRPC: type-safe end-to-end trong monorepo TypeScript, không cần schema riêng — rất phổ biến với Next.js khi chỉ có một client.

Upload file bằng presigned URL

1. Client → API: "tôi muốn upload avatar.png, 2MB, image/png"
2. API kiểm tra quyền, loại, kích thước → tạo key uploads/{orgId}/{uuid}.png
   → trả presigned PUT URL (hết hạn 5 phút, ràng buộc content-type)
3. Client PUT file THẲNG lên S3/R2 (không đi qua server Node)
4. Client → API: "đã upload xong key X" (hoặc S3 event notification)
5. Worker: quét virus, tạo thumbnail, ghi metadata vào DB

Server Node không phải giữ file lớn trong RAM. Phục vụ file công khai qua CDN; file riêng tư dùng presigned GET ngắn hạn. Không tin Content-Type từ client — kiểm tra magic bytes ở bước worker.

Webhook và thanh toán

// Stripe webhook: cần raw body để xác minh chữ ký
app.post('/webhooks/stripe', express.raw({ type: 'application/json' }), async (req, res) => {
  let event;
  try {
    event = stripe.webhooks.constructEvent(req.body, req.header('stripe-signature')!, env.STRIPE_WEBHOOK_SECRET);
  } catch { return res.sendStatus(400); }

  // Idempotent: cùng event.id có thể đến nhiều lần
  const inserted = await prisma.webhookEvent.createMany({ data: [{ id: event.id, type: event.type }], skipDuplicates: true });
  if (inserted.count === 0) return res.sendStatus(200);

  await webhookQueue.add(event.type, event);   // xử lý bất đồng bộ, trả 200 nhanh
  res.sendStatus(200);
});
  • Nguồn sự thật về trạng thái thanh toán là webhook, không phải trang redirect "success".
  • Webhook có thể đến sai thứ tự → dựa vào trạng thái hiện tại của object (gọi lại API nhà cung cấp nếu cần), không dựa vào thứ tự sự kiện.
  • Subscription: Checkout Session → customer.subscription.*, invoice.paid/invoice.payment_failed → cập nhật quyền truy cập. Dùng Customer Portal thay vì tự làm trang quản lý thẻ.
  • Gọi API ngoài: timeout, retry có backoff chỉ với lỗi tạm thời, circuit breaker khi đối tác sập.

🏋️ Bài tập thực hành

Bảng Kanban realtime có gói trả phí

(1) Board Kanban cập nhật realtime qua Socket.IO, chạy 2 instance sau Nginx với Redis adapter, kiểm tra quyền khi join room. (2) Hiển thị ai đang xem board (presence). (3) Đính kèm file vào task bằng presigned URL lên MinIO/R2, worker tạo thumbnail. (4) Gói Pro qua Stripe Checkout (test mode), webhook cập nhật plan, idempotent, test bằng stripe trigger. (5) (Tuỳ chọn) Endpoint GraphQL cho dashboard với DataLoader, chứng minh số query không tăng theo số project.

📚 Tài nguyên học tập

✅ Tự đánh giá hoàn thành

  • Realtime chạy đúng trên nhiều instance, có kiểm tra quyền room
  • Endpoint lồng dữ liệu không có N+1 nhờ DataLoader
  • File lớn đi thẳng lên object storage
  • Webhook xác minh chữ ký, idempotent, xử lý bất đồng bộ