عن المشروع

HotWax Commerce Fulfillment هو تطبيق ويب تقدمي (PWA) يتيح لفريق المتجر والمستودع تنفيذ عمليات إتمام الطلبات. الاسم المنطقي للمستودع هو Fulfillment، والغرض التجاري المعلن هو تمكين المؤسسات من شحن طلبات العملاء ونقل المخزون بكفاءة. تشمل المسؤوليات الأساسية تحديد الطلبات المفتوحة، إنشاء قوائم التجميع، تجميع ومسح العناصر، تغليف الشحنات، إنشاء الملصقات، وشحن الطلبات. كما يعالج أوامر النقل بين المرافق، بما في ذلك التجميع، الشحن، ورفضها. تغطي عمليات الناقل والشحن طرق شحن الناقل، ملصقات التتبع، ووثائق التغليف. يتعامل التطبيق مع حالات المخزون والاستثناءات مثل العناصر غير القابلة للتنفيذ، الرفض، وتحديثات حالة الطلب، ويحل مشكلات أذونات المستخدم، المرافق، وسياق متجر المنتج لعمليات الإتمام. تبدأ سير عمل موثقة بالطلبات المفتوحة إلى التجميع: بناء طوابير طلبات مدعومة بـ Solr، إنشاء قوائم تجميع أو دفعات، ومسح العناصر لتحديث الكميات المجمعة قبل التغليف والشحن. تولد عمليات التغليف والشحن وثائق تغليف، ملصقات شحن، ورموز تتبع، وتحديث حالة الشحنة من معتمدة إلى مغلفة إلى مشحونة. تتضمن سير عمل أوامر النقل استرداد أوامر النقل، مسح العناصر، إنشاء شحنات صادرة، وتسجيل أسباب الرفض عندما لا يكون المخزون قابلاً للتنفيذ. تغطي دعم الطباعة والجهاز قوائم التجميع، وثائق التغليف، والملصقات، بما في ذلك سير عمل طابعة Zebra. يتكون المكدس التقني من Vue 3، Ionic Vue، Vue Router، Pinia، وTypeScript، ومُحزم كـ mobile/PWA باستخدام Capacitor، أدوات Ionic PWA، وservice workers. تشمل الاعتمادات الأساسية والمنصة عميل واجهة برمجة تطبيقات HotWax OMS (@hotwax/oms-api)، مكونات HotWax DXP، Firebase، وModule Federation runtime. يربط مخطط الاعتماد خدمات HotWax OMS / Maarg للطلبات، الشحنات، قوائم التجميع، وسياق المنشأة/المستخدم؛ البحث المدعوم بـ Solr للطلبات المفتوحة وطوابير الإتمام؛ خدمات المستندات لطباعة قوائم التجميع، وثائق التغليف، ملصقات الشحن، والمستندات المخصصة؛ Firebase للإشعارات واستضافة الإدخال عن بُعد؛ وتكامل طابعة Zebra. يتم تطوير التطبيق وتشغيله من مساحة عمل accxui pnpm وليس من مجلده الخاص. للتشغيل المحلي، ضع التطبيق في apps/fulfillment داخل نسخة من accxui، وانسخ .env.example إلى .env واضبط القيم المطلوبة، ثم قم بتشغيل pnpm install من جذر accxui وابدأ باستخدام pnpm --filter fulfillment dev. المتطلبات الأساسية هي Node v22.12.0 أو أعلى وpnpm. تشمل تكوين البيئة VITE_BASE_URL لـ OMS API calls، VITE_LOGIN_URL لتسجيل دخول HotWax Launchpad، VITE_APP_VERSION_CONFIG لاستضافة التطبيق متعدد الإصدارات (مطلوب لتشغيل تكوين Vite)، VITE_FIREBASE_CONFIG وVITE_FIREBASE_VAPID_KEY للإشعارات، VITE_REMOTE_ENTRY لتمديدات module federation، وVITE_DEFAULT_PRODUCT_STORE_SETTINGS لإعدادات المتجر الافتراضية الخاصة بالإتمام. تستخدم ملاحظات البناء للمستخدمين والمساهمين مساحة عمل accxui، مع إضافة المساهمين لـ git clone إلى apps/fulfillment وأمر البناء pnpm --filter fulfillment build. تطلب إرشادات المساهمة من المساهمين تفريد واستنساخ الفرع الرئيسي، واختيار مشكلة، واستخدام تسمية الفروع مثل fulfillment-pwa/issue-number، وتضمين رقم المشكلة في رسائل الالتزام، وتقديم PR إلى main باستخدام القالب المقدم. يتم التمييز بين تقريب الأعطال وطلبات الميزات، وتُوجه أسئلة الدعم أو الإعداد إلى القنوات المحددة. تشمل موارد UI/UX ملف Figma community، ويمكن توجيه أسئلة المجتمع إلى قناة 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.