इस प्रोजेक्ट के बारे में

HotWax Commerce Fulfillment एक प्रगतिशील वेब ऐप (PWA) है जो स्टोर और वेयरहाउस टीमों को ऑर्डर पूर्ति संचालन करने के लिए सक्षम बनाता है। इसका तार्किक रिपॉजिटरी नाम Fulfillment है, और इसका घोषित व्यावसायिक उद्देश्य संगठनों को ग्राहक ऑर्डर भेजने और इन्वेंटरी को कुशलतापूर्वक स्थानांतरित करने की अनुमति देना है। मुख्य जिम्मेदारियों में खुले ऑर्डर ढूंढना, पिकलिस्ट बनाना, आइटम चुनना और स्कैन करना, शिपमेंट पैक करना, लेबल जनरेट करना और ऑर्डर भेजना शामिल है। यह सुविधाओं के बीच ट्रांसफर ऑर्डर को भी संसाधित करता है, जिसमें पिकिंग, शिपिंग और उन्हें अस्वीकार करना शामिल है। कैरियर और शिपिंग संचालन में कैरियर शिपमेंट विधियां, ट्रैकिंग लेबल और पैकिंग स्लिप शामिल हैं। ऐप इन्वेंटरी और अपवाद मामलों जैसे कि अपूर्ण आइटम, अस्वीकृति और ऑर्डर स्टेटस अपडेट को संभालता है, और पूर्ति कार्य के लिए उपयोगकर्ता अनुमतियों, सुविधाओं और उत्पाद स्टोर संदर्भ को हल करता है। दस्तावेजबद्ध वर्कफ़्लो खुले ऑर्डर से पिकिंग के साथ शुरू होते हैं: Solr-समर्थित ऑर्डर कतारें बनाना, पिकलिस्ट या वेव बनाना, और पैकिंग और शिपिंग से पहले चुने गए मात्रा को अपडेट करने के लिए आइटम स्कैन करना। पैकिंग और शिपिंग पैकिंग स्लिप, शिपिंग लेबल और ट्रैकिंग कोड जनरेट करती है, और शिपमेंट स्टेटस को स्वीकृत से लेकर पैक किए गए और फिर भेजे गए में अपडेट करती है। ट्रांसफर ऑर्डर फ्लो में ट्रांसफर ऑर्डर प्राप्त करना, आइटम स्कैन करना, आउटबाउंड शिपमेंट बनाना और इन्वेंटरी अपूर्ण होने पर अस्वीकृति कारण कैप्चर करना शामिल है। प्रिंटिंग और डिवाइस सपोर्ट में पिकलिस्ट, पैकिंग स्लिप और लेबल शामिल हैं, जिसमें ज़ेबरा प्रिंटर फ्लो भी शामिल है। टेक स्टैक में 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; और ज़ेबरा प्रिंटर एकीकरण। ऐप को accxui pnpm वर्कस्पेस से विकसित और चलाया जाता है, न कि इसके अपने फ़ोल्डर से। इसे स्थानीय रूप से चलाने के लिए, ऐप को accxui चेकआउट के अंदर apps/fulfillment में रखें, .env.example को .env में कॉपी करें और आवश्यक मान सेट करें, फिर accxui रूट से pnpm install चलाएं और pnpm --filter fulfillment dev के साथ शुरू करें। पूर्वrequisites में Node v22.12.0 या उच्चतर और pnpm शामिल हैं। पर्यावरण कॉन्फ़िगरेशन में OMS API कॉल के लिए VITE_BASE_URL, HotWax Launchpad लॉगिन के लिए VITE_LOGIN_URL, मल्टी-वर्जन ऐप होस्टिंग के लिए 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 जैसी शाखा नामकरण का उपयोग करने, प्रतिबद्ध संदेशों में मुद्दा संख्या शामिल करने और प्रदान किए गए टेम्पलेट के साथ main में एक 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 के साथ रिपोर्ट देखने का वर्णन करते हैं।