# 📖 คู่มือการใช้งานระบบ CMTC Tech Solution Cloud (Tutorial Notepad)

คู่มือฉบับย่อนี้จัดทำขึ้นเพื่อให้เจ้าของโครงการ ร้านค้าสมาชิก และทีมงานสามารถทำความเข้าใจและเข้าใช้งานระบบบริหารจัดการร้านอาหาร Multi-Tenant ของ **CMTC Tech Solution Cloud** ได้อย่างเป็นขั้นตอนและง่ายที่สุดครับ

---

## 🔗 สรุปเส้นทางการเข้าใช้งานระบบ (URLs Matrix)

| กลุ่มผู้ใช้งาน | ลิงก์เข้าใช้งาน (URL) | วัตถุประสงค์ |
| :--- | :--- | :--- |
| **ลูกค้าทั่วไป / หน้าร้าน** | `menu.php` | ค้นหาร้านค้าทั้งหมดที่เปิดให้บริการในระบบ |
| **ลูกค้าหน้าร้านเฉพาะจุด** | `menu.php?shop_id=รหัสร้าน` | สั่งอาหารจากร้านนั้นๆ โดยตรง (เช่น สแกนจาก QR Code ประจำโต๊ะ) |
| **แอดมินระบบหลัก (Super Admin)** | `platform-admin.php` | ควบคุมระบบ ตรวจสอบยอด อนุมัติร้านค้าใหม่ และจัดการบัญชีทั้งหมด |
| **ผู้ดูแลร้านค้า (Shop Admin)** | `demo-admin.php` | จัดการข้อมูลร้าน เมนูอาหาร และกดยืนยันออเดอร์ในครัวของร้านตนเอง |
| **บอร์ดคิวสำหรับลูกค้า** | `status.php?shop_id=รหัสร้าน` | แสดงสถานะคิวรับอาหารให้ลูกค้าเห็นแบบ Real-time |
| **หน้าจอทีวีเรียกคิวพร้อมเสียง**| `queue-tv.php?shop_id=รหัสร้าน` | จอทีวีประกาศเรียกคิวเปิดในร้านอาหาร มีเสียงพูดอัตโนมัติ |

---

## 1️⃣ ขั้นตอนการรับร้านค้าใหม่เข้าร่วมโครงการ (สำหรับ Super Admin)

ระบบมีขั้นตอนในการนำร้านค้าใหม่เข้าระบบผ่านการสมัครหน้าเว็บหลัก ดังนี้:

1. **ร้านค้าส่งใบสมัคร**:
   - ไปที่หน้าแรกของระบบ (`index.php`) เลือกแพ็กเกจ แล้วกรอกฟอร์มขอเข้าร่วมโครงการที่อยู่ด้านล่างสุด
2. **แอดมินระบบส่วนกลางกดยอมรับ**:
   - ล็อกอินเข้าใช้งานหน้าแผงควบคุมหลัก `platform-admin.php`
   - มองหาตู้จดหมายคำขอลงทะเบียน (Inbox)
   - กดปุ่มสีเขียว **"✅ อนุมัติเข้าร่วมโครงการ"**
   - **สิ่งที่ระบบทำให้อัตโนมัติ**:
     - สร้างประวัติร้านค้าใหม่ลงในระบบ
     - สร้างบัญชีผู้ดูแลร้านค้า (Shop Admin) ให้อัตโนมัติ โดยมีชื่อผู้ใช้งานตั้งต้นคือ `admin_[รหัสร้าน]` และรหัสผ่านตั้งต้นคือ `123456`

---

## 2️⃣ ขั้นตอนการใช้งานฝั่งร้านค้า (สำหรับแอดมินร้านค้า)

แอดมินร้านค้าที่ได้รับอนุมัติแล้ว สามารถดำเนินการจัดการร้านของตนเองได้ดังนี้:

1. **เข้าสู่ระบบหลังบ้าน**:
   - ไปที่หน้า `demo-admin.php`
   - เข้าใช้งานด้วยบัญชีที่ได้จากขั้นตอนอนุมัติ (เช่น Username: `admin_1` / Password: `123456`)
2. **จัดการข้อมูลร้านค้า (Shop Profile)**:
   - เลื่อนลงไปที่ส่วน **"🏪 จัดการข้อมูลร้านค้า (Shop Profile Settings)"** ด้านล่างสุด
   - สามารถแก้ไขชื่อร้าน, เบอร์โทรศัพท์ และพิกัดที่ตั้ง (เช่น ศูนย์อาหาร ชั้น 1) เพื่อให้ลูกค้าเห็นข้อมูลอัปเดตบนหัวเมนูสั่งอาหาร
3. **จัดการรายการเมนูอาหาร (CRUD)**:
   - ที่ส่วน **"ระบบบริหารจัดการทะเบียนรายการอาหาร (CRUD)"**
   - สามารถกรอกข้อมูลเพิ่มเมนูใหม่ลงในระบบ โดยเมนูนี้จะไปโผล่ที่หน้าสั่งอาหารของร้านตนเองทันที
   - สามารถกด **"ลบเมนู"** หรือเปลี่ยนสถานะ "พร้อมเสิร์ฟ/หมดชั่วคราว" ได้
4. **จัดการออเดอร์ในครัว (Kitchen Command)**:
   - เมื่อมีลูกค้าส่งออเดอร์เข้ามา แถวคิวจะโผล่ในหน้าต่างแอดมินทันที
   - หากปรุงเสร็จเรียบร้อย ให้กดปุ่มสีเขียว **"รายการเสร็จสิ้น (Ready)"** เพื่อส่งสถานะไปที่หน้าจอคิวทีวีของลูกค้า
   - หากไม่สามารถปรุงได้ ให้กดปุ่มสีแดง **"ยกเลิก"**

---

## 3️⃣ ขั้นตอนการสั่งอาหารและดูคิว (สำหรับลูกค้าทั่วไป)

1. **การสั่งอาหาร**:
   - ลูกค้าเข้าที่หน้า `menu.php?shop_id=[รหัสร้านค้า]`
   - เลือกอาหารที่ต้องการสั่งลงในตะกร้า
   - กรอก **หมายเลขโต๊ะ** (เช่น โต๊ะ 05, A3) แล้วกด **"ยืนยันและส่งใบสั่งอาหาร"**
2. **การติดตามคิวผ่านมือถือ**:
   - หลังจากส่งใบสั่งอาหารเรียบร้อย หน้าเว็บสั่งอาหารจะมีแถบแจ้งเตือนคิวออเดอร์ของตนเองปรากฏขึ้นมาแสดงความคืบหน้าการปรุงแบบสดๆ (ส่งแล้ว -> กำลังปรุง -> พร้อมรับ)
3. **การดูคิวส่วนกลางของร้าน**:
   - เปิดหน้ารายงานสถานะรวม `status.php?shop_id=[รหัสร้านค้า]` เพื่อใช้ดูคิวอาหารที่อยู่ระหว่างปรุง และคิวที่ปรุงเสร็จแล้วบนจอมือถือหรือแท็บเล็ต
4. **การติดตั้งจอประกาศเรียกคิวประจำร้าน**:
   - แอดมินร้านค้าสามารถใช้แท็บเล็ตหรือทีวีที่มีบราวเซอร์เปิดหน้าจอ `queue-tv.php?shop_id=[รหัสร้านค้า]` ติดตั้งไว้หน้าร้าน
   - เมื่ออาหารปรุงเสร็จและร้านค้ากดยืนยันออเดอร์ หน้าจอนี้จะขยายใหญ่ขึ้นพร้อมแสดงหมายเลขออเดอร์ และพ่นเสียงเรียกภาษาไทยอัตโนมัติทันที (เช่น *"โต๊ะหมายเลข A3 รับอาหารได้เลยค่ะ"*)