منصوبے کے بارے میں

# نیبولا کیفے — پیش گوئی فٹ فال اور انوینٹری ہم آہنگی نظام نیبولا کیفے ایک اوپن سورس تجزیاتی ڈیش بورڈ ہے جو اسٹریم لِٹ کے ساتھ بنایا گیا ہے، جو کافی شاپ مالکان اور مینیجرز کے لیے ڈیزائن کیا گیا ہے جو تاریخی رپورٹنگ سے آگے بڑھ کر پیش گوئی فیصلہ سازی کرنا چاہتے ہیں۔ یہ پروجیکٹ خود کو ایک "فیصلہ انجن" کے طور پر پیش کرتا ہے جو گاہکوں کی آمد کی پیش گوئی کرتا ہے، اجزاء کی دوبارہ اسٹاکنگ کو بہتر بناتا ہے، اور آپریشنل کارکردگی کو ایک گرم، خوش آئند انٹرفیس کے ساتھ متوازن کرتا ہے۔ ## بنیادی مقصد روایتی کیفے تجزیاتی ٹولز کے برعکس جو صرف ماضی کی فروخت کی رپورٹ کرتے ہیں، نیبولا کیفے ٹائم سیریز پیش گوئی (خاص طور پر LSTM ماڈلز) کا استعمال کرتا ہے تاکہ 7 دن تک گاہکوں کی آمد کی پیش گوئی کی جا سکے۔ یہ صارفین کو اجازت دیتا ہے: - پیش گوئی شدہ مصروف اوقات کی بنیاد پر ذہانت سے عملہ مقرر کریں - خراب ہونے والے فضلے کو کم کرنے کے لیے بالکل وقت پر انوینٹری آرڈر کریں (30% تک کمی کا دعویٰ) - ایونٹس یا پروموشنز کی شیڈولنگ کے لیے سست اوقات کی نشاندہی کریں - متعدد مقامات پر پیٹرن کا موازنہ کریں (علاقائی مینیجرز کے لیے) ## اہم خصوصیات ### پیش گوئی فٹ فال میپنگ - 7 دن کی گاہک تعداد کی پیش گوئی کے لیے LSTM پر مبنی ٹائم سیریز ماڈل - اعتماد کے وقفوں کے ساتھ بصری ٹائم لائن ("بادل والے بینڈ" کے طور پر دکھایا گیا) - چھٹیوں اور موسم کے ڈیٹا کی بنیاد پر متحرک ایڈجسٹمنٹ (اختیاری API انٹیگریشن) ### ذہین انوینٹری ایڈوائزر - پیش گوئی شدہ فروخت کو موجودہ اسٹاک لیول کے ساتھ کراس ریفرنس کرتا ہے - رنگ کوڈڈ ری آرڈر لسٹ تیار کرتا ہے: سبز (اسٹاک میں)، امبر (2 دن میں آرڈر کریں)، سرخ (ابھی آرڈر کریں) - مستقبل کی سفارشات کو بہتر بنانے کے لیے ماضی کی اوور اسٹاک غلطیوں سے سیکھتا ہے ### صارف کا تجربہ - ڈریگ اینڈ ڈراپ وجیٹ لے آؤٹ جو ٹیبلٹ یا فون اسکرینوں کے مطابق ڈھل جاتا ہے - کثیر لسانی UI جو انگریزی، ہسپانوی، مینڈارن، اور عربی کی حمایت کرتا ہے - بلٹ ان FAQ/سپورٹ بوٹ (قاعدہ پر مبنی، کوئی بیرونی API کیز درکار نہیں) - رنگوں اور فونٹس کو حسب ضرورت بنانے کے لیے نو کوڈ تھیم ایڈیٹر - انٹرنیٹ کے بغیر مکمل فعالیت کے لیے آف لائن موڈ ### رازداری اور ڈیٹا ہینڈلنگ - تمام ڈیٹا بطور ڈیفالٹ مقامی طور پر پروسیس ہوتا ہے؛ صفر کلاؤڈ اپ لوڈز - کوئی تصدیقی کیز درکار نہیں - گمنام جمع بندی اس بات کو یقینی بناتی ہے کہ کوئی گاہک PII محفوظ نہ ہو - جانچ اور تجربے کے لیے اختیاری مصنوعی ڈیٹا جنریٹر ## ٹیکنالوجی اسٹیک - **فرنٹ اینڈ:** اسٹریم لِٹ حسب ضرورت CSS کے ساتھ (کوئی جاوا اسکرپٹ لائبریریاں نہیں) - **بیک اینڈ:** پائتھون 3.10+ پانڈاز، نمپائی، اور پروفیٹ کے ساتھ پیش گوئی کے لیے - **ڈیٹا اسٹوریج:** مقامی CSV/JSON فائلیں (اختیاری SQLite سپورٹ) - **ویژولائزیشن:** انٹرایکٹو چارٹس کے لیے پلاٹلی، اسٹیٹک ایکسپورٹس کے لیے میٹ پلاٹ لِب - **ٹیسٹنگ:** یونٹ اور انٹیگریشن ٹیسٹس کے لیے پائی ٹیسٹ ## استعمال کے کیسز - **اکیلا کیفے مالک:** پیش گوئی شدہ سست ادوار میں ایونٹس کی منصوبہ بندی کریں - **علاقائی مینیجر:** عملے کو دوبارہ تقسیم کرنے کے لیے مقامات کے درمیان فٹ فال کا موازنہ کریں - **روسٹری پارٹنر:** ہفتہ وار بین کی ترسیل کا تعین کرنے کے لیے انوینٹری ایڈوائزر استعمال کریں - **سرمایہ کار:** ROI میٹرکس اور گاہک کثافت کے رجحانات کے ساتھ ہفتہ وار رپورٹس ایکسپورٹ کریں ## روڈ میپ (2026) - **Q1 2026:** بنیادی پیش گوئی اور انوینٹری ماڈیولز کے ساتھ v1.0 ریلیز - **Q2 2026:** عوامی مینو اسکرین اسکراپر کے ذریعے اختیاری حریف قیمت ٹریکنگ - **Q3 2026:** اوپن API کے ذریعے Square/Toast POS کے ساتھ انٹیگریشن - **Q4 2026:** فوری فٹ فال الرٹس کے لیے موبائل ساتھی ایپ (Flutter) ## انسٹالیشن اور استعمال صارفین GitHub صفحے سے ریپوزٹری کو ZIP فائل کے طور پر ڈاؤن لوڈ کر سکتے ہیں یا git کلائنٹ کا استعمال کرتے ہوئے کلون کر سکتے ہیں۔ پروجیکٹ کے لیے پائتھون 3.10+ اور ریپوزٹری میں درج انحصاریت درکار ہے۔ کسی انسٹالیشن وزرڈ کی ضرورت نہیں—صرف خالص پائتھون کوڈ۔ ## کمیونٹی اور شراکت شراکتیں خوش آئند ہیں، بشمول: - نئے پیش گوئی ماڈلز شامل کرنا (مثلاً ARIMA، فیس بک پروفیٹ) - UI کا اضافی زبانوں میں ترجمہ کرنا - ماحولیاتی میٹرکس (محیطی شور، درجہ حرارت) کے لیے نئے وجیٹس ڈیزائن کرنا پروجیکٹ میں `docs/` فولڈر میں دستاویزات شامل ہیں اور کمیونٹی سپورٹ کے لیے GitHub ایشوز اور مباحثے استعمال کرتا ہے۔ ## لائسنس MIT لائسنس کے تحت لائسنس یافتہ، تجارتی یا غیر تجارتی مقاصد کے لیے مفت استعمال، ترمیم، اور تقسیم کی اجازت دیتا ہے۔ ## دستبرداری سافٹ ویئر "جیسا ہے" کے طور پر بغیر وارنٹی کے فراہم کیا گیا ہے۔ پیش گوئی ماڈلز مظاہرے کے لیے مصنوعی تربیتی ڈیٹا پر انحصار کرتے ہیں اور کیلبریشن کے بغیر حقیقی دنیا کی درستگی کی عکاسی نہیں کر سکتے۔ ڈویلپر ڈیش بورڈ آؤٹ پٹس کی بنیاد پر کیے گئے کاروباری فیصلوں کی کوئی ذمہ داری قبول نہیں کرتا۔ سپورٹ بوٹ ایک اسکرپٹڈ FAQ اسسٹنٹ ہے، زندہ انسانی ایجنٹ نہیں۔ صارفین کو ہمیشہ انوینٹری کی سفارشات کی جسمانی گنتی کے ساتھ توثیق کرنی چاہیے۔