Medusa 2.19 متوفرة الآن: ماذا يعني ذلك فعليًا لمتجرك

تم إصدار Medusa 2.19.0 في 13/08/2026، وهو الآن الإصدار الحالي للمنصة. عنوان الإصدار الرسمي — “Vite v7 Update, Inventory Export, Custom Fulfillment Addresses” — يوضح معظم ما تحتاج معرفته: ترقية بنية تحتية كبيرة وعدة ميزات ستستخدمها فرق العمليات أسبوعيًا.

إذا كنت تدير نشاط تجارة إلكترونية على Medusa، فغالبًا لا تحتاج لقراءة سجل التغييرات بالتفصيل. ما تحتاج معرفته هو ثلاثة أمور: ما الذي ستحصل عليه فرقكم، وما الذي قد يتعطل، وما الذي يجب أن تسأل عنه المطورين قبل أي تغييرات على بيئة الإنتاج. هذا ما يوضحه هذا المقال.

الملخص

خبر جيد للعمليات. يمكنك الآن تصدير المخزون إلى CSV، والشحن إلى عناوين تختلف عن عنوان الشحن الخاص بالعميل، والتحكم في إرسال الإشعارات للعملاء عند تعديل الطلب. جميعها تلغي حلولاً يدوية كانت فرق المتاجر تعتمد عليها.

خبر جيد لتقنية المعلومات والأمان. توفر Medusa الآن مزود مصادقة OIDC عام، ما يتيح ربط تسجيل دخول الموظفين بنظام الهوية الحالي لديكم.

أمر يحتاج تخطيطًا. يتضمن هذا الإصدار ثلاث تغييرات مصنفة كجوهرية، بالإضافة إلى متطلبات جديدة لبيئة الاستضافة والمتصفحات التي يستخدمها الموظفون للوصول إلى لوحة الإدارة. لا شيء منها جذري، لكن لا ينبغي اكتشافها في نهاية الأسبوع.

التغيير الذي سيلاحظه مديرو المتجر أولاً

لنبدأ هنا، لأنه التغيير الأكثر احتمالاً لإثارة تساؤلات عبر Slack في اليوم الأول.

تقوم Medusa 2.19 بترقية لوحة الإدارة إلى Vite 7.3.6 وReact Router 7.18.2 — إصدارات حديثة من الأدوات التي بُنيت بها اللوحة. وأحد آثار هذه الترقية هو رفع الحد الأدنى لإصدارات المتصفحات:

بالنسبة لمعظم الفرق، هذا التغيير غير مؤثر — أي شخص يستخدم متصفحًا يتم تحديثه تلقائيًا تجاوز هذه الإصدارات بالفعل. لكنه مهم في حالتين شائعتين في قطاع التجزئة والجملة:

• أجهزة مشتركة أو مقيدة. أجهزة المستودعات، الحواسيب القريبة من نقاط البيع، وأي جهاز قامت تقنية المعلومات بتثبيت إصدار محدد من المتصفح عليه.
• أجهزة Mac القديمة. يتطلب Safari 16 نظام macOS Big Sur أو أحدث. مدير المتجر الذي يستخدم جهاز Mac لا يدعم ذلك سيحتاج إلى استخدام Chrome أو Firefox، أو تحديث جهازه.

قبل الترقية، من المفيد إجراء تدقيق سريع: ما هي الأجهزة التي يستخدمها فريقكم فعليًا للدخول إلى لوحة الإدارة، وما هي المتصفحات المثبتة عليها؟ اكتشاف جهاز قديم الآن أقل تكلفة بكثير من اكتشافه عندما يتعذر على أحد الموظفين معالجة مرتجع.

الترقية نفسها ترفع أيضًا متطلبات Node.js في بيئة الخادم إلى ^20.19.0 أو ^22.12.0 أو إصدار LTS أحدث. لم تعد الإصدارات 20.0–20.18 و22.0–22.11 مدعومة. هذه ليست مسؤوليتكم المباشرة، لكنها سؤال مشروع يجب طرحه على من يدير الاستضافة لديكم: هل نستخدم إصدار Node مدعوم؟

تصدير المخزون أصبح متاحًا أخيرًا

إذا احتجتم يومًا إلى معرفة أرصدة المخزون الحالية في جدول بيانات — لمحادثة مع مورد، أو جرد، أو جلسة تخطيط، أو حتى لإرسالها إلى المحاسب — فأنتم تعرفون الروتين: تطلبون من مطور تنفيذ استعلام، أو تتنقلون في لوحة التحكم وتنسخون الأرقام يدويًا.

Medusa 2.19 يضيف تصدير عناصر المخزون كملف CSV، متاحًا عبر لوحة الإدارة أو عبر الـ API. يتبع نفس النمط الذي تستخدمه Medusa بالفعل في تصدير المنتجات والطلبات، لذا سيكون مألوفًا لمن سبق له تصدير أي منهما.

هذه ميزة صغيرة لكن تأثيرها كبير على حجم تواصل فريق العمليات مع فريق التطوير. تسوية الأرصدة بالجملة، تقارير الموردين، وتخطيط المخزون تصبح جميعها عمليات ذاتية التنفيذ.

يمكن الآن توجيه الشحنات إلى عنوان مختلف

هذا سيناريو تواجهه معظم المتاجر النامية: يطلب العميل منتجًا، لكن يجب شحنه من مكان غير مستودعكم — مورد، مصنع، مزود لوجستي طرف ثالث — أو يجب إرساله إلى موقع غير العنوان المسجل في الطلب.

حتى الآن، كان ذلك يتطلب حلولاً مؤقتة. في الإصدار 2.19، عند إنشاء شحنة يمكنكم تحديد عنوان تسليم مخصص مستقل عن عنوان الشحن في الطلب، وتمرير بيانات إضافية إلى مزود الشحن مع العنوان.

الفوائد العملية:

• الدروب شيبنج. يمكن توجيه الشحنة إلى عنوان مورد دون تعديل طلب العميل.
• إعدادات المستودعات المتعددة أو مزودي الخدمات اللوجستية. يمكنكم تزويد الشريك اللوجستي بالعنوان والتعليمات الدقيقة التي يحتاجها الشحن.
• متطلبات خاصة بالمزود. يتيح حقل additional_data لفريقكم تمرير بيانات الناقل أو الشريك — أرقام مرجعية، تعليمات معالجة، رموز حسابات — دون الحاجة لتعديل الكود كلما طلب شريك إضافة حقل جديد.

إذا كان أي جزء من الكتالوج يُشحن من جهة لا تملكونها، فهذه الميزة في 2.19 تستحق مناقشتها مع المطورين لديكم.

يمكنكم التحكم في رسائل البريد الإلكتروني عند تعديل الطلبات

تعديلات الطلب جزء روتيني من خدمة العملاء: يتصل العميل لإضافة منتج، أو تغيير مقاس، أو إزالة عنصر قبل الشحن. سابقًا، لم يكن بالإمكان ضبط سلوك الإشعارات المرتبطة بهذه التعديلات.

سير عمل تعديل الطلبات الآن يحترم تفضيلات الإشعارات، أي أنه عند تنفيذ تعديل على الطلب، يمكن لفريقكم اختيار إرسال إشعار للعميل أو عدم إرساله — بما يتوافق مع إعدادات التفضيلات التي توفرها Medusa بالفعل في العمليات الأخرى على الطلبات.

القيمة هنا في التقدير المناسب. بعض التعديلات تستحق فعلاً إرسال بريد إلكتروني — يجب أن يعرف العميل إذا أُزيل منتج غير متوفر. تعديلات أخرى تصحيحية داخلية فقط وتسبب ارتباكًا أو تذكرة دعم إذا وصلت إلى البريد الوارد للعميل. منح فريقكم التحكم في ذلك تغيير بسيط يقلل من حجم التواصل مع الدعم.

تسجيل دخول الموظفين يمكن ربطه بمزود الهوية لديكم

Medusa 2.19 يضيف مزود مصادقة OIDC عام. OIDC (OpenID Connect) هو المعيار المفتوح الذي تعتمد عليه معظم أنظمة الهوية المؤسسية، ما يعني أن Medusa يمكن ربطها الآن بنفس نظام الدخول الذي يستخدمه فريقكم لباقي الأنظمة.

لماذا يجب على مدير متجر إلكتروني الاهتمام بميزة تبدو تقنية بحتة:

• إلغاء وصول الموظفين فعّال فعلاً. عند مغادرة أحد الموظفين، إلغاء حسابه المركزي يقطع وصوله إلى لوحة الإدارة أيضًا. لا حاجة للبحث عن حسابات متبقية تملك صلاحيات استرداد الأموال.
• سياسة الأمان الحالية لديكم تطبق كما هي. المصادقة متعددة العوامل الإلزامية، انتهاء الجلسات، قواعد الوصول المشروط — كلها تُفرض من مكان واحد بدلاً من إعادة تنفيذها في كل نظام.
• التدقيق يصبح أسهل. "كيف تتحكمون في الوصول إلى لوحة إدارة التجارة؟" يصبح سؤالاً أسهل عندما يكون الجواب: "بنفس الطريقة التي نتحكم بها في باقي الأنظمة."

هذه خطوة تأسيسية وليست تكاملاً نهائيًا — ربطها بمزود الهوية الخاص بكم يتطلب عمل فريق التطوير. لكنها القطعة الأساسية التي كان يجب توفرها أولاً، وهي متاحة الآن.

تم نقل البحث إلى الواجهة الخلفية

المصادقة ليست الجزء الوحيد الذي أعيد بناؤه في 2.19. الإصدار يغير أيضًا طريقة البحث داخل لوحة الإدارة — مربع البحث الذي يستخدمه فريقكم عدة مرات يوميًا.

الإصدار 2.19 يقدم وحدة بحث مع نقطة نهاية بحث في الواجهة الخلفية، بالإضافة إلى DSL — طريقة منظمة لتعريف كيفية بناء فهارس البحث — وتم تحويل البحث في لوحة الإدارة لاستخدام نقطة النهاية الخلفية.

لم تنشر Medusa أرقام أداء رسمية لهذا التغيير، لذا تعاملوا مع أي ادعاءات سرعة محددة بحذر. ما هو مؤكد من الناحية الهيكلية أن عمليات البحث أصبحت الآن تتم على الخادم عبر وحدة مخصصة بدلاً من الطريقة السابقة، وهذا هو التصميم المناسب إذا كان الكتالوج لديكم كبيرًا أو في توسع. إذا كان فريقكم يواجه صعوبات مع البحث في لوحة الإدارة على كتالوج ضخم، فهذا الإصدار غيّر الأساس — يستحق إعادة الاختبار بعد الترقية.

ثلاث تغييرات جذرية، بلغة واضحة

ملاحظات الإصدار تشير إلى ثلاث تغييرات جذرية. فيما يلي ما تعنيه كل واحدة منها فعليًا.

1. ترقية Vite 7 وReact Router 7. تم شرحها أعلاه — متطلبات المتصفح وNode ارتفعت. الخطر يخص أي إضافات مخصصة على لوحة الإدارة طورها فريقكم؛ قد تحتاج إلى تحديث. اسألوا المطورين إن كان لديكم أي منها.

2. إزالة أربع طرق لخيارات المنتجات من JS SDK. تم حذف طرق إنشاء وتحديث واسترجاع وحذف خيارات المنتجات؛ البديل هو طريقة التحديث العامة للمنتج. هذا يؤثر فقط على الشيفرة أو التكاملات المخصصة التي تعتمد على هذه الطرق تحديدًا. التغيير محدد، لكن إذا كان لديكم مزامنة PIM أو أداة منتجات بالجملة، يستحق المراجعة.

3. إجمالي السلة والطلبات يُدرج افتراضيًا الآن. سابقًا، كان طلب جميع الحقول في السلة أو الطلب لا يشمل المجاميع المحسوبة. الآن أصبحت مدرجة. هذا يجعل السلوك الافتراضي أكثر وضوحًا، لكنه يعني أن هذه الطلبات أصبحت أثقل من قبل. توجيه Medusa هو طلب الحقول التي تحتاجونها فقط بدلاً من كل شيء — لذا إذا كان المتجر أو أي تكامل يجلب السلات والطلبات بشكل واسع، يستحق مراجعة الأداء بعد الترقية.

أسئلة يجب طرحها على فريقكم قبل الترقية

لستَ مضطراً لتنفيذ الترقية بنفسك. لكن من الضروري التأكد من طرح الأسئلة الصحيحة. فيما يلي الأسئلة التي تستحق التوثيق:

1. هل نستخدم إصدار Node مدعوم (^20.19.0، ^22.12.0 أو إصدار LTS أحدث)؟ وإذا لم يكن الأمر كذلك، ما الخطة؟
2. ما المتصفحات التي يستخدمها فريقنا للوصول إلى لوحة الإدارة؟ وهل يوجد أي متصفح بإصدار أقدم من Chrome 107 أو Edge 107 أو Firefox 104 أو Safari 16؟
3. هل أنشأنا إضافات مخصصة للوحة تحكم الإدارة؟ وهل تم اختبارها مع Vite 7 وReact Router 7؟
4. هل يستخدم أي جزء من الشيفرة لدينا طرق SDK الخاصة بخيارات المنتج التي تم حذفها؟
5. هل نطلب جميع الحقول في عربات التسوق أو الطلبات في أي موضع؟ إذا كان الجواب نعم، كيف يؤثر تغيير المجاميع على أوقات الاستجابة؟
6. هل اختبرنا ذلك على بيئة تجريبية تحاكي بيئة الإنتاج، بما في ذلك تنفيذ ترحيلات قاعدة البيانات؟
7. ما خطة التراجع لدينا إذا ظهرت مشكلة بعد الإطلاق؟

هل ينبغي عليك الترقية؟

نعم، وفق جدول زمني مدروس.

الميزات التشغيلية في الإصدار 2.19 تهدف إلى إزالة العوائق بدلاً من إضافة قدرات جديدة تتطلب التعلم: تصدير المخزون، عناوين التنفيذ المرنة، والتحكم في الإشعارات هي أمور سيبدأ فريقك باستخدامها مباشرة. أما موفر OIDC فهو ذو قيمة استراتيجية إذا كنت في مرحلة أصبحت فيها إدارة الوصول والتدقيق أموراً ضرورية — وهذه المرحلة تصل إليها معظم شركات التجارة المتنامية أسرع مما تتوقع.

التغييرات الجوهرية محدودة وموثقة جيداً. الخطر الواقعي ليس في فشل الترقية نفسها؛ بل في عدم التحقق من المتصفح على جهاز المستودع، أو توقف إضافة مخصصة للوحة الإدارة لم يتم تحديثها منذ ثمانية أشهر عن العمل دون ملاحظة.

نفذ الترقية على بيئة تجريبية، وراجع الأسئلة السبعة أعلاه، وحدد موعد الترقية في بيئة الإنتاج في صباح يكون فيه المطورون متواجدين وحجم الطلبات منخفضاً. هذه هي الخطة كاملة.

هل تدير متجراً على Medusa؟

نتولى تطوير Medusa للمتاجر التي تكون فيها مراجعة بيئة الاختبار، وتدقيق الإضافات، ونافذة الترقية، مسؤولية واضحة — مسؤوليتنا نحن. وهو نفس النهج الذي اعتمدناه في مشاريع مثل واجهة AURA&CO متعددة المناطق على Medusa 2.18. إذا كنت تفضل أن يتولى فريق آخر ترقية 2.19، تواصل معنا.