Architecture Decision Records (ADR)
Nhật ký các quyết định kỹ thuật quan trọng của tầng GitOps (ArgoCD Application/ApplicationSet pattern, Helm chart, flow deploy).
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 | ApplicationSet theo nhóm runtime, 1 file/service | Accepted | ~2026-06-27 |
| 0002 | CI commit image tag, không dùng Image Updater | Accepted | ~2026-06-27 |
ADR 0001–0002 được backfill ngày 2026-07-25: tái tạo từ
README.mdvà cấu trúcargocd//envs/. 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.