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

Tổng quan kiến trúc

DevLink Backend là một ứng dụng NestJS dạng modular monolith: một tiến trình duy nhất chia thành nhiều module nghiệp vụ, chạy cả API, WebSocket, worker hàng đợi và cron. Tài liệu này là điểm vào cho nhóm tài liệu kiến trúc.

Bức tranh tổng thể​

Các nguyên tắc thiết kế quan sát được​

Nguyên tắcBiểu hiện trong codeChi tiết
Mọi route cần xác thực mặc địnhJwtAuthGuard và RolesGuard đăng ký toàn cục, route công khai phải gắn @Public()component-diagram.md
Controller mỏng, logic ở serviceQuy ước trong AGENTS.md, cấu trúc module chuẩnproject-structure.md
Việc chậm đi qua hàng đợiBảy hàng đợi BullMQ, giới hạn tốc độ theo trần của nhà cung cấp AIdata-flow.md
AI hỗ trợ, backend quyết địnhChấm điểm bằng code riêng, không gọi AItechnology-decisions.md
Fail fast khi thiếu cấu hìnhKiểm tra biến môi trường lúc khởi độngtechnology-decisions.md
Xóa mềmPlugin gắn cho mọi kết nối Mongoosecomponent-diagram.md

Chỉ số nhanh​

Các số dưới đây đếm trực tiếp từ source tại thời điểm viết (2026-11-05).

MụcSố lượngCách đếm
File module29*.module.ts
Controller17*.controller.ts
Route HTTP116Decorator @Get, @Post, @Put, @Patch, @Delete trong controller
Collection MongoDB17Model đăng ký trong *.module.ts (18 file schema, trong đó CompanySnapshot là tài liệu nhúng)
Hàng đợi BullMQ7@Processor
Cron4@Cron
WebSocket gateway1NotificationsGateway, namespace /notifications
File unit test64*.spec.ts trong src/ (file e2e test/app.e2e-spec.ts không tính)

Mục lục nhóm kiến trúc​

Tài liệuTrả lời câu hỏi
system-context.mdAi dùng hệ thống, hệ thống nói chuyện với dịch vụ ngoài nào?
container-diagram.mdNhững tiến trình và kho dữ liệu nào tạo nên hệ thống?
component-diagram.mdMột request đi qua những lớp nào?
module-dependencies.mdModule nào phụ thuộc module nào?
data-flow.mdViệc nào xử lý ngay, việc nào đưa sang hàng đợi? Dữ liệu nằm ở đâu?
technology-decisions.mdVì sao dùng công nghệ này? Phần nào có bằng chứng, phần nào là suy luận?
observability.mdTheo dõi hệ thống bằng gì?
scalability.mdĐiều gì cản trở việc chạy nhiều instance?

Các vấn đề đã biết ở mức kiến trúc​

Tổng hợp từ các tài liệu trên. Mỗi mục có bằng chứng và mức chắc chắn ở tài liệu liên kết.

Vấn đềTài liệu
CACHE_MANAGER chạy trong bộ nhớ thay vì Redis (đã kiểm chứng), ảnh hưởng token đặt lại mật khẩu và hủy xóa tài khoảndata-flow.md
Cron và Socket.IO chưa được thiết kế cho nhiều instancescalability.md
File tải lên nằm trên đĩa cục bộscalability.md
Ba script package.json trỏ tới file không tồn tạilocal-development.md

Tài liệu sẽ bổ sung​

Hàng đợi chi tiết, chiến lược cache và các tính năng chuyên sâu (nhập tin, tìm kiếm hợp nhất, chấm điểm CV, chat AI) nằm ở Phase 3. Bảo mật và vận hành nằm ở Phase 4.