# V2 Plan — Smart Shopping Journey Suggestion Chips

> **Mục tiêu**: Không để gãy hành trình mua sắm. Luôn gợi mở phối đồ (cross-sell/upsell). Tiến tới chốt đơn.
> 
> **Tham khảo**: Zalando Assistant, feedback anh Tùng (CMi Director), chị Huyền (BA)

---

## 📊 Tổng quan hành trình

```
KHÁM PHÁ → TÌM SẢN PHẨM → ĐI SÂU / SO SÁNH → CHỐT ĐƠN → SAU MUA
    ↓            ↓                ↓                ↓           ↓
 Chips v1     Chips v1       Per-product       Journey      Post-sale
 (done ✅)   (done ✅)       buttons (v2)     chips (v2)   chips (v3)
```

---

## 🚀 Phase 1: Per-Product Action Buttons (ưu tiên cao)

### Ý tưởng (từ chị Huyền BA)
Mỗi product card hiển thị thêm 2 nút nhỏ:

| Button | Hành vi | Mục đích |
|--------|---------|----------|
| 💬 **Tư vấn chi tiết** | Gửi: "Tư vấn chi tiết [SKU]" → AI mô tả sâu: chất liệu, form, phối đồ | Giữ khách ở lại, tăng hiểu biết SP |
| 🔍 **Đồ tương tự** | Gửi: "Xem đồ tương tự [SKU]" → AI tìm SP cùng loại khác kiểu/giá | Cross-sell, không mất khách khi SP đầu không ưng |

### Implement
- **Frontend** (`index.html`): Thêm 2 button vào mỗi `.product-card` trong phần render product cards
- **Backend**: Không cần sửa — AI nhận câu hỏi tự nhiên và xử lý
- **Effort**: ~1-2h

### Mockup UI
```
┌─────────────────────────┐
│  [Ảnh SP]               │
│  6TS25S018              │
│  Áo phông nữ            │
│  ~~399k~~ 279k          │
│  🛍️ Xem chi tiết        │
│                         │
│  [💬 Tư vấn] [🔍 Tương tự] │  ← MỚI
└─────────────────────────┘
```

---

## 🧠 Phase 2: Journey-Aware Smart Chips (ưu tiên cao)

### Logic
Chips thay đổi tự động theo giai đoạn mua sắm, dựa vào `user_insight.LAST_ACTION` + `GOAL`:

```python
# LOGIC PHÂN GIAI ĐOẠN:

if chưa_hỏi_SP:
    # Giai đoạn KHÁM PHÁ
    chips = ["Xem sản phẩm mới", "Đồ đang sale hot", "Tư vấn phối đồ"]

elif vừa_show_SP and chưa_chọn_cụ_thể:
    # Giai đoạn TÌM KIẾM
    chips = [
        "{Loại phối đồ} phối cùng {SP}",  # Cross-sell
        "Xem thêm màu khác",               # Variation
        "Check size còn hàng",              # Size check
    ]

elif đã_xem_2_SP_trở_lên:
    # Giai đoạn SO SÁNH
    chips = [
        "So sánh 2 mẫu vừa xem",          # Comparison
        "Tư vấn size cho tôi",             # Size guidance
        "Đặt hàng ngay",                   # Checkout push
    ]

elif đã_chốt_SP:
    # Giai đoạn CHỐT ĐƠN
    chips = [
        "Phụ kiện kèm theo",              # Accessory upsell
        "Chính sách vận chuyển",           # Shipping info
        "Mã giảm giá nào không?",          # Promotion
    ]
```

### Implement
- **Backend** (`controller.py`): Nâng cấp fallback logic → đọc `user_insight` để detect giai đoạn
- **Prompt** (`07_output_format.txt`): Thêm hướng dẫn AI sinh chips theo journey stage
- **Effort**: ~2-3h

---

## 🎯 Phase 3: Checkout Acceleration (ưu tiên trung bình)

### Chips đặc biệt khi gần chốt đơn

| Trigger | Chip hiện ra |
|---------|-------------|
| Khách nói "ưng mẫu này" | `"Đặt hàng online"`, `"Gọi hotline chốt nhanh"` |
| Khách hỏi size xong | `"Thêm vào giỏ"`, `"Xem sản phẩm phối thêm"` |
| Khách xem 3+ SP | `"SP nào hợp nhất với bạn?"` → AI recommend 1 SP tốt nhất |

### Implement
- **Backend**: Thêm logic detect "near-checkout" signals từ `LAST_ACTION`
- **Prompt**: Thêm instruction cho AI khi khách gần chốt đơn → push mạnh hơn
- **Effort**: ~2h

---

## 📦 Phase 4: Post-Purchase (ưu tiên thấp — v3)

Khi khách đã mua xong:
- `"Chính sách đổi trả"`
- `"Kiểm tra đơn hàng"`
- `"Gợi ý outfit cho tuần sau"`

> Cần tích hợp order tracking API → giai đoạn sau.

---

## 📋 Implementation Priority

| # | Task | Effort | Impact | Priority |
|---|------|--------|--------|----------|
| 1 | Per-product buttons (Tư vấn / Tương tự) | 1-2h | ⭐⭐⭐⭐⭐ | 🔴 Triển ngay |
| 2 | Journey-aware smart chips | 2-3h | ⭐⭐⭐⭐ | 🔴 Triển ngay |
| 3 | Checkout acceleration chips | 2h | ⭐⭐⭐⭐ | 🟡 Sau Phase 1+2 |
| 4 | Post-purchase chips | 3h+ | ⭐⭐ | 🟢 v3 |

---

## 🔧 Files cần sửa

### Phase 1 (Per-product buttons)
- `backend/static/index.html` — thêm 2 button vào product card render

### Phase 2 (Journey-aware chips)
- `backend/agent/controller.py` — nâng cấp fallback logic đọc user_insight
- `backend/agent/prompt_module/07_output_format.txt` — thêm hướng dẫn journey chips

### Phase 3 (Checkout acceleration)
- `backend/agent/controller.py` — detect near-checkout signals
- `backend/agent/prompt_module/04a_sales_core.txt` — sales push instructions

---

## ✅ Verification

1. Test hành trình đầy đủ: Chào → Tìm áo → Bấm "Tư vấn chi tiết" → Bấm "Quần phối cùng" → So sánh → Chốt đơn
2. Verify chips thay đổi theo từng giai đoạn
3. Đảm bảo không gãy UX — mọi chip đều dẫn đến bước tiếp theo có ý nghĩa
