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

Tổng quan cơ sở dữ liệu

DevLink dùng MongoDB 7 qua Mongoose 7. MongoDB là cơ sở dữ liệu tài liệu: dữ liệu nằm trong collection (tập hợp) gồm các document (bản ghi dạng JSON), không có bảng, khóa ngoại hay JOIN bắt buộc như cơ sở dữ liệu quan hệ.

Danh sách collection​

17 collection, mỗi collection có một data dictionary riêng. Tên collection lấy từ model Mongoose thực tế: 8 collection khai báo collection: tường minh, phần còn lại do Mongoose tự đặt (chữ thường, số nhiều).

NhómCollectionNội dung
Tài khoảnusersNgười dùng ba vai trò
sessionsPhiên đăng nhập theo thiết bị
notificationsThông báo trong ứng dụng
subscribersĐăng ký nhận gợi ý việc làm
Tuyển dụngcompaniesCông ty, kèm tài liệu nhúng CompanySnapshot
jobsTin tuyển dụng nội bộ
resumesHồ sơ ứng tuyển và điểm phù hợp
cv-profilesCV trực tuyến (tên thật cvprofiles)
skillsDanh mục kỹ năng
Tin ngoàijob-sourcesCấu hình nguồn tin
external-jobsTin lấy từ nguồn ngoài
crawl-runsNhật ký đồng bộ
Chat AIchat-sessionsPhiên chat
chat-messagesTin nhắn
chat-tool-actionsHành động chờ xác nhận
chat-quota-policiesChính sách giới hạn lượt chat
ai-usage-logsNhật ký dùng AI

Quan hệ giữa các collection: collection-relationships.md.

Quy ước chung​

Quy ướcChi tiết
Kết nốiMongooseModule.forRootAsync trong app.module.ts, chuỗi kết nối MONGO_URL
timestampsHầu hết schema bật timestamps: true, Mongoose tự quản createdAt, updatedAt. Ngoại lệ: crawl_runs
AuditNhiều collection có createdBy, updatedBy, deletedBy dạng { _id, email }, khai báo type: Object nên Mongoose coi là Mixed (không kiểm tra cấu trúc)
SnapshotCompanySnapshot nhúng vào users.company và jobs.company để tránh truy vấn nối
Kỹ năngLưu tên dạng chuỗi (jobs.skills, subscribers.skills, ...), không lưu tham chiếu tới skills
Địa điểmlocation kèm locationCode chuẩn hóa chữ thường, danh mục ở location-catalog.ts

Xóa mềm​

Xóa mềm (soft delete) nghĩa là đánh dấu bản ghi đã xóa thay vì xóa khỏi database, để giữ lịch sử và có thể khôi phục.

Plugin soft-delete-plugin-mongoose 1.0.17 được gắn cho mọi kết nối trong connectionFactory của AppModule. Đọc mã nguồn plugin cho thấy:

Hành viChi tiết
Field thêm vào mọi schemaisDeleted (Boolean, required, mặc định false) và deletedAt (Date, mặc định null), kể cả schema không tự khai báo
Tự lọcChỉ find, count, countDocuments: thêm isDeleted: { $ne: true } nếu truy vấn không tự đặt isDeleted: true
Hàm thêmsoftDelete, restore, findDeleted

Known Limitation: xóa mềm không tự áp dụng cho mọi loại truy vấn​

Plugin không móc vào findOne, findOneAndUpdate, updateOne, updateMany, aggregate. Truy vấn thuộc các loại này phải tự thêm điều kiện isDeleted. Biểu hiện trong code: nhiều index và truy vấn có isDeleted tường minh (ví dụ jobs dùng isDeleted: { $ne: true } trong pipeline thống kê). Truy vấn mới viết mà quên điều kiện sẽ trả cả bản ghi đã xóa.

Collection không dùng xóa mềm trên thực tế​

CollectionCách xóa
sessionsXóa thật (deleteOne, deleteMany)
cv-profilesXóa thật (deleteOne)
crawl-runsTTL 90 ngày

Kiểu ObjectId thực tế​

Schema dùng hai cách khai báo khác nhau cho tham chiếu, và chúng cho kết quả khác nhau:

Khai báoKiểu Mongoose thực tếDùng ở
type: mongoose.Schema.Types.ObjectIdObjectId (ép kiểu và validate)sessions.userId, notifications.userId, resumes.*, users.savedJobs, ...
type: Types.ObjectId (import từ mongoose)Mixedcv-profiles.userId, chat_sessions.userId, chat_messages.{sessionId,userId}, chat_tool_actions.{userId,sessionId}, ai_usage_logs.{userId,sessionId,conversationId}

Đã kiểm tra bằng cách nạp schema thật: với Types.ObjectId qua @nestjs/mongoose, schema.path('userId').instance là Mixed, và Model.find({ userId: '<chuỗi>' }).cast() giữ nguyên chuỗi thay vì chuyển sang ObjectId. (Mongoose thuần với Types.ObjectId vẫn cho ObjectId, nên lỗi nằm ở cách @nestjs/mongoose xử lý khai báo này.)

Hệ quả: truy vấn bằng chuỗi sẽ không khớp dữ liệu lưu dạng ObjectId. Code hiện tại tránh được vì luôn bọc new Types.ObjectId(...) khi ghi và khi truy vấn (ví dụ cv-profiles.service.ts, ai-usage.service.ts). Rủi ro nằm ở truy vấn mới viết sau này. Tác động lên populate chưa được kiểm tra: Chưa xác minh.

Index​

TTL index​

CollectionKeyThời gianGhi chú
usersverificationExpires0 giây sau thời điểm đó, chỉ với isActive: falseXóa tài khoản chưa xác thực (hạn 15 phút)
sessionsexpiresAt0 giây sau thời điểm đóCó thể không được tạo, xem bên dưới
crawl_runsstartedAt90 ngày

Không collection nào khác có TTL: chat_*, ai_usage_logs, notifications, resumes được giữ vô thời hạn.

Known Limitation: khai báo index trùng key pattern​

Ba collection khai báo cùng một key pattern hai lần với option khác nhau, vì kết hợp index: true hoặc unique: true trên field với lời gọi Schema.index(...):

CollectionKeyChi tiết
sessionsexpiresAt, refreshTokenHashXem sessions
cvprofilesuserIdXem cv-profiles
chat_sessionslegacyConversationIdXem chat-sessions

MongoDB không cho hai index cùng key pattern với option khác nhau cùng tồn tại. Trạng thái: Chưa xác minh, cần db.<collection>.getIndexes() trên database thật.

Tham chiếu tới model không tồn tại​

chat_sessions.legacyConversationId và ai_usage_logs.conversationId khai báo ref: 'Conversation', nhưng không có schema Conversation trong source. Đây là dấu vết của cấu trúc chat cũ.

Migration​

  • Repository không có framework migration. Thư mục src/databases/migrations/ rỗng, và script npm run migrate:locations trỏ tới file không tồn tại, xem local-development.md.
  • Dữ liệu mẫu nạp bằng npm run seed (src/databases/seeds/).
  • Khi thêm field mới: Mongoose trả undefined cho bản ghi cũ, nên cần xử lý giá trị thiếu trong code hoặc viết script nạp bù.
  • Khi thêm index unique lên collection đã có dữ liệu trùng: việc tạo index sẽ thất bại.
  • Mongoose mặc định tự tạo index khi khởi động (autoIndex). Repository không tắt tùy chọn này trong app.module.ts, nên thay đổi index trong schema được áp dụng khi triển khai. Điều này cần cân nhắc với collection lớn ở production. Trạng thái: suy ra từ cấu hình, Chưa xác minh trên môi trường thật.

Ví dụ và dữ liệu cá nhân​

Mọi ví dụ document trong thư mục này dùng dữ liệu giả (@example.com, mã ObjectId minh họa). Các collection chứa dữ liệu cá nhân: users, sessions (IP, user agent), resumes, cv-profiles, chat_messages, subscribers, notifications. Quy tắc bảo vệ dữ liệu sẽ nằm ở 08-security (Phase 4).