چگونه کافه‌تریا را راه‌اندازی کنیم

این راهنما مراحل کامل راه‌اندازی اولیه ماژول کافه‌تریا را توضیح می‌دهد. در پایان، منوی مشتری منتشر شده در handy.cafe/{your-slug}، نقشه طبقات با حداقل یک میز فعال، منویی با محصولات و یک سفارش آزمایشی موفق خواهید داشت.

آنچه نیاز خواهید داشت

• یک مجوز فعال HandyCafe. احراز هویت کافه‌تریا به‌طور خودکار از مجوز استفاده می‌کند؛ نیازی به وارد کردن دستی کلید نیست.
• اتصال اینترنتی روی سرور. کافه‌تریا ابتدا به ابر متصل می‌شود، بنابراین آماده‌سازی، همگام‌سازی منو و نظرسنجی سفارش‌ها همگی نیاز به دسترسی به API ابری دارند.
• یک slug که می‌خواهید برای URL منوی عمومی استفاده کنید. کاراکترهای مجاز حروف کوچک، اعداد و خط تیره هستند. طول آن ۳ تا ۶۲ کاراکتر است.
• اختیاری: یک لوگو و تصویر سربرگ. فرمت پیشنهادی WebP تا ۲ مگابایت.
• اختیاری: یک چاپگر رسید TCP در شبکه محلی.

مرحله ۱: فعال‌سازی کافه‌تریا

1. سرور HandyCafe را باز کنید.
2. به تنظیمات در نوار کناری بروید.
3. برگه کافه‌تریا را باز کنید.
4. فعال‌سازی کافه‌تریا را روشن کنید.
5. سرور با استفاده از مجوز شما به عنوان توکن احراز هویت با API ابری تماس می‌گیرد. اگر موفق باشد، جادوگر آماده‌سازی باز می‌شود.

نتیجه مورد انتظار: صفحه جادوگر آماده‌سازی ظاهر می‌شود. اگر خطایی درباره مجوز یا اتصال مشاهده کردید، اتصال اینترنت خود را بررسی کنید و تأیید کنید که مجوز HandyCafe شما فعال است.

مرحله ۲: آماده‌سازی کافه شما

جادوگر از شما چهار فیلد می‌خواهد.

1. Slug. پسوند URL مورد نظر خود را تایپ کنید. نشانگر دسترسی در عرض یک ثانیه به‌روزرسانی می‌شود. اگر slug گرفته شده یا رزرو شده است، یکی دیگر انتخاب کنید.
2. نام نمایش. نام قابل خواندن توسط انسان که در بالای منوی مشتری نمایش داده می‌شود، به عنوان مثال "Atilla's Gaming Lounge".
3. کشور و ارز. کشوری که کافه در آن فعالیت می‌کند را انتخاب کنید. ارز بر اساس کشور به‌طور پیش‌فرض تنظیم می‌شود و قابل تغییر است.
4. منطقه زمانی. منطقه زمانی برای زمان‌بندی سفارش و تسویه حساب را انتخاب کنید.
5. روی ایجاد کافه کلیک کنید.

نتیجه مورد انتظار: جادوگر بسته می‌شود و فضای کاری کافه‌تریا باز می‌شود. URL عمومی شما handy.cafe/{slug} اکنون فعال است، اگرچه منو خالی است.

مرحله ۳: تکمیل پروفایل کسب‌وکار

1. همچنان در تنظیمات > کافه‌تریا، به بخش پروفایل کسب‌وکار بروید.
2. یک لوگو (تصویر مربعی) بارگذاری کنید.
3. یک تصویر سربرگ (بنر عریض) بارگذاری کنید.
4. آدرس و تلفن را برای نمایش در پایین منوی مشتری وارد کنید.
5. نمایش زمان آماده‌سازی در منو را بسته به اینکه آیا می‌خواهید مشتریان زمان‌های تخمینی آماده‌سازی را ببینند یا خیر، روشن یا خاموش کنید.
6. روی ذخیره کلیک کنید.

نتیجه مورد انتظار: لوگو و سربرگ در پیش‌نمایش ظاهر می‌شوند. بازدید از handy.cafe/{slug} در مرورگر اکنون سربرگ برند شده را نشان می‌دهد اما محتوا همچنان خالی است.

مرحله ۴: ایجاد طبقات

1. در تنظیمات > کافه‌تریا، بخش طبقات را پیدا کنید.
2. روی افزودن طبقه کلیک کنید و نامی برای آن انتخاب کنید (به عنوان مثال "سالن اصلی").
3. اگر مکان شما دارای مناطق متعددی است، طبقات اضافی اضافه کنید (به عنوان مثال "نیم‌طبقه"، "پاسیوی بیرونی").
4. طبقات را با دکمه‌های جابجایی بالا و پایین مرتب کنید. طبقه بالا به‌طور پیش‌فرض در ویرایشگر نقشه طبقات قرار می‌گیرد.

نتیجه مورد انتظار: طبقات شما در لیست ظاهر می‌شوند. برگه کافه‌تریا > نقشه طبقات اکنون قرص‌های طبقات را در بالا نشان می‌دهد.

مرحله ۵: ساخت نقشه طبقات

1. کافه‌تریا > نقشه طبقات را باز کنید.
2. اولین طبقه را از قرص‌ها انتخاب کنید.
3. روی افزودن میز کلیک کنید. یک میز مربعی در مبدأ بوم ظاهر می‌شود.
4. میز را به موقعیت دلخواه بکشید. رها کنید تا ذخیره شود.
5. روی میز کلیک کنید تا پانل ویژگی‌های آن باز شود. پیکربندی کنید:
   • کد (به عنوان مثال "T1"، "پنجره ۳").
   • نام نمایش (برچسب طولانی‌تر اختیاری).
   • تعداد صندلی‌ها.
   • شکل (مربع، مستطیل افقی، مستطیل عمودی یا گرد).
   • اندازه (۱ تا ۱۰).
6. برای هر میز در طبقه تکرار کنید.
7. به‌صورت اختیاری به نمای ۳D بروید تا چیدمان را از دیدگاه معمار بررسی کنید.

نتیجه مورد انتظار: نقشه طبقات شما تمام میزها را در موقعیت‌های واقعی خود رندر می‌کند. کشیدن در نمای ۳D غیرفعال است؛ برای جابجایی میزها به ۲D برگردید.

مرحله ۶: ساخت منو

1. کافه‌تریا > منو را باز کنید.
2. روی افزودن دسته‌بندی کلیک کنید. نامی وارد کنید و یک آیکون MDI از انتخابگر آیکون انتخاب کنید. روی ذخیره کلیک کنید.
3. برای هر دسته‌بندی تکرار کنید (به عنوان مثال "نوشیدنی‌های گرم"، "نوشیدنی‌های سرد"، "برگرها"، "دسرها").
4. درون یک دسته‌بندی، روی افزودن محصول کلیک کنید. وارد کنید:
   • نام.
   • توضیحات (پشتیبانی از Markdown).
   • خط مواد اولیه.
   • قیمت پایه.
   • نرخ مالیات بر ارزش افزوده.
   • زمان آماده‌سازی (پیش‌فرض ثابت).
   • اختیاری: برچسب واحد، پرچم پیگیری موجودی، تعداد موجود در انبار.
5. یک عکس محصول بارگذاری کنید. هر فرمتی پذیرفته می‌شود؛ WebP تا ۲ مگابایت توصیه می‌شود.
6. روی ذخیره کلیک کنید.
7. اگر محصول دارای انتخاب‌هایی است، به بخش واریانت‌ها بروید و روی افزودن واریانت کلیک کنید. برای هر گزینه با تغییر قیمت آن یک ردیف ایجاد کنید. ضروری را روشن کنید اگر مشتری باید یکی را انتخاب کند.
8. برای هر محصول در منوی خود تکرار کنید.

نتیجه مورد انتظار: منوی مشتری در handy.cafe/{slug} اکنون دسته‌بندی‌ها و محصولات شما را نشان می‌دهد. برای تأیید به آن در مرورگر مراجعه کنید.

مرحله ۷: پیکربندی چاپگر (اختیاری)

1. همچنان در تنظیمات > کافه‌تریا، به تنظیمات چاپگر بروید.
2. نوع را به TCP تنظیم کنید.
3. IP و پورت چاپگر را وارد کنید. اکثر چاپگرهای ESC POS TCP روی پورت 9100 گوش می‌دهند.
4. برش خودکار را فعال کنید اگر چاپگر از آن پشتیبانی می‌کند.
5. چاپ خودکار در سفارش جدید را فعال کنید تا برای هر سفارش ورودی یک چاپ انجام شود.
6. اعلان صوتی را برای هشدار صوتی همراه با اعلان دسکتاپ فعال کنید.
7. روی چاپ آزمایشی کلیک کنید. یک رسید نمونه باید در عرض چند ثانیه چاپ شود.

نتیجه مورد انتظار: رسید آزمایشی با موفقیت چاپ می‌شود. اگر چیزی چاپ نمی‌شود، IP، پورت و اینکه چاپگر در همان شبکه محلی با سرور است را بررسی کنید.

مرحله ۸: نشستن در میز و گرفتن سفارش آزمایشی

1. کافه‌تریا > میزها را باز کنید (یا از منوی اقدام نقشه طبقات استفاده کنید).
2. یک میز را انتخاب کنید و روی نشستن مشتری کلیک کنید (همچنین با برچسب "باز کردن میز").
3. کد امنیتی ۶ رقمی نمایش داده شده را یادداشت کنید یا دیالوگ را باز بگذارید.
4. روی یک گوشی، به handy.cafe/{slug}/{table-code} بروید. همچنین می‌توانید QR را اسکن کنید اگر برچسب چاپی دارید.
5. کد ۶ رقمی را وارد کنید.
6. منو را مرور کنید و یک آیتم به سبد خرید اضافه کنید.
7. به مرحله پرداخت بروید. نقدی را به عنوان روش پرداخت انتخاب کنید (راه‌اندازی Stripe اختیاری است و می‌تواند بعداً اضافه شود).
8. سفارش را ارسال کنید.
9. در سرور، به کافه‌تریا > سفارش‌ها بروید.

نتیجه مورد انتظار: در عرض ۳ ثانیه، یک کارت سفارش جدید در داشبورد سفارش‌ها ظاهر می‌شود. یک اعلان دسکتاپ فعال می‌شود. یک هشدار صوتی پخش می‌شود اگر اعلان‌های صوتی فعال باشند. نشانگر تعداد در حال انتظار در برگه سفارش‌ها افزایش می‌یابد.

مرحله ۹: پیشرفت و تسویه سفارش آزمایشی

1. روی کارت سفارش، روی دکمه وضعیت بعدی کلیک کنید. سفارش از ثبت شده به تأیید شده منتقل می‌شود.
2. با کلیک کردن ادامه دهید تا از در حال آماده‌سازی، آماده و سرو شده عبور کنید.
3. در صفحه میزها، همان میز را باز کنید و روی تسویه حساب کلیک کنید.
4. نقدی را به عنوان روش پرداخت انتخاب کنید و تأیید کنید.

نتیجه مورد انتظار: میز به بیکار برمی‌گردد. کد امنیتی منقضی می‌شود. یک رکورد تسویه ایجاد می‌شود و می‌تواند بعداً بررسی شود.

اشتباهات رایج برای اجتناب

• رد کردن پروفایل کسب‌وکار. مشتریان نام نمایش پیش‌فرض و ناحیه لوگوی خراب را می‌بینند اگر قبل از ذخیره پروفایل راه‌اندازی کنید.
• عدم چاپ مجدد کدهای QR پس از تغییر slug. تغییر slug هر QR موجود را نامعتبر می‌کند. برچسب‌های جدید چاپ کنید و روی هر میز جایگزین کنید.
• انتشار بیش از حد دسته‌بندی‌ها در هنگام راه‌اندازی. هدف ۶ تا ۱۰ دسته‌بندی سطح بالا باشد. مشتریان سریع‌تر مرور می‌کنند وقتی منو در صفحه جا می‌شود.
• فراموش کردن پیکربندی چاپگر قبل از اولین شیفت واقعی. بدون چاپ خودکار در سفارش جدید، کارکنان ممکن است در دوره شلوغ سفارش‌ها را از دست بدهند. همیشه حداقل یک چاپ آزمایشی انجام دهید.
• رها کردن نمایش زمان آماده‌سازی پیش‌فرض در منو با تاریخچه پویا غیرفعال. برای ۳۰ روز اول مقدار ثابت چیزی است که مشتریان می‌بینند. زمان‌های ثابت واقعی تنظیم کنید یا تراشه را تا زمانی که تخمین پویا آموزش دیده است غیرفعال کنید.
• استفاده از همان دستگاه برای آزمایش کارکنان و مشتریان. جلسه مشتری برای ۲۴ ساعت باقی می‌ماند؛ اگر دستگاه آزمایشی شما بعداً به مشتری داده شود، آن‌ها بدون تأیید قبلاً در منو خواهند بود. دستگاه را پاک کنید یا از پروفایل مرورگر تمیز برای آزمایش‌ها استفاده کنید.