মাইমাই সাশ্রয় সহায়িকা টিউটোরিয়াল: McDonald's MCP ব্যবহার করে অর্ডার অপ্টিমাইজ ও কুপন ক্ষতি নিরীক্ষা

প্রকল্প পরিচিতি

মাইমাই সাশ্রয় সহায়িকা (mcd-coupon-strategist) হলো McDonald's China 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।
• McDonald's MCP ওপেন প্ল্যাটফর্ম থেকে নেওয়া Token।
• স্থানীয় পরীক্ষা চালাতে হলে Python 3.8 বা তার পরের সংস্করণ।

স্থানীয় চারটি পরীক্ষা চালাতে MCP Token লাগে না। তবে প্রকৃত মেনু, অ্যাকাউন্টের কুপন এবং পূর্ববর্তী অর্ডার查询 করতে কার্যকর Token প্রয়োজন।

MCP Token নেওয়া ও কনফিগার করা

প্রথম ধাপ: Token নেওয়া

McDonald's 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 সক্রিয় করুন।

মৌলিক ব্যবহার

উদাহরণ ১: বাজেট অনুযায়ী কম্বো খোঁজা

প্রথমে রেস্তোরাঁ বেছে নিন। এরপর বাজেট, প্রয়োজনীয় খাবারের ধরন এবং তুলনার সংখ্যা স্পষ্টভাবে জানান। সরাসরি লিখতে পারেন:

আমি McDonald's থেকে ডেলিভারি অর্ডার করতে চাই। রেস্তোরাঁ বেছে নেওয়ার পর হিসাব করে বলুন:
আমার কাছে কুপন আছে। একটি বার্গার + এক份 ফ্রেঞ্চ ফ্রাই + এক কাপ পানীয় চাই, বাজেট 40 ইউয়ান,
কীভাবে অর্ডার করলে সবচেয়ে সাশ্রয়ী হবে? দুটি পরিকল্পনা তুলনা করে দিন।

সহায়িকাটি বর্তমান রেস্তোরাঁর মেনু ও ব্যবহারযোগ্য কুপন পড়ে সম্ভাব্য কম্বো তৈরি করবে এবং MCP দিয়ে প্রকৃত মূল্য নির্ধারণ করবে। একটি সাধারণ ফলাফলে 33.5 ইউয়ানের ম্যাকস্পাইসি চিকেন বার্গার তিন-পণ্যের কম্বো সুপারিশ করা হতে পারে এবং তা 37 ইউয়ানের বার্গার ও ফ্রেঞ্চ ফ্রাই আলাদাভাবে কেনার সঙ্গে তুলনা করা হতে পারে।

উদাহরণ ২: প্রধান খাবার ও সাইড সীমাবদ্ধ করা

বাজেট 35 ইউয়ান। একটি চিকেন-ভিত্তিক প্রধান খাবার এবং একটি সাইড চাই।
বর্তমান রেস্তোরাঁয় বিক্রিত পণ্য查询 করে সুপারিশ, বিকল্প এবং অনুপযুক্ত পরিকল্পনা দিন,
এবং প্রতিটি পরিকল্পনা কেন বেশি সাশ্রয়ী বা ব্যয়বহুল তা ব্যাখ্যা করুন।

এ ধরনের নির্দেশনা সহায়িকাকে বাজেট, পেট ভরা এবং পণ্যের ধরন একসঙ্গে বিবেচনা করতে সাহায্য করে। ফলে শুধু সর্বনিম্ন মূল্যের কিন্তু চাহিদা পূরণ করে না এমন বিকল্প সুপারিশ করার ঝুঁকি কমে।

উদাহরণ ৩: অতিরিক্ত কেনাকাটা সার্থক কি না যাচাই

আমার কাছে “50 ইউয়ান পূর্ণ হলে 12 ইউয়ান ছাড়” কুপন আছে।
বর্তমান প্রয়োজন অনুযায়ী সরাসরি কেনা, অতিরিক্ত পণ্য যোগ করে কুপন ব্যবহার এবং কম্বো কেনার চূড়ান্ত প্রদেয় অর্থ তুলনা করুন।
অতিরিক্ত পণ্য যোগ করলে যদি বরং বেশি খরচ হয়, আমাকে স্পষ্টভাবে সতর্ক করুন।

তুলনার সময় চূড়ান্ত প্রদেয় অর্থকে গুরুত্ব দিন, কুপনে লেখা ছাড়ের পরিমাণকে নয়। প্রকল্পটি অতিরিক্ত পণ্যের খরচ হিসাবের মধ্যে রাখবে এবং কম্বোটি অতিরিক্ত কেনাকাটার চেয়ে বেশি সাশ্রয়ী কি না তা জানাবে।

উদাহরণ ৪: সাম্প্রতিক খরচ নিরীক্ষা

সাম্প্রতিক কয়েক মাসের McDonald's অর্ডার বিশ্লেষণ করুন:
অর্ডারের সংখ্যা, মোট খরচ ও গড় অর্ডার মূল্য হিসাব করুন এবং বেশি কেনা পণ্য খুঁজে বের করুন;
একই সঙ্গে মেয়াদোত্তীর্ণ হতে যাওয়া কুপন, আনুমানিক মূল্য ও অবশিষ্ট দিন তালিকাভুক্ত করুন,
শেষে জানান, এই মাসে কোন বিষয়টি আগে সামলানো উচিত।

এতে দীর্ঘমেয়াদি নিরীক্ষা ধারা চালু হবে। ফলাফলের মূল বিষয় হবে মেয়াদোত্তীর্ণ হতে যাওয়া কুপনের মোট মূল্য, খরচের অভ্যাস এবং বাস্তবে প্রয়োগযোগ্য কাঠামোগত পরামর্শ; শুধু একটি অর্ডারের সর্বনিম্ন মূল্য নয়।

স্থানীয় পরীক্ষা চালানো

প্রকল্পের সোর্স কোড নেওয়ার পর রিপোজিটরির মূল ডিরেক্টরিতে 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 ধরে উল্লেখ করতে হবে; অনুমান করা যাবে না।
• ফেরত দেওয়া অর্ডার খরচের মধ্যে গণনা করা হবে না।
• শুধু কুপন ব্যবহারের জন্য প্রকল্পটি অপ্রয়োজনীয় অতিরিক্ত কেনাকাটায় উৎসাহ দেয় না।
• খাবার, মূল্য, সরবরাহের অবস্থা এবং কুপনের প্রযোজ্যতা McDonald's-এর অফিসিয়াল চ্যানেলের রিয়েল-টাইম ফলাফলের ওপর নির্ভর করবে।
• এই প্রকল্পটি স্বাধীনভাবে তৈরি একটি প্রতিযোগিতা-প্রকল্প, McDonald's-এর অফিসিয়াল পণ্য নয়।
• ফলাফল শুধু ভোক্তা-সিদ্ধান্তের参考; এটি চিকিৎসা, পুষ্টি বা অন্য কোনো পেশাদার পরামর্শ নয়।

সারাংশ

মাইমাই সাশ্রয় সহায়িকা রিয়েল-টাইম অর্ডার অপ্টিমাইজেশন ও দীর্ঘমেয়াদি খরচ নিরীক্ষাকে একত্র করে। স্বল্পমেয়াদে প্রকৃত মূল্য নির্ধারণের মাধ্যমে কম্বো, একক পণ্য ও কুপনের সমন্বয় বেছে নেয়। দীর্ঘমেয়াদে অর্ডার ও কুপনের মজুত বিশ্লেষণ করে বেশি গড় অর্ডার মূল্য, বারবার একক পণ্য কেনা এবং কুপনের মেয়াদ শেষ হয়ে যাওয়ার মতো গোপন ক্ষতি খুঁজে বের করে।

MCP Token কনফিগার করার পর বাজেট ও খাবারের চাহিদা উল্লেখ করে একটি অর্ডার অনুরোধ দিয়ে শুরু করতে পারেন। এরপর ধীরে ধীরে অতিরিক্ত কেনাকাটার তুলনা ও মাসিক খরচ নিরীক্ষা চেষ্টা করুন। ডেভেলপারদের জন্য saver.py, auditor.py এবং mcd_adapter.py-এর স্তরবিন্যাসও দ্বৈত-ধারার MCP অর্কেস্ট্রেশনের একটি পরিষ্কার参考 হিসেবে কাজ করে।