# 📋 HƯỚNG DẪN IMPORT KOC SỮA CÔNG THỨC

## 🎯 Mục Đích
Template này dùng để nhập hàng loạt thông tin KOC cho chương trình Sữa Công Thức (Formula Milk Program).

---

## ⚠️ CÁC TRƯỜNG BẮT BUỘC (*)

### 1. **Họ Tên KOC** (*)
- **Bắt buộc phải có**
- Định dạng: Text
- Ví dụ: `Nguyễn Thị Lan`, `Trần Văn Minh`
- Lưu ý: Tên đầy đủ, viết hoa chữ cái đầu

### 2. **TikTok Link hoặc Facebook Link** (*)
- **Ít nhất 1 trong 2 phải có**
- Định dạng: URL đầy đủ
- Ví dụ TikTok: `https://www.tiktok.com/@mebimsuaofficial`
- Ví dụ Facebook: `https://www.facebook.com/mebimsuaofficial`
- Lưu ý: Phải là link profile đầy đủ, không viết tắt

### 3. **Danh Mục** (*)
- **Bắt buộc phải có**
- Giá trị cho phép:
  - `Sữa công thức bò`
  - `Sữa công thức dê`
- Lưu ý: Viết chính xác như trên, không viết tắt

---

## 📝 CÁC TRƯỜNG KHUYẾN NGHỊ (Nên Có)

### 4. **Số Điện Thoại**
- Định dạng: 10 số, bắt đầu bằng 0
- Ví dụ: `0912345678`
- Mục đích: Dùng để kiểm tra trùng lặp, liên hệ

### 5. **CCCD**
- Định dạng: 12 số
- Ví dụ: `001234567890`
- Mục đích: Dùng để kiểm tra trùng lặp, xác thực

### 6. **Thông Tin Con** (Rất quan trọng cho Sữa Công Thức)
- **Tên Con**: Ví dụ `Bé Minh`, `Bé An`
- **Ngày Sinh**: Định dạng `DD/MM/YYYY`, ví dụ `15/03/2023`
- **Giới Tính**: `Nam` hoặc `Nữ`
- **Ghi Chú Con**: Thông tin đặc biệt như `Dị ứng lactose`, `Sinh non`, `Cân nặng thấp`
- Lưu ý: Có thể nhập tối đa 2 con trong template này

### 7. **Người Phụ Trách (ME)**
- Định dạng: Họ tên đầy đủ
- Ví dụ: `Nguyễn Thanh Ngân`, `Phạm Ngọc Quyền`
- Lưu ý: Phải là tên ME có trong hệ thống (Role = 3)

---

## 📌 CÁC TRƯỜNG TÙY CHỌN

### 8. **Email**
- Định dạng: email hợp lệ
- Ví dụ: `lan@gmail.com`

### 9. **Zalo**
- Định dạng: Số điện thoại hoặc Zalo ID
- Ví dụ: `0912345678`

### 10. **Địa Chỉ**
- Định dạng: Text tự do
- Ví dụ: `123 Nguyễn Huệ, Quận 1`

### 11. **Tỉnh/Thành**
- Định dạng: Text
- Ví dụ: `TP.HCM`, `Hà Nội`, `Đà Nẵng`

### 12. **Kênh Social Media Khác**
- Facebook Link: `https://www.facebook.com/username`
- Instagram Link: `https://www.instagram.com/username`
- Threads Link: `https://www.threads.net/@username`
- YouTube Link: `https://www.youtube.com/@username`

### 13. **Tình Trạng Hợp Tác**
- Định dạng: Text tự do
- Ví dụ:
  - `Đã lên bài sau khi nhận quà`
  - `Đã nhận quà chưa rep`
  - `Đã liên hệ đang chờ rep`
  - `Chưa liên hệ`

### 14. **Cấp Độ KOC**
- Giá trị: `1` (Cơ Bản) hoặc `2` (Mở Rộng)
- Để trống nếu chưa đánh giá
- Ý nghĩa:
  - **Cơ Bản (1):** KOC nhỏ, ảnh hưởng hạn chế
  - **Mở Rộng (2):** KOC lớn, ảnh hưởng rộng

### 15. **Loại Hợp Tác**
- Giá trị: `Cast` hoặc `Non-Cast`
- Ý nghĩa:
  - **Cast:** KOC được trả phí để làm content
  - **Non-Cast:** KOC chỉ nhận sản phẩm miễn phí
- Để trống nếu chưa xác định

### 16. **Tham Gia Incentive**
- Giá trị: `Có` hoặc `Không`
- Mặc định: `Không`

### 16. **KOC Tổng Hợp**
- Giá trị: `Có` hoặc `Không`
- Mặc định: `Không`
- Ý nghĩa: KOC được tổng hợp từ nhiều nguồn

### 17. **Ghi Chú Chung**
- Định dạng: Text tự do
- Ví dụ: `KOC tiềm năng`, `Mẹ 2 con`, `Nhiệt tình`

---

## 🔍 QUY TẮC KIỂM TRA TRÙNG LẶP

Hệ thống sẽ kiểm tra trùng lặp dựa trên:
1. **Số điện thoại** (nếu có)
2. **CCCD** (nếu có)
3. **Social Profile** (Platform + StableUid)

Nếu phát hiện trùng, hệ thống sẽ:
- Bỏ qua dòng đó
- Báo lỗi trong kết quả import

---

## 📊 CẤU TRÚC FILE (29 cột)

### Thứ Tự Cột (29 cột)
1. STT
2. Họ Tên KOC (*)
3. Số Điện Thoại
4. Email
5. CCCD
6. Zalo
7. Địa Chỉ
8. Tỉnh/Thành
9. Tên Con 1
10. Ngày Sinh Con 1
11. Giới Tính Con 1
12. Ghi Chú Con 1
13. Tên Con 2
14. Ngày Sinh Con 2
15. Giới Tính Con 2
16. Ghi Chú Con 2
17. TikTok Link (*)
18. Facebook Link
19. Instagram Link
20. Threads Link
21. YouTube Link
22. Danh Mục (*)
23. Người Phụ Trách (ME)
24. Tình Trạng Hợp Tác
25. Cấp Độ KOC (1=Cơ Bản/2=Mở Rộng)
26. Loại Hợp Tác (Cast/Non-Cast)
27. Tham Gia Incentive
28. KOC Tổng Hợp
29. Ghi Chú Chung

---

## 🚀 CÁCH SỬ DỤNG

### Bước 1: Chuẩn Bị Dữ Liệu
1. Mở file `KOC_IMPORT_TEMPLATE_SUA_CONG_THUC.csv`
2. Xóa 3 dòng mẫu (dòng 2, 3, 4)
3. Nhập dữ liệu KOC của bạn

### Bước 2: Kiểm Tra Dữ Liệu
- ✅ Các trường bắt buộc (*) đã điền đầy đủ
- ✅ Định dạng ngày tháng đúng: DD/MM/YYYY
- ✅ Link social media đầy đủ (https://...)
- ✅ Danh mục viết đúng chính tả
- ✅ Không có ký tự đặc biệt lạ

### Bước 3: Chuyển Đổi Sang Excel (Nếu Cần)
1. Mở file CSV trong Excel
2. File > Save As > chọn định dạng `.xlsx`
3. Lưu với tên mới

### Bước 4: Upload Vào Hệ Thống
1. Vào trang **KOC Management**
2. Click nút **"Bulk Import"** hoặc **"Nhập Hàng Loạt"**
3. Chọn file Excel/CSV
4. Click **"Upload"**
5. Đợi hệ thống xử lý

### Bước 5: Kiểm Tra Kết Quả
Sau khi import, hệ thống sẽ hiển thị:
- ✅ **Số dòng thành công**: KOC đã được tạo
- ❌ **Số dòng lỗi**: Lý do lỗi cụ thể
- ⚠️ **Số dòng bỏ qua**: Trùng lặp hoặc thiếu thông tin

---

## ⚠️ LƯU Ý QUAN TRỌNG

### 1. Về Thông Tin Con
- **Rất quan trọng** cho chương trình Sữa Công Thức
- Giúp phân loại KOC theo độ tuổi con:
  - **0-6 tháng**: Sữa cho trẻ sơ sinh
  - **6-12 tháng**: Sữa cho trẻ ăn dặm
  - **1-3 tuổi**: Sữa cho trẻ nhỏ
  - **3+ tuổi**: Sữa cho trẻ lớn
- Nếu không có thông tin con, KOC sẽ khó được phân loại chính xác

### 2. Về Link Social Media
- Phải là link **profile/channel**, không phải link bài viết
- Ví dụ đúng: `https://www.tiktok.com/@username`
- Ví dụ sai: `https://www.tiktok.com/@username/video/1234567890`

### 3. Về Danh Mục
- Chỉ chọn 1 trong 2:
  - `Sữa công thức bò`
  - `Sữa công thức dê`
- Viết chính xác, không viết tắt

### 4. Về Người Phụ Trách
- Phải là tên ME có trong hệ thống
- Nếu không tìm thấy, KOC sẽ không được assign

### 5. Về Encoding
- File CSV phải lưu với encoding **UTF-8 with BOM**
- Để hiển thị đúng tiếng Việt có dấu

---

## 🐛 XỬ LÝ LỖI THƯỜNG GẶP

| Lỗi | Nguyên Nhân | Cách Khắc Phục |
|-----|-------------|----------------|
| "Thiếu tên kênh" | Cột "Họ Tên KOC" để trống | Điền tên KOC |
| "Thiếu link social" | Không có TikTok hoặc Facebook link | Điền ít nhất 1 link |
| "Danh mục không hợp lệ" | Viết sai tên danh mục | Viết đúng: "Sữa công thức bò" hoặc "Sữa công thức dê" |
| "Người phụ trách không tồn tại" | Tên ME không có trong hệ thống | Kiểm tra lại tên ME hoặc để trống |
| "Ngày sinh không hợp lệ" | Sai định dạng ngày | Dùng định dạng DD/MM/YYYY |
| "KOC đã tồn tại" | Trùng số điện thoại hoặc CCCD | Kiểm tra lại hoặc cập nhật KOC cũ |

---

## 📞 HỖ TRỢ

Nếu gặp vấn đề khi import, vui lòng liên hệ:
- **Email**: info@hoai.name.vn
- **Hotline**: 0798869696
- Hoặc Hoài đẹp troai

---

## 📝 CHANGELOG

### Version 1.0 (2025-01-29)
- Tạo template ban đầu
- Hỗ trợ 28 trường thông tin
- Hỗ trợ tối đa 2 con
- Hỗ trợ 5 kênh social media

---

**Chúc bạn import thành công! 🎉**