# Experiment Logging

> **Trạng thái:** 🟡 Experimental — Module tracking A/B test và thay đổi hệ thống.

---

## 1. Mục đích

Mỗi khi có thay đổi lớn (đổi model LLM, cập nhật thuật toán search, thay đổi prompt), Admin tạo **Experiment Record** để so sánh KPI trước/sau.

## 2. Cấu trúc dự kiến

| Trường | Mô tả | Ví dụ |
|--------|-------|-------|
| `experiment_id` | ID duy nhất | `EXP-2025-042` |
| `name` | Tên thử nghiệm | "Đổi Classifier sang Gemini Flash" |
| `hypothesis` | Giả thuyết | "Giảm latency 30% mà giữ accuracy" |
| `start_date` | Ngày bắt đầu | 2025-04-20 |
| `end_date` | Ngày kết thúc | 2025-04-27 |
| `kpi_before` | Metrics trước | `{latency: 1.8s, accuracy: 91%}` |
| `kpi_after` | Metrics sau | `{latency: 1.1s, accuracy: 89%}` |
| `verdict` | Kết luận | ✅ Accepted / ❌ Rejected |
| `rollback_plan` | Kế hoạch rollback | "Đổi lại model cũ trong llm_factory.py" |

## 3. Tích hợp Langfuse

Experiment sẽ được tag trong Langfuse trace → filter theo experiment_id → so sánh metrics hàng loạt.

---

*Module này thuộc khối Experimental — nội dung sẽ được bổ sung khi triển khai tracking.*