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

HotWax Commerce Fulfillment হল একটি প্রগ্রেসিভ ওয়েব অ্যাপ (PWA) যা স্টোর এবং গুদাম দলগুলিকে অর্ডার ফালফিলমেন্ট অপারেশন চালানোর জন্য ব্যবহার করে। এর যৌক্তিক রিপোজিটরি নাম হল Fulfillment, এবং এর ঘোষিত ব্যবসায়িক উদ্দেশ্য হল গ্রাহকের অর্ডার শিপিং এবং ইনভেন্টরি দক্ষতার সাথে সরানোর জন্য সংস্থাগুলিকে সক্ষম করা। মূল দায়িত্বগুলির মধ্যে রয়েছে খোলা অর্ডারগুলি সনাক্ত করা, পিকলিস্ট তৈরি করা, আইটেমগুলি পিকিং এবং স্ক্যানিং করা, শিপমেন্ট প্যাকিং করা, লেবেল তৈরি করা এবং অর্ডার শিপিং করা। এটি সুবিধাগুলির মধ্যে ট্রান্সফার অর্ডারও প্রক্রিয়া করে, যার মধ্যে পিকিং, শিপিং এবং প্রত্যাখ্যান করা অন্তর্ভুক্ত। ক্যারিয়ার এবং শিপিং অপারেশনগুলি ক্যারিয়ার শিপমেন্ট পদ্ধতি, ট্র্যাকিং লেবেল এবং প্যাকিং স্লিপগুলিকে কভার করে। অ্যাপটি ইনভেন্টরি এবং ব্যতিক্রমী পরিস্থিতি যেমন ফালফিল করা যায় না এমন আইটেম, প্রত্যাখ্যান এবং অর্ডার স্ট্যাটাস আপডেট পরিচালনা করে, এবং ফালফিলমেন্ট কাজের জন্য ব্যবহারকারী অনুমতি, সুবিধা এবং প্রোডাক্ট স্টোর প্রসঙ্গ সমাধান করে। ডকুমেন্টেড ওয়ার্কফ্লো খোলা অর্ডার থেকে পিকিং দিয়ে শুরু হয়: Solr-ব্যাকড অর্ডার কিউ তৈরি করা, পিকলিস্ট বা ওয়েভ তৈরি করা, এবং প্যাকিং এবং শিপিংয়ের আগেPicked পরিমাণ আপডেট করতে আইটেম স্ক্যান করা। প্যাকিং এবং শিপিং প্যাকিং স্লিপ, শিপিং লেবেল এবং ট্র্যাকিং কোড তৈরি করে, এবং শিপমেন্ট স্ট্যাটাসকে অনুমোদিত থেকে প্যাকড থেকে শিপড পর্যন্ত আপডেট করে। ট্রান্সফার অর্ডার ফ্লো ট্রান্সফার অর্ডার পুনরুদ্ধার করে, আইটেম স্ক্যান করে, আউটবাউন্ড শিপমেন্ট তৈরি করে, এবং ইনভেন্টরি ফালফিল করা না গেলে প্রত্যাখ্যানের কারণ ক্যাপচার করে। প্রিন্টিং এবং ডিভাইস সাপোর্ট পিকলিস্ট, প্যাকিং স্লিপ এবং লেবেল, যার মধ্যে 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। এনভায়রনমেন্ট কনফিগারেশন 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 কমিউনিটি ফাইল রয়েছে, এবং কমিউনিটি প্রশ্নগুলি প্রজেক্ট ডিসকর্ড চ্যানেলে যেতে পারে। অ্যাপটি 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 দিয়ে রিপোর্ট দেখার বর্ণনা দেয়।