ابدأ بمنتج واحد: دليل SKU.md لتجار Shopify وSHOPLINE وWooCommerce وBigCommerce
موضوعات v1.0.0
قارن شروط النشر على أربع منصات، ثم أنشئ معرفة منتج واحد وراجعها وتحقق من نشرها في تجربة محدودة.
لا يتطلب إعداد معرفة المنتجات لوكلاء التسوق إعادة بناء المتجر. يمكن لتجار Shopify وSHOPLINE وWooCommerce وBigCommerce البدء بمنتج واحد، وجمع معلومات دقيقة، والتحقق من كيفية تقديم الملف، ثم تقرير التوسع.
يقدم SKU.md v1.0.0 تمثيلًا مفتوحًا قابلًا للفحص يكمل صفحات المنتجات والبيانات المنظمة وخلاصات القنوات. تستمر أنظمة المخزون والدفع والطلبات في إدارة التجارة الحية. المسارات التالية خيارات للتقييم، وليست إعلانًا عن دعم أصلي من المنصات الأربع.
تحقق أولًا مما تستطيع واجهتك تقديمه
دقة المحتوى وصحة تقديمه عبر الإنترنت مهمتان منفصلتان. يعد فريق المتجر المواصفات والنسخ والقيود والمصادر، ويتحقق المطور أو مزود الخدمة من الاستجابة الفعلية على نطاق المتجر.
يستند الجدول إلى وثائق رسمية، لكنه لا يشهد بتوافق متجر بعينه. يعتمد التنفيذ على الاستضافة والصلاحيات واختبار الاستجابة، ولا تكفي إمكانية رفع ملف.
| المنصة | ما يمكن التحكم فيه | ما يجب تأكيده | ما يُفحص |
|---|---|---|---|
| Shopify | محتوى القالب ومسارات واجهة يديرها التاجر بحسب البنية | بادئات App Proxy المقيدة لا تعني التحكم في أي مسار جذري | استجابة Markdown بدل HTML القالب |
| SHOPLINE | بيانات المنتجات وإعادة التوجيه المسموح بها | إعادة التوجيه لا تثبت المطابقة؛ يلزم تأكيد التقديم من الأصل نفسه | الوجهة والمحتوى وسلسلة التحويل |
| WooCommerce | مسارات WordPress أو ملفات ثابتة وفق صلاحيات الاستضافة | يلزم إعداد الاستجابة الصحيحة، لا قاعدة إعادة كتابة فقط | الحالة ونوع المحتوى والتخزين المؤقت والبايتات |
| BigCommerce | قوالب Stencil أو مسارات واجهة يديرها التاجر | قالب الصفحة لا يثبت وجود استجابة Markdown في الجذر | التمييز بين صفحة HTML واستجابة ملف |
هذه استنتاجات تنفيذية من قدرات المنصات، وليست شهادات توافق. إن لم يتوفر مسار مناسب، حسّن معلومات المنتج واطلب من مزود الخدمة تقييم الخيارات. لا تغيّر المنصة لمجرد ملف واحد.
كيف يجري الاكتشاف في المواصفة الحالية؟
الأولوية للمسار الدقيق /sku.md على الموقع نفسه. لا يجوز للمستهلك فحص إعلان بديل واحد واضح في الصفحة الرئيسية من الأصل نفسه إلا بعد استجابة HTTP 404 دقيقة من الجذر، مثل:
<link rel="alternate" type="text/markdown" title="SKU.md" href="/catalog.md">يجب أن يطابق الملف المعلن المواصفة أيضًا: HTTPS من الأصل نفسه، دون query أو fragment. انتهاء المهلة أو خطأ الخادم أو الوثيقة غير الصحيحة لا يعني غياب الجذر.
هذا مسار مشروط، وليس حيلة تعمل على كل قالب. يجب التحكم في الإعلان والملف الفعلي وفحصهما. رابط تنزيل CDN أو صفحة تعريف HTML أو تحويل إلى أصل آخر لا يحقق المطابقة تلقائيًا.
ابدأ بكتالوج صغير
هذا مثال لمتجر خيالي. استبدل الاسم والملخص والنطاق ورابط الكتالوج بقيم حقيقية قبل الإنشاء والفحص. ملف الجذر وحده لا يدعي وصف جميع سمات المنتج.
# Example Outdoor Gear
> Lightweight outdoor equipment for hikers.
SKU.md: [1.0.0](https://sku.md/spec/1.0.0/)
Website: [example-outdoor.com](https://www.example-outdoor.com/)
## Catalog
- [All products](https://www.example-outdoor.com/collections/all)وثائق معرفة المنتجات اختيارية. عند إضافة أول وثيقة، اربطها صراحة من الجذر، وأدرج فيها رابط العودة إلى الكتالوج وصفحة المنتج ومصادر الحقائق الفردية. حدد هل تنطبق الحقيقة على المنتج كله أم على نسخة معينة.
تجربة قابلة للفحص في خمس خطوات
- اختر المنتج. فضّل منتجًا بوثائق عامة مكتملة وأسئلة متكررة عن المواصفات. لا حاجة إلى زحف المتجر كله.
- راجع الحقائق. طابق الهوية والمواصفات والقيود والأدلة مع الصفحات الفعلية، واترك المجهول مجهولًا.
- أنشئ وافحص. جهز الجذر باستخدام المولّد، واستعن بأداة تحسين المنتج لمراجعة السمات بالتفصيل.
- انشر وتحقق. يقدّم مسؤول المتجر الملف، ثم تفحص أداة العنوان المنشور الرابط الفعلي. تحقق أيضًا من علاقة وثائق المنتجات بالكتالوج.
- حدد الصيانة. عيّن مسؤولًا، واحتفظ بالأدلة، وحدّث وأعد الفحص عند تغير المواصفات أو النسخ أو المصادر.
يشمل القبول HTTPS عامًا، واستجابة HTTP 200، ومحتوى Markdown بترميز UTF-8، ونوعًا مسموحًا هو text/markdown أو text/plain. تحتاج التحويلات الآمنة وعلاقات الكتالوج والمصادر إلى فحص أيضًا. رؤية نص في المتصفح لا تثبت نجاح كل الطبقات.
متى تتوسع؟
تثبت التجربة المفيدة أن الملف متاح، والحقائق لها مصادر، ونطاق النسخ صحيح، وأن الأسئلة الحية تُحال إلى نظام المتجر. افحص ذلك قبل التوسع بدل الاكتفاء بعدّ الملفات المولدة.
لا يسجل SKU.md الدخول إلى لوحة الإدارة، ولا ينشر المنتجات تلقائيًا، ولا يرسلها إلى قنوات تسوق خارجية. يقرر التاجر ما ينشره، ويُتحقق من استهلاك الوكلاء للمعرفة بصورة مستقلة. تبقى الأسعار والمخزون والتزامات التسليم في الأنظمة الحية.
اتبع البدء السريع وسلّم معرفة مراجعة لمنتج واحد إلى المسؤول عن واجهتك. إنها بداية صغيرة ومحددة تكشف المشكلة التالية التي تستحق المعالجة.