คู่มือการใช้งาน Glamhagan Operations

วิธีใช้แอปแบบครบทุก feature — สำหรับ Jiggy

1. เริ่มต้นใช้งานทุกๆ วัน

  1. 1ดับเบิลคลิก start-glamhagan.bat ที่ Desktop หรือใน folder C:\Glamhagan-App\
  2. 2รอ 8 วินาที — Browser เปิดให้อัตโนมัติที่ localhost:3000
  3. 3ใช้งานได้เลย — เริ่มที่ หน้าภาพรวม หรือ แจ้งเตือน
  4. 4จบวัน — ปิดหน้าต่าง Command Prompt ที่เปิดไว้ (หรือทิ้งไว้ก็ได้)
Sidebar ทางซ้าย มี 5 หมวด: หน้าหลัก · ข้อมูล · Online channels · Marketing · จัดการ · ความช่วยเหลือ

2. งานทุกวัน — ขายเร็ว / รายจ่าย

ขายเร็ว (ASAP / Shopee / Line / Other)

เปิดหน้า →
  1. 1.แตะ "ขายเร็ว" ใน Sidebar
  2. 2.เลือก ช่องทาง — ระบบจะเลือก location ให้อัตโนมัติ (ASAP→ASAP, Shopee/TikTok→Online_Buffer)
  3. 3.กดเลือก สินค้า — พิมพ์ค้นหาก็ได้
  4. 4.ใส่ จำนวน — ราคาเด่งจาก catalog ให้แล้ว, แก้ได้ถ้าลด
  5. 5.กด "บันทึกการขาย" — Stock จะหักให้ทันที
ขาย ZOS ใช้ POS ใน event hub แทน — เร็วกว่ามาก

บันทึกรายจ่าย + ใบเสร็จ

เปิดหน้า →
  1. 1.แตะ "รายจ่าย""+ บันทึกรายจ่าย"
  2. 2.ใส่ วันที่ + ยอดเงิน
  3. 3.เลือก ประเภท (Booth_Fees / Ads / COGS / Photoshoot / etc.)
  4. 4.📷 ถ่ายรูป ใบเสร็จ — แตะปุ่ม Camera (บน iPhone จะเปิดกล้องเลย)
  5. 5.หรือ ลากรูปวางในกล่อง / เลือกไฟล์
  6. 6.กด "บันทึก" — รูปจะถูกย่อให้เล็กอัตโนมัติ
รูปเก็บใน data/evidence/{ปี-เดือน}/ — backup ทุกวันจะรวมไปด้วย

ดูภาพรวมตอนเช้า

เปิดหน้า →
  1. 1.เปิด "ภาพรวม" (หน้าแรก)
  2. 2.ดู "Glamhagan ตั้งแต่เริ่ม" — รายได้สะสม + กำไรสะสม
  3. 3.ดู 4 KPI เดือนนี้
  4. 4.ดู ปฏิทิน 90 วัน — สีเข้มกว่า = ขายดีกว่า
  5. 5.ดู Top SKUs เดือนนี้

ดูแจ้งเตือนสำคัญ

เปิดหน้า →
  1. 1.แตะ "แจ้งเตือน" ใน Sidebar
  2. 2.🚨 หมดสต็อก — ต้องสั่งของทันที
  3. 3.⚠️ ใกล้หมด — เตรียมสั่ง
  4. 4.💤 ขายไม่ดี 60+ วัน — พิจารณาลดราคาหรือเลิก
  5. 5.🎪 Event ค้างของ — ยังไม่คืนของ
  6. 6.🏪 ASAP refill — ยังไม่เติมของไปร้านนาน

3. งาน Event ZOS — 4 ขั้นตอน

งาน Event ใช้ flow แบบใหม่ — สร้างงาน 1 ครั้ง แล้วใช้ POS เก็บเงินหน้างานต่อเนื่องได้เลย

1
สร้าง event
ZOS43, วันที่, ค่าบูธ
2
Pack ของไป
Warehouse → งาน
3
POS หน้างาน
กดเก็บเงินต่อเนื่อง
4
คืนของ + ปิด
งาน → Warehouse
  1. 1สร้าง event: งาน Event → "+ สร้างงานใหม่"
    • • ใส่ชื่อ (ระบบเดา ZOS43, ZOS44 ให้)
    • • ใส่วันที่เริ่ม-จบ + ค่าบูธ + ค่าพนักงาน
    • • Save → ระบบสร้าง location ZOS43 อัตโนมัติ + บันทึก booth/staff เป็น expense
    • • กระโดดไป Event Hub ทันที
  2. 2Pack ของไป: ที่ Event Hub → กดปุ่ม 📦 Pack ของไป
    • • Tap-grid สินค้าใน Warehouse
    • • กด +/- หรือพิมพ์ qty ที่จะเอาไป
    • • Save → stock ที่ Warehouse ลด, ที่ ZOS43 เพิ่ม
  3. 3POS หน้างาน ⭐⭐: ที่ Event Hub → กดปุ่ม 💰 POS · เปิดร้าน (ปุ่มใหญ่สี cherry)
    Workflow ลูกค้า 1 คน:
    • แตะรูปสินค้า → เพิ่มเข้าตะกร้า (มี badge แสดง qty)
    • +/- qty หรือแก้ราคาในช่อง
    • ลดราคา: ปุ่ม -10% / -20% / -30% / -50% ต่อบรรทัด
    • แถม: ปุ่ม "🎁 แถม" → ราคา ฿0
    • ลดทั้งบิล: ปุ่มด้านล่าง -10/-20/-30/-50%
    • กด เก็บเงิน ฿xxx → ลูกค้าเสร็จ → cart รีเซ็ต → ลูกค้าใหม่
    • กดผิด? Undo ฿xxx ลบ checkout ล่าสุดได้
    บนหัวจอ: ลูกค้าวันนี้ + ยอดวันนี้ + เฉลี่ย/บิล แสดงตลอด
  4. 4หลังงาน — Return + ปิด: Event Hub → ↩️ คืนของ + ปิดงาน
    • • ระบบเดาตัวเลขให้แล้วจาก pack-sales
    • นับจริง ของที่เหลือที่บูธ → ใส่ลงไป
    • • ส่วนต่าง = ของหาย (จะแสดงเตือน)
    • • ติ๊ก "ปิด event location" → Save
    • • ของที่เหลือ auto-transfer กลับ Warehouse
กรณีลืมบันทึกหน้างาน: Event Hub → 📝 Backfill → กรอกข้อมูลย้อนหลังเป็น batch

4. บริหาร Stock

แนวคิด: 4 Locations

ของไม่ได้อยู่ที่เดียว — ระบบ track แยกตาม location

🏠 Warehouse
คลังหลักที่บ้าน · default
🏪 ASAP
หน้าร้าน · ค่าเช่า ฿6,420/เดือน
📲 Online_Buffer
ของกันไว้ขาย Shopee/TikTok/Line
🎪 ZOS43+
ที่บูธ event · auto-create + ปิดเมื่อจบ

รับของจาก Supplier

เปิดหน้า →
  1. 1.แตะ "สต็อก""+ รับของ"
  2. 2.เลือก Supplier (Shenzen / Yiwu / etc.)
  3. 3.เลือก SKU + จำนวนรับ + QC pass/fail/damaged
  4. 4.ใส่ต้นทุน/ชิ้น + reference (ใบ invoice)
  5. 5.Save → stock เพิ่มที่ Warehouse
หลาย SKU ใช้ /stock-in/batch จะเร็วกว่า

ย้ายของระหว่าง Location

เปิดหน้า →
  1. 1.แตะ "ย้ายของ" ใน Sidebar
  2. 2.เลือก "ย้ายหลายรายการ" (batch) — เหมาะกว่า single
  3. 3.เลือก จากที่ → ไปยัง (เช่น Warehouse → ASAP)
  4. 4.เลือก เหตุผล (refill ASAP / online_alloc / etc.)
  5. 5.เพิ่มแถว SKU + qty หลายตัวพร้อมกัน
  6. 6.Save → atomic — ทุกแถวบันทึกพร้อมกัน
ใช้ตอน weekly refill ASAP / กันของให้ Shopee

ดู Stock 3 มุม

เปิดหน้า →
  1. 1.ภาพรวม — รวมทุก location เป็นยอดเดียว
  2. 2.Matrix — ตาราง SKU × Location เห็นทั้งหมด
  3. 3.Per-location — เลือก ASAP/Warehouse/ZOS43 → ดูเฉพาะที่นั้น
  4. 4.Filter: หมด / ใกล้หมด / พอใช้
  5. 5.Sort คอลัมน์ + search

เพิ่ม Location ใหม่

เปิดหน้า →
  1. 1.แตะ "Locations" ใน Sidebar
  2. 2.กด "+ เพิ่ม Location"
  3. 3.ใส่ชื่อ + ประเภท (warehouse / store / online / event)
  4. 4.ใช้กรณี: เปิดร้านที่ 2, pop-up booth, แยก online channel ต่างๆ
event location สร้างอัตโนมัติเมื่อสร้าง ZOS event

5. QC Hub — ของหลุด QC

เก็บ record ของที่ QC ไม่ผ่าน + เสีย — แยกตาม supplier เพื่อประเมินคุณภาพแต่ละโรงงาน

  1. 1ตอนรับของ: ใส่ QC failed + Damaged ใน หน้ารับของ → ระบบ track อัตโนมัติ
  2. 2หลังรับของ — เจอของเสีย/หาย: QC Hub → "+ บันทึก QC ใหม่"
    • • ประเภท: DAMAGE / LOST / RECOUNT_MINUS / RETURN_FROM_CUSTOMER / FOUND
    • • ใส่ SKU + qty + เหตุผล
    • • Save → stock ลด + เก็บเป็น record QC ของ supplier
  3. 3ดู ranking supplier: /qc → table ทางซ้ายแสดง pass rate ทุก supplier
    • เขียว = pass rate ≥ 95%
    • เหลือง = 80-95%
    • แดง = ต่ำกว่า 80% — พิจารณาเปลี่ยน supplier
  4. 4คลิก supplier → filter เห็น events ของ supplier นั้นเท่านั้น

6. จัดการสินค้า + รูปภาพ

แก้ข้อมูล SKU + อัพรูป

เปิดหน้า →
  1. 1.แตะ "สินค้า" ใน Sidebar
  2. 2.คลิก SKU ที่ต้องการ → ดู detail page
  3. 3.กด "แก้ไข" → form + photo manager
  4. 4.📷 อัพได้ 8 รูป: camera (iPhone) / drag-drop / file picker
  5. 5.กด ⭐ บนรูป → ตั้งเป็น cover (รูปหลักที่แสดงใน list)
  6. 6.กด ✕ บนรูป → ลบ
  7. 7.แก้ราคา/cost → ระบบคำนวณ margin ให้ live
cover photo จะโชว์ใน Top SKUs ของ Dashboard

เพิ่ม SKU ใหม่

เปิดหน้า →
  1. 1.แตะ "สินค้า""+ เพิ่ม SKU"
  2. 2.ใส่ SKU code (A-Z 0-9 - _ เท่านั้น) เช่น GHG-EAR-NEW1
  3. 3.ใส่ชื่อ + หมวด + วัสดุ + สี
  4. 4.ใส่ cost + ราคาขาย — ดู margin live ที่ panel ขวา
  5. 5.เลือก Supplier + status (active / ลองขาย)
  6. 6.Save → ไปหน้า edit เพื่ออัพรูปต่อ

7. Online channels — Shopee / TikTok / Line

Shopee และ TikTok ต้อง Export CSV/Excel จาก Seller Centre แล้วอัพโหลดเข้าระบบ — Phase ถัดไปจะมี API auto-sync ทุก 4 ชั่วโมง

  1. 1Login Shopee Seller Centre / TikTok Shop Center → Export orders เป็น Excel/CSV
  2. 2Import file → เลือกช่องทาง (Shopee / TikTok / Lazada / Line / CSV)
  3. 3ลากไฟล์มาวาง → ระบบหา column อัตโนมัติ + เดา SKU mapping
  4. 4Review screen:
    • ผูก SKU แล้ว = พร้อม import
    • ยังไม่ผูก = กดเลือก SKU เอง (ระบบจะจำไว้ครั้งหน้า)
  5. 5ติ๊ก "จำการผูกไว้สำหรับครั้งหน้า" → save → sales บันทึกที่ location Online_Buffer
  6. 6ดูประวัติ import ที่ /imports
ครั้งแรกใช้เวลา ผูก SKU mapping ทุกตัว · ครั้งที่ 2 เป็นต้นไป ระบบจะ auto-resolve เกือบหมด

8. Marketing Hub — Calendar + Assets + Campaigns

  1. 1.แตะ "Content calendar" ใน Sidebar
  2. 2.คลิกวันใดวันหนึ่ง → modal สร้างโพสต์ใหม่
  3. 3.เลือก ช่อง (IG/TikTok/FB/Line/Shopee) + ประเภท (product/bts/promo/lifestyle)
  4. 4.ใส่ caption ภาษาไทย + hashtags
  5. 5.เลือก SKUs ในโพสต์ + Campaign ที่ผูก
  6. 6.Save status: draft → scheduled → posted
คลิกโพสต์เก่า → modal เปิดแก้ไขได้
  1. 1.แตะ "Asset library"
  2. 2.กด "อัพ asset" → ลากไฟล์
  3. 3.ติด mood tags: cute / cherry / coquette / on-model / BTS / etc.
  4. 4.ติด SKU tags: รูปนี้มีสินค้าตัวไหนบ้าง
  5. 5.Filter ตาม mood / SKU / search
product photos จาก /products รวมอยู่ด้วย
  1. 1.แตะ "Campaigns" → "+ Campaign ใหม่"
  2. 2.ตั้ง theme + วันที่ + budget
  3. 3.เลือก ช่อง + Target SKUs
  4. 4.กลับ Calendar → สร้างโพสต์หลายๆ ตัว ผูกกับ campaign นี้
  5. 5.Detail page เห็น posts ทั้งหมดใน campaign
ตัวอย่าง: 'ZOS43_lead_up' = 7 โพสต์ก่อนงาน
Phase ถัดไป (Marketing M2-M5): Influencer DB, AI caption generator (Claude), ROI dashboard, IG/TikTok auto-sync — ดูใน Marketing Hub เมื่อพร้อม

9. Dashboard / Alerts / Cashflow

  • ภาพรวมGlamhagan ตั้งแต่เริ่ม + KPI เดือนนี้ + ปฏิทิน 90 วัน + Top SKUs + Stock health
  • แจ้งเตือนหมดสต็อก · ใกล้หมด · ขายไม่ดี · ขาดทุน · Event ค้าง · ASAP refill overdue
  • กระแสเงินP&L รายเดือน · Waterfall · Treemap · Per-Event ZOS comparison · Cumulative profit
    Toggle "เฉพาะข้อมูลใหม่" ถ้าอยากดูเฉพาะข้อมูล per-piece (ตั้งแต่ พ.ค. 2569)
  • ยอดขายทุกรายการ · filter ช่องทาง / วันที่ / SKU · sort ทุกคอลัมน์
  • สต็อก3 view: ภาพรวม / Matrix / per-location · filter หมด-ใกล้หมด-พอใช้
  • รายจ่ายFilter category + วันที่ · จำนวนรูปใบเสร็จต่อ row

10. Backup / Excel export / Settings

Backup ตอนนี้

  1. 1ไปที่ ตั้งค่า
  2. 2กด "Backup ตอนนี้"
  3. 3ไฟล์ .sql ถูก copy ไป data/backups/ บน server
  4. 4เก็บไว้ 30 ตัวล่าสุด (auto delete ตัวเก่า)
Auto-backup รายวัน — setup ครั้งเดียวด้วย cron บน Linux (ดูใน infra/backup-cron.sh)

Export Excel ทั้งระบบ

  1. 1ไปที่ ตั้งค่า
  2. 2กด "Export Excel ทั้งหมด"
  3. 3ไฟล์ Glamhagan_export_YYYYMMDD.xlsx ถูกสร้างใน data/backups/
  4. 49 sheets: ขาย / รับของ / รายจ่าย / ปรับสต็อก / Products / Suppliers / Locations / Transfers / Cashflow
ใช้ส่งให้ Ken รีวิวแบบ offline / audit รายเดือน

11. ใช้งานบน iPhone

  1. 1iPhone ต้อง connect wifi เดียวกับคอม
  2. 2ไปที่ เชื่อมต่อมือถือ ในคอม
  3. 3เปิด Camera บน iPhone → ส่อง QR → แตะแถบเหลือง
  4. 4ใน Safari แตะปุ่ม Share → "เพิ่มที่หน้าจอหลัก"
  5. 5แตะ icon GlamHagan บน Home Screen — ใช้ได้เหมือน app
ตอนอยู่ที่บูธ ZOS — ใช้ Personal Hotspot ของ iPhone → คอมเชื่อม wifi เดียวกัน → POS ใช้บน iPad/iPhone ได้ live

12. เมื่อมีปัญหา

แอปไม่เปิด / localhost ไม่โหลด

  1. 1.ปิดหน้าต่าง Command Prompt ทั้งหมด
  2. 2.ดับเบิลคลิก start-glamhagan.bat ใหม่
  3. 3.รอ 10-15 วินาที (ครั้งแรกจะช้า)
  4. 4.ถ้ายังไม่ได้ — โทรหา Ken

Stock ไม่ตรง

  1. 1.ไปที่ /qc/new บันทึกของหาย/เสีย หรือ FOUND
  2. 2.ถ้า import แล้ว double — ลบจาก /sales (filter date)
  3. 3.ถ้าจริงๆ ผิดเยอะ — Backup ก่อน → reset → seed ใหม่ (ติดต่อ Ken)

iPhone เข้าไม่ได้

  1. 1.ตรวจ wifi เดียวกับคอม
  2. 2.ไป /connect-phone สแกน QR ใหม่
  3. 3.ลอง restart wifi router
  4. 4.ตรวจ Windows Firewall — Allow Node.js (private)

POS ไม่มีของให้กด

  1. 1.ของยังไม่ pack ไป event
  2. 2.กลับ Event Hub → กด Pack ก่อน
  3. 3.แล้วกลับมาเปิด POS อีกครั้ง

Import เจอ error 'หา column ไม่เจอ'

  1. 1.ไฟล์ format ไม่ตรงกับที่ระบบรู้จัก
  2. 2.Screenshot ไฟล์ → ส่งให้ Ken เพิ่ม column hints
  3. 3.หรือใช้ "CSV ทั่วไป" และ rename headers เป็น "Date / Product Name / SKU / Quantity / Price"

กลัวข้อมูลหาย

  1. 1.กด Backup ตอนนี้ใน /settings ก่อนใช้งานหนัก
  2. 2.Auto-backup เก็บ 30 ตัวล่าสุดในโฟลเดอร์ backup ของ server
  3. 3.Export Excel เก็บไว้นอก app ก็ดี
  4. 4.DB อยู่บน MySQL server (กำหนดผ่าน env: MYSQL_HOST/DATABASE)
ปัญหาเฉพาะ / อยากเพิ่ม feature → แจ้ง Ken · ดู version ที่ /settings