Architecture Decision Records (ADR)
Nhật ký các quyết định kỹ thuật quan trọng của chatbot service (LLM provider/routing, RAG pipeline, session store).
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 | Groq (Llama 3.1/3.3) với smart routing 2 model | Accepted | ~2026-06-27 |
| 0002 | Pinecone + fastembed cho RAG pipeline | Accepted | ~2026-06-27 |
ADR 0001–0002 được backfill ngày 2026-07-25: tái tạo từ
README.md,pyproject.tomlvà 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.