Chuyển tới nội dung chính

Component Diagram

Mức 3 của mô hình C4: các thành phần bên trong container backend và đường đi của một request. Dùng tài liệu này để biết một request đi qua những lớp nào trước khi tới service.

Thành phần​

Sơ đồ rút gọn các luồng chính. Quan hệ phụ thuộc giữa module: module-dependencies.md.

Vòng đời một HTTP request​

Thiết lập trong app.setup.ts và app.module.ts.

Thứ tự giữa các loại thành phần tuân theo vòng đời request của NestJS: middleware, rồi guard, rồi interceptor và pipe, rồi handler. configureApp đăng ký helmet đầu tiên để mọi phản hồi đều có header bảo mật, và đăng ký hai guard toàn cục theo thứ tự JwtAuthGuard trước RolesGuard.

Những điểm hay vấp​

Chủ đềHành viNguồn
Xác thực mặc địnhMọi route đều cần JWT trừ khi gắn @Public(). @OptionalAuth() dùng cho route công khai nhưng vẫn nhận biết người dùng nếu có tokensrc/utils/decorators/
Tiền tốMọi route có dạng /api/v1/.... Swagger ở /apiapp.setup.ts
Cấu trúc phản hồiController chỉ trả dữ liệu. message lấy từ @ResponseMessage, nếu không có thì là nulltransform.interceptor.ts
Rate limitBa mức khai báo toàn cục (burst 5/giây, sustained 20/10 giây, default 60/phút) lưu trên Redis, nhưng chỉ có hiệu lực ở controller gắn ThrottlerGuard: auth, chat, job-search, resumesapp.module.ts
Người dùng hiện tạiLấy bằng decorator @User()user.decorator.ts
Xóa mềmPlugin soft-delete-plugin-mongoose gắn cho mọi kết nốiapp.module.ts

Chi tiết xác thực và phân quyền sẽ nằm ở 08-security và 03-modules/authorization.md.

Lưu ý khi thêm route xác thực​

Guard riêng của route (LocalAuthGuard, AuthGuard('jwt-refresh')) không thay thế guard toàn cục. Vì vậy POST /api/v1/auth/login và GET /api/v1/auth/refresh đều gắn @Public() cùng guard riêng (auth.controller.ts). Một route xác thực mới mà thiếu @Public() sẽ bị JwtAuthGuard toàn cục chặn khi chưa có token.