HandyCafe Docs
owner

مینو مینجمنٹ

کیفیٹیریا کے تحت Menu ٹیب وہ جگہ ہے جہاں آپ وہ catalog بناتے ہیں جو کسٹمر handy.cafe/{slug} پر دیکھتے ہیں۔ مینو کیٹیگریز اور پروڈکٹس پر مشتمل ہوتا ہے۔ پروڈکٹس میں Size یا Toppings جیسے انتخاب کے لیے variant groups ہو سکتے ہیں۔

ساخت

سطح مقصد
Category مینو کا ایک حصہ، مثلاً "Hot Drinks" یا "Burgers"۔ ہر کیٹیگری کے ساتھ ایک آئیکن اور sort order ہوتا ہے۔
Product کیٹیگری کے اندر ایک واحد قابلِ آرڈر آئٹم۔ اس میں نام، وضاحت، تصویر، قیمت، VAT شرح، اور تیاری کا وقت شامل ہوتا ہے۔
Variant Group اختیاری۔ پروڈکٹ کے ساتھ منسلک انتخابی سیٹ، مثلاً "Size: Small, Medium, Large"۔ ہر variant کی قیمت میں اضافہ ہوتا ہے۔

Categories

ہر category میں درج ذیل فیلڈز ہوتے ہیں:

فیلڈ مطلب
Name کسٹمر مینو پر سیکشن ہیڈر کے طور پر دکھایا جاتا ہے۔
Icon ایک MDI (Material Design Icons) نام۔ icon picker سے منتخب کریں۔
Sort Order عدد۔ چھوٹے نمبر پہلے آتے ہیں۔ drag یا move-up/move-down controls سے ترتیب بدلیں۔
Active بند ہونے پر category اور اس کے تمام products کسٹمر مینو سے چھپ جاتے ہیں مگر حذف نہیں ہوتے۔

Category شامل کرنا

  1. کیفیٹیریا > Menu کھولیں۔
  2. Add Category پر کلک کریں۔
  3. ایک نام درج کریں۔
  4. icon box پر کلک کریں اور ایک MDI icon منتخب کریں۔ picker میں searchable فہرست کھلتی ہے۔ "coffee"، "burger"، یا "pizza" جیسے keywords آزما سکتے ہیں۔
  5. Save کریں۔ category menu editor میں ظاہر ہو جائے گی۔

Categories کی ترتیب بدلنا

Category row پر موجود handle گھسیٹ کر اسے منتقل کریں۔ چھوڑتے ہی نئی جگہ محفوظ ہو جاتی ہے۔ درست جگہ کے لیے move-up اور move-down arrows بھی استعمال کیے جا سکتے ہیں۔

نرم حذف

جن category کے ساتھ dependent products ہوں، انہیں حذف کرنے پر record مٹانے کے بجائے category کو inactive نشان زد کیا جاتا ہے۔ اس سے اصل product IDs سے منسلک order history محفوظ رہتی ہے۔ بحال کرنے کے لیے admin UI سے category دوبارہ فعال کریں۔

Products

ہر product میں درج ذیل فیلڈز ہوتے ہیں:

فیلڈ مطلب
Category والد category۔
Name کسٹمر کو دکھائی دیتا ہے۔
Description مارک ڈاؤن معاون ہے۔ کسٹمر کے آئٹم پر tap کرنے پر product detail sheet میں نظر آتی ہے۔
Ingredients وضاحت کے نیچے مختصر لائن۔ allergens یا ingredient highlights کے لیے استعمال کریں۔
Base Price variants سے پہلے قیمت۔ minor units میں محفوظ ہوتی ہے، مثلاً cents، مگر پورے currency units میں درج کی جاتی ہے۔
VAT Rate فیصد۔ کسٹمر رسید پر totals دکھاتے وقت لاگو ہوتی ہے۔
Unit اختیاری لیبل جیسے "ml" یا "g"۔ قیمت کے ساتھ دکھائی دیتا ہے۔
Photo پروڈکٹ تصویر۔ کوئی بھی فارمیٹ قبول ہے۔ تیز ترین لوڈ کے لیے 2 MB تک WebP تجویز کیا جاتا ہے۔
Track Stock فعال ہونے پر پروڈکٹ کے پاس موجود اسٹاک quantity ہوتی ہے جو ہر آرڈر پر کم ہوتی ہے۔
In Stock موجودہ اسٹاک گنتی۔ جب اسٹاک صفر ہو جائے تو کسٹمر کے لیے آرڈر ناکام ہو جاتا ہے اور پروڈکٹ خود بخود چھپ جاتی ہے۔
Active بند ہونے پر پروڈکٹ کسٹمر مینو سے چھپ جاتی ہے۔
Sort Order category کے اندر ترتیب۔
Preparation Time منٹوں میں static fallback اندازہ۔ نیچے Dynamic Preparation Time دیکھیں۔

Photo اپ لوڈ کرنا

  1. پروڈکٹ کھولیں۔
  2. photo area پر کلک کریں۔
  3. اپنے کمپیوٹر سے ایک تصویر منتخب کریں۔ upload endpoint کوئی بھی format قبول کرتا ہے۔
  4. سرور فائل process کرتا ہے، asset ID، MIME type، اور checksum محفوظ کرتا ہے، اور URL واپس کرتا ہے۔
  5. تصویر فوراً editor اور کسٹمر مینو پر چند سیکنڈ میں دکھائی دینے لگتی ہے۔

موجودہ تصویر پر کلک کر کے اور نئی فائل اپ لوڈ کر کے تصویر بدلیں۔ پرانی فائل کی جگہ نئی آ جاتی ہے۔

وضاحتوں میں مارک ڈاؤن

Product descriptions مارک ڈاؤن سپورٹ کرتی ہیں۔ عام استعمال:

  • **strong** کے ساتھ bold highlights۔
  • متعدد سطروں والی وضاحتوں کے لیے line breaks۔
  • اجزاء یا pairing کے لیے مختصر فہرستیں۔

Product descriptions میں headings (H1 سے H6) سے پرہیز کریں۔ کسٹمر مینو وضاحت کو محدود sheet میں render کرتا ہے اور headings غیر موزوں لگتی ہیں۔

Variant Groups

Variants وہ کسٹمر انتخاب ہیں جو قیمت یا ترتیب بدلتے ہیں۔ ایک product میں کئی variant groups ہو سکتے ہیں، مثلاً ایک ہی burger پر Size اور Toppings۔

ہر variant میں یہ فیلڈز ہوتے ہیں:

فیلڈ مطلب
Name کسٹمر کے سامنے آنے والا لیبل، مثلاً "Size" یا "Extra Cheese"۔
Price Delta جب یہ variant منتخب ہو تو base price میں جتنی رقم شامل ہو۔ صفر یا منفی بھی ہو سکتی ہے۔
Required فعال ہونے پر کسٹمر کو cart میں شامل کرنے سے پہلے اس group سے کم از کم ایک variant منتخب کرنا ہوگا۔
Sort Order group کے اندر ترتیب۔

Variant Group بنانا

  1. پروڈکٹ کھولیں۔
  2. Variants حصے تک سکرول کریں۔
  3. Add Variant پر کلک کریں۔
  4. نام اور price delta درج کریں۔ اگر انتخاب لازمی ہو تو Required فعال کریں۔
  5. Save کریں۔

گروپ کے ہر اختیار کے لیے یہی عمل دہرائیں۔ عام "Size" group میں تین rows ہوتی ہیں: Small کے لیے delta 0، Medium کے لیے +1.00، اور Large کے لیے +2.00۔

Dynamic Preparation Time

HandyCafe حقیقی kitchen performance کی بنیاد پر ہر product کے لیے real-time تیاری کا وقت اندازہ کر سکتا ہے۔ اس سے کسٹمر مینو اور فعال آرڈرز پر دکھائے جانے والے estimate chip کی درستگی بہتر ہوتی ہے۔

Setting اثر
Static Time پروڈکٹ پر محفوظ ہوتا ہے۔ اس وقت استعمال ہوتا ہے جب dynamic value نکالنے کے لیے کافی تاریخچہ موجود نہ ہو۔
Dynamic Estimate پچھلے 30 دن کے order history سے نکالا جاتا ہے۔ فی پروڈکٹ اوسط تیاری کا وقت current queue length سے حاصل ہونے والے busy-factor سے ضرب دیا جاتا ہے۔ multiplier 1.0 اور 2.0 کے درمیان محدود رہتا ہے۔ حتمی قدر 1 سے 120 منٹ کے درمیان محدود رہتی ہے۔

Business profile میں "Show Prep Time on Menu" setting طے کرتی ہے کہ estimate chip کسٹمرز کو نظر آئے گی یا نہیں۔ عملہ Orders dashboard پر یہ اندازہ ہمیشہ دیکھتا ہے۔

Stock Tracking

جو items ختم ہو چکے ہوں انہیں بیچنے سے بچنے کے لیے فی product Track Stock فعال کریں۔

  • جب آرڈر دیا جاتا ہے تو stock count آرڈر شدہ quantity کے مطابق کم ہو جاتا ہے۔
  • جب stock صفر ہو جائے تو پروڈکٹ خود بخود کسٹمر مینو سے چھپ جاتی ہے جب تک آپ count اپڈیٹ نہ کریں۔
  • Restock کرنے کے لیے پروڈکٹ میں جا کر نیا In Stock value درج کریں۔

Track Stock کے بغیر پروڈکٹس لامحدود inventory کی طرح برتاؤ کرتی ہیں اور خود بخود نہیں چھپتیں۔

ایک category کے اندر products کی ترتیب بدلنا

Product کو اوپر یا نیچے منتقل کرنے کے لیے handle گھسیٹیں۔ چھوڑتے ہی نیا sort order محفوظ ہو جاتا ہے۔ کسٹمر مینو اگلی menu refresh کے بعد نئی ترتیب دکھاتا ہے، اور یہ ہر session load پر ہوتا ہے۔

مشورے

  • 6 سے 10 categories سے شروع کریں۔ بہت زیادہ categories کسٹمر مینو کو براؤز کرنے میں سست بنا دیتی ہیں۔
  • زیادہ contrast اور اچھی روشنی والی تصاویر استعمال کریں۔ مدھم یا شور زدہ تصاویر آرڈر conversion کم کرتی ہیں۔
  • ممکن ہو تو وضاحتیں 120 حروف کے اندر رکھیں۔ لمبی وضاحتیں فون پر پہلے اسکرین سے Add to Cart بٹن نیچے دھکیل دیتی ہیں۔
  • حقیقت پسندانہ static preparation times مقرر کریں۔ dynamic system کو سیکھنے میں 30 دن لگتے ہیں۔ اس وقت تک جو static number دکھتا ہے وہی کسٹمر دیکھتے ہیں۔
  • زیادہ انتخاب والے items کو ایک بہت بڑی فہرست کے بجائے دو variant groups میں تقسیم کریں۔ "Size" اور "Milk" الگ ہونا "Size with Milk" سے بہتر ہے۔