React từ cơ bản đến nâng cao
Trang chủ / Module 21
🏗️ Module 21 / 22 · 5 ngày 📅 Tuần 11 ●●●○ Khó

Kiến trúc dự án lớn, bảo mật frontend và vận hành

Cấu trúc thư mục theo tính năng, ranh giới module, monorepo, micro-frontend khi nào nên, bảo mật frontend (XSS, token, CSP, dependency), quản lý lỗi production và feature flag.

Feature foldersMonorepoXSSObservability
📌 Vì sao module này quan trọng

Một ứng dụng React 200 màn hình với 15 người sửa cùng lúc cần quy ước khác hẳn một app cá nhân. Đồng thời, frontend là nơi kẻ tấn công chạm vào trực tiếp — hiểu XSS và lưu token sai cách là lý do nhiều JD yêu cầu "security awareness".

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

  • Tổ chức code theo tính năng với ranh giới import rõ ràng
  • Biết khi nào monorepo và micro-frontend đáng giá
  • Phòng chống XSS, lưu token an toàn, cấu hình CSP
  • Quản lý lỗi và hiệu năng production (Sentry, web-vitals)
  • Dùng feature flag để phát hành an toàn

Cấu trúc theo tính năng

src/
├─ app/               # khởi tạo: router, providers, layout gốc
├─ features/
│  ├─ cart/
│  │  ├─ api/         # query options, mutation
│  │  ├─ components/
│  │  ├─ hooks/
│  │  ├─ model/       # reducer, store, types, schema
│  │  └─ index.ts     # public API: chỉ export những gì feature khác được dùng
│  ├─ catalog/
│  └─ auth/
├─ shared/
│  ├─ ui/             # design system: Button, Dialog...
│  ├─ lib/            # tiện ích thuần: format, http client
│  └─ config/
└─ pages/ (hoặc routes/)  # ghép các feature thành màn hình
  • Quy tắc phụ thuộc một chiều: pages → features → shared. Feature không import sâu vào nội bộ feature khác, chỉ qua index.ts. Ép bằng ESLint (eslint-plugin-boundaries hoặc no-restricted-imports).
  • Colocation: test, story, style nằm cạnh component. Xoá một feature = xoá một thư mục.
  • Tham khảo phương pháp Feature-Sliced Design hoặc Bulletproof React.

Monorepo và micro-frontend

Monorepo (pnpm workspaces + Turborepo/Nx)Micro-frontend (Module Federation)
Giải quyếtChia sẻ code (UI kit, types, schema Zod) giữa web, admin, mobile web, backendNhiều team deploy độc lập các phần của một ứng dụng
Chi phíThấp-vừa: cấu hình build cacheCao: phiên bản React trùng, state chia sẻ, hiệu năng, debug
Nên dùng khiCó 2+ ứng dụng dùng chung codeTổ chức lớn (nhiều team, nhiều chu kỳ release), không phải vì "kiến trúc đẹp"

XSS và React

React tự escape mọi chuỗi trong {}. XSS vẫn xảy ra qua các cửa sau:

// 1. dangerouslySetInnerHTML với HTML từ người dùng
import DOMPurify from 'dompurify';
<div dangerouslySetInnerHTML={{ __html: DOMPurify.sanitize(post.html) }} />

// 2. URL javascript: trong href
const safeUrl = (u: string) => (/^(https?:|mailto:|\/)/i.test(u) ? u : '#');
<a href={safeUrl(user.website)}>Website</a>

// 3. Spread props từ dữ liệu người dùng
<div {...userControlledObject} />    // ❌ có thể chứa dangerouslySetInnerHTML, href...

// 4. Chèn dữ liệu vào <script> khi SSR (JSON.stringify không escape </script>)

Lớp phòng thủ thứ hai là Content Security Policy: script-src 'self' 'nonce-…' chặn script lạ dù đã chèn được HTML. Thêm Trusted Types cho ứng dụng nhạy cảm.

Lưu token ở đâu

CáchRủi roĐánh giá
localStorageBất kỳ XSS nào cũng đọc được tokenTránh cho token dài hạn
Cookie HttpOnly; Secure; SameSite=LaxJS không đọc được; cần chống CSRF (SameSite + token CSRF cho thao tác nhạy cảm)Khuyến nghị cho web
Access token trong bộ nhớ + refresh token trong cookie HttpOnlyMất khi reload (gọi refresh), phức tạp hơnTốt cho SPA gọi API khác domain
Mẫu BFF (backend-for-frontend)Token không bao giờ tới trình duyệt, chỉ có session cookieAn toàn nhất, phổ biến với Next.js

Không bao giờ đặt secret (API key trả phí, khoá bí mật) trong code frontend hay biến VITE_*/NEXT_PUBLIC_* — mọi thứ trong bundle đều công khai.

Chuỗi cung ứng và dependency

  • Commit lockfile, cài bằng npm ci; bật Dependabot/Renovate; npm audit trong CI.
  • Cân nhắc trước khi thêm package nhỏ: số người bảo trì, lượt tải, có script postinstall không. Các vụ tấn công npm (gói phổ biến bị chiếm tài khoản, chèn mã đánh cắp token) xảy ra thường xuyên.
  • Theo dõi cảnh báo bảo mật của React/Next.js: ví dụ lỗ hổng RCE nghiêm trọng trong React Server Components (CVE-2025-55182, 12/2025) buộc mọi dự án dùng RSC phải nâng cấp ngay.

Vận hành production

// Gửi lỗi tập trung
const root = createRoot(el, {
  onUncaughtError: (error, info) => Sentry.captureException(error, { extra: { componentStack: info.componentStack } }),
  onCaughtError: (error, info) => Sentry.captureException(error, { level: 'warning', extra: info }),
});

// Đo người dùng thật
import { onLCP, onINP, onCLS } from 'web-vitals';
[onLCP, onINP, onCLS].forEach(fn => fn(m => navigator.sendBeacon('/rum', JSON.stringify(m))));
  • Upload source map lên Sentry (không public ra internet) để đọc được stack trace.
  • Feature flag (Unleash, LaunchDarkly, GrowthBook, PostHog): merge code sớm nhưng tắt; bật cho 5% người dùng rồi tăng dần; tắt ngay khi có sự cố mà không cần deploy lại.
  • Xử lý "chunk load error" sau mỗi lần deploy (người dùng đang mở bản cũ, chunk cũ đã bị xoá): bắt lỗi trong lazy và reload trang một lần.

🚩 Sai lầm hay gặp

  • Thư mục components/ phẳng với 300 file.
  • Đặt API key trả phí trong biến môi trường frontend.
  • Render HTML từ CMS/người dùng mà không sanitize.
  • Micro-frontend cho đội 5 người.

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

Tái cấu trúc + kiểm tra bảo mật

Tổ chức lại app cửa hàng theo feature folders có ESLint chặn import sai ranh giới. Thêm Sentry (gói miễn phí), web-vitals, một feature flag đơn giản. Tự kiểm tra 4 cửa XSS ở trên và viết test chứng minh safeUrl chặn javascript:.

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

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

  • Tôi tổ chức được dự án theo feature với public API rõ ràng
  • Tôi giải thích được khi nào không nên dùng micro-frontend
  • Tôi kể được 4 cách XSS lọt qua React
  • Tôi so sánh được các cách lưu token
  • Tôi thiết lập được theo dõi lỗi và Web Vitals