# 🚀 DOING: Cookbook Deep Dive - Nâng Cấp Chi Tiết Tận Răng

## 📌 Context
- **Idea:** `Nâng cấp Cookbook (Documentation) chi tiết, bài bản`
- **Report:** N/A (Directly approved via implementation_plan.md)
- **Status:** ✅ Done

## 🎯 Goal
Nâng cấp 9 tài liệu cốt lõi trong Cookbook (`01`, `01b`, `02`, `03`, `05`, `06`, `07`, `09`, `11`) từ dạng Overview cơ bản thành chuẩn "Deep Dive" (chi tiết luồng dữ liệu, giải thích logic, trích xuất mã nguồn thực tế và troubleshooting) nhằm làm tài liệu chuẩn mực cho Developer/BA.

## ⚠️ Active Trade-offs
- Skipping: Cập nhật các UI layout phức tạp trong frontend Cookbook — Lý do: Tập trung nâng cấp chất lượng nội dung JSON data trước.
- Skipping: Phase 3 (Hạ tầng & Công cụ) — Lý do: Ưu tiên làm Core Systems và Business Logic trước để tránh quá tải.

## 🛠 Impact & Files Touched
| File | Symbol | Change | Blast Radius |
|------|--------|--------|--------------|
| `static/cookbook/data/01-architecture.json` | JSON format | MODIFY | 0 callers (Docs only) |
| `static/cookbook/data/01b-database.json` | JSON format | MODIFY | 0 callers (Docs only) |
| `static/cookbook/data/02-chatbot-core.json` | JSON format | MODIFY | 0 callers (Docs only) |
| `static/cookbook/data/03-prompt-system.json`| JSON format | MODIFY | 0 callers (Docs only) |
| `static/cookbook/data/11-text-to-sql.json` | JSON format | MODIFY | 0 callers (Docs only) |
| `static/cookbook/data/05-ultra-description.json` | JSON format | MODIFY | 0 callers (Docs only) |
| `static/cookbook/data/06-fashion-matches.json` | JSON format | MODIFY | 0 callers (Docs only) |
| `static/cookbook/data/07-product-stock.json` | JSON format | MODIFY | 0 callers (Docs only) |
| `static/cookbook/data/09-image-search.json` | JSON format | MODIFY | 0 callers (Docs only) |

**Risk:** Low (Chỉ thay đổi data hiển thị của tài liệu nội bộ)

## 🔙 Rollback Plan
N/A

## 📋 Execution Checklist

### Phase 1: Core Systems (Hệ thống cốt lõi) (~30m)
- [x] Task 1.1: Viết lại `01-architecture.json` - Trình bày sâu về Micro-modular monolith, giao tiếp Interface & Gateway.
- [x] Task 1.2: Viết lại `01b-database.json` - Đi sâu vào `sqlite_mock.py` proxy pattern, Connection Pool (pool_wrapper.py) và cơ chế backoff.
- [x] Task 1.3: Viết lại `02-chatbot-core.json` - Khám phá LangGraph engine, Tool Node Execution logic và RAG context retrieval.
- [x] Task 1.4: Viết lại `03-prompt-system.json` - Trích code `llm_factory.py`, giải thích dynamic parameters prompt versioning.
- [x] Task 1.5: Viết lại `11-text-to-sql.json` - Kiến trúc Agentic Text-to-SQL, ảo hóa Schema, guardrails chặn Injection.

### Phase 2: Search & Fashion Logic (Nghiệp vụ Thời trang) (~30m)
- [x] Task 2.1: Viết lại `05-ultra-description.json` - Phân tích logic pipeline sinh mô tả, sync n8n với database.
- [x] Task 2.2: Viết lại `06-fashion-matches.json` - Code snippet từ thuật toán ghép đồ Top/Bottom/Accessories.
- [x] Task 2.3: Viết lại `07-product-stock.json` - Cơ chế Realtime Caching, phân tích file `cache.py`.
- [x] Task 2.4: Viết lại `09-image-search.json` - Quy trình embed ảnh qua CLIP model và tra cứu cosine similarity.

### Phase 3: Testing & Verification (~10m)
- [x] Task 3.1: Mở UI `localhost:5000/static/main.html?page=cookbook/cookbook.html` để verify format render.
- [x] Task 3.2: Check code blocks render qua thư viện Prism.js xem có bị vỡ layout không.

## 🔄 Sub-Doings
_None yet_

## ✅ Completion Gate
- [x] All tasks [x] | [x] Sub-Doings resolved | [x] Smoke test passed | [x] Trade-offs confirmed

---
_Started: 2026-04-29 | Updated: 2026-04-29_
