Bỏ qua

Architecture Decision Records (ADR)

Nhật ký các quyết định kỹ thuật quan trọng của tầng hạ tầng (provisioning, stateful stack, GitOps bootstrap, observability hạ tầng).

Quy tắc

  • Mỗi ADR là 1 file, đánh số tuần tự NNNN-slug-khong-dau.md.
  • Dùng template.md khi tạo ADR mới.
  • Không sửa lại ADR đã Accepted — tạo ADR mới, set Supersedes/ Superseded by để link 2 chiều, đổi status ADR cũ thành Superseded.
  • 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 Docker Compose cho stateful stack trên master node Accepted ~2026-06-27
0002 ArgoCD làm chủ deployment app, ranh giới với Ansible Accepted ~2026-06-27
0003 Cloudflare Pages cho docs-hub Accepted ~2026-07-20
0004 LangFuse + OmniRoute cho LLM observability/routing Accepted ~2026-06-27
0005 PgBouncer làm connection pooler trước Postgres Accepted 2026-07-25

ADR 0001–0004 được backfill ngày 2026-07-25: tái tạo từ README.md, SERVICES.md và cấu trúc roles/ hiện có — ngày ~ là ước tính, không phải ngày quyết định thực tế. Từ ADR 0005 trở đi, viết trước khi thực thi thay đổi hạ tầng.