Tham chiếu dữ liệu backend
Frontend không có database và không định nghĩa schema lưu trữ. Trang này chỉ ra mỗi model ở frontend tương ứng với collection nào ở backend, và dẫn tới tài liệu database của backend. Dành cho người cần biết một field được lưu ở đâu hoặc có quan hệ với dữ liệu nào.
Vì sao schema chỉ nằm ở backend
Backend dùng NestJS với Mongoose trên MongoDB, và là nơi quyết định field nào được lưu, index nào có và quan hệ giữa các collection. Nếu frontend cũng mô tả database thì sẽ có hai bản dần lệch nhau. Vì vậy ở frontend chỉ có hợp đồng dữ liệu: type TypeScript, schema Zod và trạng thái giao diện.
WARNING
Các link sang backend dùng nhánh main của repo it-job-portal-be. Tài liệu database của backend nằm trong nhánh chưa được merge vào main tại thời điểm viết, nên các link này chỉ chạy sau khi nhánh đó được merge.
Bảng đối chiếu
| Dữ liệu | Nơi định nghĩa ở frontend | Collection ở backend |
|---|---|---|
| Người dùng, tài khoản | IUser, IAccount trong src/shared/types/backend.d.ts; schema Zod ở src/features/user/schemas/user.schema.ts và src/features/auth/schemas/auth.schema.ts | users |
| Tin tuyển dụng nội bộ | IJob trong backend.d.ts; schema Zod ở src/features/job/schemas/job.schema.ts | jobs |
| Kết quả tìm kiếm hợp nhất, tin bên ngoài | JobSearchItem, ExternalJobDetail ở src/features/job/schemas/job-search.schema.ts | external-jobs và jobs |
| Hồ sơ ứng tuyển | IResume trong backend.d.ts; schema Zod ở src/features/resume/schemas/resume.schema.ts | resumes |
| Hồ sơ CV | src/features/cv-builder/schemas/cv-profile.schema.ts, src/shared/types/cv.d.ts | cv-profiles |
| Tin nhắn chat | src/shared/types/chat.d.ts | chat-messages |
| Công ty | ICompany trong backend.d.ts; schema Zod ở src/features/company/schemas/company.schema.ts | companies |
| Thông báo | src/features/notification/schemas/notification.schema.ts | notifications |
| Đăng ký nhận việc | ISubscribers trong backend.d.ts; schema Zod ở src/features/subscriber/schemas/subscriber.schema.ts | subscribers |
| Kỹ năng | src/features/skill/schemas/skill.schema.ts | skills |
Trang models/* mô tả từng model ở phía frontend; chỉ một phần model có trang riêng, các trang còn lại được viết theo từng đợt.
Cách đọc một model
Khi cần biết một field, đọc theo thứ tự:
- Trang
models/*của frontend: field nào frontend dùng và ý nghĩa nghiệp vụ. - Tài liệu collection của backend: field đó lưu thế nào, có index hay ràng buộc gì.
- Mã nguồn backend, khi hai nơi trên khác nhau. Code đúng hơn tài liệu.
NOTE
Một model có thể có nhiều định nghĩa ở frontend: interface trong backend.d.ts, schema Zod trong features/*/schemas/ và type riêng cho form. Chúng không tự đồng bộ. Mỗi trang model sẽ ghi type nào là chính và chỉ ra chỗ chúng khác nhau.
Quan hệ giữa các collection
Sơ đồ quan hệ, chỉ mục và ràng buộc nằm ở backend:
Tài liệu này không mô tả lại các nội dung đó.
Source code liên quan
src/shared/types/backend.d.ts: interface dùng chungsrc/shared/types/cv.d.ts: kiểu dữ liệu CVsrc/shared/types/chat.d.ts: kiểu dữ liệu chatsrc/features/job/schemas/job.schema.ts: schema tin tuyển dụngsrc/features/job/schemas/job-search.schema.ts: kết quả tìm kiếm hợp nhấtsrc/features/resume/schemas/resume.schema.ts: schema hồ sơsrc/features/user/schemas/user.schema.ts: schema người dùng
Đọc tiếp: Tổng quan API và dữ liệu, Quy ước API, Bối cảnh hệ thống.
