প্রকল্প সম্পর্কে

# Nebula Cafe — ভবিষ্যদ্বাণীমূলক ফুটফল ও ইনভেন্টরি হারমনি সিস্টেম Nebula Cafe হলো স্ট্রিমলিট দিয়ে তৈরি একটি ওপেন-সোর্স বিশ্লেষণাত্মক ড্যাশবোর্ড, যা কফি শপের মালিক ও ম্যানেজারদের জন্য ডিজাইন করা হয়েছে যারা ঐতিহাসিক রিপোর্টিংয়ের বাইরে গিয়ে ভবিষ্যদ্বাণীমূলক সিদ্ধান্ত গ্রহণে যেতে চান। প্রকল্পটি নিজেকে একটি "ডিসিশন ইঞ্জিন" হিসেবে উপস্থাপন করে যা গ্রাহকের ফুটফল পূর্বাভাস দেয়, উপকরণ পুনরায় মজুদ অপ্টিমাইজ করে এবং উষ্ণ, আমন্ত্রণমূলক ইন্টারফেসের সাথে অপারেশনাল দক্ষতা ভারসাম্য রাখে। ## মূল উদ্দেশ্য ঐতিহ্যবাহী ক্যাফে বিশ্লেষণ টুলের বিপরীতে যারা কেবল অতীতের বিক্রয় রিপোর্ট করে, Nebula Cafe সময়-সিরিজ পূর্বাভাস (বিশেষত LSTM মডেল) ব্যবহার করে ৭ দিন পর্যন্ত গ্রাহকের ট্রাফিক পূর্বাভাস দেয়। এটি ব্যবহারকারীদের অনুমতি দেয়: - পূর্বাভাসকৃত ব্যস্ত সময়ের ভিত্তিতে বুদ্ধিমানের সাথে কর্মী নিয়োগ - পচনশীল অপচয় কমাতে জাস্ট-ইন-টাইম ইনভেন্টরি অর্ডার (৩০% পর্যন্ত হ্রাস দাবি করা হয়েছে) - ইভেন্ট বা প্রচারণার সময়সূচির জন্য ধীর সময় চিহ্নিত করা - একাধিক অবস্থানের মধ্যে প্যাটার্ন তুলনা (আঞ্চলিক ম্যানেজারদের জন্য) ## মূল বৈশিষ্ট্য ### ভবিষ্যদ্বাণীমূলক ফুটফল ম্যাপিং - ৭ দিনের গ্রাহক সংখ্যা পূর্বাভাসের জন্য LSTM-ভিত্তিক সময়-সিরিজ মডেল - আত্মবিশ্বাসের ব্যবধানসহ ভিজ্যুয়াল টাইমলাইন ("মেঘলা ব্যান্ড" হিসেবে কল্পনা করা হয়েছে) - ছুটি ও আবহাওয়ার ডেটার উপর ভিত্তি করে গতিশীল সমন্বয় (ঐচ্ছিক API ইন্টিগ্রেশন) ### বুদ্ধিমান ইনভেন্টরি অ্যাডভাইজার - পূর্বাভাসকৃত বিক্রয়কে বর্তমান স্টক স্তরের সাথে ক্রস-রেফারেন্স করে - রঙ-কোডেড পুনরায় অর্ডার তালিকা তৈরি করে: সবুজ (স্টকে আছে), অ্যাম্বার (২ দিনে অর্ডার করুন), লাল (এখনই অর্ডার করুন) - ভবিষ্যতের সুপারিশ উন্নত করতে অতীতের অতিরিক্ত স্টক ভুল থেকে শেখে ### ব্যবহারকারীর অভিজ্ঞতা - ড্র্যাগ-অ্যান্ড-ড্রপ উইজেট লেআউট যা ট্যাবলেট বা ফোনের স্ক্রিনে মানিয়ে নেয় - ইংরেজি, স্প্যানিশ, ম্যান্ডারিন এবং আরবি সমর্থনকারী বহুভাষিক UI - অন্তর্নির্মিত FAQ/সাপোর্ট বট (নিয়ম-ভিত্তিক, কোনো বাহ্যিক API কী প্রয়োজন নেই) - রঙ ও ফন্ট কাস্টমাইজ করার জন্য নো-কোড থিম এডিটর - ইন্টারনেট ছাড়া সম্পূর্ণ কার্যকারিতার জন্য অফলাইন মোড ### গোপনীয়তা ও ডেটা হ্যান্ডলিং - ডিফল্টভাবে সমস্ত ডেটা লোকালি প্রসেস করা হয়; শূন্য ক্লাউড আপলোড - কোনো প্রমাণীকরণ কী প্রয়োজন নেই - বেনামী সমষ্টিকরণ নিশ্চিত করে কোনো গ্রাহক PII সংরক্ষণ করা হয় না - পরীক্ষা ও পরীক্ষা-নিরীক্ষার জন্য ঐচ্ছিক সিন্থেটিক ডেটা জেনারেটর ## প্রযুক্তি স্ট্যাক - **ফ্রন্টএন্ড:** কাস্টম CSS সহ স্ট্রিমলিট (কোনো জাভাস্ক্রিপ্ট লাইব্রেরি নেই) - **ব্যাকএন্ড:** Pandas, NumPy এবং Prophet সহ Python 3.10+ পূর্বাভাসের জন্য - **ডেটা স্টোরেজ:** লোকাল CSV/JSON ফাইল (ঐচ্ছিক SQLite সমর্থন) - **ভিজ্যুয়ালাইজেশন:** ইন্টারঅ্যাকটিভ চার্টের জন্য Plotly, স্ট্যাটিক এক্সপোর্টের জন্য Matplotlib - **টেস্টিং:** ইউনিট ও ইন্টিগ্রেশন টেস্টের জন্য PyTest ## ব্যবহারের ক্ষেত্রে - **একক ক্যাফে মালিক:** পূর্বাভাসকৃত ধীর সময়ে ইভেন্ট পরিকল্পনা করুন - **আঞ্চলিক ম্যানেজার:** কর্মী পুনর্বণ্টনের জন্য অবস্থান জুড়ে ফুটফল তুলনা করুন - **রোস্টারি পার্টনার:** সাপ্তাহিক বিন শিপমেন্ট নির্ধারণ করতে ইনভেন্টরি অ্যাডভাইজার ব্যবহার করুন - **বিনিয়োগকারী:** ROI মেট্রিক্স এবং গ্রাহক ঘনত্বের প্রবণতা সহ সাপ্তাহিক রিপোর্ট এক্সপোর্ট করুন ## রোডম্যাপ (২০২৬) - **২০২৬ সালের Q1:** মূল পূর্বাভাস ও ইনভেন্টরি মডিউলসহ v1.0 রিলিজ - **২০২৬ সালের Q2:** পাবলিক মেনু স্ক্রিনস্ক্র্যাপারের মাধ্যমে ঐচ্ছিক প্রতিযোগী মূল্য ট্র্যাকিং - **২০২৬ সালের Q3:** ওপেন API এর মাধ্যমে Square/Toast POS এর সাথে ইন্টিগ্রেশন - **২০২৬ সালের Q4:** তাৎক্ষণিক ফুটফল সতর্কতার জন্য মোবাইল কম্প্যানিয়ন অ্যাপ (Flutter) ## ইনস্টলেশন ও ব্যবহার ব্যবহারকারীরা GitHub পেজ থেকে রিপোজিটরিটি ZIP ফাইল হিসেবে ডাউনলোড করতে পারেন বা git ক্লায়েন্ট ব্যবহার করে ক্লোন করতে পারেন। প্রকল্পটির জন্য Python 3.10+ এবং রিপোজিটরিতে তালিকাভুক্ত নির্ভরতা প্রয়োজন। কোনো ইনস্টলেশন উইজার্ডের প্রয়োজন নেই—শুধু বিশুদ্ধ Python কোড। ## কমিউনিটি ও অবদান অবদান স্বাগত, যার মধ্যে রয়েছে: - নতুন পূর্বাভাস মডেল যোগ করা (যেমন, ARIMA, Facebook Prophet) - UI কে অতিরিক্ত ভাষায় অনুবাদ করা - পরিবেশগত মেট্রিক্সের জন্য নতুন উইজেট ডিজাইন করা (পরিবেষ্টিত শব্দ, তাপমাত্রা) প্রকল্পটিতে `docs/` ফোল্ডারে ডকুমেন্টেশন অন্তর্ভুক্ত রয়েছে এবং কমিউনিটি সমর্থনের জন্য GitHub issues এবং discussions ব্যবহার করে। ## লাইসেন্স MIT লাইসেন্সের অধীনে লাইসেন্সপ্রাপ্ত, যা বাণিজ্যিক বা অ-বাণিজ্যিক উদ্দেশ্যে বিনামূল্যে ব্যবহার, পরিবর্তন এবং বিতরণের অনুমতি দেয়। ## দাবিত্যাগ সফ্টওয়্যারটি কোনো ওয়ারেন্টি ছাড়াই "যেমন আছে" প্রদান করা হয়েছে। ভবিষ্যদ্বাণীমূলক মডেলগুলি প্রদর্শনের জন্য সিন্থেটিক প্রশিক্ষণ ডেটার উপর নির্ভর করে এবং ক্রমাঙ্কন ছাড়া বাস্তব-বিশ্বের নির্ভুলতা প্রতিফলিত নাও করতে পারে। ডেভেলপার ড্যাশবোর্ড আউটপুটের উপর ভিত্তি করে নেওয়া ব্যবসায়িক সিদ্ধান্তের জন্য কোনো দায়িত্ব গ্রহণ করে না। সাপোর্ট বট একটি স্ক্রিপ্টেড FAQ সহায়ক, লাইভ মানব এজেন্ট নয়। ব্যবহারকারীদের সর্বদা শারীরিক গণনার সাথে ইনভেন্টরি সুপারিশ যাচাই করা উচিত।