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

HotWax Commerce Fulfillment ایک پروگریسو ویب ایپ (PWA) ہے جو اسٹور اور ویئرہاؤس ٹیموں کے لیے آرڈر فلپمنٹ آپریشنز انجام دینے کے لیے بنائی گئی ہے۔ اس کا منطقی ریپوزٹری نام Fulfillment ہے، اور اس کا بیان کردہ کاروباری مقصد یہ ہے کہ تنظیموں کو گاہکوں کے آرڈرز بھیجنے اور انوینٹری کو مؤثر طریقے سے منتقل کرنے کی اجازت دی جائے۔ اس کے بنیادی فرائض میں کھلے آرڈرز تلاش کرنا، پک لسٹس بنانا، آئٹمز چننا اور اسکین کرنا، شپمنٹس پیک کرنا، لیبلز تیار کرنا، اور آرڈرز بھیجنا شامل ہیں۔ یہ سہولتوں کے درمیان ٹرانسفر آرڈرز کو بھی پروسیس کرتا ہے، بشمول ان کا چننا، بھیجنا، اور مسترد کرنا۔ کیریئر اور شپنگ آپریشنز میں کیریئر شپمنٹ کے طریقے، ٹریکنگ لیبلز، اور پیکنگ سلپس شامل ہیں۔ ایپ انوینٹری اور استثنائی معاملات جیسے کہ غیر قابل فلپمنٹ آئٹمز، مستردات، اور آرڈر اسٹیٹس اپ ڈیٹس کو بھی ہینڈل کرتی ہے، اور فلپمنٹ کے کام کے لیے صارف کے اجازت ناموں، سہولتوں، اور پروڈکٹ اسٹور کے سیاق و سباق کو حل کرتی ہے۔ دستاویزی ورک فلو کھلے آرڈرز سے شروع ہوتے ہیں اور چننے تک جاتے ہیں: Solr-بیکڈ آرڈر کیو بنانا، پک لسٹس یا ویوز بنانا، اور آئٹمز کو اسکین کرکے چنے گئے مقدار کو اپ ڈیٹ کرنا، پھر پیکنگ اور شپنگ کرنا۔ پیکنگ اور شپنگ سے پیکنگ سلپس، شپنگ لیبلز، اور ٹریکنگ کوڈز تیار ہوتے ہیں، اور شپمنٹ اسٹیٹس کو منظور شدہ سے لے کر پیکڈ اور پھر بھیجے گئے تک اپ ڈیٹ کیا جاتا ہے۔ ٹرانسفر آرڈر فلو میں ٹرانسفر آرڈرز کو حاصل کرنا، آئٹمز کو اسکین کرنا، آؤٹ باؤنڈ شپمنٹس بنانا، اور انوینٹری غیر قابل فلپمنٹ ہونے کی صورت میں مسترد ہونے کی وجوہات کو ریکارڈ کرنا شامل ہے۔ پرنٹنگ اور ڈیوائس سپورٹ میں پک لسٹس، پیکنگ سلپس، اور لیبلز شامل ہیں، بشمول Zebra پرنٹر فلو۔ ٹیک اسٹیک میں Vue 3، Ionic Vue، Vue Router، Pinia، اور TypeScript شامل ہیں، جو Capacitor، Ionic PWA ٹولز، اور سروس ورکرز کے ساتھ موبائل/PWA کے طور پر پیکجڈ ہے۔ پلیٹ فارم اور یوٹیلیٹی ڈیپینڈنسز میں HotWax OMS API کلائنٹ (@hotwax/oms-api)، HotWax DXP کمپونینٹس، Firebase، اور Module Federation رن ٹائم شامل ہیں۔ ڈیپینڈنسی میپ HotWax OMS / Maarg سروسز کو آرڈرز، شپمنٹس، پک لسٹس، اور سہولت/صارف کے سیاق و سباق کے لیے جوڑتا ہے؛ Solr-بیکڈ سرچ کو کھلے آرڈرز اور فلپمنٹ کیو کے لیے جوڑتا ہے؛ ڈاکیومنٹ سروسز کو پک لسٹس، پیکنگ سلپس، شپنگ لیبلز، اور کسٹم ڈاکیومنٹ پرنٹ کرنے کے لیے جوڑتا ہے؛ Firebase کو نوٹیفیکیشنز اور ریموٹ انٹری ہوسٹنگ کے لیے جوڑتا ہے؛ اور Zebra پرنٹر انٹیگریشن کو جوڑتا ہے۔ یہ ایپ accxui pnpm ورک اسپیس سے تیار اور چلائی جاتی ہے، نہ کہ اپنے فولڈر سے۔ اسے لوکل میں چلانے کے لیے، ایپ کو accxui چیک آؤٹ کے اندر apps/fulfillment میں رکھیں، .env.example کو .env میں کاپی کریں اور مطلوبہ اقدار سیٹ کریں، پھر accxui روٹ سے pnpm install چلائیں اور pnpm --filter fulfillment dev سے شروع کریں۔ پری ریکیویزٹس میں Node v22.12.0 یا اس سے زیادہ اور pnpm شامل ہیں۔ ماحول کی ترتیب میں VITE_BASE_URL کے لیے OMS API کالز، VITE_LOGIN_URL کے لیے HotWax Launchpad لاگ ان، VITE_APP_VERSION_CONFIG کے لیے ملٹی ورژن ایپ ہوسٹنگ (Vite کانفیگ کو لوڈ کرنے کے لیے ضروری)، VITE_FIREBASE_CONFIG اور VITE_FIREBASE_VAPID_KEY کے لیے نوٹیفیکیشنز، VITE_REMOTE_ENTRY کے لیے ماڈیول فیڈریشن ایکسٹینشنز، اور VITE_DEFAULT_PRODUCT_STORE_SETTINGS کے لیے ڈیفالٹ اسٹور لیول فلپمنٹ فلیگز شامل ہیں۔ صارفین اور کنٹریبیوٹرز دونوں کے لیے بلڈ نوٹس accxui ورک اسپیس کا استعمال کرتے ہیں، جس میں کنٹریبیوٹر کا راستہ apps/fulfillment میں ایک git clone شامل کرتا ہے اور بلڈ کمانڈ pnpm --filter fulfillment build شامل کرتا ہے۔ کنٹریبیوشن گائیڈلائنز کنٹریبیوٹرز سے کہتے ہیں کہ وہ مین برانچ کو فورک اور کلون کریں، ایک ایشو چنیں، برانچ نانمنگ جیسے fulfillment-pwa/issue-number کا استعمال کریں، کمٹ میسجز میں ایشو نمبر شامل کریں، اور فراہم کردہ ٹیمپلیٹ کے ساتھ مین میں PR جمع کرائیں۔ بگ رپورٹس اور فیچر رکویسٹس کو الگ کیا گیا ہے، اور سپورٹ یا سیٹ اپ کے سوالات کو مخصوص چینلز پر بھیجا جاتا ہے۔ UI/UX وسائل میں ایک Figma کمیونٹی فائل شامل ہے، اور کمیونٹی کے سوالات پروجیکٹ کے Discord چینل پر بھیجے جا سکتے ہیں۔ ایپ Apache v2.0 لائسنس کے تحت ریلیز کی گئی ہے۔ Playwright آٹومیشن گائیڈلائنز میں npx playwright install کے ساتھ براؤزرز انسٹال کرنا، کمانڈز جیسے npx playwright test، npx playwright test tests/login.spec.js، npx playwright test --headed، npx playwright test --project=chromium، اور npx playwright test --debug کے ساتھ ٹیسٹ چلانا، اور پھر npx playwright show-report کے ساتھ رپورٹس دیکھنا شامل ہے۔