# คู่มือการใช้ AI/LLM สร้าง JSON สำหรับนำเข้าสินค้า (Product Catalog Generator)

ระบบรองรับการสร้างสินค้าจำนวนมากผ่าน **JSON Import** ในหน้า Admin (`/admin/products` -> คลิกปุ่ม **"Import JSON"**) หรือเรียก API `POST /api/products/bulk`

เพื่อป้องกันไม่ให้ AI เกิดความสับสนกับตัวอย่างสินค้าเฉพาะกลุ่ม เอกสารชุดนี้จึงแยก Prompt ออกเป็น **4 ไฟล์เฉพาะทาง (Dedicated Prompts)** ตามหมวดธุรกิจและสภาพแวดล้อม Demo Showcase:

---

## 📂 รายการ Prompt ทั้ง 4 กลุ่มธุรกิจ (เลือก Copy ไปส่งให้ LLM ได้ทันที)

| กลุ่มธุรกิจ | ไฟล์ Prompt สำหรับ Copy | ตัวอย่างแบรนด์ / สินค้า | สภาพแวดล้อม Demo |
| :--- | :--- | :--- | :--- |
| **1. Wellness & Luxury** | [LLM_PROMPT_1_WELLNESS_LUXURY.md](file:///c:/Users/ti/git/homaroma/LLM_PROMPT_1_WELLNESS_LUXURY.md) | Panpuri, Jo Malone, Diptyque (น้ำมันหอมระเหย, ก้านไม้หอม, เทียนหอม, สปา) | `wellness.kittisak.com` |
| **2. Beauty & Multi-Brand** | [LLM_PROMPT_2_BEAUTY_MULTIBRAND.md](file:///c:/Users/ti/git/homaroma/LLM_PROMPT_2_BEAUTY_MULTIBRAND.md) | EVEANDBOY, Beautrium (สกินแคร์, เซรั่ม, กันแดด, ลิปสติก, คุชชั่น) | `beauty.kittisak.com` |
| **3. Fashion & Lifestyle** | [LLM_PROMPT_3_FASHION_LIFESTYLE.md](file:///c:/Users/ti/git/homaroma/LLM_PROMPT_3_FASHION_LIFESTYLE.md) | Jaspal, CPS CHAPS, Zara, Gentlewoman (เสื้อเชิ้ต, เดรส, กางเกง, กระเป๋าหนัง) | `fashion.kittisak.com` |
| **4. Motorcycle Parts & Accessories** | [LLM_PROMPT_4_MOTO_PARTS.md](file:///c:/Users/ti/git/homaroma/LLM_PROMPT_4_MOTO_PARTS.md) | RCB Racing Boy, Brembo, Öhlins, YSS (ปั๊มเบรก, คาลิปเปอร์, โช้คอัพ, ล้อแม็ก) | `moto.kittisak.com` |

---

## 🛠️ ข้อกำหนดทางเทคนิคสากล (Universal Schema Rules)

ไม่ว่าจะใช้ไฟล์ใด LLM จะต้องยึดหลักเกณฑ์ทางเทคนิคของระบบดังนี้:

1. **Format:** ต้องส่งคืนเฉพาะ **Valid JSON Array** (`[ ... ]`) ล้วนๆ ไม่มีข้อความเกริ่นหรือปิดท้าย
2. **Numeric Fields:** `price`, `stock`, `order` ต้องเป็นตัวเลข Number แท้จริง (ห้ามครอบเครื่องหมายคำพูด เช่น `"1500"` เป็นต้น)
3. **Product Types:**
   - **Simple Product (สินค้าเดี่ยว):** ใส่ `price`, `stock`, `sku`, `barcode` ที่ระดับบนสุด ระบบจะแปลงเป็น Base Variant ในฐานข้อมูลให้อัตโนมัติ
   - **Variable Product (สินค้ามีตัวเลือก ไซส์/สี/ขนาด):** กำหนด `options` (เช่น `[{"name": "ขนาด", "values": ["S", "M"]}]`) และใน `variants` ต้องมี `option1` ตรงกับค่าใน `values` ทุกตัวอักษร
4. **Bilingual (2 ภาษา):** มีฟิลด์ `translations` ครบทั้ง `th` และ `en` สำหรับ `name`, `description`, `details`
5. **Images:** กำหนดเป็น Array ของ URL รูปภาพจริง เช่น จาก Unsplash หรือ CDN

---

## 🚀 ขั้นตอนการนำเข้าข้อมูล (Import Workflow)

1. เปิดไฟล์ Prompt หมวดที่ต้องการ แล้ว Copy ข้อความในบล็อก `Prompt ส่งให้ LLM`
2. ส่งให้ LLM เช่น **ChatGPT, Claude 3.5 Sonnet หรือ Google Gemini**
   *(สามารถระบุจำนวนสินค้าที่ต้องการ เช่น "ขอ 20 รายการ" ได้)*
3. คัดลอก JSON ที่ได้จาก LLM
4. เข้าไปที่หน้า Admin ของระบบนั้นๆ -> เมนู **สินค้า (Products)** -> กดปุ่ม **"Import JSON"**
5. ตรวจสอบสถานะการตรวจสอบ (Validation) และกดยืนยัน **"ยืนยันนำเข้าสินค้า"**