مائی مائی بچت اسسٹنٹ ٹیوٹوریل: میک ڈونلڈز MCP کے ذریعے آرڈر بہتر بنائیں اور کوپن کے نقصانات کا آڈٹ کریں

پروجیکٹ کا تعارف

مائی مائی بچت اسسٹنٹ (mcd-coupon-strategist) میک ڈونلڈز چین MCP پر مبنی آرڈر لاگت کا اسسٹنٹ ہے۔ یہ صرف اس سوال کا جواب نہیں دیتا کہ “اس آرڈر کو سب سے کم خرچ میں کیسے دیا جائے”، بلکہ سابقہ آرڈرز اور دستیاب کوپن کا تجزیہ کرکے یہ بھی بتاتا ہے کہ کون سی جلد ختم ہونے والی رعایتیں حقیقی نقصان میں بدل رہی ہیں۔

یہ پروجیکٹ بچت کے مسئلے کو دو سلسلوں میں تقسیم کرتا ہے:

• قلیل مدتی بہتری: موجودہ اسٹور کا مینو اور اکاؤنٹ میں دستیاب کوپن پڑھ کر انفرادی اشیا، کومبو، کوپن کے استعمال اور اضافی خریداری کے منصوبے بناتا ہے، پھر calculate-price کے ذریعے ہر منصوبے کی حقیقی قیمت حاصل کرتا ہے۔
• طویل مدتی آڈٹ: اخراجات، فی آرڈر اوسط خرچ، کثرت سے خریدی جانے والی اشیا اور جلد ختم ہونے والے کوپن کا تجزیہ کرنے کے لیے order-list اور query-my-coupons استعمال کرتا ہے۔

پروجیکٹ کا بنیادی نقطۂ نظر صارف کو محض مزید خرچ کرنے میں مدد دینا نہیں، بلکہ پہلے سے ہونے والے نقصان کی نشاندہی کرنا ہے۔

اہم خصوصیات اور طریقۂ کار

موجودہ اسٹور کی حقیقی قیمت کے مطابق حساب

مختلف اسٹورز میں قیمتیں اور دستیابی مختلف ہو سکتی ہے، اس لیے پروجیکٹ مینو کی قیمتیں پہلے سے درج نہیں کرتا۔ ہر امیدوار منصوبہ MCP کے calculate-price کو دے کر قیمت معلوم کرتا ہے، ماڈل سے رقم کا اندازہ نہیں لگوایا جاتا۔

نتیجے میں صرف کم ترین قابلِ ادائیگی رقم نہیں ہوتی، بلکہ یہ بھی بتایا جاتا ہے کہ قیمت کا فرق کومبو کی ساخت، کوپن یا اضافی خریداری کی وجہ سے ہے۔ مثال کے طور پر، تین اشیا کا کومبو الگ الگ برگر اور فرائز خریدنے سے سستا ہو سکتا ہے۔ ایسی صورت میں نظام واضح طور پر کومبو تجویز کرتا ہے اور بچت کی رقم بھی بتاتا ہے۔

اضافی خریداری کے جال کی شناخت

کوپن استعمال کرنے سے ہر بار زیادہ بچت نہیں ہوتی۔ فرض کریں اصل منصوبے میں 46.5 یوآن کی اشیا خریدنی تھیں۔ “50 سے زیادہ پر 12 کی رعایت” حاصل کرنے کے لیے 3.5 یوآن کی ایک اضافی چیز شامل کی گئی اور کوپن کے بعد ادائیگی 38 یوآن بنی؛ اگر اسی نوعیت کا کومبو صرف 33.5 یوآن کا ہو، تو اضافی خریداری والا منصوبہ اب بھی 4.5 یوآن مہنگا ہے۔

پروجیکٹ کوپن پر درج رعایت کی رقم کے بجائے آخری قابلِ ادائیگی رقم کا موازنہ کرتا ہے۔ اگر اضافی چیز کی صارف کو پہلے سے ضرورت نہ ہو تو ایسا منصوبہ اختیار نہ کرنے کا مشورہ دیا جاتا ہے۔

کوپن کی پوشیدہ لاگت کا حساب

“کوپن کی پوشیدہ لاگت” سے مراد وہ رعایت ہے جو جلد ختم ہونے والی ہو مگر ابھی استعمال نہ ہوئی ہو۔ چونکہ MCP سے ملنے والے کوپن میں کبھی صرف نام ہوتا ہے، اس لیے پروجیکٹ موجودہ اسٹور کے مینو سے ان کی قدر معلوم کرتا ہے:

• کم از کم خرچ پر رعایت والا کوپن: “50 سے زیادہ پر 12 کی رعایت” کو براہِ راست 12 یوآن شمار کیا جاتا ہے۔
• ایک خریدیں، ایک مفت کوپن: “درمیانے فرائز خریدیں، ایک مفت حاصل کریں” کو متعلقہ شے کی مینو قیمت کے مطابق شمار کیا جاتا ہے۔
• مقررہ قیمت والا کوپن: “9.9 یوآن کا درمیانہ آئسڈ امریکنو” مینو کی اصل قیمت میں سے 9.9 یوآن گھٹا کر شمار کیا جاتا ہے۔

اگر مینو میں متعلقہ شے نہ ملے تو پروجیکٹ کوپن کی قدر 0 شمار کرتا ہے اور رپورٹ میں نشان زد کرتا ہے۔ یہ بے بنیاد مگر بظاہر مناسب تخمینہ درج نہیں کرتا۔

طویل مدتی خرچ کرنے کی عادات کا تجزیہ

آڈٹ ماڈیول سابقہ آرڈرز سے آرڈرز کی تعداد، کل خرچ، فی آرڈر اوسط خرچ اور کثرت سے خریدی جانے والی اشیا کا خلاصہ بنا کر ساختی تجاویز دے سکتا ہے۔ مثال کے طور پر، اگر ایک ہی برگر کئی بار الگ سے خریدا گیا ہو تو نظام متعلقہ کومبو سے موازنہ کرنے کا مشورہ دے سکتا ہے، کیونکہ ہر بار کومبو میں تبدیل کرنے سے عموماً خرچ کم ہو سکتا ہے۔ مکمل رقم واپس کیے گئے آرڈرز کو فلٹر کر دیا جاتا ہے تاکہ انہیں خرچ میں شامل نہ کیا جائے۔

تیاری

آن لائن MCP خصوصیات استعمال کرنے سے پہلے درج ذیل ماحول تیار کریں:

• ایسا کلائنٹ جو MCP کسٹم کنیکٹرز کو سپورٹ کرتا ہو، مثلاً README میں دکھایا گیا WorkBuddy۔
• میک ڈونلڈز MCP اوپن پلیٹ فارم سے حاصل کردہ Token۔
• اگر مقامی ٹیسٹ چلانے ہوں تو Python 3.8 یا اس کے بعد کا ورژن۔

مقامی چاروں ٹیسٹس کے لیے MCP Token درکار نہیں؛ تاہم حقیقی مینو، اکاؤنٹ کے کوپن اور سابقہ آرڈرز دیکھنے کے لیے مؤثر Token ضروری ہے۔

MCP Token حاصل کرنا اور ترتیب دینا

پہلا مرحلہ: Token حاصل کریں

میک ڈونلڈز MCP اوپن پلیٹ فارم پر جائیں، موبائل نمبر سے لاگ اِن کریں، کنسول میں MCP Token فعال کرکے اسے کاپی کریں۔

دوسرا مرحلہ: MCP کنفیگریشن بنائیں

ریپوزٹری میں غیر حساس کنفیگریشن فائل mcp-config.example.json موجود ہے۔ کنفیگریشن کی ساخت یہ ہے:

{
  "mcpServers": {
    "mcd-mcp": {
      "type": "streamablehttp",
      "url": "https://mcp.mcd.cn",
      "headers": {
        "Authorization": "Bearer ${MCD_MCP_TOKEN}"
      }
    }
  }
}

${MCD_MCP_TOKEN} کو اپنے Token سے تبدیل کرکے MCP Client کی کنفیگریشن میں لکھیں۔ حقیقی Token کو عوامی ریپوزٹری میں جمع نہ کریں، اور اسکرین شاٹس، لاگز یا مسئلے کی رپورٹ میں بھی ظاہر نہ کریں۔

تیسرا مرحلہ: WorkBuddy میں فعال کریں

1. WorkBuddy کھولیں، بائیں جانب “ماہرین، مہارتیں، کنیکٹرز” میں جاکر “کنیکٹرز” ٹیب منتخب کریں۔
2. “کسٹم کنیکٹر” پر کلک کریں، پھر “MCP ترتیب دیں” منتخب کریں۔
3. Token سے تبدیل شدہ JSON کنفیگریشن پیسٹ کرکے محفوظ کریں۔
4. کسٹم کنیکٹرز کی فہرست پر واپس جائیں اور mcd-mcp کو فعال کریں۔

بنیادی استعمال

مثال 1: بجٹ کے مطابق کومبو تلاش کرنا

پہلے اسٹور منتخب کریں، پھر بجٹ، مطلوبہ کھانے کی اقسام اور موازنے کے منصوبوں کی تعداد واضح کریں۔ براہِ راست یہ پیغام بھیجا جا سکتا ہے:

میں میک ڈونلڈز سے ڈیلیوری آرڈر کر رہا ہوں۔ اسٹور منتخب ہونے کے بعد حساب کریں:
میرے پاس کوپن ہے، ایک برگر + فرائز کی ایک سرونگ + ایک مشروب چاہیے، بجٹ 40 یوآن ہے،
سب سے کم خرچ میں کیسے آرڈر کروں؟ دو منصوبوں کا موازنہ کریں۔

اسسٹنٹ موجودہ اسٹور کا مینو اور دستیاب کوپن پڑھے گا، امیدوار کومبو بنائے گا اور MCP کے ذریعے حقیقی قیمت معلوم کرے گا۔ ایک عام نتیجے میں 33.5 یوآن کا میک اسپائسی چکن برگر تین اشیا کا کومبو تجویز کیا جا سکتا ہے اور اس کا موازنہ 37 یوآن کے الگ برگر اور فرائز والے منصوبے سے کیا جا سکتا ہے۔

مثال 2: مرکزی کھانے اور سائیڈ کی پابندی

بجٹ 35 یوآن ہے، چکن پر مبنی مرکزی کھانا اور ایک سائیڈ چاہیے۔
موجودہ اسٹور میں دستیاب اشیا دیکھ کر تجویز کردہ، متبادل اور ناموزوں منصوبے دیں،
اور بتائیں کہ ہر منصوبہ زیادہ سستا یا مہنگا کیوں ہے۔

ایسی ہدایت اسسٹنٹ کو بجٹ، سیر ہونے کی ضرورت اور اشیا کی قسم کو بیک وقت مدِنظر رکھنے دیتی ہے، تاکہ صرف سب سے کم قیمت مگر ضرورت پوری نہ کرنے والا انتخاب تجویز نہ ہو۔

مثال 3: اضافی خریداری فائدہ مند ہے یا نہیں

میرے پاس “50 سے زیادہ پر 12 کی رعایت” والا کوپن ہے۔
موجودہ خریداری کی ضرورت کے مطابق براہِ راست خریداری، اضافی اشیا شامل کرکے کوپن استعمال کرنے
اور کومبو خریدنے کی آخری قابلِ ادائیگی رقم کا موازنہ کریں۔ اگر اضافی خریداری زیادہ مہنگی ہو
تو مجھے واضح طور پر خبردار کریں۔

موازنے میں آخری قابلِ ادائیگی رقم کو ترجیح دینی چاہیے، نہ کہ کوپن پر درج رعایت کو۔ پروجیکٹ نئی اشیا کی لاگت شامل کرکے حساب کرتا ہے اور بتاتا ہے کہ آیا کومبو اضافی خریداری سے زیادہ فائدہ مند ہے۔

مثال 4: حالیہ اخراجات کا آڈٹ

میرے حالیہ چند ماہ کے میک ڈونلڈز آرڈرز کا تجزیہ کریں:
آرڈرز کی تعداد، کل خرچ اور فی آرڈر اوسط خرچ شمار کریں، اور کثرت سے خریدی جانے والی اشیا تلاش کریں؛
ساتھ ہی جلد ختم ہونے والے کوپن، ان کی متوقع قدر اور باقی دن درج کریں،
آخر میں بتائیں کہ اس ماہ مجھے سب سے پہلے کیا کرنا چاہیے۔

اس سے طویل مدتی آڈٹ کا سلسلہ شروع ہوگا۔ نتیجے میں جلد ختم ہونے والے کوپن کی مجموعی قدر، خرچ کرنے کی عادات اور قابلِ عمل ساختی تجاویز پر توجہ ہوگی، نہ کہ صرف کسی ایک آرڈر کی کم ترین قیمت پر۔

مقامی ٹیسٹ چلانا

پروجیکٹ کا سورس کوڈ حاصل کرنے کے بعد ریپوزٹری کی جڑ میں Python 3.8 یا اس کے بعد کے ورژن سے درج ذیل ٹیسٹس چلائیں:

python src/test_saver.py
python src/test_auditor.py
python src/test_adapter.py
python src/test_order_adapter.py

• test_saver.py: منصوبوں کی فہرست سازی، ترتیب اور اضافی خریداری کے جال کی شناخت کی جانچ کرتا ہے۔
• test_auditor.py: پوشیدہ لاگت، خرچ کرنے کی عادات اور تاریخ کی حدی قدروں کی جانچ کرتا ہے۔
• test_adapter.py: اکائیوں کی تبدیلی اور MCP جواب کی تشریح کی جانچ کرتا ہے۔
• test_order_adapter.py: آرڈرز، کوپن کی تشریح، رقم واپسی کے فلٹر اور کوپن کی قدر کے تخمینے کی جانچ کرتا ہے۔

یہ چاروں ٹیسٹس مکمل طور پر مقامی طور پر چلتے ہیں اور MCP Token کی ضرورت نہیں۔ README میں اضافی پیکیج انسٹالیشن کی کمانڈز درج نہیں، اس لیے ریپوزٹری کے اصل کوڈ اور انٹیگریشن دستاویزات کو ترجیح دیں۔

پروجیکٹ کی ساخت کو سمجھنا

پروجیکٹ ایک ایڈاپٹر پرت کے ذریعے MCP کے خام جوابات اور کاروباری الگورتھمز کو الگ رکھتا ہے۔ اہم ماڈیول یہ ہیں:

• src/saver.py: ایک بار کی بچت کے سلسلے، امیدوار کومبو کی فہرست سازی اور حقیقی قابلِ ادائیگی رقم کے موازنے کا ذمہ دار ہے۔
• src/auditor.py: طویل مدتی آڈٹ، کوپن کی پوشیدہ لاگت اور خرچ کرنے کے پروفائل کی تیاری کا ذمہ دار ہے۔
• src/mcd_adapter.py: فیلڈ میپنگ، رقم واپسی کا فلٹر، کوپن کی قدر کی تلاش اور واحد “سینٹ سے یوآن” تبدیلی کا ذمہ دار ہے۔
• MCP_INTEGRATION.md: MCP Server، ٹولز، کال کے مراحل اور آزمودہ کال کنٹریکٹ درج کرتا ہے۔
• SKILL.md: Skill کی تعریف اور مجموعی ورک فلو بیان کرتا ہے۔

الگورتھم کی پرت براہِ راست خام MCP جواب سے واسطہ نہیں رکھتی، جس سے فیلڈ کے فرق اور رقم کی اکائیوں کی الجھن سے بچنے میں مدد ملتی ہے۔ خاص طور پر یاد رکھیں کہ مختلف انٹرفیسز میں “سینٹ” اور “یوآن” کی سمت مختلف ہو سکتی ہے، اس لیے انہیں ایڈاپٹر پرت کے ذریعے یکساں طور پر سنبھالیں۔

اعلیٰ درجے کے استعمال کی تجاویز

پہلے واضح کریں کہ کیا کھانا ہے، پھر قیمت کا موازنہ کریں

کم ترین قیمت ہمیشہ موزوں منصوبہ نہیں ہوتی۔ ہدایت میں مرکزی کھانا، سائیڈ، مشروب، افراد کی تعداد، بجٹ اور کم از کم ضرورت لکھیں، تاکہ نظام یکساں ضرورت پوری کرنے والے منصوبوں کا موازنہ کرے۔

بچت کی وجہ دکھانے کو کہیں

آپ کہہ سکتے ہیں کہ “کون سا کوپن استعمال ہوا، کون سا کومبو اختیار کیا گیا، کون سی اضافی چیز شامل کی گئی اور بنیادی منصوبے کے مقابلے میں کتنی بچت ہوئی” دکھائیں۔ اس طرح صرف نتیجہ نہیں ملتا بلکہ یہ بھی پرکھا جا سکتا ہے کہ تجویز حقیقی ضرورت کے مطابق ہے یا نہیں۔

کوپن کی درج شدہ قدر اور حقیقی فائدے میں فرق کریں

کسی کوپن کی نظریاتی قدر 12 یوآن ہو سکتی ہے، مگر اس کا مطلب یہ نہیں کہ موجودہ آرڈر میں لازماً 12 یوآن کی بچت ہوگی۔ کم از کم خرچ، قابلِ استعمال اسٹور، دستیاب اشیا اور اضافی خریداری کی لاگت حقیقی فائدہ بدل سکتی ہے۔ کوپن کی درج شدہ قدر اور آخری قابلِ ادائیگی رقم دونوں دیکھیں۔

قریب ختم ہونے والے اور واضح قدر والے کوپن پہلے استعمال کریں

طویل مدتی آڈٹ میں کوپن کو باقی دنوں اور تصدیق شدہ قدر کے مطابق ترتیب دیا جا سکتا ہے۔ جن کوپن کی اصل قیمت مینو سے معلوم نہ ہو سکے انہیں نامعلوم یا 0 کے طور پر نشان زد کرتے رہیں؛ مکمل رپورٹ بنانے کے لیے رقم کا اندازہ نہ لگائیں۔

ہر بار موجودہ اسٹور کا ڈیٹا استعمال کریں

دوسرے اسٹورز یا سابقہ آرڈرز کی قیمتیں دوبارہ استعمال نہ کریں۔ مینو، دستیابی اور کوپن کے قابلِ استعمال دائرے میں تبدیلی آ سکتی ہے، اس لیے ہر فیصلہ موجودہ اسٹور کے سرکاری حقیقی وقت کے نتیجے پر مبنی ہونا چاہیے۔

اکاؤنٹ کی اسناد محفوظ رکھیں

Token محفوظ کرنے کے لیے ہمیشہ ماحولیاتی متغیرات یا کلائنٹ کی محفوظ کنفیگریشن استعمال کرنے کی سفارش کی جاتی ہے۔ کنفیگریشن عوامی طور پر شیئر کرتے وقت صرف ${MCD_MCP_TOKEN} جیسے پلیس ہولڈر رکھیں۔

حدود اور احتیاطی نکات

• تمام قیمتیں MCP کے calculate-price سے حاصل شدہ حقیقی نتیجے کے مطابق ہونی چاہئیں۔
• مینو سے تصدیق نہ ہونے والی کوپن کی قدر 0 شمار کرکے نشان زد کریں، اندازہ نہ لگائیں۔
• رقم واپس کیے گئے آرڈرز کو خرچ میں شامل نہ کریں۔
• پروجیکٹ کوپن استعمال کرنے کے لیے غیر ضروری اضافی خریداری کی حوصلہ افزائی نہیں کرتا۔
• کھانے، قیمت، دستیابی اور کوپن کے قابلِ استعمال دائرے کے لیے میک ڈونلڈز کے سرکاری چینلز کے حقیقی وقت کے نتائج کو ترجیح دیں۔
• یہ پروجیکٹ آزادانہ طور پر تیار کیا گیا مقابلے کا کام ہے، میک ڈونلڈز کی سرکاری پروڈکٹ نہیں۔
• نتائج صرف صارفین کے فیصلے میں مدد کے لیے ہیں اور طبی، غذائی یا دیگر پیشہ ورانہ مشورہ نہیں ہیں۔

خلاصہ

مائی مائی بچت اسسٹنٹ حقیقی وقت کی آرڈر بہتری اور طویل مدتی خرچ کے آڈٹ کو یکجا کرتا ہے: قلیل مدت میں حقیقی قیمت کے مطابق کومبو، انفرادی اشیا اور کوپن کا انتخاب کرتا ہے، جبکہ طویل مدت میں آرڈرز اور کوپن کے ذخیرے کے ذریعے زیادہ فی آرڈر خرچ، بار بار الگ سے خریداری اور کوپن کے ختم ہونے جیسے پوشیدہ نقصانات تلاش کرتا ہے۔

MCP Token ترتیب دینے کے بعد بجٹ اور کھانے کی ضرورت والی ایک آرڈر درخواست سے آغاز کریں، پھر اضافی خریداری کے موازنے اور ماہانہ خرچ کے آڈٹ کو آزمائیں۔ ڈویلپرز کے لیے saver.py، auditor.py اور mcd_adapter.py کی پرت بندی دو سلسلوں پر مبنی MCP آرکیسٹریشن کی واضح مثال بھی فراہم کرتی ہے۔