การใช้งานหน้าร้าน

2.1 จัดการเมนูอาหาร

สร้างหมวด เพิ่มเมนู กำหนดราคา รูป ตัวเลือก (modifier) และสถานะพร้อมขาย/หมด

• มีสาขาในระบบเรียบร้อย (1.3)
• มีรูปภาพอาหารพร้อมอัปโหลด (แนะนำ 800×800px สี่เหลี่ยม)
• ทราบโครงสร้างหมวด/เมนู และต้นทุน (สำหรับคำนวณกำไร)

1. ไปที่เมนู เมนู (Menu) บน Sidebar
2. กด + หมวดหมู่ มุมบนขวา เปิด Category Modal
3. กรอกชื่อหมวด (เช่น "อาหารจานเดียว") เลือกไอคอน emoji แล้วกด บันทึก

1. กด + เมนูใหม่ เปิด Item Modal
2. อัปโหลด รูปอาหาร แล้วกรอก ชื่อ ราคา ต้นทุน
3. เลือก หมวด และ station ครัว (ครัวร้อน / ครัวเย็น / เครื่องดื่ม / ของหวาน)
4. (ถ้ามี) เพิ่ม ตัวเลือก (Modifier): ชื่อกลุ่ม + ตัวเลือก + ราคาเสริม + กำหนดเลือกได้หลายข้อ/ข้อเดียว
5. เพิ่ม tag เช่น spicy / best_seller / shared ตามต้องการ
6. กด บันทึก — เมนูจะแสดงทันทีทั้งในหน้า Waiter และ QR ของลูกค้า

• เปิดขาย — ลูกค้าและพนักงานเห็นและสั่งได้ตามปกติ
• หมดวันนี้ — แสดงเป็น "หมด" จนเที่ยงคืน แล้วกลับเป็นเปิดขายเอง
• ซ่อนจาก QR — พนักงานยังสั่งได้ แต่ลูกค้าใน QR menu ไม่เห็น

• เมนูใหม่ปรากฏใน Grid พร้อมรูปและ badge สถานะ
• ลูกค้าสแกน QR เห็นเมนูในหมวดที่กำหนด
• Kitchen Display routing ออเดอร์ไป station ที่ตั้งไว้

• 2.6 Kitchen Display (เห็นผลของการตั้ง station)
• 5.2 รายงานและ Analytics (Menu Health)
• 4.5 AI Setup Wizard (ใช้ AI สร้างเมนูจำนวนมาก)

2.2 จัดการโต๊ะ โซน และ QR Code

เพิ่มโต๊ะ จัดโซน สร้าง QR สำหรับให้ลูกค้าสแกนสั่ง และดูสถานะโต๊ะแบบ real-time

• เปิด QR Ordering ที่สาขาแล้ว (1.3)
• เตรียมผังร้านโดยประมาณ (กี่โต๊ะ โซนไหน)

1. ไปที่เมนู โต๊ะ (Tables) เลือก tab ตั้งค่าโต๊ะ
2. กด + เพิ่มโต๊ะ กรอก code (เช่น "T01"), ชื่อ, จำนวนที่นั่ง, โซน (Indoor / Outdoor / VIP / Counter)
3. เลือกรูปทรง (Round / Square / Rect) และลากวางบน Floor Plan Editor
4. กด บันทึก — ระบบสร้าง QR token อัตโนมัติสำหรับโต๊ะนี้

1. เปิด tab พิมพ์ QR เลือกโต๊ะที่ต้องการ (ติ๊กหลายโต๊ะได้)
2. เลือกขนาด/รูปแบบ (Sticker / Standee / Mini card)
3. กด พิมพ์ ระบบส่งออก PDF พร้อมพิมพ์ลงสติกเกอร์/กระดาษ

• tab สถานะโต๊ะ แสดงสีตาม state: เทา = ว่าง, เขียว = กำลังทาน, ส้ม = รออาหาร, ม่วง = ขอเช็คบิล, เหลือง = ชำระบางส่วน, แดง = ต้องทำความสะอาด
• คลิกไทล์โต๊ะเพื่อเปิด Drawer — เห็นข้อมูล session + ปุ่ม "เปิดโต๊ะ / เพิ่มออเดอร์ / ชำระเงิน"

• โต๊ะใหม่อยู่ใน Grid พร้อม QR ที่พิมพ์ได้
• ลูกค้าสแกน QR แล้วเข้าหน้าเมนูของโต๊ะนั้นได้
• สถานะโต๊ะอัปเดต real-time เมื่อมีการเปลี่ยน state

• 2.3 ลูกค้าสแกน QR สั่งอาหาร
• 2.5 วงจรโต๊ะและ Session

2.3 ลูกค้าสแกน QR สั่งอาหาร

Flow ฝั่งลูกค้า ตั้งแต่สแกน QR ที่โต๊ะ ใส่ชื่อเล่น เลือกเมนู เพิ่มลงตะกร้า และส่งออเดอร์เข้าครัว

• โต๊ะมี QR sticker และ qr_enabled = true
• ลูกค้ามีอินเทอร์เน็ตและกล้องมือถือ

1. เปิดกล้องมือถือสแกน QR ที่ติดอยู่บนโต๊ะ เบราว์เซอร์เปิดหน้า OrderDee อัตโนมัติ
2. ระบบแสดงชื่อร้าน + เลขโต๊ะ + สถานะ ("เริ่ม session ใหม่" หรือ "เข้าร่วมโต๊ะ" หากมีคนสั่งอยู่ก่อนแล้ว)
3. กรอก ชื่อเล่น (เช่น "เอ", "พี่หมู") แล้วกด 🍽 เริ่มสั่งอาหาร
4. เลือกหมวดจาก Category tabs (เลื่อนแนวนอน) แตะการ์ดเมนูที่ต้องการ
5. ใน Add to Cart Sheet: เลือกตัวเลือก (modifier), กรอกหมายเหตุ, เลือกเจ้าของรายการ (ตัวเอง / ของกลาง 🤝), ปรับจำนวน − +
6. กด เพิ่ม · ฿xx — รายการเข้าตะกร้า แตะ 🛒 ตะกร้า มุมขวาบนเพื่อดูสรุปและกด ส่งออเดอร์ เข้าครัว
7. หากต้องการพนักงาน แตะ 🔔 เรียกพนักงาน เลือกเหตุผล (ขอน้ำ / ช้อนส้อม / เช็คบิล / อื่นๆ)

• ออเดอร์ส่งเข้า KDS ฝั่งครัวทันที
• โต๊ะเปลี่ยนสถานะเป็น "ordering" หรือ "order_sent"
• ลูกค้าเห็นสถานะรายการ "กำลังทำ / พร้อมเสิร์ฟ" บนมือถือ real-time

• 2.6 Kitchen Display
• 3.2 แยกบิล Split Bill
• 4.6 AI รับออเดอร์

2.4 พนักงานรับออเดอร์แทนลูกค้า

หน้าจอ Waiter สำหรับรับออเดอร์ที่โต๊ะ — เลือกโต๊ะ เลือกเจ้าของรายการ เพิ่มเมนู และส่งเข้าครัว พร้อมโหมด AI/เสียงช่วยสั่งเร็วขึ้น

• มีเมนูในระบบ (2.1) และโต๊ะ (2.2)
• หากใช้ Mic — เปิด permission ไมโครโฟนบนเบราว์เซอร์

• ซ้าย: Table Selector — รายชื่อโต๊ะพร้อมสถานะสี
• กลาง: Menu Panel — Category tab + Smart Input (ค้นหา/พิมพ์เร็ว) + 🎤 Mic + Grid เมนู
• ขวา: Cart Panel — โต๊ะที่เลือก + Owner Dropdown + รายการ + ปุ่ม "ส่งเข้าครัว"

1. ไปเมนู รับออเดอร์ (Waiter) แล้วเลือก โต๊ะ จาก Table Selector ฝั่งซ้าย
2. ถ้าโต๊ะยังว่าง ระบบ prompt ให้กรอก จำนวนคน + ชื่อผู้รับ → กด สร้างโต๊ะ
3. เลือก Owner ใน Cart (default "โต๊ะรวม" หรือเลือกชื่อคน)
4. คลิกเมนูจาก Menu Panel หรือพิมพ์ค้นชื่อ หรือกด 🎤 พูดคำสั่ง
5. ใน Item Option Sheet: เลือก modifier, ใส่หมายเหตุ, ปรับ qty → กด เพิ่ม
6. ตรวจรายการใน Cart Panel ทางขวา แล้วกด ส่งเข้าครัว → Toast แจ้ง "ส่งเข้าครัว N รายการ"

• ออเดอร์ปรากฏใน KDS ครัวภายใน 1 วินาที
• โต๊ะเปลี่ยนสถานะเป็น "order_sent"
• Cart Panel ล้างพร้อมรับออเดอร์ถัดไป

• 2.5 วงจรโต๊ะและ Session
• 4.6 AI รับออเดอร์

2.5 วงจรโต๊ะและ Session

เข้าใจวงจรของโต๊ะตั้งแต่เปิด → รับออเดอร์ → เสิร์ฟ → ขอบิล → ชำระ → ปิด พร้อมการย้าย/รวม/แยกโต๊ะ

1. คลิกโต๊ะที่หน้า Tables เปิด Drawer แล้วเลือก tab ย้ายโต๊ะ
2. ย้ายโต๊ะ: เลือกโต๊ะปลายทาง — order/bill ทั้งหมดย้ายตามไป
3. รวมโต๊ะ: เลือกโต๊ะอื่นที่จะรวมเข้ามา — รายการเมนูและบิลรวมเป็นโต๊ะเดียว
4. แยกโต๊ะ: เลือกลูกค้า (participant) บางคนแยกไปโต๊ะใหม่ พร้อมรายการของคนนั้น

• 3.1 แคชเชียร์และการปิดบิล
• 3.2 แยกบิล Split Bill

2.6 หน้าจอครัว Kitchen Display (KDS)

หน้าจอสำหรับครัวรับออเดอร์ แสดงเป็น Kanban 3 คอลัมน์ (ใหม่ / กำลังทำ / พร้อมเสิร์ฟ) พร้อมเสียงแจ้งเตือนและ filter ตาม station

• เมนูทุกรายการตั้ง station เรียบร้อย (2.1)
• เปิดเสียงแจ้งเตือน (Topbar) เพื่อไม่พลาดออเดอร์ใหม่

• Station Chips ด้านบน: ทั้งหมด / ครัวร้อน / ครัวเย็น / เครื่องดื่ม / ของหวาน (แสดงจำนวนรายการ)
• 3 Columns: 🔔 ใหม่ → 🍳 กำลังทำ → ✅ พร้อมเสิร์ฟ
• Kitchen Card แต่ละใบ: ชื่อเมนู + Qty + โต๊ะ + Owner + เวลาที่รอ + Modifier + Note พิเศษ
• การ์ดที่เกินเวลาจะมี ⚠️ badge เกินเวลา สีแดง

1. มีออเดอร์ใหม่ → ระบบเล่นเสียงและการ์ดเด้งขึ้นในคอลัมน์ ใหม่
2. กด เริ่มทำ → ที่การ์ด — ย้ายไปคอลัมน์ กำลังทำ
3. เมื่อทำเสร็จ กด พร้อมเสิร์ฟ → — การ์ดย้ายไป พร้อมเสิร์ฟ และแจ้ง Waiter
4. Waiter เสิร์ฟแล้วกด เสิร์ฟแล้ว → — การ์ดหายไปจากบอร์ด
5. กด ⋯ มุมการ์ดเพื่อ "แจ้งวัตถุดิบหมด" / "ยกเลิกรายการ" / "แจ้งพนักงาน"

• 2.7 ยกเลิก Void และเมนูหมด
• 2.8 Notifications และ Real-time

2.7 ยกเลิกออเดอร์ Void และเมนูหมด

วิธียกเลิกรายการ ไม่ว่าจะเป็นเหตุผล "ลูกค้ายกเลิก", "วัตถุดิบหมด" หรือ "Void" โดยพนักงาน พร้อม audit log

• out_of_stock — วัตถุดิบหมด (ครัวแจ้ง)
• customer_cancel — ลูกค้ายกเลิกเอง
• staff_void — พนักงานยกเลิกให้ (ต้อง manager approval)
• payment_timeout — pre-pay ไม่จ่ายในเวลา auto-cancel
• payment_rejected_max — สลิปถูกปฏิเสธเกินจำนวนครั้ง
• compensation — ชดเชยลูกค้า (เช่นเสิร์ฟผิด)

1. ที่ KDS กด ⋯ ที่การ์ด เลือก แจ้งวัตถุดิบหมด
2. เปิด Cancel Modal — เลือก "หมดวันนี้" หรือ "หมดถาวร" (ติ๊ก checkbox)
3. กด ยืนยัน — ระบบยกเลิกรายการนี้ + มาร์คเมนูเป็น sold_out ใน QR menu + แจ้ง Waiter

1. Waiter ไปที่หน้า ออเดอร์ หรือเปิด Drawer ของบิล
2. คลิก ⋯ ที่รายการ เลือก ยกเลิก
3. เลือกเหตุผล + ใส่หมายเหตุ (ไม่บังคับ) → กด ส่งคำขอ
4. ระบบส่งคำขอไปยัง Manager (state = pending_cancel)
5. Manager เปิด notification กด อนุมัติ หรือ ปฏิเสธ

• 3.5 คืนเงินและ Void บิล
• 5.4 Security และข้อมูลส่วนตัว

2.8 Notifications และ Real-time

ระบบแจ้งเตือนแบบ real-time ผ่าน WebSocket — ครัว แคชเชียร์ พนักงาน และผู้จัดการได้รับข้อมูลทันทีโดยไม่ต้องรีเฟรช

• kitchen — ออเดอร์ใหม่เข้าครัว / ขอยกเลิก
• payment — สลิปรอตรวจ / payment timeout ใกล้จะหมด
• customer_call — ลูกค้าเรียกพนักงาน / ขอเช็คบิล
• system — ข้อความระบบ การบำรุงรักษา
• billing — แพ็คเกจใกล้หมด AI credits ใกล้หมด

1. ไอคอน 🔔 กระดิ่ง บน Topbar แสดง badge จำนวนที่ยังไม่อ่าน
2. คลิก → Dropdown แสดง 5 รายการล่าสุด พร้อมปุ่ม "ดูทั้งหมด"
3. หน้า การแจ้งเตือน เต็มรูปแบบ: filter (ทั้งหมด / ยังไม่อ่าน / ออเดอร์ / ชำระเงิน / เรียกพนักงาน / ระบบ)
4. แต่ละการ์ดมี CTA link ตรงไปหน้าที่เกี่ยวข้อง (เช่น แจ้งเตือนสลิป → ไปหน้า Payments)
5. ปุ่ม อ่านทั้งหมด / ลบที่อ่านแล้ว ช่วยจัดการคิว