# AI cho Nhân viên Nội bộ (Internal Ops)

> **Tóm tắt:** Chatbot không chỉ phục vụ khách hàng — cùng bộ não AI có thể giúp nhân viên Canifa tra cứu kho, phân tích doanh số, soạn báo cáo, và training nhân viên mới. Tài liệu phân tích cách tái sử dụng hạ tầng AI hiện có cho internal operations.

---

## 1. Tại sao cần AI cho nhân viên?

### 1.1. Vấn đề thực tế

| Tình huống | Hiện tại | Với AI Internal |
|-----------|---------|----------------|
| Nhân viên tra kho | Mở POS → Gõ mã SP → Chờ load | "Áo polo nam size L còn bao nhiêu?" → Trả lời ngay |
| Store Manager cần báo cáo | Export Excel → Lọc → Tổng hợp (30 phút) | "Top 5 SP bán chạy nhất tuần này?" → 10 giây |
| Nhân viên mới cần training | Đọc SOP 50 trang + hỏi mentor | "Chính sách đổi trả hàng sale?" → Trả lời chuẩn |
| Telesale follow-up | Mở CRM → Đọc history → Soạn script | "Tóm tắt lịch sử khách 0912xxx" → Ready |

### 1.2. Lợi thế: Tái sử dụng 100% hạ tầng

Canifa đã có sẵn toàn bộ building blocks:

| Component hiện có | Dùng cho khách hàng | Tái sử dụng cho nhân viên |
|------------------|--------------------|-----------------------|
| **Product Search Engine** | Tìm SP tư vấn | Tra kho real-time |
| **Store Search** | Tìm cửa hàng gần | Tra tồn kho theo store |
| **Text-to-SQL** | — | Báo cáo doanh số |
| **Brand Knowledge RAG** | Trả lời chính sách | Training nhân viên mới |
| **Promotion Search** | Thông báo KM cho khách | Kiểm tra KM đang áp dụng |

---

## 2. Kiến trúc: 1 Brain, 2 Personas

```
                    ┌──────────────────────┐
                    │   Unified AI Brain   │
                    │  (Same LLM + Tools)  │
                    └──────────┬───────────┘
                               │
                    ┌──────────┴───────────┐
                    │                      │
           [Customer Persona]      [Staff Persona]
           "Chào chị, em gợi ý..."  "Báo cáo: Store HN01..."
           Tone: Thân thiện          Tone: Chuyên nghiệp
           Tools: Search, Size       Tools: SQL, Stock, KPI
           Channel: Chat, Zalo       Channel: Slack, Internal Web
```

### Khác biệt chính

| Aspect | Customer Mode | Staff Mode |
|--------|--------------|-----------|
| **System Prompt** | Tư vấn viên thời trang | Data analyst nội bộ |
| **Available Tools** | Product Search, Size Guide, Promotion | Text-to-SQL, Stock Check, Full Catalog, KPI |
| **Data Access** | Giới hạn (chỉ public data) | Full access (internal data) |
| **Auth** | Guest / Customer JWT | Staff JWT + Role-based |
| **Tone** | Thân thiện, emoji | Chuyên nghiệp, số liệu |

---

## 3. Use Cases chi tiết

### 3.1. Tra kho (Stock Inquiry)

**Nhân viên:** "Áo polo nam xanh navy size L còn bao nhiêu ở Vincom Bà Triệu?"

```
→ Classifier: STOCK_CHECK
→ Tools: [product_search, check_is_stock]  
→ Response: "SP CNF-12345: Polo Nam Navy
             - Vincom Bà Triệu (HN01): 3 cái (size L)
             - Royal City (HN02): 7 cái (size L)
             - Online Warehouse: 42 cái"
```

### 3.2. Báo cáo doanh số (Sales Report)

**Store Manager:** "Doanh số tuần này so với tuần trước?"

```
→ Classifier: ANALYTICS
→ Tool: [text_to_sql]
→ SQL: SELECT SUM(revenue) FROM orders 
       WHERE store_id = 'HN01' 
       AND order_date >= date('now', '-7 days')
→ Response: "📊 Báo cáo tuần (Store HN01):
             - Tuần này: 127 đơn — 89.3 triệu
             - Tuần trước: 115 đơn — 82.1 triệu
             - Tăng trưởng: +10.4% đơn, +8.7% doanh thu
             - Top SP: Polo CNF-123 (23 đơn)"
```

### 3.3. Training Assistant

**Nhân viên mới:** "Chính sách đổi trả hàng sale như nào?"

```
→ Classifier: FAQ_INTERNAL
→ Tool: [brand_knowledge_search]
→ RAG: Tìm trong SOP documents
→ Response: "Theo SOP v3.2 (cập nhật 01/2025):
             - Hàng sale: Đổi size trong 7 ngày
             - Không hoàn tiền, chỉ đổi SP khác
             - Phải còn tag, chưa giặt
             - Exception: Flash sale → không đổi trả"
```

### 3.4. Telesale Support

**Telesale:** "Tóm tắt lịch sử mua hàng khách 0912345678"

```
→ Classifier: CRM_LOOKUP
→ Tool: [customer_history_search]
→ Response: "👤 Khách: Chị Hương (VIP Silver)
             - 12 đơn trong 6 tháng qua
             - Tổng chi: 4.2 triệu
             - Style: Công sở, thích váy midi
             - Size: S/M
             - Lần cuối mua: 15/04 — Váy công sở
             - Gợi ý: BST Summer mới ra, váy midi linen"
```

---

## 4. Phân quyền & Bảo mật

| Role | Quyền truy cập | Tools |
|------|---------------|-------|
| **Staff (Bán hàng)** | Tra kho, giá, KM | Product Search, Stock |
| **Store Manager** | Doanh số store mình | Text-to-SQL (filtered) |
| **Area Manager** | Doanh số khu vực | Text-to-SQL (area) |
| **HQ** | Toàn bộ data | Full access |

**Nguyên tắc:** Text-to-SQL có **SQL whitelist** — chỉ cho phép SELECT, cấm INSERT/UPDATE/DELETE/DROP.

---

## 5. Lộ trình triển khai

| Phase | Feature | Effort |
|-------|---------|--------|
| **P0** | Stock inquiry (tái sử dụng Product Search) | 1 tuần |
| **P1** | Sales report (tái sử dụng Text-to-SQL) | 1 tuần |
| **P2** | Training assistant (tái sử dụng RAG) | 3 ngày |
| **P3** | Telesale CRM lookup | 2 tuần |
| **P4** | Slack/Teams integration | 1 tuần |

---

## References

- Canifa Engineering — `text_to_sql.py`, `product_search_engine.py`
- Canifa Engineering — `brand_knowledge_search` (RAG pipeline)
- Gartner (2024) — "AI for Internal Operations reduces ops cost by 25-40%"
