HandyCafe Docs
owner it-admin

کافه‌تریا

کافه‌تریا ماژول یکپارچه خدمات غذا و نوشیدنی در HandyCafe است. این امکان را به شما می‌دهد که یک نقشه دیجیتال از میزهایتان بسازید، یک منوی سلف‌سرویس برند شده در وب در handy.cafe/{your-slug} منتشر کنید و هر سفارش ورودی را به صورت زنده از داشبورد سرور پیگیری کنید.

مشتریان کد QR روی میز خود را اسکن می‌کنند، یک کد امنیتی ۶ رقمی وارد می‌کنند، منو را به زبان خود مرور می‌کنند و سفارش می‌دهند. سفارش در صفحه سفارشات کافه‌تریا شما در عرض چند ثانیه ظاهر می‌شود. کارکنان شما هر مرحله از آماده‌سازی را تأیید می‌کنند و وقتی سرویس کامل شد، عمل "تسویه حساب" صورتحساب را در یک مرحله می‌بندد.

مخاطبان

کافه‌تریا برای کافی‌نت‌ها، مراکز بازی و سالن‌های ورزش‌های الکترونیکی طراحی شده است که همچنین غذا و نوشیدنی در محل مشتری ارائه می‌دهند. این ماژول جایگزین برگه‌های سفارش کاغذی و درخواست‌های شفاهی به پیشخوان می‌شود. این ماژول در کنار سیستم استاندارد جلسه و قیمت‌گذاری HandyCafe کار می‌کند؛ سفارشات کافه‌تریا به صورت جداگانه اما تحت همان مجوز کافی‌نت پیگیری می‌شوند.

قابلیت‌های اصلی

قابلیت خلاصه
نقشه طبقه ویرایشگر بصری برای حداکثر چندین طبقه. میزها را به موقعیت بکشید، به نمای ۳ بعدی تغییر دهید، میزها را خارج از سرویس علامت‌گذاری کنید.
میزها تنظیم تعداد صندلی، شکل، اندازه (۱ تا ۱۰) و کد نمایش برای هر میز. تولید کدهای QR و چرخش آن‌ها به صورت دلخواه.
منو دسته‌بندی‌ها با آیکون‌های MDI، محصولات با عکس‌ها، توضیحات مارک‌داون، لیست مواد تشکیل‌دهنده و گروه‌های متغیر (مثلاً اندازه، تاپینگ‌ها).
سفارشات داشبورد زنده با نظرسنجی ۳ ثانیه‌ای، نشان تعداد در انتظار، اعلان‌های دسکتاپ و صوتی، وضعیت هر سفارش و هر آیتم.
تسویه حساب عمل بستن صورتحساب با یک کلیک که همه سفارشات باز روی یک میز را با روش پرداخت انتخابی تسویه می‌کند.
منوی مشتری منوی وب برند شده در ۲۴ زبان در handy.cafe/{slug}، با تم روشن و تاریک و زبان پیش‌فرض آگاه از دستگاه.
پرداخت آنلاین یکپارچه‌سازی اختیاری Stripe Checkout برای پرداخت در هنگام سفارش، با گزینه پرداخت نقدی در میز.
چاپگر چاپگر رسید TCP اختیاری با برش خودکار و چاپ خودکار در سفارشات جدید.

محل قرارگیری کافه‌تریا در رابط کاربری سرور

کافه‌تریا دو نقطه ورود دارد:

  1. بخش کافه‌تریا در نوار کناری. این فضای کاری عملیاتی برای استفاده روزانه است. شامل پنج تب است: میزها، نقشه طبقه، منو، سفارشات و برنامه‌ریزی. تب سفارشات نشان در انتظار را هر زمان که سفارشات جدید در انتظار باشند نشان می‌دهد.
  2. تنظیمات > کافه‌تریا. این ناحیه پیکربندی است. شامل پروفایل کسب‌وکار (slug، نام نمایش، لوگو، تصویر سرصفحه، آدرس، ارز، منطقه زمانی)، تنظیمات چاپگر، مدیریت طبقه و تغییرات ویژگی اختیاری است.

راه‌اندازی کافی‌نت

وقتی برای اولین بار کافه‌تریا را فعال می‌کنید، سرور به طور خودکار از مجوز HandyCafe شما به عنوان توکن احراز هویت استفاده می‌کند. نیازی به وارد کردن دستی چیزی نیست. سپس جادوگر راه‌اندازی چهار قطعه اطلاعات را درخواست می‌کند:

  1. Slug. این به عنوان URL عمومی در handy.cafe/{slug} می‌شود. کاراکترهای مجاز حروف کوچک، اعداد و خط تیره هستند. طول slug بین ۳ تا ۶۲ کاراکتر است. سیستم در زمان واقعی در دسترس بودن را بررسی می‌کند و slugهای رزرو شده مانند "admin"، "api" یا "dashboard" را رد می‌کند.
  2. نام نمایش. نام قابل خواندن توسط انسان که در بالای منوی مشتری نمایش داده می‌شود.
  3. کشور و ارز. ارز پیش‌فرض برای قیمت‌های منو. قیمت‌ها در واحدهای کوچک (مثلاً سنت) ذخیره می‌شوند و با نماد ارز تنظیم شده نمایش داده می‌شوند.
  4. منطقه زمانی. برای محاسبات زمان آماده‌سازی پویا، زمان‌بندی سفارشات و سوابق تسویه حساب استفاده می‌شود.

پس از تکمیل راه‌اندازی، کافی‌نت در پایگاه داده ابری ایجاد می‌شود و فضای کاری کافه‌تریا باز می‌شود. سپس می‌توانید طبقات، میزها و آیتم‌های منو را اضافه کنید.

پروفایل کسب‌وکار

پروفایل کسب‌وکار در هر زمان تحت تنظیمات > کافه‌تریا قابل ویرایش است. فیلدهای کلیدی:

فیلد هدف
Slug بخش URL عمومی. تغییر slug کدهای QR موجود را تا زمان بازتولید می‌شکند.
نام نمایش در بالای منوی مشتری نمایش داده می‌شود.
لوگو تصویر مربعی. WebP تا ۲ مگابایت توصیه می‌شود.
تصویر سرصفحه تصویر بنر عریض در بالای منوی مشتری. WebP تا ۲ مگابایت توصیه می‌شود.
آدرس و تلفن اختیاری. در پایین‌صفحه منو نمایش داده می‌شود.
ارز به هر قیمت محصول در منو اعمال می‌شود.
کشور برای مالیات و پیش‌فرض‌های منطقه‌ای استفاده می‌شود.
منطقه زمانی به زمان‌بندی سفارشات و تسویه حساب‌ها اعمال می‌شود.
نمایش زمان آماده‌سازی در منو تغییر وضعیت. وقتی روشن است، هر محصول زمان آماده‌سازی تخمینی را نمایش می‌دهد.

تنظیمات چاپگر

بخش چاپگر تنظیمات زیر را می‌پذیرد:

  • نوع. یا غیرفعال یا TCP. چاپ مستقیم USB در این نسخه پشتیبانی نمی‌شود.
  • IP و پورت. آدرس شبکه چاپگر رسید شما. بیشتر چاپگرهای ESC POS TCP روی پورت ۹۱۰۰ گوش می‌دهند.
  • برش خودکار. فرمان برش کاغذ را بعد از هر رسید چاپ شده اضافه می‌کند.
  • چاپ خودکار در سفارش جدید. وقتی روشن است، هر سفارش ورودی به طور خودکار یک رسید چاپ می‌کند.
  • اعلان صوتی. علاوه بر اعلان دسکتاپ، یک هشدار صوتی پخش می‌کند وقتی یک سفارش جدید می‌رسد.
  • چاپ آزمایشی. یک رسید نمونه به چاپگر تنظیم شده ارسال می‌کند تا اتصال را تأیید کند.

خلاصه معماری

کافه‌تریا از یک مدل داده ابری استفاده می‌کند. هر میز، دسته‌بندی، محصول، سفارش و رکورد تسویه حساب در پایگاه داده ابری handy.cafe ذخیره می‌شود. سرور محلی HandyCafe این وضعیت را منعکس می‌کند و هر ۳ ثانیه نقطه پایانی سفارشات را برای فعالیت جدید نظرسنجی می‌کند. صفحات مشتری‌محور مستقیماً توسط ابر handy.cafe ارائه می‌شوند؛ آن‌ها نیازی به دسترسی سرور شما از اینترنت ندارند.

زیرا داده‌ها در ابر زندگی می‌کنند:

  • کدهای QR حتی زمانی که سرور آفلاین است کار می‌کنند، اما کارکنان نمی‌توانند سفارشات را در داشبورد ببینند تا زمانی که اتصال بازگردد.
  • تغییرات منو در عرض چند ثانیه پس از ذخیره به handy.cafe منتقل می‌شوند.
  • سفارشات مشتریان پس از نظرسنجی ۳ ثانیه‌ای بعدی به داشبورد سفارشات می‌رسند.

مراحل بعدی