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

Cấu trúc dự án

Repository là một ứng dụng NestJS duy nhất, không phải monorepo. Tài liệu này giúp tìm đúng thư mục khi cần đọc hoặc sửa một tính năng.

Thư mục gốc​

Đường dẫnVai trò
src/Toàn bộ mã nguồn backend
test/Cấu hình và test e2e (chưa commit tại thời điểm viết)
docs/Tài liệu dự án
agent_docs/Ghi chú kỹ thuật cho công cụ AI và developer
public/File tĩnh và ảnh tải lên, được serve trực tiếp
Dockerfile, docker-compose.yml, docker-compose.prod.ymlĐóng gói và triển khai
.github/workflows/ci.ymlCI
DEPLOYMENT.mdHướng dẫn triển khai lên VPS

Điểm vào của ứng dụng​

FileVai trò
src/main.tsKhởi tạo ứng dụng, Swagger, logger, shutdown hook
src/app.setup.tsconfigureApp: pipeline HTTP dùng chung cho production và e2e (helmet, CORS, guard, pipe, interceptor, versioning)
src/app.module.tsModule gốc: cấu hình, logging, rate limit, MongoDB và import toàn bộ module nghiệp vụ
src/instrument.tsKhởi tạo Sentry, phải được import đầu tiên

Bản đồ src/​

Thư mụcNhómVai trò
auth/Danh tínhĐăng ký, đăng nhập, Google, refresh token, OTP, quên mật khẩu, xóa tài khoản
users/Danh tínhQuản lý người dùng, tin đã lưu, công ty theo dõi
sessions/Danh tínhPhiên đăng nhập theo thiết bị
profile-identity/Danh tínhĐồng bộ tên, email, ảnh đại diện giữa User và CvProfile
casl/Phân quyềnERole, RolesGuard, decorator @Roles, @CheckPolicies
companies/Tuyển dụngCông ty, snapshot công ty nhúng trong tin
jobs/Tuyển dụngTin tuyển dụng nội bộ và vòng đời duyệt tin
resumes/Tuyển dụngHồ sơ ứng tuyển
cv-profiles/Tuyển dụngCV trực tuyến có cấu trúc
skills/Tuyển dụngDanh mục kỹ năng
subscribers/Tuyển dụngĐăng ký nhận gợi ý việc làm qua email
job-ingestion/Tin ngoàiNguồn tin, đồng bộ, vòng đời tin bên ngoài
job-search/Tin ngoàiTìm kiếm hợp nhất tin nội bộ và tin ngoài
cv-parser/AIĐọc nội dung CV từ file
matching/AIChấm điểm phù hợp giữa CV và tin
ai/, gemini/, groq/AILớp chọn nhà cung cấp AI và hai client
chat/AITrợ lý AI: phiên, tin nhắn, ngữ cảnh, quota, công cụ
queues/Bất đồng bộBảy hàng đợi BullMQ và processor
notifications/Hạ tầngThông báo, WebSocket gateway
mail/Hạ tầngGửi email, cron gợi ý việc làm hằng tuần
files/Hạ tầngTải file lên
statistics/Hạ tầngSố liệu thống kê
redis/Hạ tầngKết nối Redis, BullMQ, cache
health/Hạ tầngKiểm tra sức khỏe
databases/Hạ tầngSeed dữ liệu mẫu và controller databases
config/Hạ tầngKiểm tra biến môi trường khi khởi động
utils/Dùng chungDecorator, interceptor, helper, danh mục địa điểm
scripts/Công cụScript benchmark hiệu năng

Chi tiết từng module sẽ nằm trong 03-modules (Phase 2 và 3). Quan hệ phụ thuộc giữa module: module-dependencies.md.

Cấu trúc một module điển hình​

src/<feature>/
├── <feature>.module.ts # kết nối: MongooseModule.forFeature, imports, exports
├── <feature>.controller.ts # mỏng: route, decorator auth, DTO, gọi service
├── <feature>.service.ts # nghiệp vụ
├── dto/ # DTO kiểm tra đầu vào bằng class-validator
├── schemas/ # Mongoose schema
├── enums/, interfaces/ # kiểu dữ liệu
└── *.spec.ts # unit test đặt cạnh file nguồn

Không phải module nào cũng có đủ các phần này. Ví dụ cv-parser/ chỉ có module và service.

Known Limitation: thư mục còn sót​

Đường dẫnTình trạng
src/roles/Chỉ có hai thư mục con rỗng dto/ và schemas/, không có file, không có module và không có chỗ nào import. Là phần còn lại của entity Role đã bị bỏ ở commit 773dbcd (2026-06-06, "replace Role entity with ERole enum"). Vai trò thực tế nằm ở casl/ (ADR-0002)
src/databases/migrations/Thư mục rỗng. Xem local-development.md
scripts/ (gốc repo)Không tồn tại dù package.json tham chiếu

src/roles/ đã được đối chiếu với lịch sử git. Hai mục còn lại (migrations/, scripts/) chưa kiểm tra lịch sử.