# 📖 คู่มือการใช้งานระบบ POS ร้านอาหาร PosStar ฉบับสมบูรณ์ (Complete User Manual)

ยินดีต้อนรับสู่ระบบบริหารจัดการร้านอาหาร **PosStar** ระบบ POS และ Kitchen Display System (KDS) ที่ออกแบบมาเพื่อร้านอาหาร คาเฟ่ และธุรกิจเครื่องดื่มโดยเฉพาะ รองรับทั้งหน้าจอคอมพิวเตอร์ แท็บเล็ต (iPad/Android) และโทรศัพท์มือถือ

---

## 📑 สารบัญ (Table of Contents)
1. [การเข้าสู่ระบบและจัดการกะการทำงาน (Login & Shifts)](#1-การเข้าสู่ระบบและจัดการกะการทำงาน)
2. [การขายหน้าร้าน (Counter POS Operations)](#2-การขายหน้าร้าน-counter-pos-operations)
3. [ระบบแสดงผลในครัว & เสียงพูดแจ้งเตือน (KDS & Voice Announcements)](#3-ระบบแสดงผลในครัว-kitchen-display-system---kds)
4. [ผังโต๊ะอาหาร, โซน VIP & เช็คบิลที่โต๊ะ (Floor Plan, VIP Rooms & Table Checkout)](#4-ผังโต๊ะอาหารและการจัดการโซน-floor-plan--table-management)
5. [ระบบลูกค้าสแกนสั่งอาหารผ่าน QR (Mobile QR Self-Ordering)](#5-ระบบลูกค้าสแกนสั่งอาหารผ่าน-qr-mobile-qr-self-ordering)
6. [การจัดการเมนูอาหาร, คลังรูปสำเร็จรูป 189 รูป & เมนู Demo (Menu, Preset Images & Inventory)](#6-การจัดการเมนูอาหารและวัตถุดิบ-menu--inventory)
7. [รายงานยอดขายและวิเคราะห์การเงิน (Sales Reports & Analytics)](#7-รายงานยอดขายและวิเคราะห์การเงิน-sales-reports--analytics)
8. [ระบบบัญชีร้านค้าดึงยอดอัตโนมัติ (Store Accounting Ledger)](#8-ระบบบัญชีร้านค้าดึงยอดอัตโนมัติ-store-accounting-ledger)
9. [การตั้งค่าร้านค้า, บันทึกความปลอดภัย & ระบบรับเงิน PromptPay / Alipay / WeChat (Settings, Security Audit & Payments)](#9-การตั้งค่าร้านค้าและระบบรับเงิน-store-settings--promptpay)
10. [ระบบสมาชิกและส่วนลดอัตโนมัติ (Membership & CRM System)](#10-ระบบสมาชิกและส่วนลดอัตโนมัติ-membership--crm-system)
11. [การใช้งานบนแท็บเล็ตและมือถือ (Mobile & Tablet Experience)](#11-การใช้งานบนแท็บเล็ตและมือถือ-mobile--tablet-experience)
12. [ระบบ 2 ภาษา ไทย - อังกฤษ (Bilingual Thai / English System)](#12-ระบบ-2-ภาษา-ไทย---อังกฤษ-bilingual-thai--english-system)
13. [การแก้ปัญหาเบื้องต้นและคำถามที่พบบ่อย (Troubleshooting & FAQ)](#13-การแก้ปัญหาเบื้องต้นและคำถามที่พบบ่อย-troubleshooting--faq)
14. [การเคลียร์ยอดทั้งหมดก่อนเปิดใช้งานจริง (Factory Reset Data)](#19-การเคลียร์ยอดทั้งหมดก่อนเปิดใช้งานจริง-factory-reset-data-before-launch)
15. [ศูนย์แชตสดร้านค้า & ห้องแจ้งปัญหาการใช้งาน (Live Chat & Support)](#20-ศูนย์แชตสดร้านค้า-ห้องแจ้งปัญหาการใช้งาน--โหมดมือถือ-live-chat--support-hub)
16. [ระบบเปิดสาขาเพิ่ม & บริหารหลายสาขา (Branch Expansion & Store Switching)](#21-ระบบเปิดสาขาเพิ่ม--บริหารจัดการหลายสาขา-branch-expansion--multi-branch-management)

---

## 1. การเข้าสู่ระบบและจัดการกะการทำงาน

### 1.1 การเข้าสู่ระบบ (Login) & การยืนยันตัวตน
1. **เข้าสู่ระบบด้วยชื่อผู้ใช้ / อีเมล**:
   - กรอก **ชื่อผู้ใช้ (Username)** หรือ **อีเมล (Email)** และ **รหัสผ่าน (Password)** แล้วกดปุ่ม "เข้าสู่ระบบ (Login)"
2. **เข้าสู่ระบบและสมัครสมาชิกด้วย Google (Google Sign-In / OAuth 2.0)**:
   - แตะปุ่ม **"เข้าสู่ระบบ / สมัครด้วย Google"** เพื่อล็อกอินด้วยบัญชี Gmail ของ Google ได้สะดวกรวดเร็วและปลอดภัยสูง
   - หากยังไม่มีบัญชีในระบบ ระบบจะสร้างบัญชีผู้ใช้งานใหม่อัตโนมัติทันที
3. **ระบบลืมรหัสผ่าน (Forgot Password)**:
   - หากลืมรหัสผ่าน ให้กดลิงก์ **"ลืมรหัสผ่าน?"**
   - กรอกชื่อผู้ใช้หรืออีเมลเพื่อขอรับรหัส OTP 6 หลัก แล้วตั้งรหัสผ่านใหม่ได้ทันที
4. **การสมัครสมาชิกผู้ใช้งานใหม่ (Sign Up)**:
   - กดปุ่ม **"สมัครสมาชิกใหม่"** ด้านล่างฟอร์มเพื่อลงทะเบียนบัญชีพนักงานหรือผู้ดูแลร้านค้าย่อย

### 1.2 การสลับโหมดหน้าจอมืด/สว่าง (Dark & Light Theme)
- กดที่ไอคอน **พระจันทร์ 🌙 / พระอาทิตย์ ☀️** บนแถบด้านบน (Topbar) เพื่อสลับโหมดแสงได้ทันที ระบบจะจดจำค่าไว้ให้อัตโนมัติ

### 1.3 การออกจากระบบ (Logout)
- กดที่ไอคอน **ออกจากระบบ (Sign Out)** บริเวณแถบเมนูด้านล่างสุดของแถบข้าง (Sidebar)

### 1.4 การแก้ไขรูปโปรไฟล์และข้อมูลผู้ใช้ (Profile Avatar & Account Info)
- ผู้ใช้งานทุกคน (Admin, พนักงาน, แคชเชียร์) สามารถเปลี่ยนรูปไอคอนโปรไฟล์และแก้ไขข้อมูลส่วนตัวได้เอง:
  1. แตะที่ **รูปโปรไฟล์ / ชื่อผู้ใช้** บริเวณมุมขวาบนของแถบด้านบน (Topbar)
  2. เลือกเมนู **"แก้ไขข้อมูล & รูปโปรไฟล์"**
  3. สามารถอัปโหลดรูปภาพประจำตัวใหม่ (รองรับไฟล์ JPG, PNG, WebP)
  4. แก้ไขชื่อ-นามสกุล, เบอร์โทรศัพท์, อีเมล และเปลี่ยนรหัสผ่านใหม่
  5. กด **"บันทึกข้อมูล"** รูปโปรไฟล์และชื่อจะอัปเดตแสดงผลทั่วทั้งระบบทันที

---

## 2. การขายหน้าร้าน (Counter POS Operations)

เข้าสู่เมนู **"หน้าขาย (POS)"** จากแถบเมนูด้านข้างหรือปุ่มลัดด้านล่าง

### 2.1 ขั้นตอนการรับออเดอร์
1. **เลือกประเภทการสั่งอาหาร**:
   - 🪑 **ทานที่ร้าน (Dine-in)**: แตะเลือกหมายเลขโต๊ะที่ต้องการ
   - 🛍️ **กลับบ้าน (Takeaway)**: ระบบจะไม่บังคับเลือกโต๊ะ
   - 🛵 **เดลิเวอรี (Delivery)**: สำหรับออเดอร์ส่งถึงบ้าน
2. **เลือกหมวดหมู่อาหาร**:
   - แตะที่แท็บหมวดหมู่ด้านบน เช่น *อาหารจานเดียว, ทานเล่น, เครื่องดื่ม, ของหวาน*
   - หรือใช้ **ช่องค้นหา 🔍** ด้านบน พิมพ์ชื่อเมนูเพื่อความรวดเร็ว
3. **เพิ่มรายการอาหารลงตะกร้า**:
   - แตะที่การ์ดรูปอาหาร หรือกดปุ่ม + บนการ์ด
   - หากต้องการเพิ่มจำนวน ให้กดปุ่ม + ในตะกร้า หรือกดซ้ำที่เมนูนั้นๆ
   - หากต้องการลดจำนวน ให้กดปุ่ม −

### 2.2 การระบุหมายเหตุพิเศษของเมนู (Modifier Notes)
- ในตะกร้าสินค้า กดที่ไอคอน **ดินสอ ✏️** ข้างชื่อเมนู
- พิมพ์โน้ตพิเศษ เช่น *หวานน้อย, เผ็ดมาก, ไม่ใส่ผัก, แยกน้ำแข็ง* หรือกดปุ่มลัด
- กด **"บันทึกโน้ต"** ข้อความนี้จะถูกส่งไปแสดงที่หน้าจอครัวและพิมพ์ลงใบออเดอร์โดยอัตโนมัติ

### 2.3 การใส่ส่วนลดและคูปอง (Discounts)
- กดปุ่ม **"ส่วนลด/คูปอง"** ในแผงตะกร้าสินค้า
- เลือกรูปแบบส่วนลด:
  - **ลดเป็นบาท (฿)**: กรอกจำนวนเงินที่ต้องการลด
  - **ลดเป็นเปอร์เซ็นต์ (%)**: เช่น 10%, 15%
  - **รหัสคูปอง**: กรอกโค้ดโปรโมชั่น
- กดยืนยัน ยอดเงินรวมจะถูกคำนวณใหม่ทันที

### 2.4 การคิดเงินด่วนและการชำระเงิน (Checkout & Quick Cash)
1. **เลือกวิธีชำระเงิน**:
   - 💵 **เงินสด (Cash)**: 
     - กดปุ่มเงินด่วน ฿100, ฿500, ฿1,000 หรือ พอดี
     - ระบบจะคำนวณ **เงินทอน (Change)** ให้ทันทีแบบเรียลไทม์
   - 📱 **พร้อมเพย์ (PromptPay QR)**:
     - กดปุ่ม "ชำระเงิน" ระบบจะแสดง **Dynamic QR Code** พร้อมยอดเงินเป๊ะๆ ให้ลูกค้าสแกนจ่ายผ่านแอปธนาคาร
   - 💳 **บัตรเครดิต (Card)** / 🏦 **โอนเงิน (Transfer)**
2. กดปุ่ม **"ชำระเงิน"** เพื่อบันทึกบิลและปิดการขาย
3. กล่องพิมพ์ใบเสร็จจะทำงานอัตโนมัติ (Thermal Receipt 58mm/80mm)

---

## 3. ระบบแสดงผลในครัว (Kitchen Display System - KDS)

เข้าสู่เมนู **"ห้องครัว (KDS)"** เหมาะสำหรับตั้งแท็บเล็ตหรือจอ Monitor ไว้ในครัว

### 3.1 การทำงานของตั๋วออเดอร์ (Kitchen Tickets)
- เมื่อหน้าร้านหรือลูกค้าผ่าน QR สั่งอาหาร ตั๋วจะเด้งขึ้นหน้าจอครัวทันที พร้อมเสียงแจ้งเตือน 🔔
- รายการอาหารจะถูกจัดกลุ่มตาม **หมายเลขโต๊ะ** พร้อมแสดงจำนวน 2x และหมายเหตุพิเศษอย่างเด่นชัด

### 3.2 แถบสีจับเวลาความเร่งด่วน (Elapsed Timer Badges)
- 🟢 **สีเขียว (< 10 นาที)**: ออเดอร์เข้าใหม่ ปรุงตามลำดับ
- 🟡 **สีส้ม (10–20 นาที)**: ออเดอร์เริ่มรอนาน ควรเร่งมือ
- 🔴 **สีแดง (> 20 นาที)**: ออเดอร์รอนานมาก ต้องรีบจัดส่งให้ลูกค้าทันที

### 3.3 ปุ่มกดเปลี่ยนสถานะอาหาร (One-Click Status Workflow)
1. กด **"เริ่มทำ (Cooking)"** เมื่อพ่อครัวเริ่มลงมือปรุงอาหาร
2. กด **"เสร็จแล้ว / พร้อมเสิร์ฟ (Ready)"** เมื่อทำเสร็จ ระบบจะส่งเสียงแจ้งเตือนพนักงานเสิร์ฟ
3. กด **"เสิร์ฟให้ลูกค้าแล้ว (Served)"** เมื่อพนักงานนำไปเสิร์ฟที่โต๊ะเรียบร้อย
4. กด **"ล้างที่เสิร์ฟแล้ว"** ด้านบน เพื่อเคลียร์ตั๋วที่เสร็จแล้วออกจากหน้าจอ

### 3.4 ระบบเสียงพูดแจ้งเตือนอัจฉริยะ (Multilingual Voice Announcements)
หน้าจอครัวมาพร้อมระบบสังเคราะห์เสียงพูด (Speech Synthesis TTS) ที่ส่งเสียงแจ้งเตือนอัตโนมัติตามสถานะ:
- 📢 **มีออเดอร์ใหม่**: พูดแจ้งเตือน *"มีออเดอร์ใหม่จากหน้าร้านค่ะ"*
- 🍳 **เริ่มทำ**: พูดแจ้งเตือน *"กำลังปรุงอาหารอยู่ค่ะ"*
- 🔔 **พร้อมเสิร์ฟ**: พูดแจ้งเตือน *"พร้อมเสิร์ฟแล้วค่ะ"*
- 🍽️ **เสิร์ฟแล้ว**: พูดแจ้งเตือน *"เสิร์ฟอาหารแล้วค่ะ"*
- 🌐 **รองรับ 9 ภาษาตามโหมดที่เลือก**: เสียงพูดจะเปลี่ยนภาษาตามภาษาที่เลือกใช้งานของระบบโดยอัตโนมัติ (ไทย, อังกฤษ, จีน, ญี่ปุ่น, เกาหลี, รัสเซีย, เยอรมัน, ฝรั่งเศส, พม่า)

---

## 4. ผังโต๊ะอาหารและการจัดการโซน (Floor Plan & Table Management)

เข้าสู่เมนู **"ผังโต๊ะ (Tables)"**

### 4.1 ตรวจสอบสถานะโต๊ะแบบ Real-time
- 🟢 **สีเขียว (ว่าง)**: โต๊ะว่างพร้อมรับลูกค้าใหม่
- 🔴 **สีแดง (มีลูกค้า)**: มีลูกค้านั่งอยู่ พร้อมแสดง **ยอดเงินที่สั่งไปแล้ว** และเวลาที่เปิดโต๊ะ

### 4.2 โซน V.I.P. (ห้องส่วนตัว / Private Room)
- **ผังโต๊ะโซนพิเศษ V.I.P.**: รองรับการจัดเลี้ยง, ประชุม, คาราโอเกะ หรือครอบครัวใหญ่ที่นั่งได้หลายคน
- **แอดมินและเจ้าของร้านกำหนดค่าได้อิสระ**:
  - กำหนดชื่อห้อง VIP (เช่น ห้อง VIP 1 (ห้องเพชร), ห้อง VIP 2 (ห้องทอง))
  - กำหนดจำนวนที่นั่งสูงสุด (เช่น 8-16 ที่นั่ง)
  - กำหนดค่าบริการห้องพิเศษ (Room Surcharge / Service Fee)
- **ป้ายกำกับ VIP Badge สีทอง & ดีไซน์ Responsive สวยงาม**:
  - หัวข้อโซนแสดงสัญลักษณ์มงกุฎสีทอง `👑 โซน V.I.P. (ห้องส่วนตัว)` และป้าย `👑 ห้องส่วนตัว (Private VIP Room)` จัดวางเรียบหรูเป็นระเบียบ ไม่แตกบรรทัด รองรับทั้งหน้าจอมือถือ แท็บเล็ต และคอมพิวเตอร์อย่างสมบูรณ์แบบ
  - แสดงป้ายสถานะหรูหราทั้งในหน้าผังโต๊ะของร้านและหน้าสั่งอาหารของลูกค้า (QR Menu)

### 4.3 การเปิดโต๊ะและสร้าง QR สั่งอาหาร
1. แตะที่โต๊ะที่ว่าง
2. กด **"ยืนยันเปิดโต๊ะ"**
3. ระบบจะเปิดรอบบิล และสร้าง **QR Code ประจำโต๊ะ** สำหรับให้ลูกค้านำมือถือมาสแกนสั่งอาหาร

### 4.4 ผังโต๊ะสัมพันธ์กับรายการอาหาร และระบบชำระเงินอัตโนมัติ
1. **ดึงรายการอาหารอัตโนมัติ**: เมื่อแตะเลือกโต๊ะที่มีลูกค้า ระบบจะดึงรายการอาหารที่สั่งไปแล้วทั้งหมดของโต๊ะนั้นขึ้นมาแสดงผลทันทีแบบ Real-Time
2. **แสดงสถานะอาหารชัดเจน**: ระบุสถานะอาหารแต่ละจาน (กำลังปรุง, พร้อมเสิร์ฟ, เสิร์ฟแล้ว)
3. **ปุ่มชำระเงินอัตโนมัติ**: เมื่ออาหารทุกจานถูกเสิร์ฟครบแล้ว ระบบจะแสดงปุ่ม **"ชำระเงิน"** ขึ้นมาให้อัตโนมัติทันที
4. **รับชำระเงินและเสียงพูดขอบคุณ**:
   - เลือกช่องทางชำระเงิน (เงินสด, PromptPay QR, บัตรเครดิต) และกดยืนยันรับเงิน
   - ระบบจะส่งเสียงพูดขอบคุณลูกค้า: *"ขอบคุณที่ใช้บริการค่ะ โอกาสหน้าเชิญใหม่นะคะ"* ตามโหมดภาษาที่เลือก
   - กดยืนยันปิดโต๊ะเพื่อรีเซ็ตสถานะเป็นโต๊ะว่างรับลูกค้าชุดถัดไป

---

## 5. ระบบลูกค้าสั่งอาหารผ่าน QR (Mobile QR Customer Ordering App)

ลูกค้าสามารถสั่งอาหารผ่านสมาร์ตโฟนได้ครบ 3 รูปแบบอย่างสมบูรณ์แบบ ทั้งสแกน QR บนโต๊ะ หรือเปิดลิงก์สั่งออนไลน์:

### 5.1 รองรับ 3 โหมดการสั่งอาหาร (3 Order Modes)
1. 🍽️ **ทานที่ร้าน (Dine-in)**:
   - **สแกน QR ประจำโต๊ะ**: ระบบจะจับคู่โต๊ะอาหารอัตโนมัติ สั่งอาหารได้ทันที
   - **เปิดเมนูทั่วไป**: ลูกค้าสามารถเลือกหมายเลขโต๊ะที่ตนนั่งอยู่ได้จากแถบเลือกโต๊ะด้านบน หรือในหน้ายืนยันสั่งซื้อ
2. 🛍️ **สั่งกลับบ้าน (Takeaway)**:
   - ลูกค้าเลือกเมนู ระบุชื่อ เบอร์โทร และเวลามารับอาหาร เพื่อให้ร้านจัดเตรียมไว้ล่วงหน้า
3. 🛵 **จัดส่งถึงบ้าน (Delivery)**:
   - ลูกค้าระบุชื่อ เบอร์โทรติดต่อ และที่อยู่สำหรับจัดส่งอาหารอย่างละเอียด

### 5.2 ขั้นตอนการสั่งอาหารของลูกค้า
1. ลูกค้าเลือกดูเมนูตามหมวดหมู่ หรือพิมพ์ค้นหาเมนูที่ต้องการ
2. แตะปุ่ม **+** เพื่อเพิ่มอาหารลงตะกร้า
3. แตะแถบ **"ดูรายการสั่งซื้อ"** ด้านล่างสุด:
   - ตรวจสอบจำนวนและพิมพ์ข้อความพิเศษในช่องหมายเหตุ (เช่น หวานน้อย, ไม่ใส่กระเทียม)
   - ใช้สิทธิ์ส่วนลดสมาชิก หรือใส่รหัสคูปองส่วนลด
4. กดปุ่ม **"ส่งเข้าห้องครัวทันที"**
5. ออเดอร์จะวิ่งตรงเข้าสู่ **หน้าจอครัว (KDS)** และ **แดชบอร์ด** ทันที พร้อมแสดงสถานะให้ลูกค้าติดตามได้สดๆ

---

## 6. การจัดการเมนูอาหาร, หมวดหมู่ และการตั้งค่าแสดงผล (Menu & Inventory Management)

เข้าสู่เมนู **"เมนูอาหาร (Products)"** (`/products.php`) (เฉพาะสิทธิ์ Admin)

### 6.1 การเพิ่มและแก้ไขเมนูอาหาร
1. กดปุ่ม **"+ เพิ่มเมนูใหม่"** หรือกดไอคอนดินสอบนเมนูที่ต้องการแก้ไข
2. กรอกรายละเอียด:
   - ชื่อเมนูอาหาร (เช่น ข้าวกะเพราหมูกรอบ, ชาเย็น)
   - หมวดหมู่อาหาร (อาหารจานหลัก, เครื่องดื่ม, ของหวาน ฯลฯ)
   - ราคาขาย (บาท) และ ต้นทุน (บาท)
   - เวลาที่ใช้ปรุงโดยประมาณ (นาที)
   - ลำดับการแสดงผล (Sort Order - ตัวเลขน้อยจะแสดงก่อน)
   - อัปโหลดรูปภาพอาหาร
3. กด **"บันทึกเมนู"**

### 6.2 การเปิด/ปิดการแสดงผล (สวิตช์เปิดขาย / ปิดขาย)
- ในตารางรายการอาหาร แอดมินสามารถ **กดสวิตช์ (Toggle Switch)** ในคอลัมน์ "เปิด/ปิดขาย" ได้ทันที:
  - 🟢 **เปิดขาย**: แสดงเมนูในหน้า POS และหน้าสั่งอาหารของลูกค้า (QR Menu)
  - 🔴 **ปิดขาย (ซ่อน)**: ซ่อนเมนูนั้นจากหน้าสั่งของลูกค้าทันที เช่น กรณีวัตถุดิบหมด หรือไม่พร้อมขาย
- ระบบจะอัปเดตแบบ Real-time ทันทีโดยไม่ต้องโหลดหน้าเว็บใหม่

### 6.3 การจัดการหมวดหมู่และการเรียงลำดับ (Category Manager)
- กดปุ่ม **"จัดการหมวดหมู่"** ด้านบน เพื่อ:
  - เพิ่มหมวดหมู่อาหารใหม่
  - แก้ไขชื่อหมวดหมู่
  - ปรับลำดับการแสดงผล (Sort Order) เพื่อให้หมวดที่ต้องการแสดงก่อน
  - สลับเปิด/ปิดการแสดงผลทั้งหมวดหมู่

### 6.4 ปุ่มล้างรายการซ้ำอัตโนมัติ (Deduplicate & Clean up)
- หากพบปัญหาเมนูอาหารหรือหมวดหมู่ซ้ำกันในระบบ สามารถกดปุ่ม **"🧹 ล้างรายการซ้ำ"**
- ระบบจะรวมและลบรายการที่ชื่อซ้ำกันให้เหลือเพียง 1 รายการโดยอัตโนมัติ พร้อมอัปเดตประวัติการสั่งซื้อและสูตรอาหารให้อย่างปลอดภัย 100%

### 6.5 คลังรูปภาพอาหารสำเร็จรูป (Preset Food Images Gallery 189 รายการ)
ระบบ PosStar มาพร้อมกับคลังรูปภาพอาหารสำเร็จรูปความคมชัดสูงระดับ 600px กว่า 189 รายการ ครอบคลุม 27-29 หมวดหมู่อาหารไทยยอดนิยม:
1. **การเปิดใช้งานในหน้าเพิ่ม/แก้ไขเมนู**:
   - เมื่อกด **"เพิ่มเมนูใหม่"** หรือ **"แก้ไขเมนู"** ในหน้าสินค้า (`/products.php`)
   - บริเวณส่วนเลือกรูปภาพ จะมีปุ่ม **"🖼️ เลือกรูปสำเร็จรูป"**
   - เมื่อกดปุ่ม ระบบจะเปิดกล่องโมดอลคลังรูปภาพพร้อมช่องค้นหาด่วน (Live Search) และตัวกรองหมวดหมู่
2. **หมวดหมู่อาหารที่มีรูปสำเร็จรูปพร้อมใช้**:
   - 🍲 **ข้าวต้ม** (ข้าวต้มหมู, ข้าวต้มกุ้ง, ข้าวต้มปลากะพง)
   - 🍚 **ข้าวผัด** (ข้าวผัดหมู, ข้าวผัดไก่, ข้าวผัดกุ้ง, ข้าวผัดปู, ข้าวผัดแหนม, ข้าวผัดโบราณ)
   - 🥗 **ยำ / ส้มตำ / ลาบ** (ยำวุ้นเส้นทะเล, ยำมาม่ารวมมิตร, ลาบหมู, ส้มตำไทย)
   - 🐟 **ผัดคึ่นช่าย** (ผัดคึ่นช่ายปลากะพง)
   - 🍳 **ผัดไข่เค็ม** (ปลาหมึกผัดไข่เค็ม)
   - 🍗 **เมนูทอด / ทานเล่น** (หมูสามชั้นทอดน้ำปลา, ไก่ทอด, หมูทอดกระเทียม)
   - 🌿 **ผัดผักไฟแดง** (ผัดผักบุ้งไฟแดง, ผัดแขนงหมูกรอบ)
   - 🌶️ **ผัดพริกเผา** (หอยลายผัดน้ำพริกเผา, กะเพรา, ผัดขี้เมา, ผัดฉ่า)
   - 🥣 **ต้มยำ / ต้มจืด / แกง** (ต้มยำกุ้งน้ำข้น, แกงจืดเต้าหู้หมูสับ)
3. **เลือกใช้ง่ายในคลิกเดียว**: เพียงคลิกที่รูปภาพที่ต้องการ ระบบจะนำ URL รูปภาพความละเอียดสูงใส่ลงในช่องรูปภาพของเมนูทันที โดยไม่ต้องเสียเวลาถ่ายรูปหรืออัปโหลดเอง

### 6.6 ปุ่มอัปเดตเมนู Demo (186 รายการ / 29 หมวดหมู่)
สำหรับร้านค้าที่เริ่มต้นใช้งาน หรือต้องการตัวอย่างเมนูอาหารที่สมบูรณ์แบบครบวงจร:
- ที่มุมบนขวาของหน้าจัดการเมนู มีปุ่มสีเขียว **"อัปเดตเมนู Demo (189 รายการ)"**
- เมื่อกดปุ่ม ระบบจะทำการซิงก์และสร้าง 29 หมวดหมู่อาหารมาตรฐาน พร้อมนำเข้ารายการอาหาร Demo รวม 186 รายการ ที่มีทั้งชื่ออาหารภาษาไทย, ราคาขาย, ต้นทุนวัตถุดิบโดยประมาณ, คำอธิบายเมนูชวนทาน และเชื่อมโยงรูปภาพ 600px สวยงามครบทุกเมนูโดยอัตโนมัติ 100%

---

## 7. รายงานยอดขายและวิเคราะห์การเงิน (Sales Reports & Analytics)

เข้าสู่เมนู **"รายงาน (Reports)"**

### 7.1 ตัวกรองช่วงเวลา (Date Filter)
- กำหนดวันที่เริ่มต้น และวันที่สิ้นสุด แล้วกดปุ่ม **"กรองข้อมูล"** (เช่น วันนี้, 7 วันล่าสุด, เดือนนี้)

### 7.2 ตัวชี้วัดสำคัญ (Key Financial Metrics)
- **ยอดขายรวมสุทธิ (Net Revenue)**: รายได้รวมทั้งหมดหลังหักส่วนลด
- **จำนวนบิลทั้งหมด (Total Orders)**: จำนวนคำสั่งซื้อที่ชำระเงินสำเร็จ
- **ยอดเฉลี่ยต่อบิล (AOV)**: ยอดการใช้จ่ายเฉลี่ยของลูกค้าต่อโต๊ะ
- **ส่วนลด / VAT / Service Charge**: สรุปยอดภาษีและค่าบริการแยกตามหมวดหมู่

### 7.3 กราฟวิเคราะห์และอันดับยอดนิยม
- 📊 **กราฟแท่งแนวโน้มยอดขายรายวัน**: ดูจังหวะวันที่ขายดีที่สุด
- 🥧 **Doughnut Chart ช่องทางรับเงิน**: เปอร์เซ็นต์เปรียบเทียบระหว่าง เงินสด, PromptPay, บัตรเครดิต, และเงินโอน
- 🏆 **10 เมนูขายดีที่สุด (Top Sellers)**: วิเคราะห์เมนูทำเงินสูงสุด
- 👥 **ประสิทธิภาพพนักงาน**: สรุปยอดขายตามรายชื่อพนักงานแคชเชียร์
- 🖨️ กดปุ่ม **"พิมพ์รายงาน"** เพื่อพิมพ์รายงานสรุปยอดขายประจำวัน (Z-Report)

### 7.4 รายการบิลคำสั่งซื้อ และการลบบิลเดี่ยว (Sales Orders Table & Order Deletion)
- ในหน้า **"รายงาน (Reports)"** เลื่อนลงมาด้านล่างสุด จะพบตาราง **"รายการบิลคำสั่งซื้อ (Sales Orders & Invoices)"**:
  1. **แสดงรายการบิลละเอียด**: แสดงเลขที่บิล (`#ID`), วัน-เวลา, ประเภท/โต๊ะ (🍽️ ทานที่ร้าน, 🥡 สั่งกลับบ้าน, 🛵 เดลิเวอรี), รายการสินค้าที่สั่ง, พนักงานผู้ดูแล, สถานะการชำระเงิน, และยอดสุทธิ (฿)
  2. **ช่องค้นหาด่วน (Live Search)**: พิมพ์ค้นหาเลขที่บิล, โต๊ะ หรือชื่อสินค้าเพื่อกรองดูบิลที่ต้องการได้ทันทีแบบเรียลไทม์
  3. **ปุ่มดูใบเสร็จย้อนหลัง (`fas fa-receipt`)**: กดเพื่อเปิดดูรายละเอียดบิลใบเสร็จเต็มรูปแบบ และสั่งพิมพ์ซ้ำได้ทันที
  4. **ปุ่มถังขยะสีแดง ลบรายการบิล (`fas fa-trash-alt`)**:
     - สิทธิ์ Admin และผู้จัดการร้านค้า สามารถกดปุ่มถังขยะสีแดงเพื่อลบรายการบิลเดี่ยว (เช่น บิลทดสอบระบบ หรือบิลที่เปิดผิดพลาด)
     - มีหน้าต่างแจ้งเตือนยืนยันความปลอดภัย พร้อมแสดงเลขที่บิลและยอดเงิน เพื่อป้องกันการกดลบพลาด
     - เมื่อยืนยัน ระบบจะลบออเดอร์ รายการอาหาร ประวัติการชำระเงิน และคำนวณยอดขายรวม กราฟ และงบกำไรขาดทุนใหม่ให้ทันทีโดยอัตโนมัติ

---

## 8. ระบบบัญชีร้านค้าดึงยอดอัตโนมัติ (Store Accounting Ledger)

เข้าสู่เมนู **"ระบบบัญชี (Accounting)"** (`/accounting.php`) เหมาะสำหรับเจ้าของร้านและฝ่ายบัญชีใช้ตรวจสอบกระแสเงินสดและผลกำไรขาดทุนแบบ Real-Time

### 8.1 การดึงยอดรายรับอัตโนมัติ (Auto-Pull Income)
- **เชื่อมต่อบิลขาย Real-Time**: ทุกออเดอร์ที่ชำระเงินสำเร็จ (ทั้ง POS หน้าร้าน, โต๊ะอาหาร, กลับบ้าน, QR Code, เดลิเวอรี่) จะถูกดึงเข้ามาบันทึกเป็นรายรับให้อัตโนมัติทันที
- **ระบุช่องทางชำระเงิน**: เงินสด, พร้อมเพย์, โอนธนาคาร, บัตรเครดิต, คริปโต (USDT)
- **ตัดยอดออเดอร์ยกเลิกอัตโนมัติ**: หากออเดอร์ถูกยกเลิกหรือคืนเงิน ระบบจะลบรายการออกจากบัญชีให้อัตโนมัติทันที

### 8.2 การดึงยอดรายจ่ายอัตโนมัติ (Auto-Pull Expenses)
- **ค่าสั่งซื้อ/เติมสต็อกวัตถุดิบ**: เมื่อบันทึกการเติมสต็อกในหน้าคลังสินค้า (`/inventory.php`) ยอดรวม (จำนวน × ราคาต้นทุน) จะถูกส่งเข้าสมุดบัญชีรายจ่ายให้อัตโนมัติ พร้อมลิงก์เปิดดูคลังสินค้า
- **เงินเดือนพนักงาน**: เมื่องวดเงินเดือนในระบบ (`/staff.php`) ถูกกดยืนยันจ่ายเรียบร้อย ยอดสุทธิจะถูกบันทึกเข้าสมุดบัญชีรายจ่ายทันที
- **บันทึกรายจ่ายอื่นๆ**: สามารถกดปุ่ม **"บันทึกรายจ่าย (-)"** เพื่อบันทึกค่าเช่าร้าน ค่าน้ำ-ค่าไฟ ค่าแก๊ส ค่าการตลาด พร้อมแนบรูปภาพสลิปใบเสร็จ

### 8.3 ปุ่มดึงยอดล่าสุด และการดูบิลใบเสร็จ
- 🔄 **ปุ่ม "ดึงยอดล่าสุด (Sync)"**: กดเพื่อสแกนยอดขาย ค่าสต็อก และเงินเดือนล่าสุดเข้าสู่บัญชีแบบทันที
- 🧾 **ปุ่มดูบิลใบเสร็จ**: ในแต่ละแถวของออเดอร์ สามารถกดปุ่ม **"ใบเสร็จ"** เพื่อเปิดดูรายการอาหาร ยอดรวม ส่วนลด VAT และสั่งพิมพ์ใบเสร็จความร้อนซ้ำได้
- 🔍 **ตัวกรองที่มารายการ (Source Filter)**: กรองดูเฉพาะ ยอดขาย POS, ซื้อวัตถุดิบ, เงินเดือน หรือรายการที่บันทึกเอง
- 📊 **สรุปผลกำไรขาดทุน (P&L Summary)**: คำนวณรายรับรวม, รายจ่ายรวม, กำไรสุทธิ และอัตรากำไร (%) แบบเรียลไทม์ พร้อมพิมพ์รายงานบัญชี

### 8.4 ปุ่มถังขยะ ลบรายการบัญชี (Transaction Deletion by Admin / Store Owner)
- ในตารางรายการบัญชี (`/accounting.php`) ที่คอลัมน์ **"จัดการ"** มีไอคอน **ถังขยะสีแดง (`fas fa-trash-alt`)** ในทุกแถวรายการ:
  1. **สิทธิ์การลบ**: เฉพาะผู้ดูแลระบบ (Admin / Super Admin) และเจ้าของร้าน (Vendor Admin) เท่านั้นที่สามารถลบได้
  2. **ครอบคลุมทุกประเภทรายการ**:
     - 📝 **รายการที่บันทึกเอง (Manual Entry)**: ลบรายการรายรับ/รายจ่ายที่คีย์เอง พร้อมลบรูปภาพสลิปที่แนบไว้อัตโนมัติ
     - 🛒 **รายการจากออเดอร์ POS (POS Orders)**: มีกล่องยืนยันความปลอดภัย สามารถเลือกลบรายการเพื่อเคลียร์ยอดขาย หรือลบบิลออเดอร์ออกจากระบบ
     - 📦 **รายการจากการซื้อวัตถุดิบ (Restock)**: ลบรายการรายจ่ายค่าวัตถุดิบออกจากสมุดบัญชี
     - 💼 **รายการจากเงินเดือน (Payroll)**: ลบรายการรายจ่ายเงินเดือนออกจากสมุดบัญชี
  3. **คำนวณสรุปกำไรขาดทุนใหม่ทันที**: เมื่อกดยืนยันลบสำเร็จ ระบบจะคำนวณยอดรายรับรวม รายจ่ายรวม และกำไรสุทธิในหน้ารายงานบัญชีใหม่ให้อัตโนมัติทันที


---

## 9. การตั้งค่าร้านค้าและระบบรับเงิน (Store Settings & PromptPay)

เข้าสู่เมนู **"ตั้งค่า (Settings)"**

### 9.1 ข้อมูลร้านค้าและใบเสร็จ
- ตั้งชื่อร้านค้า, ที่อยู่, เบอร์โทรศัพท์ติดต่อ, และข้อความท้ายใบเสร็จ (Receipt Footer)
- อัปโหลด **โลโก้ร้านค้า** เพื่อให้พิมพ์บนหัวใบเสร็จและหน้าสั่งอาหาร

### 9.2 ตั้งค่าระบบรับเงิน PromptPay QR
- กรอก **หมายเลขพร้อมเพย์ (PromptPay ID)**: เบอร์โทรศัพท์มือถือ หรือ เลขประจำตัวผู้เสียภาษี 13 หลัก
- เลือกระเภทบัญชี (เบอร์โทร / เลขนิติบุคคล)
- เมื่อตั้งค่าเสร็จ ระบบจะสร้าง QR Code พร้อมเพย์ตามมาตรฐาน EMVCo ธนาคารแห่งประเทศไทยโดยอัตโนมัติ

### 9.3 ตั้งค่าภาษีมูลค่าเพิ่มและค่าบริการ
- กำหนด **VAT (%)**: เช่น 7% หรือ 0%
- กำหนด **Service Charge (%)**: เช่น 10% หรือ 0%

### 9.4 การตั้งค่าระบบแจ้งเตือนผ่าน Telegram Bot & cron-job.org (ฟรี)
ระบบ PosStar รองรับการส่งสรุปยอดขายรายวันและแจ้งเตือนสต็อกวัตถุดิบใกล้หมดเข้า Telegram อัตโนมัติ:
1. **ตั้งค่า Telegram Bot**:
   - ไปที่ **ตั้งค่าร้านค้า ➡️ การแจ้งเตือน (Notifications)**
   - กรอก **Telegram Bot Token** (สร้างจาก @BotFather ในแอป Telegram)
   - กรอก **Telegram Chat ID** (ดูจาก @userinfobot หรือทักคุยกับบอทแล้วกด "ดึง Chat ID อัตโนมัติ")
   - กดปุ่ม **"ทดสอบส่งเข้า Telegram ตอนนี้"** เพื่อทดสอบว่าระบบเชื่อมต่อและส่งข้อความสำเร็จ
2. **ตั้งค่าเวลาทำงานอัตโนมัติฟรีด้วย cron-job.org**:
   - เข้าเว็บไซต์ https://console.cron-job.org (สมัครและใช้งานฟรี)
   - กดปุ่ม **"CREATE CRONJOB"**
   - **Title**: ตั้งชื่อ เช่น `PosStar Daily EOD Report`
   - **URL**: คัดลอก URL Webhook จากหน้าตั้งค่าระบบ (เช่น `https://posstar.siampr.com/api/cron_eod.php?token=...`)
   - **Schedule**: กำหนดเวลาที่ต้องการให้ส่งรายงาน เช่น ทุกวัน เวลา 22:00 น. (`0 22 * * *`)
   - กด **"CREATE"** ระบบจะส่งสรุปยอดขายเข้า Telegram ของคุณทุกคืนโดยอัตโนมัติ 100%

### 9.5 ระบบบันทึกความปลอดภัยและการตรวจสอบ (Security Audit Logs)
ระบบ PosStar มีระบบ Audit Log ตรวจจับและบันทึกทุกกิจกรรมด้านความปลอดภัยของร้านค้าแบบ Real-time:
1. **การเข้าถึงบันทึกความปลอดภัย**:
   - ไปที่ **ตั้งค่าร้านค้า (Settings)** ➔ เลือกแท็บ **"ความปลอดภัย (Security)"** (`#tabSecurity`)
   - สิทธิ์การเข้าดูและจัดการ: **Superadmin**, **Admin** และ **เจ้าของร้านค้า (Vendor Admin / Store Owner)**
2. **สิ่งที่ระบบบันทึก**:
   - ประวัติการเข้าสู่ระบบสำเร็จ / ล้มเหลว (Login Success / Failed)
   - การเปลี่ยนแปลงรหัสผ่านผู้ใช้งาน
   - การเปิด/ปิดสิทธิ์การใช้งาน และการตั้งค่าระบบที่สำคัญ
   - หมายเลข IP Address, Browser User-Agent, และวัน-เวลาที่เกิดเหตุการณ์
3. **การลบประวัติความปลอดภัย (Trash-Can Deletion & Clear All)**:
   - 🗑️ **ปุ่มไอคอนถังขยะรายแถว (`fas fa-trash-can`)**: ในตารางบันทึกความปลอดภัย มีคอลัมน์ "ลบ" พร้อมปุ่มสีแดง แอดมินและเจ้าของร้านสามารถกดเพื่อลบประวัติเฉพาะแถวที่ต้องการได้ โดยมีหน้าต่างยืนยันความปลอดภัย และแถวจะเฟดออกทันที
   - 🧹 **ปุ่ม "ล้างประวัติทั้งหมด"**: ปุ่มสีแดงบริเวณส่วนหัวการ์ด สำหรับล้างประวัติการบันทึกทั้งหมดในคลิกเดียวเมื่อต้องการรีเซ็ตประวัติ

### 9.6 ระบบรับชำระเงินข้ามพรมแดน Alipay (支付宝) และ WeChat Pay (微信支付)
เพื่อรองรับลูกค้านักท่องเที่ยวชาวจีนและชาวต่างชาติ ระบบรองรับการตั้งค่ารับเงินผ่าน QR Code ของ Alipay และ WeChat Pay:
1. **การตั้งค่าในหน้า Settings (แท็บการเงิน/Payment)**:
   - กรอก **ชื่อร้านค้า / Merchant Name** ของ Alipay และ WeChat Pay
   - กรอก **หมายเลขบัญชี / Merchant ID**
   - อัปโหลด **รูปภาพ QR Code รับเงิน** ของ Alipay และ WeChat Pay
2. **ระบบอัตราแลกเปลี่ยน CNY / THB แบบเรียลไทม์**:
   - ระบบมีปุ่ม **"ดึงอัตราแลกเปลี่ยน CNY/THB ล่าสุด"** เชื่อมต่อ API ธนาคารเพื่อคำนวณอัตราแลกเปลี่ยนบาทต่อหยวนที่แม่นยำ
   - ที่หน้าชำระเงิน POS และ QR สั่งอาหาร ลูกค้าชาวจีนสามารถเลือกชำระผ่าน Alipay หรือ WeChat Pay ระบบจะคำนวณยอดเงินเป็นสกุลหยวน (¥ CNY) พร้อมแสดง QR ให้สแกนจ่ายได้ทันที

---

## 10. ระบบสมาชิก, บัตรสมาชิกดิจิทัล และสะสมแต้ม (CRM & Loyalty System)

ระบบ PosStar มาพร้อมกับระบบสมาชิกระดับพรีเมียม (Customer Relationship Management - CRM) ช่วยกระตุ้นยอดขาย สะสมแต้ม แลกส่วนลดเงินสด และสร้างความภักดีต่อแบรนด์:

### 10.1 ระดับสมาชิก (Membership Tiers) และสิทธิประโยชน์
ระบบแบ่งระดับสมาชิกออกเป็น 2 ระดับหลัก:
1. 👤 **สมาชิกทั่วไป (General Member)**:
   - สมัครฟรี ไม่จำกัดอายุการใช้งาน
   - ได้รับส่วนลดทันที **5%** (หรือตามที่ร้านตั้งค่าไว้) ทุกครั้งที่สั่งอาหาร
   - สะสมแต้มอัตโนมัติ: ทุก **100 บาท = 1 แต้ม** (Points)
2. 👑 **สมาชิก VIP (VIP Member - Annual Plan)**:
   - อายุสมาชิก **1 ปี (365 วัน)** นับจากวันที่เปิดใช้งานหรือต่ออายุ
   - ได้รับส่วนลดพิเศษระดับ VIP (เช่น 10% - 15% ตามที่ร้านกำหนด)
   - ป้ายบัตรสัญลักษณ์มงกุฎสีทอง `VIP Member 👑` แสดงโดดเด่นทั้งในระบบ, หน้าบัตรเสมือนจริง และบนสลิปใบเสร็จ
   - **ระบบแจ้งเตือนวันหมดอายุ**: ระบบจะแสดงวันหมดอายุชัดเจน หากใกล้หมดอายุ (ภายใน 30 วัน) จะมีป้ายเตือนสีส้ม และหากหมดอายุแล้วจะมีป้ายเตือนสีแดง `(VIP หมดอายุ)` เพื่อให้เจ้าหน้าที่หรือลูกค้ากดต่ออายุได้ทันที

### 10.2 การใช้งานระบบสมาชิกที่หน้าจอขาย POS (`/pos.php`)
1. **การค้นหาและสมาชิกลงบิล**:
   - แคชเชียร์แตะที่แถบ **"👑 สมาชิก (ค้นหา/สมัคร)"** ในหน้าคิดเงิน
   - กรอกเบอร์โทรศัพท์ของลูกค้าเพื่อค้นหา หรือสแกน QR Code จากบัตรสมาชิกดิจิทัลของลูกค้า
   - เมื่อเลือกสมาชิก: ระบบจะแสดงชื่อ, เบอร์โทร, ระดับสมาชิก (VIP/ทั่วไป), แต้มสะสมคงเหลือ และส่วนลดอัตโนมัติ
2. **ระบบแลกแต้มเป็นส่วนลดเงินสด (Point Redemption)**:
   - **อัตราแลกแต้ม**: **1 แต้ม = 1 บาท**
   - แคชเชียร์สามารถกรอกจำนวนแต้มที่ลูกค้าต้องการใช้แลก หรือกดปุ่ม **"ใช้หมด"** เพื่อแลกแต้มสะสมทั้งหมดเป็นส่วนลดเงินสด
   - แต้มส่วนลดจะถูกหักออกจากยอดรวมบิลทันที และระบบจะตัดแต้มสะสมของลูกค้าในฐานข้อมูลโดยอัตโนมัติเมื่อชำระเงินเสร็จสิ้น
3. **การสมัครสมาชิกด่วนหน้าร้าน**:
   - หากยังไม่เป็นสมาชิก สามารถพิมพ์ชื่อและเบอร์โทรในแถบสมาชิกหน้าร้าน แล้วกดยืนยันเพื่อเปิดสมาชิกและรับส่วนลดได้ทันที

### 10.3 บิลใบเสร็จรับเงินสำหรับสมาชิก (Enhanced Member Receipts)
สลิปใบเสร็จรับเงินความร้อน (Thermal Slip 58mm / 80mm) ทั้งที่เคาน์เตอร์ POS และบิลรวมโต๊ะอาหาร จะแสดงข้อมูลสมาชิกอย่างละเอียด สวยงาม และชัดเจน:
- **กล่องข้อมูลสมาชิก (Member Details Box)**:
  - 👑 **ระดับสมาชิก**: แสดงสถานะ `VIP Member 👑` หรือ `Member (ทั่วไป)` พร้อมเบอร์โทรและชื่อสมาชิก
  - 🏷️ **ส่วนลดที่ได้รับ**: แสดงแจกแจงแยกชัดเจนระหว่าง *ส่วนลดสินค้า/สมาชิก* และ *แลกแต้มส่วนลด (X แต้ม) -฿...*
  - 🌟 **แต้มที่ได้รับจากบิลนี้ (Earned Points)**: คำนวณแต้มที่ได้รับใหม่จากยอดชำระสุทธิ (+1 แต้ม / 100 บาท)
  - 💰 **แต้มสะสมคงเหลือ (Remaining Points)**: แสดงแต้มสะสมล่าสุดที่สามารถใช้ในครั้งถัดไป
  - 🎟️ **คูปองสะสมคงเหลือ (Coupons Balance)**: แสดงจำนวนคูปองเงินสดและมูลค่ารวมที่ยังใช้งานได้ (เช่น *2 ใบ (฿100)*)
  - ⏳ **วันหมดอายุ VIP**: แสดงวันที่หมดอายุของบัตร VIP เพื่อกระตุ้นให้ลูกค้ามาใช้บริการและต่ออายุ

### 10.4 หน้าจัดการสมาชิกหลังบ้าน (`/members.php`)
เจ้าของร้านและผู้จัดการสามารถบริหารจัดการฐานข้อมูลสมาชิกได้อย่างมีประสิทธิภาพ:
1. **แท็บกรองสถานะด่วน (Quick Filter Tabs)**:
   - `ทั้งหมด`: ดูสมาชิกทั้งหมดในระบบ
   - `VIP`: ดูเฉพาะสมาชิก VIP ที่ยังไม่หมดอายุ
   - `ทั่วไป`: ดูสมาชิกประเภทฟรีตลอดชีพ
   - `ใกล้หมดอายุ`: แสดงสมาชิก VIP ที่เหลืออายุไม่เกิน 30 วัน เพื่อติดต่อเสนอโปรโมชั่นต่ออายุ
   - `หมดอายุแล้ว`: แสดงสมาชิก VIP ที่หมดอายุแล้ว เพื่อติดตามการต่ออายุ
2. **การต่ออายุสมาชิก VIP (One-Click VIP Renewal)**:
   - กดปุ่ม **"ต่ออายุ VIP (+1 ปี)"** ที่การ์ดสมาชิก ระบบจะบวกอายุสมาชิกเพิ่ม 365 วันให้อัตโนมัติทันที
3. **การส่งออกข้อมูล (Export to CSV / Excel)**:
   - กดปุ่ม **"📥 ส่งออก Excel (CSV)"** เพื่อดาวน์โหลดรายชื่อสมาชิก, เบอร์โทร, ประเภท, แต้มสะสม, ยอดใช้จ่ายรวม และวันหมดอายุ ไปใช้งานใน Excel ได้ทันทีโดยไม่เจอปัญหาภาษาไทยเป็นภาษาต่างดาว (รองรับ UTF-8 with BOM)
4. **การแสดงผล 2 คอลัมน์บนมือถือและแท็บเล็ต**:
   - ออกแบบการ์ดสมาชิกให้จัดวาง 2 คอลัมน์บนแท็บเล็ตและมือถือแนวนอน เพิ่มความสวยงามและใช้งานง่าย

### 10.5 บัตรสมาชิกดิจิทัลและ QR Code (Digital Membership Card)
- สมาชิกแต่ละคนจะมี **บัตรสมาชิกดิจิทัลเสมือนจริง (Virtual Glassmorphism Member Card)**:
  - แสดงชื่อร้าน, โลโก้, ป้าย VIP สีทองอร่าม, ชื่อสมาชิก, เบอร์โทร, แต้มสะสม, และวันหมดอายุ
  - มี **QR Code ส่วนบุคคล**: ลูกค้าสามารถเปิดหน้าบัตรบนมือถือเพื่อให้แคชเชียร์หน้าร้านสแกน หรือพิมพ์เป็นบัตรแข็งพกพาได้
  - ปุ่ม **"🖨️ พิมพ์บัตร"**: รองรับการสั่งพิมพ์บัตรสมาชิกลงกระดาษหรือเครื่องพิมพ์การ์ด

### 10.6 ระบบชวนเพื่อนรับคูปองส่วนลด 5% (Referral & Reward Coupons)
ระบบชวนเพื่อนช่วยขยายฐานลูกค้าแบบ Viral Marketing:
1. **การชวนเพื่อนของสมาชิก**:
   - สมาชิกเปิดเมนูบนมือถือ ➡️ กดปุ่มสีชมพู **"🎁 ชวนเพื่อนรับ 5%"**
   - ระบบจะสร้าง **ลิงก์ชวนเพื่อนเฉพาะบุคคล** และปุ่ม **"แชร์เข้า LINE"** / **"แชร์ Facebook"** / **"คัดลอกลิงก์"**
2. **เมื่อเพื่อนเปิดลิงก์และสั่งอาหาร**:
   - หน้าจอของเพื่อนจะแสดงข้อความต้อนรับ **"🎉 คุณได้รับคำชวนจากเพื่อน! สมัครสมาชิกรับส่วนลด 5% ทันที"**
   - เมื่อเพื่อนสั่งอาหาร และ **ชำระเงินเรียบร้อยแล้ว**
3. **การแจกคูปองรางวัลอัตโนมัติ**:
   - ระบบจะสร้าง **คูปองส่วนลด 5% จากยอดที่เพื่อนจ่ายจริง** ให้กับผู้ชวนโดยอัตโนมัติ (เช่น เพื่อนจ่าย 1,000 บาท ผู้ชวนได้รับคูปอง 50 บาท)
   - คูปองจะถูกส่งเข้าไปใน **"กระเป๋าคูปองของฉัน (My Coupons)"** บนมือถือของผู้ชวนทันที
   - ผู้ชวนสามารถกด **"ใช้คูปอง"** เพื่อหักลดค่าอาหารในมื้อถัดไปได้ทันที!
4. **การตั้งค่าสำหรับแอดมิน**:
   - แอดมินสามารถกำหนด % รางวัลคูปอง (ค่าเริ่มต้น 5%), เปิด/ปิดระบบชวนเพื่อน, และกำหนดอายุวันหมดอายุของคูปอง (เช่น 30 วัน) ได้ที่เมนู **ตั้งค่า ➡️ ระบบสมาชิก & ส่วนลด**

---

## 11. การใช้งานบนแท็บเล็ตและมือถือ (Mobile & Tablet Experience)

ระบบได้รับการออกแบบให้ใช้งานผ่านอุปกรณ์พกพาได้อย่างสมบูรณ์แบบ:

1. **แถบเมนูลัดด้านล่าง (Bottom Navigation)**: มีปุ่มกดลัด 5 ปุ่มสำคัญ สลับหน้าได้ด้วยนิ้วโป้งเดียว
2. **หน้าขายบนมือถือ (Mobile POS Drawer)**: ตะกร้าสินค้าจะแสดงเป็นแถบลอยด้านล่าง แตะเพื่อเปิดแผงคิดเงินขึ้นมาได้อย่างสะดวก
3. **การติดตั้งเป็นแอปบนหน้าจอ (PWA / Add to Home Screen)**:
   - บน **iPhone / iPad (Safari)**: กดปุ่ม Share (แชร์) ➡️ เลือก *"เพิ่มไปยังหน้าจอโฮม (Add to Home Screen)"*
   - บน **Android (Chrome)**: กดปุ่ม 3 จุดมุมขวาบน ➡️ เลือก *"ติดตั้งแอป (Install App)"*

---

## 12. ระบบ 2 ภาษา ไทย - อังกฤษ (Bilingual Thai / English System)

ระบบ PosStar รองรับการทำงาน 2 ภาษา (ภาษาไทย และ ภาษาอังกฤษ) อย่างสมบูรณ์แบบ 100% ทั้งในส่วนของลูกค้า (Frontend) และระบบจัดการร้านค้า/POS (Backend):

### 12.1 การสลับภาษาสำหรับผู้ใช้งาน (Language Switcher)
- **บนแถบเมนูด้านบน (Top Bar)**: ทั้งในระบบ POS, หน้าจอครัว, หน้าจัดการต่างๆ และหน้าสั่งอาหารลูกค้า จะมีปุ่มสลับภาษา `🇹🇭 TH` / `🇬🇧 EN`
- เมื่อผู้ใช้แตะปุ่มสลับภาษา ระบบจะเปลี่ยนภาษาของหน้าจอ, ข้อความแจ้งเตือน, ปุ่มคำสั่ง, สถานะบิล และส่วนประกอบทั้งหมดทันที
- ระบบจะจดจำภาษาที่ผู้ใช้เลือกไว้ใน Session และเครื่องของผู้ใช้

### 12.2 การตั้งค่าภาษาเริ่มต้นของระบบสำหรับแอดมิน (Default System Language)
แอดมินสามารถกำหนดได้ว่าเมื่อลูกค้าหรือพนักงานเปิดระบบขึ้นมาครั้งแรก จะให้แสดงผลเป็นภาษาใดเป็นค่าเริ่มต้น:
1. เข้าสู่เมนู **"ตั้งค่าร้านค้า (Settings)" (`/settings.php`)**
2. ในแท็บ **"ข้อมูลร้าน (Store Info)"** ดูที่หัวข้อ **"ภาษาเริ่มต้นของระบบ (Default System Language)"**
3. เลือกภาษาที่ต้องการ:
   - 🇹🇭 **ภาษาไทย (Thai)** (ค่าเริ่มต้น)
   - 🇬🇧 **English (อังกฤษ)**
4. กด **"บันทึก (Save Changes)"** ➡️ ระบบจะใช้ภาษานี้เป็นภาษาเริ่มต้นของทั้งร้านค้าทันที

---

## 13. ระบบจัดการพนักงานและสิทธิ์ผู้ใช้งาน (Staff & User Management)

เข้าสู่เมนู **"จัดการพนักงาน (Staff)" (`/staff.php`)** (เฉพาะสิทธิ์ผู้ดูแลระบบ Admin):

### 13.1 การเพิ่มพนักงานใหม่ (Add New Staff)
1. กดปุ่มสีแดง **"+ เพิ่มพนักงานใหม่"** ที่มุมขวาบน
2. กรอกข้อมูลพนักงาน:
   - **ชื่อ - นามสกุล**: เช่น สมชาย ใจดี
   - **ชื่อผู้ใช้ (Username)**: สำหรับใช้ล็อกอิน เช่น `somchai`, `cashier1`
   - **รหัสผ่าน (Password)**: รหัสผ่านเข้าใช้งานระบบ
   - **สิทธิ์ / ตำแหน่ง (Role)**:
     - 👑 **Admin (ผู้ดูแลระบบ)**: เข้าถึงได้ทุกฟังก์ชัน ทั้งตั้งค่าร้าน รายงาน พนักงาน และการขาย
     - 👤 **Staff (พนักงานทั่วไป)**: สำหรับแคชเชียร์, พนักงานบริการ, พนักงานครัว
   - **รหัส PIN ด่วน (Quick PIN)**: เช่น 4 หลัก สำหรับสลับกะหรือปลดล็อกระบบ
   - **สถานะ**: เปิดใช้งาน (Active) / ระงับใช้งาน (Inactive)
3. กด **"บันทึกข้อมูล"** ➡️ พนักงานสามารถใช้ Username และ Password นี้เข้าสู่ระบบได้ทันที

### 13.2 การแก้ไขข้อมูลพนักงาน (Edit Staff)
- แตะปุ่มสีเหลือง **"แก้ไข"** ที่รายการพนักงาน
- สามารถแก้ไขชื่อ, ตำแหน่ง, PIN, หรือตั้งรหัสผ่านใหม่ (หากไม่ต้องการเปลี่ยนรหัสผ่าน ให้เว้นว่างไว้)

### 13.3 การลบพนักงานออกจากระบบ (Delete Staff)
- แตะปุ่มสีแดง **"ลบ"** ที่รายการพนักงานที่ต้องการลบ
- ระบบจะมีหน้าต่างแจ้งเตือนยืนยันความปลอดภัย
- *ระบบมีระบบป้องกันความปลอดภัย*: ไม่สามารถลบบัญชีที่กำลังล็อกอินอยู่ได้ และไม่อนุญาตให้ลบจนไม่เหลือผู้ดูแลระบบ (Admin)

---

## 14. ระบบความปลอดภัยของเว็บไซต์และข้อมูล (Enterprise Security & Protection)

ระบบ PosStar ได้รับการออกแบบโครงสร้างความปลอดภัยระดับมาตรฐานสากล เพื่อปกป้องข้อมูลยอดขาย รหัสผ่าน และความลับของร้านค้า:

### 14.1 มาตรการรักษาความปลอดภัยของระบบ
1. 🛡️ **HTTP Security Headers & Anti-Sniffing**: ป้องกันการถูกฝังโค้ดขโมยข้อมูล (Clickjacking), บล็อก MIME Type Exploits, ป้องกัน Cross-Site Scripting (XSS)
2. 🔒 **ระบบล็อกคุกกี้และความปลอดภัย Session (Session Hardening)**: บังคับใช้ `HttpOnly` และ `SameSite=Lax` เพื่อป้องกันไม่ให้สคริปต์ภายนอกเข้าถึง Session ของระบบได้ พร้อมระบบสุ่ม Session ID ใหม่ทุกครั้งที่เข้าสู่ระบบ (Anti-Session Fixation)
3. 🛑 **ระบบป้องกันการสุ่มเดารหัสผ่าน (Brute-Force Rate Limiting)**: หากมีการพยายามเข้าสู่ระบบผิดพลาดเกิน 5 ครั้ง ระบบจะระงับการเข้าสู่ระบบของ IP นั้นชั่วคราวเป็นเวลา 15 นาที เพื่อป้องกันบอทหรือแฮกเกอร์สุ่มรหัสผ่าน
4. 🔐 **ระบบป้องกันคำขอปลอมแปลง (CSRF Protection)**: ทุกฟอร์มมีการเข้ารหัส Security Token ตรวจสอบความถูกต้องก่อนบันทึกข้อมูล
5. 🖼️ **เกราะป้องกันโฟลเดอร์ไฟล์อัปโหลด (Upload Sandbox Protection)**:
   - ปิดการทำงานของสคริปต์ PHP/CGI ในโฟลเดอร์รูปภาพ `uploads/` 100%
   - ตรวจสอบไส้ในไฟล์ภาพจริง (MIME Magic Bytes Inspection) ป้องกันการนำไฟล์ไวรัส/สคริปต์มาเปลี่ยนนามสกุลเพื่ออัปโหลด
6. 🚫 **การบล็อกไฟล์ระบบสำคัญ (Sensitive File Shield)**: บล็อกการเข้าถึงไฟล์ `.env`, `config.php`, `init_db.php`, `*.sql`, `*.log`, `*.md` จากภายนอกโดยตรง

---

---

## 15. ระบบเดลิเวอรี่ครบวงจร (Complete Food Delivery System)

ระบบ PosStar รองรับการขายแบบจัดส่ง (Delivery) อย่างสมบูรณ์แบบ ทั้งการจัดส่งโดยตรงจากทางร้าน และการเชื่อมต่อกับแอพพลิเคชันส่งอาหารยอดนิยมในประเทศไทย:

### 15.1 การสั่งเดลิเวอรี่สำหรับลูกค้าผ่านหน้าเว็บ / QR Code (`/qr_menu.php`)
เมื่อลูกค้าเลือกโหมด **"🛵 จัดส่ง (Delivery)"**:
1. **จัดส่งโดยทางร้าน (Direct Store Delivery)**:
   - ลูกค้าสามารถเลือกเมนูอาหารลงตะกร้า
   - กรอก **ชื่อผู้รับ, เบอร์โทรศัพท์, ที่อยู่จัดส่งอย่างละเอียด**
   - มีปุ่ม **"📍 ปักหมุด GPS ปัจจุบัน"** ช่วยดึงพิกัด Google Maps แนบไปกับออเดอร์โดยอัตโนมัติ
   - ระบบคำนวณ **ค่าจัดส่งเริ่มต้น** (เช่น ฿30) และมีระบบ **"ฟรีค่าจัดส่งเมื่อสั่งครบยอดที่กำหนด"** (เช่น ครบ ฿500 ส่งฟรี)
2. **สั่งผ่านแอพเดลิเวอรี่ชั้นนำ (Delivery Apps Hub)**:
   - มีปุ่มทางลัดกดเปิดหน้าร้านบนแอพเดลิเวอรี่ชั้นนำได้ทันที 1 คลิก:
     - 🟢 **LINE MAN**
     - 🟢 **GrabFood**
     - 🔴 **foodpanda**
     - 🟠 **ShopeeFood**
     - 🟣 **Robinhood**

### 15.2 การรับออเดอร์เดลิเวอรี่หน้าร้าน POS (`/pos.php`)
- แคชเชียร์สามารถกดเลือกโหมด **"🛵 เดลิเวอรี"** ที่หน้าขาย
- เลือกช่องทางจัดส่ง: `ร้านจัดส่งเอง`, `LINE MAN`, `GrabFood`, `foodpanda`, `ShopeeFood`, `Robinhood`
- กรอกรหัสอ้างอิงออเดอร์แอพ (Platform Order Ref) เช่น `LM-1234`, `GF-5678` เพื่อให้ตรงกับบิลของไรเดอร์

### 15.3 การจัดการในห้องครัว (Kitchen KDS Display) (`/kitchen.php`)
- ตั๋วอาหารเดลิเวอรี่จะแสดงสัญลักษณ์ช่องทางจัดส่งอย่างเด่นชัด (🟢 LINE MAN, 🟢 GrabFood, 🔴 foodpanda, 🛵 ร้านส่งเอง)
- แสดงชื่อลูกค้า เบอร์โทร และที่อยู่จัดส่ง เพื่อให้ครัวจัดเตรียมบรรจุภัณฑ์และส่งมอบให้ไรเดอร์ได้อย่างถูกต้องแม่นยำ

### 15.4 การตั้งค่าระบบเดลิเวอรี่สำหรับแอดมิน (`/settings.php`)
เข้าสู่เมนู **"ตั้งค่า ➡️ ระบบเดลิเวอรี่ (Delivery)"**:
- **การจัดส่งของร้าน**: เปิด/ปิดบริการ, กำหนดค่าส่งเริ่มต้น (บาท), ยอดสั่งซื้อขั้นต่ำเพื่อส่งฟรี (บาท), เบอร์โทรฝ่ายจัดส่ง, และเวลาจัดส่งโดยประมาณ
- **ลิงก์แอพเดลิเวอรี่**: ใส่ URL หน้าร้านบน LINE MAN, GrabFood, foodpanda, ShopeeFood, Robinhood

### 15.5 รายงานยอดขายแยกตามช่องทางจัดส่ง (`/reports.php`)
- หน้าสรุปรายงานมียอดขายและจำนวนบิลแยกตามช่องทาง: `ทานที่ร้าน`, `สั่งกลับบ้าน`, `LINE MAN`, `GrabFood`, `foodpanda`, `ShopeeFood`, `Robinhood`, `ร้านจัดส่งเอง`

---

---

## 16. ระบบชำระเงินหลายช่องทาง (Multi-Channel Payment Gateway)

ระบบ PosStar รองรับการชำระเงินที่หลากหลาย ทั้งเงินสด, พร้อมเพย์, บัญชีธนาคารไทย, บัตรเครดิตสากลผ่าน Stripe, และคริปโตเคอเรนซี USDT บนเครือข่าย BSC:

### 16.1 การตั้งค่าระบบชำระเงินสำหรับผู้ดูแลระบบ (`/settings.php ➡️ ระบบชำระเงิน`)
1. 📱 **พร้อมเพย์ (PromptPay QR)**:
   - ระบุเบอร์โทรศัพท์มือถือ (10 หลัก) หรือเลขประจำตัวผู้เสียภาษี (13 หลัก)
   - ระบบจะแปลงยอดเงินในบิลและสร้าง QR Code พร้อมเพย์แบบเรียลไทม์
2. 🏦 **บัญชีธนาคาร (Bank Transfer & Bank QR)**:
   - เลือกธนาคาร (เช่น กสิกรไทย KBANK, ไทยพาณิชย์ SCB, กรุงเทพ BBL, กรุงไทย KTB, กรุงศรี BAY, ทหารไทยธนชาต TTB ฯลฯ)
   - กรอก **ชื่อบัญชี, เลขที่บัญชี, และสาขา**
   - อัปโหลด **รูปภาพ QR Code หน้าสมุดบัญชีธนาคาร** สำหรับแสดงให้ลูกค้าสแกน
3. 💳 **บัตรเครดิต/เดบิต ผ่าน Stripe (Stripe Gateway)**:
   - เปิด/ปิดบริการรับชำระผ่าน Stripe
   - กรอก `Stripe Publishable Key` (เช่น `pk_live_...` หรือ `pk_test_...`)
   - กรอก `Stripe Secret Key` (เช่น `sk_live_...` หรือ `sk_test_...`)
   - เลือกสกุลเงินที่เรียกเก็บ (THB หรือ USD)
4. 🪙 **คริปโตเคอเรนซี USDT (Network: BSC / BEP-20 - Binance Smart Chain)**:
   - เปิด/ปิดบริการรับชำระด้วย USDT (BSC)
   - ระบุกระเป๋ารับเงิน `BEP-20 Wallet Address` (เช่น `0x...` รองรับ Bitkub, Binance, MetaMask, Trust Wallet)
   - กำหนดอัตราแลกเปลี่ยน (เช่น 1 USDT = 35.50 บาท) ระบบจะแปลงยอดเงินในบิลเป็น USDT อัตโนมัติ

### 16.2 หน้าชำระเงินสำหรับลูกค้า (`/qr_menu.php`)
เมื่อลูกค้ากด **"ชำระเงิน"**:
- เลือกระหว่างแท็บ **พร้อมเพย์ (PromptPay)**, **โอนธนาคาร (Bank Transfer)**, **บัตรเครดิต (Stripe)**, และ **USDT (BSC)**
- มีปุ่ม **"📋 คัดลอกเลขบัญชี"** และ **"📋 คัดลอก Wallet Address"** เพื่อความสะดวกรวดเร็ว
- ชำระด้วยบัตรเครดิตผ่านฟอร์มมาตรฐานความปลอดภัยสากล PCI-DSS ของ Stripe
- ชำระด้วย USDT สามารถกรอก **Transaction Hash (TXID)** เพื่อบันทึกการโอนเงินลงในระบบได้ทันที

### 16.3 การรับชำระเงินหน้าร้าน POS (`/pos.php`)
- มีแท็บเลือกวิธีชำระเงิน: `💵 เงินสด`, `📱 พร้อมเพย์`, `🏦 โอนธนาคาร`, `💳 บัตร/Stripe`, และ `🪙 USDT (BSC)`
- ระบบจะแสดง QR Code ข้อมูลบัญชี และยอดที่ต้องชำระตามช่องทางที่เลือก พร้อมปุ่มยืนยันรับเงินและพิมพ์ใบเสร็จทันที

---

## 17. ระบบมัลติเวนเดอร์ & ศูนย์อาหารครบวงจร (Multi-Vendor Marketplace & Food Court)

ระบบ PosStar รองรับการบริหารจัดการศูนย์อาหาร (Food Court), ตลาดนัด, คอมมูนิตี้มอลล์ และแพลตฟอร์มรวมร้านค้าที่มีหลายร้านค้า (Vendors / Stalls) ขายร่วมกันในระบบเดียว พร้อมระบบโมเดลธุรกิจให้เช่าแพลตฟอร์มรายงวดแบบ SaaS:

### 17.1 สถาปัตยกรรมระบบ Multi-Vendor (Architecture Diagram)

```mermaid
flowchart TD
    subgraph SuperAdminPlatform["👑 แพลตฟอร์มหลัก & Super Admin (ศูนย์กลาง)"]
        SA_Dashboard["📊 ควบคุมทั้งระบบ & ดูรายงานรวมทุกร้าน"]
        SA_Vendors["🏬 จัดการร้านค้า & บูธ (Booth Zones)"]
        SA_SubPlans["💳 ระบบจัดการค่าเช่าร้านค้า (1ด/3ด/6ด/1ปี)"]
        SA_Payouts["💰 ระบบ Settlement & จ่ายเงินร้านค้า (Payouts)"]
    end

    subgraph VendorA["🏪 ร้านค้าย่อย A (เช่น ร้านอาหารตามสั่ง - บูธ A1)"]
        VA_Admin["🔐 Vendor A Admin (หลังบ้านร้าน A)"]
        VA_Products["🍱 จัดการเมนู & ราคาเฉพาะร้าน A"]
        VA_Stock["📦 สต็อก & วัตถุดิบเฉพาะร้าน A"]
        VA_KDS["🍳 หน้าจอครัว KDS เฉพาะร้าน A"]
        VA_Reports["📈 รายงานยอดขาย & ยอดรอรับเงินของร้าน A"]
    end

    subgraph VendorB["☕ ร้านค้าย่อย B (เช่น ร้านเครื่องดื่ม & คาเฟ่ - บูธ B2)"]
        VB_Admin["🔐 Vendor B Admin (หลังบ้านร้าน B)"]
        VB_Products["🥤 จัดการเมนู & ราคาเฉพาะร้าน B"]
        VB_Stock["📦 สต็อก & วัตถุดิบเฉพาะร้าน B"]
        VB_KDS["🍳 หน้าจอครัว KDS เฉพาะร้าน B"]
        VB_Reports["📈 รายงานยอดขาย & ยอดรอรับเงินของร้าน B"]
    end

    subgraph CustomerApp["📱 ลูกค้าสแกนสั่งอาหาร (QR Menu & Tracking)"]
        Cust_Picker["🏬 เลือกร้านค้า / โซนบูธ (Store Selector)"]
        Cust_Cart["🛒 ตะกร้าสินค้า & สั่งอาหาร"]
        Cust_Payment["💳 ชำระเงิน (PromptPay / ธนาคาร / บัตร / USDT)"]
        Cust_Tracking["📍 ติดตามสถานะอาหารแยกรายร้าน (Per-Vendor Live Tracking)"]
    end

    %% Relations
    SA_Vendors -->|สร้าง/จัดการร้าน & กำหนด GP| VendorA
    SA_Vendors -->|สร้าง/จัดการร้าน & กำหนด GP| VendorB
    SA_SubPlans -->|เก็บค่าเช่า 120/350/650/1200 บ.| VendorA
    SA_SubPlans -->|เก็บค่าเช่า 120/350/650/1200 บ.| VendorB
    SA_Payouts -->|โอนเงินยอดสุทธิหลังหัก GP| VendorA
    SA_Payouts -->|โอนเงินยอดสุทธิหลังหัก GP| VendorB

    Cust_Picker -->|เลือกสั่งอาหาร| VendorA
    Cust_Picker -->|เลือกสั่งอาหาร| VendorB
    Cust_Payment -->|สร้าง Order & Item แยก Vendor ID| SA_Payouts
    Cust_Payment -->|ส่งตั๋วอาหารตรงไปยัง| VA_KDS
    Cust_Payment -->|ส่งตั๋วเครื่องดื่มตรงไปยัง| VB_KDS

    VA_KDS -->|อัปเดตสถานะ: กำลังปรุง/พร้อมเสิร์ฟ| Cust_Tracking
    VB_KDS -->|อัปเดตสถานะ: กำลังชง/พร้อมเสิร์ฟ| Cust_Tracking
```

### 17.2 สิทธิ์การใช้งาน 3 ระดับ (Role Hierarchy)
1. 👑 **เจ้าของแพลตฟอร์ม / ผู้บริหารศูนย์อาหาร (Superadmin)**:
   - เพิ่ม, แก้ไข, ระงับ, และลบร้านค้าในระบบ
   - จัดการจัดเก็บค่าเช่าระบบร้านค้าย่อย (SaaS Rental Subscriptions)
   - กำหนดอัตราส่วนแบ่งค่า GP แพลตฟอร์ม (%) แยกตามแต่ละร้านค้าได้อิสระ
   - ดูรายงานภาพรวมยอดขายทุกร้านค้า และคำนวณเงินค้างจ่าย
   - บันทึกการโอนเงิน/จ่ายยอดขายสุทธิให้ร้านค้า พร้อมแนบหลักฐานสลิปโอนเงิน
2. 🏬 **เจ้าของร้านค้าย่อย (Vendor Admin)**:
   - เข้าสู่ระบบหลังบ้านเฉพาะร้านของตนเอง
   - จัดการรายการเมนูอาหาร, หมวดหมู่, และราคาเฉพาะร้านตนเอง
   - จัดการวัตถุดิบและสต็อกสินค้าของร้านตนเอง (`ingredients` & `stock_movements` แยกอิสระ)
   - ดูหน้าจอครัว (KDS) เฉพาะตั๋วอาหารของร้านตัวเองแบบเรียลไทม์
   - ดูรายงานยอดขายสุทธิ อัตราส่วนแบ่ง GP และยอดเงินคงเหลือที่รอรับจากแพลตฟอร์ม
   - บันทึกข้อมูลบัญชีธนาคารหรือ PromptPay สำหรับรับเงิน
   - ดูสถานะแพ็กเกจค่าเช่าร้านและวันหมดอายุ
3. 👨‍🍳 **พนักงานครัวประจำร้าน (Vendor Kitchen Staff)**:
   - ดูหน้าจอครัว KDS เฉพาะร้านที่ตนเองสังกัด พร้อมเสียงแจ้งเตือนเฉพาะร้าน

### 17.3 ระบบแพ็กเกจค่าเช่าร้านค้าย่อย (SaaS Rental Subscription Plans)
แพลตฟอร์มทำหน้าที่เป็นตัวกลาง โดยมีอัตราค่าบริการเช่าระบบดังนี้:
- 📅 **ราย 1 เดือน**: **฿120**
- 📅 **ราย 3 เดือน**: **฿350** (ประหยัด ~116 บ./ด.)
- 📅 **ราย 6 เดือน**: **฿650** (ประหยัด ~108 บ./ด.)
- 📅 **ราย 1 ปี (12 เดือน)**: **฿1,200** (สุดคุ้ม เพียง 100 บ./ด.)

**การบริหารจัดการค่าเช่า (`/vendors.php ➡️ 💳 จัดการค่าเช่า/ต่ออายุ`)**:
- Superadmin เลือกแพ็กเกจที่ร้านค้าชำระเงิน
- ระบบจะคำนวณวันหมดอายุถัดไปให้อัตโนมัติ (`subscription_expires_at`)
- บันทึกช่องทางชำระเงิน, เลขที่อ้างอิง, และอัปโหลดสลิปหลักฐาน
- หากร้านค้าหมดอายุค่าเช่า ระบบจะปรับสถานะเป็น `Suspended` หรือ `Expired` เพื่อรอการต่ออายุ

### 17.4 การเพิ่มและจัดการร้านค้า (`/vendors.php`)
1. เข้าสู่เมนู **"ร้านค้า (Vendors)"**
2. กดปุ่ม **"➕ เพิ่มร้านค้าใหม่"**
3. กรอกข้อมูล:
   - **ชื่อร้านค้า (Store Name)** และคำอธิบาย
   - **โซนที่ตั้งบูธ (Booth Zone)**: เช่น โซน A-01, บูธ 14
   - **อัตราค่าส่วนแบ่ง GP (%)**: เช่น 15%, 20%, 25% หรือ 0%
   - **แพ็กเกจค่าเช่าเริ่มต้น**: เลือก 1 เดือน, 3 เดือน, 6 เดือน หรือ 1 ปี
   - **ข้อมูลติดต่อ**: เบอร์โทรศัพท์ และอีเมล
   - **ข้อมูลบัญชีรับเงิน**: ธนาคาร, เลขที่บัญชี, ชื่อบัญชี, หรือพร้อมเพย์
   - **บัญชีผู้ดูแลร้าน (Vendor Admin Account)**: กำหนด Username และ Password สำหรับให้เจ้าของร้านล็อกอินจัดการ
4. อัปโหลดโลโก้ร้าน แล้วกดยืนยัน

### 17.5 การแยกตะกร้าและระบบติดตามสถานะอาหารแยกตามร้าน (Per-Vendor Order Tracking)
- **แถบเลือกร้านค้า (Food Stalls Directory)**: ลูกค้าเลือกดูเมนูอาหารแยกตามร้านค้าบูธได้สะดวก
- **การ์ดอาหารแสดงป้ายร้านค้า**: ระบุชื่อร้านและโซนบูธชัดเจน
- **Per-Vendor Live Order Tracker (`/qr_menu.php`)**: ในหน้ารายการสั่งอาหารของลูกค้า จะแสดงสถานะการปรุงของแต่ละร้านแยกกันชัดเจนแบบเรียลไทม์:
  - 🔔 *ร้านเครื่องดื่ม (โซน B-02): พร้อมเสิร์ฟแล้ว*
  - 🍳 *ร้านอาหารตามสั่ง (โซน A-01): กำลังปรุงอาหาร*
  - ⏳ *ร้านของหวาน (โซน C-05): ได้รับออเดอร์แล้ว*

### 17.6 สรุปยอดขายร้านค้า 100%, คูปองชวนเพื่อน และการเบิกจ่ายค่าคอมมิสชั่นเงินสด (`/vendor_payouts.php`)
- **การรับเงินยอดขายของร้านค้า (100% Direct Store Revenue)**:
  - เมื่อลูกค้าชำระเงินค่าอาหาร (เงินสด หรือสแกน QR PromptPay เข้าบัญชีร้านค้า) **เจ้าของร้านจะรับเงินเข้ากระเป๋าตัวเองโดยตรงเต็มจำนวน 100%** (เมื่ออัตรา GP = 0.0%)
- **ระบบคูปองชวนเพื่อนมาทานอาหาร (Food Referral Coupons)**:
  - เมื่อลูกค้าชวนเพื่อนมาทานอาหารและเพื่อนชำระเงิน ผู้แนะนำจะได้รับ **คูปองส่วนลด 5%** (หรือตาม % ที่ร้านกำหนด) จากยอดบิลของเพื่อน
  - ลูกค้าสามารถกดเปิดดูกระเป๋าคูปองในมือถือ และนำมาใช้เป็นส่วนลดทานอาหารที่ร้านได้ทันที
- **ระบบแนะนำเพื่อนเช่าระบบ PosStar รับคอมมิสชั่นเงินสด 5% (SaaS Affiliate Payouts)**:
  - สมาชิก/ร้านค้าที่แนะนำร้านอื่นมาเช่าซื้อระบบ PosStar จะได้รับ **ค่าคอมมิสชั่น 5% เป็นเงินสด**
  - เมื่อสะสมยอดเงินสดครบ **฿300 บาท** สามารถกดขอถอนเงินสดเข้าบัญชีธนาคารหรือพร้อมเพย์ได้ที่หน้า `/affiliates.php`
  - แอดมินสามารถตรวจสอบคำขอ อนุมัติการโอนเงินสด และแนบรูปสลิปหลักฐานได้ที่หน้า `/vendor_payouts.php`

---

## 18. การแก้ปัญหาเบื้องต้นและคำถามที่พบบ่อย (Troubleshooting & FAQ)

### ❓ คำถาม: หน้าจอครัว (KDS) ไม่ส่งเสียงแจ้งเตือนทำอย่างไร?
- **ตอบ**: ให้แตะที่ใดก็ได้บนหน้าจอ 1 ครั้งเพื่อเปิดสิทธิ์ Web Audio ของบราวเซอร์ หรือตรวจสอบว่าไอคอนรูปลำโพงด้านบนเปิดอยู่หรือไม่

### ❓ คำถาม: ลูกค้าสแกน QR Code แล้วไม่ขึ้นเมนูอาหาร?
- **ตอบ**: ตรวจสอบว่าพนักงานได้กด **"เปิดโต๊ะ"** ในหน้าผังโต๊ะแล้วหรือยัง หากยังไม่ได้เปิดโต๊ะให้แตะเปิดโต๊ะก่อน ลูกค้าจึงจะสั่งอาหารได้

### ❓ คำถาม: ต้องการพิมพ์ใบเสร็จซ้ำ (Re-print Receipt)?
- **ตอบ**: ไปที่หน้า **ผังโต๊ะ** แตะที่โต๊ะที่ต้องการ แล้วกดปุ่ม **"พิมพ์ใบเสร็จ / บิลตรวจสอบ"** หรือไปที่หน้า **แดชบอร์ด** เลือกเลขที่บิลล่าสุด

---

## 19. การเคลียร์ยอดทั้งหมดก่อนเปิดใช้งานจริง (Factory Reset Data Before Launch)

ระบบมีฟังก์ชันพิเศษสำหรับผู้ดูแลระบบสูงสุด (Superadmin / Admin) ในการ **"เคลียร์ยอดทั้งหมด"** เพื่อล้างข้อมูลการทดสอบระบบก่อนเปิดรับลูกค้าจริง:

### 19.1 ตำแหน่งของปุ่มเคลียร์ยอด
สามารถเข้าใช้งานได้จาก 2 หน้าจอหลัก:
1. **หน้ารายงานยอดขาย (`/reports.php`)**: มองที่แถบเครื่องมือด้านบนขวา จะมีปุ่มสีแดง **"🗑️ เคลียร์ยอดทั้งหมด"**
2. **หน้าตั้งค่าระบบ (`/settings.php ➡️ แท็บ Audit Logs & IP`)**: เลื่อนลงมาด้านล่างสุดในกล่อง **"พื้นที่ควบคุมพิเศษ: ล้างข้อมูลธุรกรรมก่อนเปิดร้านจริง (Factory Reset Data)"**

### 19.2 ระบบความปลอดภัยป้องกันการกดพลาด 3 ชั้น
เพื่อป้องกันการสูญหายของข้อมูลโดยไม่ตั้งใจ ระบบจะบังคับยืนยัน 3 ขั้นตอน:
1. **พิมพ์คำยืนยัน**: พิมพ์คำว่า `CLEAR-ALL` ให้ถูกต้องตรงทุกตัวอักษร
2. **กรอกรหัสผ่านแอดมิน**: ใส่รหัสผ่านบัญชีผู้ดูแลระบบของคุณเพื่อยืนยันสิทธิ์
3. **รหัสยืนยัน 2FA Google Authenticator**: หากบัญชีของคุณเปิดใช้ 2FA ไว้ จะต้องกรอกรหัส 6 หลักจากแอปในโทรศัพท์ด้วย

### 19.3 สิ่งที่ถูกล้าง และสิ่งที่ปลอดภัย
- 🗑️ **สิ่งที่ถูกล้างเป็นศูนย์**: บิลออเดอร์, ยอดขายทั้งหมด, ประวัติการชำระเงิน, สถานะการเปิดโต๊ะ (รีเซ็ตโต๊ะเป็นว่าง), บัญชีรายรับ-รายจ่าย, เงินเดือนพนักงาน, แต้มสะสม/ยอดซื้อสมาชิก, ลิ้นชักเงินทอน, กะพนักงาน, คิว และข้อความแชต
- 🛡️ **ข้อมูลที่ปลอดภัย 100% (ไม่สูญหาย)**: รายการเมนูอาหาร, รูปภาพ, ราคา, สูตรอาหาร, รายการวัตถุดิบในสต็อก, ผังโต๊ะ, ข้อมูลร้านค้า/บูธ, บัญชีผู้ใช้งาน/พนักงาน และการตั้งค่าระบบ

---

## 20. ศูนย์แชตสดร้านค้า, ห้องแจ้งปัญหาการใช้งาน & โหมดมือถือ (Live Chat & Support Hub)

เข้าสู่เมนู **"แชตร้านค้า (Live Chat)"** (`/chat.php`) หรือแตะที่ไอคอนกล่องข้อความ 💬 บนแถบด้านบน (Topbar):

### 20.1 การสื่อสารแบบ Real-Time ระหว่างลูกค้ากับร้านค้า และพนักงาน
- **แชตประจำโต๊ะ (Table Chat)**: ลูกค้าที่สแกน QR Menu สามารถแชตสอบถาม สั่งอาหารเพิ่ม หรือขอความช่วยเหลือจากโต๊ะอาหารได้ทันที ข้อความจะเด้งแจ้งเตือนหน้าร้านพร้อมเสียงกริ่ง
- **ห้องรวมพนักงาน (Staff Channels)**:
  - 🍳 **ห้องครัว (Kitchen)**: สื่อสารระหว่างแคชเชียร์และพ่อครัว
  - 🛎️ **พนักงานเสิร์ฟ (Waiters)**: สื่อสารการส่งอาหารและการบริการ
  - 🛵 **ไรเดอร์เดลิเวอรี (Delivery)**: ประสานงานการจัดส่งอาหาร

### 20.2 ห้อง "🛠️ แจ้งปัญหาการใช้งาน (Support Room)"
- เพิ่มห้องแชตกลางพิเศษสำหรับรับแจ้งและแก้ไขปัญหาการใช้งานระบบ POS และอุปกรณ์ภายในร้าน:
  - 🖨️ เครื่องพิมพ์ใบเสร็จมีปัญหา / ไม่พิมพ์ใบเสร็จ
  - 💵 ลิ้นชักเก็บเงินไม่เด้งเปิดอัตโนมัติ
  - 📶 สัญญาณอินเทอร์เน็ตขัดข้อง / ระบบโหลดช้า
  - 📱 ลูกค้าสแกน QR Code ไม่ติด
- มาพร้อมชิปข้อความด่วน (Quick Action Chips) ให้พนักงานกดแจ้งปัญหา และแอดมินกดตอบรับเรื่องและแจ้งแก้ไขสำเร็จได้ในคลิกเดียว

### 20.3 การปรับแต่งสำหรับหน้าจอมือถือ (Mobile Responsive & Smooth Touch Scrolling)
- กล่องแชตคำนวณความสูงพอดีกับหน้าจอมือถือ ไม่ตกขอบจอ และไม่ถูกแถบเมนูล่างบดบัง
- ช่องพิมพ์ข้อความ ปุ่มแนบรูปภาพ ปุ่มส่งข้อความ และสติ๊กเกอร์ อยู่ในตำแหน่งที่กดพิมพ์ได้ง่าย 100%
- เลื่อนอ่านข้อความได้อย่างลื่นไหลด้วยระบบสัมผัส Smooth Touch Scroll และรองรับคีย์บอร์ดมือถืออัตโนมัติ

---

## 21. ระบบเปิดสาขาเพิ่ม & บริหารจัดการหลายสาขา (Branch Expansion & Multi-Branch Management)

สำหรับร้านค้าที่เติบโตและต้องการขยายสาขา ระบบ PosStar รองรับการเชื่อมโยงเครือข่ายร้านหลัก (Headquarters - HQ) และสาขาย่อย (Branches) อย่างสมบูรณ์แบบ:

### 21.1 แพ็กเกจเปิดสาขาเพิ่ม (ลด 50% สำหรับสมาชิกร้านหลัก 1 ปี)
- **สิทธิพิเศษสุดคุ้ม**: ร้านค้าที่สมัครแพ็กเกจสมาชิกแบบ **1 ปี (Enterprise Ultimate ฿1,200/ปี)** จะได้รับสิทธิ์เปิดสาขาเพิ่มในราคาเพียง **50% = ฿600 / สาขา / ปี** (จากราคาปกติ ฿1,200)
- **สิทธิ์การใช้งานเต็ม 1 ปี (12 เดือน)**: แต่ละสาขาที่เปิดจะได้รับอายุการใช้งานเต็ม 365 วัน (1 ปี) และปลดล็อกฟีเจอร์ครบทุกอย่างเช่นเดียวกับร้านหลัก

### 21.2 การสร้าง Username & Password แยกสำหรับผู้จัดการสาขา
- ในการเปิดสาขาใหม่ ไม่ว่าจะเป็นการเปิดผ่านหน้าเว็บไซต์ Landing Page หรือเปิดจากเมนู *ร้านค้าย่อย (Vendors)* ระบบจะให้เจ้าของร้านระบุ:
  1. **ชื่อสาขา (Store / Branch Name)**
  2. **เบอร์โทรศัพท์และข้อมูลผู้ติดต่อ**
  3. **ชื่อผู้ใช้ผู้ดูแลสาขา (Username)** เช่น `pos_branch2`
  4. **รหัสผ่านผู้ดูแลสาขา (Password)**
- บัญชีนี้จะถูกผูกเข้ากับสาขาย่อยนั้นโดยตรง เพื่อให้ผู้จัดการสาขาและพนักงานใช้ล็อกอินเข้าจัดการหน้าร้าน POS, จอครัว KDS, เมนูอาหาร, โต๊ะ และดูรายงานยอดขายเฉพาะของสาขาตนเองได้อย่างปลอดภัยและเป็นอิสระ

### 21.3 ระบบสลับร้านค้าทันที (Master Store Switcher)
- เจ้าของร้านหลัก (HQ Admin) ที่ดูแลหลายสาขา ไม่จำเป็นต้องออกจากระบบและล็อกอินใหม่:
  1. เข้าไปที่เมนู **"ร้านค้าย่อย (Vendors)"** (`/vendors.php`)
  2. ระบบจะแสดงรายการร้านหลักและสาขาย่อยทั้งหมด พร้อมป้ายระบุสถานะ **สาขาหลัก (HQ)** และ **สาขาย่อย (Branch)**
  3. กดปุ่ม **"🔄 สลับร้าน (Switch Store)"** ที่สาขาที่ต้องการ
  4. ระบบจะสลับ Context ของร้านค้า (`$_SESSION['vendor_id']`) ไปยังสาขานั้นทันที ทำให้เจ้าของร้านสามารถตรวจสอบสต็อก ยอดขาย หรือแก้ไขเมนูของแต่ละสาขาได้อย่างรวดเร็ว

---

**PosStar — ระบบบริหารจัดการร้านอาหาร, ศูนย์อาหาร และจุดขาย POS ยุคใหม่**
*ครบวงจร เรียลไทม์ Multi-Vendor 2 ภาษา สั่งง่าย รวดเร็ว ปลอดภัยระดับองค์กร และเพิ่มยอดขายอย่างยั่งยืน*

---
*เอกสารคู่มือการใช้งานระบบ PosStar POS เวอร์ชัน 2.5 Multi-Vendor (ปรับปรุงล่าสุด กันยายน 2026)*