homaroma/LLM_PRODUCT_JSON_GENERATOR_GUIDE.md

คู่มือการใช้ 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	Panpuri, Jo Malone, Diptyque (น้ำมันหอมระเหย, ก้านไม้หอม, เทียนหอม, สปา)	wellness.kittisak.com
2. Beauty & Multi-Brand	LLM_PROMPT_2_BEAUTY_MULTIBRAND.md	EVEANDBOY, Beautrium (สกินแคร์, เซรั่ม, กันแดด, ลิปสติก, คุชชั่น)	beauty.kittisak.com
3. Fashion & Lifestyle	LLM_PROMPT_3_FASHION_LIFESTYLE.md	Jaspal, CPS CHAPS, Zara, Gentlewoman (เสื้อเชิ้ต, เดรส, กางเกง, กระเป๋าหนัง)	fashion.kittisak.com
4. Motorcycle Parts & Accessories	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. Multilingual (รองรับครบ 8 ภาษา): ระบบรองรับการแปลภาษาผ่านฟิลด์ translations ครบทั้ง 8 ภาษามาตรฐานของระบบ:
   • th (ไทย - ภาษาหลัก)
   • en (English - สากล)
   • ja (日本語 - ญี่ปุ่น)
   • zh (简体中文 - จีนตัวย่อ)
   • vi (Tiếng Việt - เวียดนาม)
   • ko (한국어 - เกาหลี)
   • lo (ພາສາລາວ - ลาว)
   • it (Italiano - อิตาลี) ในแต่ละภาษากำหนด name, description, details ให้สอดคล้องกัน (สามารถสั่งให้ LLM แปลครบทั้ง 8 ภาษา หรือเลือกเฉพาะภาษาเป้าหมายที่ต้องการได้)
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) และกดยืนยัน "ยืนยันนำเข้าสินค้า"