Architecture Decision Records (ADR)
Nhật ký các quyết định kỹ thuật quan trọng của Go services (lý do tách ngôn ngữ, nguyên tắc giao tiếp, thư viện lõi dùng chung).
Quy tắc
- Mỗi ADR là 1 file, đánh số tuần tự
NNNN-slug-khong-dau.md. - Dùng
template.mdkhi tạo ADR mới. - Không sửa lại ADR đã Accepted — tạo ADR mới, set
Supersedes/Superseded by, đổi status ADR cũ thànhSuperseded. - Khi nào cần tạo ADR: xem
CLAUDE.mdở root. - Cập nhật bảng dưới đây mỗi khi thêm/đổi status một ADR.
Danh sách ADR
| # | Tiêu đề | Status | Ngày |
|---|---|---|---|
| 0001 | Go thay NestJS cho 4 workload performance-critical | Accepted | ~2026-06-27 |
| 0002 | Giao tiếp thuần Kafka, không HTTP tới NestJS | Accepted | ~2026-06-27 |
ADR 0001–0002 được backfill ngày 2026-07-25: tái tạo từ
README.mdvà cấu trúc source. Ngày~là ước tính. Từ ADR 0003 trở đi, viết trước khi implement để ngày ghi nhận chính xác.