HandyCafe Docs
owner it-admin

کیفے ٹیریا کیسے سیٹ اپ کریں

یہ گائیڈ کیفے ٹیریا ماڈیول کی پہلی بار مکمل سیٹ اپ کے عمل کو بیان کرتی ہے۔ آخر میں آپ کے پاس handy.cafe/{your-slug} پر ایک شائع شدہ کسٹمر مینو ہوگا، ایک فلور پلان جس میں کم از کم ایک کام کرنے والی میز ہوگی، مصنوعات کے ساتھ ایک مینو ہوگا، اور ایک کامیاب ٹیسٹ آرڈر ہوگا۔

آپ کو کیا چاہیے ہوگا

  • ایک فعال HandyCafe لائسنس۔ کیفے ٹیریا کی توثیق خودکار طور پر لائسنس استعمال کرتی ہے؛ آپ کو دستی طور پر کوئی کلید پیسٹ نہیں کرنی۔
  • سرور پر انٹرنیٹ کنیکٹیویٹی۔ کیفے ٹیریا کلاؤڈ-فرسٹ ہے، لہذا پروویژننگ، مینو سنک، اور آرڈر پولنگ سب کو کلاؤڈ API تک آؤٹ باؤنڈ رسائی کی ضرورت ہوتی ہے۔
  • ایک سلیگ جو آپ عوامی مینو URL کے لئے استعمال کرنا چاہتے ہیں۔ اجازت شدہ حروف چھوٹے حروف، نمبر، اور ڈیشز ہیں۔ لمبائی 3 سے 62 حروف تک ہے۔
  • اختیاری: ایک لوگو اور ہیڈر امیج۔ تجویز کردہ فارمیٹ WebP ہے جو 2 MB تک ہو۔
  • اختیاری: ایک TCP رسید پرنٹر جو مقامی نیٹ ورک پر ہو۔

مرحلہ 1: کیفے ٹیریا کو فعال کریں

  1. HandyCafe سرور کھولیں۔
  2. سائیڈبار میں Settings پر جائیں۔
  3. کیفیٹیریا ٹیب کھولیں۔
  4. Enable کیفیٹیریا کو آن کریں۔
  5. سرور آپ کے لائسنس کو توثیق ٹوکن کے طور پر استعمال کرتے ہوئے کلاؤڈ API سے رابطہ کرتا ہے۔ اگر کامیاب ہو تو پروویژننگ وزارڈ کھلتا ہے۔

متوقع نتیجہ: پروویژننگ وزارڈ اسکرین ظاہر ہوتی ہے۔ اگر آپ کو لائسنس یا کنیکٹیویٹی کے بارے میں کوئی خرابی نظر آتی ہے تو اپنے انٹرنیٹ کنکشن کو چیک کریں اور اپنے HandyCafe لائسنس کی تصدیق کریں۔


مرحلہ 2: اپنا کیفے پروویژن کریں

وزارڈ چار فیلڈز مانگتا ہے۔

  1. Slug. اپنی مطلوبہ URL لاحقہ ٹائپ کریں۔ دستیابی کا اشارہ ایک سیکنڈ کے اندر اپ ڈیٹ ہوتا ہے۔ اگر سلیگ لیا گیا یا محفوظ ہے تو کوئی دوسرا منتخب کریں۔
  2. Display Name. کسٹمر مینو کے اوپر دکھایا جانے والا انسانی قابل پڑھائی نام، مثلاً "Atilla's Gaming Lounge"۔
  3. Country and Currency. اس ملک کا انتخاب کریں جہاں کیفے کام کرتا ہے۔ کرنسی ملک کی بنیاد پر ڈیفالٹ ہوتی ہے اور تبدیل کی جا سکتی ہے۔
  4. Timezone. آرڈر اور سیٹلمنٹ ٹائم اسٹامپ کے لئے ٹائم زون منتخب کریں۔
  5. Create Cafe پر کلک کریں۔

متوقع نتیجہ: وزارڈ بند ہو جاتا ہے اور کیفے ٹیریا ورک اسپیس کھلتا ہے۔ آپ کا عوامی URL handy.cafe/{slug} اب لائیو ہے، حالانکہ مینو خالی ہے۔


مرحلہ 3: بزنس پروفائل مکمل کریں

  1. اب بھی Settings > کیفیٹیریا کے تحت، بزنس پروفائل سیکشن تک سکرول کریں۔
  2. ایک Logo (مربع تصویر) اپ لوڈ کریں۔
  3. ایک Header Image (وسیع بینر) اپ لوڈ کریں۔
  4. Address اور Phone درج کریں تاکہ کسٹمر مینو کے فوٹر میں دکھایا جا سکے۔
  5. Show Prep Time on Menu کو آن یا آف کریں اس پر منحصر ہے کہ آپ چاہتے ہیں کہ کسٹمرز کو متوقع تیاری کے اوقات نظر آئیں۔
  6. Save پر کلک کریں۔

متوقع نتیجہ: لوگو اور ہیڈر پیش نظارہ میں ظاہر ہوتے ہیں۔ براؤزر میں handy.cafe/{slug} پر جانے سے اب برانڈڈ ہیڈر نظر آتا ہے لیکن مواد ابھی بھی خالی ہے۔


مرحلہ 4: فلورز بنائیں

  1. Settings > کیفیٹیریا میں، فلورز سیکشن تلاش کریں۔
  2. Add Floor پر کلک کریں اور اسے نام دیں (مثلاً "Main Hall")۔
  3. اضافی فلورز شامل کریں اگر آپ کے مقام پر متعدد علاقے ہیں (مثلاً "Mezzanine"، "Outdoor Patio")۔
  4. فلورز کو اوپر نیچے کرنے کے بٹنوں کے ساتھ دوبارہ ترتیب دیں۔ فلور پلان ایڈیٹر میں سب سے اوپر والا فلور ڈیفالٹ بن جاتا ہے۔

متوقع نتیجہ: آپ کے فلورز فہرست میں ظاہر ہوتے ہیں۔ کیفے ٹیریا > فلور پلان ٹیب اب فلور پلز کو اوپر دکھاتا ہے۔


مرحلہ 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 > کیفیٹیریا کے تحت، پرنٹر سیٹنگز تک سکرول کریں۔
  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 کھولیں (یا فلور پلان ایکشن مینو استعمال کریں)۔
  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. Tables صفحہ پر، اسی میز کو کھولیں اور Settle Check پر کلک کریں۔
  4. Cash کو ادائیگی کے طریقہ کے طور پر منتخب کریں اور تصدیق کریں۔

متوقع نتیجہ: میز idle پر واپس آتی ہے۔ سیکیورٹی کوڈ ختم ہو جاتا ہے۔ ایک سیٹلمنٹ ریکارڈ بنایا جاتا ہے اور بعد میں آڈٹ کیا جا سکتا ہے۔


عام غلطیوں سے بچیں

  • بزنس پروفائل کو چھوڑ دینا۔ اگر آپ پروفائل کو محفوظ کرنے سے پہلے لانچ کرتے ہیں تو کسٹمرز کو ڈیفالٹ ڈسپلے نام اور ایک ٹوٹا ہوا لوگو ایریا نظر آتا ہے۔
  • سلیگ تبدیلیوں کے بعد QR کوڈز کو دوبارہ پرنٹ نہ کرنا۔ سلیگ کو تبدیل کرنے سے ہر موجودہ QR غیر فعال ہو جاتا ہے۔ نئے اسٹیکرز پرنٹ کریں اور ہر میز پر تبدیل کریں۔
  • لانچ پر بہت زیادہ زمرے شائع کرنا۔ 6 سے 10 ٹاپ لیول زمرے کا ہدف رکھیں۔ کسٹمرز تیزی سے براؤز کرتے ہیں جب مینو اسکرین پر فٹ ہوتا ہے۔
  • پہلی حقیقی شفٹ سے پہلے پرنٹر کو کنفیگر کرنا بھول جانا۔ بغیر Auto Print on New Order کے، عملہ مصروف دورانیے میں آرڈرز کو نظر انداز کر سکتا ہے۔ ہمیشہ کم از کم ایک ٹیسٹ پرنٹ چلائیں۔
  • پہلے 30 دنوں کے لئے جامد ویلیو کو فعال چھوڑ دینا۔ جامد ویلیو وہی ہے جو کسٹمرز دیکھتے ہیں۔ حقیقت پسندانہ جامد اوقات سیٹ کریں یا چپ کو غیر فعال کریں جب تک کہ متحرک تخمینہ تربیت یافتہ نہ ہو۔
  • عملے اور کسٹمر ٹیسٹنگ کے لئے ایک ہی ڈیوائس کا استعمال۔ کسٹمر سیشن 24 گھنٹے کے لئے برقرار رہتا ہے؛ اگر آپ کا ٹیسٹ ڈیوائس بعد میں کسٹمر کو دیا گیا تو وہ پہلے ہی مینو پر ہوں گے بغیر تصدیق کے۔ ڈیوائس کو صاف کریں یا ٹیسٹ کے لئے ایک صاف براؤزر پروفائل استعمال کریں۔