Next.js từ cơ bản đến nâng cao
Trang chủ / Module 18
🏁 Module 18 / 18 · 2 tuần 📅 Tuần 10 ●●●○ Khó

Capstone: SaaS đặt lịch hẹn đa tenant

Ghép toàn bộ khoá học vào một SaaS: trang marketing static, ứng dụng cho doanh nghiệp, trang đặt lịch công khai cho khách, thanh toán, email, cache có chủ đích, bảo mật, test, deploy GCP — kèm tiêu chí chấm và cách kể trong phỏng vấn.

CapstoneMulti-tenantStripePortfolio
📌 Vì sao module này quan trọng

Một dự án Next.js hoàn chỉnh trên domain thật, có quyết định cache/bảo mật/deploy được giải thích rõ, là bằng chứng mạnh nhất cho JD fullstack — đặc biệt khi bạn trả lời được "vì sao phần này static, phần kia dynamic".

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

  • Thiết kế và xây một SaaS Next.js cấp production
  • Áp dụng có chủ đích các lớp cache và ranh giới server/client
  • Bảo mật đa tenant, thanh toán, webhook
  • Deploy, giám sát và viết tài liệu kỹ thuật

Đề bài: BookFlow

  • Marketing ((marketing)): landing, bảng giá, blog MDX — static hoàn toàn, SEO 100, OG image động.
  • Ứng dụng doanh nghiệp ((app)/[orgSlug]): dịch vụ, nhân viên, lịch làm việc, lịch hẹn; vai trò owner/staff; mỗi truy vấn lọc theo orgId trong DAL (và RLS nếu dùng Postgres RLS).
  • Trang đặt lịch công khai (/b/[orgSlug]): thông tin doanh nghiệp 'use cache' + cacheTag('org:slug'); khung giờ trống dynamic trong Suspense; đặt lịch bằng Server Action có kiểm tra trùng giờ trong transaction.
  • Modal chi tiết lịch hẹn bằng intercepting route; dashboard nhiều slot.
  • Thanh toán: Stripe Checkout cho gói thuê bao; webhook xác minh chữ ký, idempotent.
  • Email xác nhận qua after() + queue; nhắc lịch bằng Cloud Scheduler gọi Route Handler có xác thực.
  • i18n vi/en cho trang công khai.

Tiêu chí chấm

Hạng mụcĐạt khi
Kiến trúcnext build cho thấy marketing ○, trang đặt lịch ◐, app ƒ — và README giải thích từng lựa chọn
Ranh giới clientFirst Load JS trang công khai < 120KB; 'use client' chỉ ở lá
Dữ liệuDAL + DTO, không import db ngoài DAL (ESLint chặn), transaction chống đặt trùng
Bảo mậtMọi action kiểm tra quyền + tenant; taint bật; CSP; test IDOR giữa hai tổ chức
TestUnit/integration + 5 E2E chạy trong CI
Vận hànhCloud Run nhiều instance + cache handler chung; deploy có smoke test; OTel + log; RUM
Tài liệuREADME, sơ đồ kiến trúc, 5 ADR, bảng cache (phần nào, lớp nào, làm mới bằng gì), báo cáo hiệu năng

Câu chuyện để kể khi phỏng vấn

  1. Cache: "Trang đặt lịch có phần thông tin cache theo tag và phần khung giờ dynamic; khi chủ doanh nghiệp sửa giờ mở cửa, tôi dùng updateTag để họ thấy ngay, còn webhook từ hệ thống khác dùng revalidateTag với SWR."
  2. Đa tenant: cách chặn tổ chức A đọc dữ liệu tổ chức B ở 3 lớp.
  3. Race condition: hai khách đặt cùng khung giờ — transaction + unique constraint, test 50 request đồng thời.
  4. Vận hành: lỗi chỉ xuất hiện khi chạy 2 instance và cách phát hiện bằng trace.

🚩 Sai lầm hay gặp

  • Bật 'use client' ở layout app 'cho nhanh'.
  • Không có bảng giải thích cache — người phỏng vấn sẽ hỏi.
  • Demo chỉ chạy local.

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

Hoàn thành và công bố

Deploy BookFlow trên domain thật, quay video 3-5 phút đi qua kiến trúc và demo, viết bài blog 'Caching trong Next.js 16 qua một dự án thật'. Tiếp theo: luyện khoá Phỏng vấn theo JD, dùng BookFlow làm ví dụ cho các câu hỏi tình huống.

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

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

  • BookFlow đã chạy trên domain thật
  • Tôi giải thích được ký hiệu build của từng nhóm route
  • Test IDOR giữa hai tổ chức pass trong CI
  • README có bảng cache và ADR
  • Tôi kể được 4 câu chuyện kỹ thuật dưới 2 phút mỗi câu