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

Quyết định kiến trúc (ADR)

Mỗi ADR (Architecture Decision Record) ghi một quyết định kiến trúc đang có trong repository, kèm bằng chứng (commit, comment, code). Quy ước:

  • Accepted: quyết định có bằng chứng trực tiếp trong code hoặc lịch sử git.
  • Proposed: dùng cho phần lý do hoặc quyết định chỉ suy luận được; cần tác giả xác nhận.
  • Không có ADR nào mô tả điều chưa triển khai.
ADRQuyết địnhTrạng thái
0001Một ứng dụng NestJS module hóa, worker chạy cùng tiến trìnhAccepted
0002Vai trò là enum ERole, không phải entity RoleAccepted
0003BullMQ cho xử lý nền, điều tiết theo hạn mức nhà cung cấpAccepted
0004AI chỉ trích xuất, điểm phù hợp tính bằng code tất địnhAccepted
0005Vòng đời tin ngoài ACTIVE, STALE, CLOSED kèm chống đóng nhầmAccepted
0006Chính sách hiển thị theo nguồn, mặc định hạn chế nhấtAccepted
0007Hạn mức chat bằng đặt chỗ nguyên tử trong RedisAccepted
0008Cache danh sách trong Redis có thẻ và vô hiệu hóa theo thẻAccepted
0009Hành động do AI đề xuất phải được người dùng xác nhậnAccepted

Quyết định chưa có ADR vì thiếu bằng chứng về lý do​

Các lựa chọn sau có trong code nhưng repository không ghi lý do; ghi ở technology-decisions dưới dạng suy luận: MongoDB với Mongoose và xóa mềm bằng plugin, NestJS trên Express, Groq làm nhà cung cấp chính và Gemini dự phòng, JWT với refresh token trong cookie. Khi tác giả xác nhận lý do, thêm ADR với trạng thái Accepted.

Cách thêm ADR​

Đặt tên NNNN-<chủ-đề>.md, thêm vào bảng trên, ghi bằng chứng cụ thể (commit, đường dẫn). Không ghi Accepted cho quyết định chỉ suy luận.