HandyCafe Docs
owner it-admin

วิธีการตั้งค่า ร้านอาหาร

คู่มือนี้จะแนะนำการตั้งค่า ร้านอาหาร ครั้งแรกแบบครบวงจร เมื่อเสร็จสิ้น คุณจะมีเมนูสำหรับลูกค้าที่เผยแพร่ที่ handy.cafe/{your-slug} มีแผนผังร้านที่มีโต๊ะทำงานอย่างน้อยหนึ่งโต๊ะ มีเมนูพร้อมสินค้า และมีการสั่งซื้อทดสอบที่สำเร็จ

สิ่งที่คุณจะต้องมี

  • ใบอนุญาต HandyCafe ที่ใช้งานอยู่ การยืนยันตัวตนของ ร้านอาหาร จะใช้ใบอนุญาตโดยอัตโนมัติ คุณไม่จำเป็นต้องวางคีย์ด้วยตนเอง
  • การเชื่อมต่ออินเทอร์เน็ตบนเซิร์ฟเวอร์ ร้านอาหาร เป็นระบบที่เน้นการใช้งานบนคลาวด์ ดังนั้นการจัดเตรียม การซิงค์เมนู และการตรวจสอบคำสั่งซื้อทั้งหมดต้องการการเข้าถึง API บนคลาวด์
  • ชื่อ slug ที่คุณต้องการใช้สำหรับ URL เมนูสาธารณะ อักขระที่อนุญาตคือ ตัวอักษรพิมพ์เล็ก ตัวเลข และขีดกลาง ความยาว 3 ถึง 62 อักขระ
  • ตัวเลือก: โลโก้และภาพหัวข้อ รูปแบบที่แนะนำคือ WebP ขนาดไม่เกิน 2 MB
  • ตัวเลือก: ปริ้นเตอร์ใบเสร็จ TCP บนเครือข่ายท้องถิ่น

ขั้นตอนที่ 1: เปิดใช้งาน ร้านอาหาร

  1. เปิด HandyCafe Server
  2. ไปที่ Settings ในแถบด้านข้าง
  3. เปิดแท็บ ร้านอาหาร
  4. สลับ Enable ร้านอาหาร ให้เป็นเปิด
  5. เซิร์ฟเวอร์จะติดต่อกับ API บนคลาวด์โดยใช้ใบอนุญาตของคุณเป็นโทเค็นการอนุญาต หากสำเร็จ หน้าต่าง Provisioning Wizard จะเปิดขึ้น

ผลลัพธ์ที่คาดหวัง: หน้าจอ Provisioning Wizard ปรากฏขึ้น หากคุณเห็นข้อผิดพลาดเกี่ยวกับใบอนุญาตหรือการเชื่อมต่อ ให้ตรวจสอบการเชื่อมต่ออินเทอร์เน็ตของคุณและยืนยันว่าใบอนุญาต HandyCafe ของคุณยังใช้งานอยู่


ขั้นตอนที่ 2: จัดเตรียมร้านของคุณ

Wizard จะขอข้อมูลสี่ช่อง

  1. Slug. พิมพ์ส่วนท้ายของ URL ที่คุณต้องการ ตัวบ่งชี้ความพร้อมใช้งานจะอัปเดตภายในหนึ่งวินาที หาก slug ถูกใช้หรือสงวนไว้ ให้เลือกอันอื่น
  2. Display Name. ชื่อที่อ่านได้ง่ายซึ่งแสดงที่ด้านบนของเมนูลูกค้า เช่น "Atilla's Gaming Lounge"
  3. Country and Currency. เลือกประเทศที่ร้านดำเนินการอยู่ สกุลเงินจะถูกตั้งค่าเริ่มต้นตามประเทศและสามารถเปลี่ยนแปลงได้
  4. Timezone. เลือกเขตเวลาสำหรับการประทับเวลาในการสั่งซื้อและการชำระเงิน
  5. คลิก Create Cafe

ผลลัพธ์ที่คาดหวัง: Wizard ปิดและพื้นที่ทำงานของ ร้านอาหาร เปิด URL สาธารณะของคุณ handy.cafe/{slug} ขณะนี้ใช้งานได้ แม้ว่าเมนูจะยังว่างเปล่า


ขั้นตอนที่ 3: กรอกข้อมูลโปรไฟล์ธุรกิจ

  1. ยังคงอยู่ใน Settings > ร้านอาหาร เลื่อนลงไปที่ส่วน Business Profile
  2. อัปโหลด Logo (ภาพสี่เหลี่ยมจัตุรัส)
  3. อัปโหลด Header Image (แบนเนอร์กว้าง)
  4. ป้อน Address และ Phone เพื่อแสดงในส่วนท้ายของเมนูลูกค้า
  5. สลับ Show Prep Time on Menu เปิดหรือปิด ขึ้นอยู่กับว่าคุณต้องการให้ลูกค้าเห็นเวลาการเตรียมการที่คาดการณ์ไว้หรือไม่
  6. คลิก Save

ผลลัพธ์ที่คาดหวัง: โลโก้และหัวข้อปรากฏในตัวอย่าง การเยี่ยมชม handy.cafe/{slug} ในเบราว์เซอร์ตอนนี้จะแสดงหัวข้อที่มีแบรนด์แต่ยังคงมีเนื้อหาว่างเปล่า


ขั้นตอนที่ 4: สร้างชั้น

  1. ใน Settings > ร้านอาหาร ค้นหาส่วน Floors
  2. คลิก Add Floor และตั้งชื่อ (เช่น "Main Hall")
  3. เพิ่มชั้นเพิ่มเติมหากสถานที่ของคุณมีหลายพื้นที่ (เช่น "Mezzanine", "Outdoor Patio")
  4. จัดลำดับชั้นด้วยปุ่มเลื่อนขึ้นและเลื่อนลง ชั้นบนสุดจะกลายเป็นค่าเริ่มต้นใน Floor Plan editor

ผลลัพธ์ที่คาดหวัง: ชั้นของคุณปรากฏในรายการ แท็บ ร้านอาหาร > Floor Plan ตอนนี้แสดงแถบชั้นที่ด้านบน


ขั้นตอนที่ 5: สร้างแผนผังร้าน

  1. เปิด ร้านอาหาร > Floor Plan
  2. เลือกชั้นแรกจากแถบ
  3. คลิก Add Table โต๊ะสี่เหลี่ยมจะปรากฏที่จุดเริ่มต้นของผืนผ้าใบ
  4. ลากโต๊ะไปยังตำแหน่งที่ต้องการ ปล่อยเพื่อบันทึก
  5. คลิกที่โต๊ะเพื่อเปิดแผงคุณสมบัติ กำหนดค่า:
    • Code (เช่น "T1", "Window 3")
    • Display Name (ป้ายยาวเพิ่มเติม)
    • Seat Count (จำนวนที่นั่ง)
    • Shape (สี่เหลี่ยม, สี่เหลี่ยมผืนผ้าตามแนวนอน, สี่เหลี่ยมผืนผ้าตามแนวตั้ง, หรือกลม)
    • Size (1 ถึง 10)
  6. ทำซ้ำสำหรับทุกโต๊ะในชั้น
  7. เลือกดูใน 3D view เพื่อทบทวนการจัดวางจากมุมมองสถาปนิก

ผลลัพธ์ที่คาดหวัง: แผนผังร้านของคุณแสดงโต๊ะทั้งหมดในตำแหน่งจริง การลากถูกปิดใช้งานในมุมมอง 3D; สลับกลับไปที่ 2D เพื่อย้ายโต๊ะ


ขั้นตอนที่ 6: สร้างเมนู

  1. เปิด ร้านอาหาร > Menu
  2. คลิก Add Category ป้อนชื่อและเลือกไอคอน MDI จากตัวเลือกไอคอน คลิก Save
  3. ทำซ้ำสำหรับแต่ละหมวดหมู่ (เช่น "Hot Drinks", "Cold Drinks", "Burgers", "Desserts")
  4. ภายในหมวดหมู่ คลิก Add Product ป้อน:
    • ชื่อ
    • คำอธิบาย (รองรับ Markdown)
    • รายการส่วนผสม
    • ราคาฐาน
    • อัตรา VAT
    • เวลาเตรียมการ (ค่าเริ่มต้นคงที่)
    • ตัวเลือก: ป้ายหน่วย, ธงติดตามสต็อก, จำนวนในสต็อก
  5. อัปโหลด Photo ของสินค้า รูปแบบใดก็ได้ที่ยอมรับ; แนะนำ WebP ขนาดไม่เกิน 2 MB
  6. คลิก Save
  7. หากสินค้ามีตัวเลือก ให้เลื่อนลงไปที่ส่วน Variants และคลิก Add Variant สร้างแถวสำหรับแต่ละตัวเลือกพร้อมราคาที่แตกต่าง สลับ Required หากลูกค้าต้องเลือกหนึ่งตัวเลือก
  8. ทำซ้ำสำหรับทุกสินค้าที่อยู่ในเมนูของคุณ

ผลลัพธ์ที่คาดหวัง: เมนูลูกค้าที่ handy.cafe/{slug} จะแสดงหมวดหมู่และสินค้าของคุณ เยี่ยมชมในเบราว์เซอร์เพื่อยืนยัน


ขั้นตอนที่ 7: ตั้งค่าปริ้นเตอร์ (ตัวเลือก)

  1. ยังคงอยู่ใน Settings > ร้านอาหาร เลื่อนลงไปที่ Printer Settings
  2. ตั้งค่า Kind เป็น TCP
  3. ป้อน IP และ Port ของปริ้นเตอร์ ปริ้นเตอร์ ESC POS TCP ส่วนใหญ่จะฟังที่พอร์ต 9100
  4. เปิดใช้งาน Auto Cut หากปริ้นเตอร์รองรับ
  5. เปิดใช้งาน Auto Print on New Order เพื่อให้พิมพ์ทุกคำสั่งซื้อที่เข้ามา
  6. เปิดใช้งาน Sound Notification สำหรับการแจ้งเตือนเสียงพร้อมกับการแจ้งเตือนบนเดสก์ท็อป
  7. คลิก Test Print ใบเสร็จตัวอย่างควรพิมพ์ภายในไม่กี่วินาที

ผลลัพธ์ที่คาดหวัง: ใบเสร็จทดสอบพิมพ์สำเร็จ หากไม่มีการพิมพ์ ตรวจสอบ IP, พอร์ต และว่าปริ้นเตอร์อยู่ในเครือข่ายท้องถิ่นเดียวกับเซิร์ฟเวอร์


ขั้นตอนที่ 8: จัดที่นั่งและสั่งซื้อทดสอบ

  1. เปิด ร้านอาหาร > Tables (หรือใช้เมนูการกระทำใน Floor Plan)
  2. เลือกโต๊ะหนึ่งและคลิก Seat Customer (หรือที่เรียกว่า "Open Table")
  3. จดรหัสความปลอดภัย 6 หลักที่แสดงไว้ เขียนลงหรือปล่อยให้หน้าต่างเปิดอยู่
  4. บนโทรศัพท์ ไปที่ handy.cafe/{slug}/{table-code} คุณยังสามารถสแกน QR ได้หากคุณมีสติกเกอร์ที่พิมพ์
  5. ป้อนรหัส 6 หลัก
  6. เรียกดูเมนูและเพิ่มสินค้าในตะกร้า
  7. ดำเนินการชำระเงิน เลือก Cash เป็นวิธีการชำระเงิน (การตั้งค่า Stripe เป็นตัวเลือกและสามารถเพิ่มได้ในภายหลัง)
  8. ส่งคำสั่งซื้อ
  9. บนเซิร์ฟเวอร์ สลับไปที่ ร้านอาหาร > Orders

ผลลัพธ์ที่คาดหวัง: ภายใน 3 วินาที การ์ดคำสั่งซื้อใหม่จะปรากฏบนแดชบอร์ดคำสั่งซื้อ การแจ้งเตือนบนเดสก์ท็อปจะทำงาน การแจ้งเตือนเสียงจะเล่นหากเปิดใช้งานการแจ้งเตือนเสียง ป้ายจำนวนที่รอดำเนินการจะเพิ่มขึ้นในแท็บคำสั่งซื้อ


ขั้นตอนที่ 9: ดำเนินการและชำระคำสั่งซื้อทดสอบ

  1. บนการ์ดคำสั่งซื้อ คลิกปุ่มสถานะถัดไป คำสั่งซื้อจะย้ายจาก placed ไปยัง confirmed
  2. คลิกต่อไปเพื่อดำเนินการผ่าน preparing, ready, และ served
  3. ในหน้าตาราง เปิดโต๊ะเดียวกันและคลิก Settle Check
  4. เลือก Cash เป็นวิธีการชำระเงินและยืนยัน

ผลลัพธ์ที่คาดหวัง: โต๊ะกลับสู่สถานะ idle รหัสความปลอดภัยหมดอายุ บันทึกการชำระเงินถูกสร้างขึ้นและสามารถตรวจสอบได้ในภายหลัง


ข้อผิดพลาดทั่วไปที่ควรหลีกเลี่ยง

  • ข้ามโปรไฟล์ธุรกิจ. ลูกค้าจะเห็นชื่อแสดงผลเริ่มต้นและพื้นที่โลโก้ที่เสียหายหากคุณเปิดตัวก่อนบันทึกโปรไฟล์
  • ไม่พิมพ์ QR ใหม่หลังจากเปลี่ยน slug. การเปลี่ยน slug จะทำให้ QR ที่มีอยู่ทั้งหมดไม่ถูกต้อง พิมพ์สติกเกอร์ใหม่และแทนที่บนทุกโต๊ะ
  • เผยแพร่หมวดหมู่มากเกินไปในตอนเปิดตัว. ตั้งเป้าหมายที่ 6 ถึง 10 หมวดหมู่ระดับบนสุด ลูกค้าจะเรียกดูได้เร็วขึ้นเมื่อเมนูพอดีกับหน้าจอ
  • ลืมตั้งค่าปริ้นเตอร์ก่อนกะจริงครั้งแรก. หากไม่มี Auto Print on New Order พนักงานอาจพลาดคำสั่งซื้อในช่วงที่ยุ่งเสมอ ทดสอบการพิมพ์อย่างน้อยหนึ่งครั้งเสมอ
  • ปล่อยให้ Show Prep Time on Menu เปิดใช้งานโดยไม่มีประวัติแบบไดนามิก. ใน 30 วันแรกค่าคงที่คือสิ่งที่ลูกค้าเห็น ตั้งค่าเวลาคงที่ที่สมจริงหรือปิดการแสดงผลจนกว่าการประเมินแบบไดนามิกจะได้รับการฝึกฝน
  • ใช้เครื่องเดียวกันสำหรับการทดสอบพนักงานและลูกค้า. เซสชันลูกค้าจะคงอยู่ 24 ชั่วโมง; หากอุปกรณ์ทดสอบของคุณถูกส่งต่อให้ลูกค้าในภายหลัง พวกเขาจะอยู่ในเมนูโดยไม่ต้องยืนยัน ล้างอุปกรณ์หรือใช้โปรไฟล์เบราว์เซอร์ใหม่สำหรับการทดสอบ