[
  {
    "id": "start",
    "group": "start",
    "group_title": "البداية واستخدام اللوحة",
    "title": "تسجيل الدخول واختيار المتجر",
    "paths": [
      "/login",
      "/reset-password",
      "/admin/no-store"
    ],
    "paragraphs": [
      "ابدأ بتسجيل الدخول بحساب الموظف. البيانات والطلبات والمنتجات تخص المتجر المختار؛ راجع اسم المتجر أعلى اللوحة قبل أي تعديل."
    ],
    "steps": [
      "أدخل بيانات الدخول ثم انتظر فتح اللوحة؛ عند رفض الدخول راجع رسالة الخطأ بدل تكرار المحاولة سريعًا.",
      "اختر متجرًا متاحًا من مبدّل المتجر أعلى الشاشة. لا يمكن دخول متجر غير مفعّل أو غير معيّن لحسابك.",
      "اختر العربية أو الإنجليزية من زر اللغة. تغيير اللغة لا يغيّر المتجر أو بياناته.",
      "عند نسيان كلمة المرور استخدم رابط استعادة كلمة المرور واتبع التعليمات الظاهرة. إذا ظهرت شاشة عدم وجود متجر، اطلب من المسؤول مراجعة تعيين حسابك."
    ],
    "fields": [
      "المتجر الحالي: يحدد نطاق البيانات والصلاحيات الخاصة بالمتجر.",
      "اللغة: تتحكم في اتجاه اللوحة وترجمة العناوين، ولا تترجم محتوى المنتجات تلقائيًا."
    ],
    "tips": [
      "اختفاء شاشة أو رفض فتح رابطها قد يكون بسبب صلاحيتها؛ صلاحية العرض تختلف عن صلاحية الإضافة أو التعديل.",
      "كتالوج المنتجات مستقل لكل متجر. البلاد مرجع مشترك، وإعدادات تطبيق الجوال مشتركة بين متاجر العميل نفسه؛ يوضح الدليل هذين الاستثناءين في شاشاتهما."
    ],
    "examples": [
      "موظف له متجران يختار المتجر المقصود قبل البحث عن المنتج؛ تشابه الاسم لا يعني مشاركة المخزون."
    ],
    "troubleshooting": [
      "لا يوجد متجر متاح: راجع تفعيل المتجر وتعيين الموظف له قبل إعادة تسجيل الدخول."
    ]
  },
  {
    "id": "account",
    "group": "start",
    "group_title": "البداية واستخدام اللوحة",
    "title": "حساب الموظف وكلمة المرور وشكل اللوحة",
    "paths": [],
    "paragraphs": [
      "من قائمة الحساب أعلى الشاشة يمكن تغيير كلمة مرور الموظف أو تسجيل الخروج، ومن أزرار الرأس يمكن تبديل اللغة والمظهر والبحث عن شاشة."
    ],
    "steps": [
      "افتح قائمة حسابك واختر تغيير كلمة المرور.",
      "أدخل كلمة المرور الحالية والجديدة وتأكيد الجديدة، ثم احفظ وانتظر النجاح أو أخطاء الحقول.",
      "استخدم زر المظهر للتبديل بين الفاتح والداكن وأزرار القائمة لتوسيع التنقل أو فتحه على الجوال.",
      "استخدم تسجيل الخروج عند الانتهاء على جهاز مشترك؛ لا تشارك حسابك مع موظف آخر."
    ],
    "fields": [
      "الحالية: للتحقق من هوية صاحب الحساب قبل التغيير.",
      "الجديدة والتأكيد: يجب أن يتطابقا ويحققا شروط الحفظ.",
      "البحث عن شاشة: اختصار تنقل، ويختلف عن البحث داخل قائمة المنتجات أو الطلبات.",
      "تغيير كلمة المرور: بعد النجاح تُبطل الجلسات الأخرى وفق سياسة النظام؛ راجع التنبيه وأعد تسجيل الدخول إذا طلبت الشاشة ذلك."
    ],
    "tips": [
      "تغيير كلمة مرورك يخص حساب الموظف الحالي، وليس كلمة مرور عميل المتجر. لا تغيّر بيانات حساب تجريبي لمجرد اختبار الشرح."
    ],
    "examples": [
      "استخدام حساب مستقل لكل موظف يسمح بمراجعة سجل التدقيق ومبيعات مدخل الطلب بصورة واضحة."
    ],
    "troubleshooting": [
      "كلمة المرور الحالية غير صحيحة: صححها أو استخدم الاستعادة؛ تغيير اللغة أو المتجر لا يغيّر كلمة المرور."
    ]
  },
  {
    "id": "access-errors",
    "group": "start",
    "group_title": "البداية واستخدام اللوحة",
    "title": "رفض الوصول والصفحة غير الموجودة",
    "paths": [
      "/admin/unauthorized",
      "/404"
    ],
    "paragraphs": [
      "قد تظهر صفحة رفض الوصول عند نقص صلاحية الشاشة أو صفحة غير موجودة عندما يكون الرابط غير صحيح أو قديمًا."
    ],
    "steps": [
      "راجع عنوان الصفحة واسم المتجر المختار.",
      "ارجع للقائمة الجانبية وافتح الشاشة من رابطها الحالي بدل تعديل عنوان سجل يدويًا.",
      "إذا استمر رفض الوصول اطلب مراجعة صلاحية الشاشة وتعيين المتجر؛ إذا لم يوجد السجل راجع البحث والحذف والصلاحيات."
    ],
    "fields": [
      "رفض الوصول: الحساب غير مخوّل للمسار المطلوب في السياق الحالي.",
      "غير موجودة: لا توجد صفحة مطابقة لهذا الرابط، ولا يعني ذلك بالضرورة حذف بيانات المتجر."
    ],
    "tips": [
      "لا تعالج رفض الوصول بمنح صلاحيات مالية أو إدارية شاملة؛ امنح صلاحية الشاشة والإجراء اللازمين فقط."
    ],
    "examples": [
      "حساب يملك عرض الطلبات دون تعديلها قد يفتح الطلب ولا تظهر له أزرار التغيير."
    ],
    "troubleshooting": [
      "الرابط يرفض الوصول بعد تبديل المتجر: تحقق من تعيين الحساب وصلاحياته في المتجر الجديد."
    ]
  },
  {
    "id": "guide",
    "group": "start",
    "group_title": "البداية واستخدام اللوحة",
    "title": "دليل الاستخدام والمساعد",
    "paths": [
      "/admin/guide"
    ],
    "paragraphs": [
      "هذه الصفحة مرجع تشغيل اللوحة، مرتبة حسب أقسام القائمة الجانبية. لكل شاشة وظيفة وخطوات وشرح حقول وملاحظات على النتيجة المتوقعة."
    ],
    "steps": [
      "اختر قسمًا من الفهرس أو اكتب اسم شاشة أو إجراء أو حقل في البحث.",
      "افتح شرح الشاشة، واتبع الخطوات بالترتيب، ثم راجع الملاحظات قبل الحفظ.",
      "استخدم توسيع الشروحات لقراءة النتائج كاملة أو طباعة لحفظها عبر نافذة طباعة المتصفح.",
      "افتح المساعد من أعلى اللوحة للسؤال عن طريقة الاستخدام؛ المساعد يعتمد على نفس الدليل.",
      "اقرأ الأمثلة العملية لتجربة حالة واضحة، ثم راجع مشكلات شائعة وطريقة حلها إذا اختلفت النتيجة."
    ],
    "fields": [
      "البحث: يبحث داخل العناوين والشرح والخطوات والحقول والملاحظات.",
      "القسم: يحصر الدليل في مجموعة شاشات؛ اختر كل الأقسام للعودة للدليل الكامل.",
      "البحث يشمل أيضًا أمثلة الاستخدام وحلول المشكلات ومعرّف الموضوع ومسارات الشاشات؛ يمكنك البحث بكلمات مثل POS أو abandoned carts أو اسم المسار."
    ],
    "tips": [
      "المساعد لا يقرأ طلبًا مباشرًا ولا يعدّل أسعارًا أو إعدادات، وقد يحتاج تفعيلًا من مسؤول النظام.",
      "الطباعة تشمل الشروحات المطابقة للبحث والقسم الحالي؛ امسح البحث واختر كل الأقسام لطباعة الدليل الكامل."
    ],
    "examples": [
      "ابحث عن نصف ساعة للوصول لتفسير فلاتر السلات، أو POS لشرح الكاشير وتقرير مدخل الطلب."
    ],
    "troubleshooting": [
      "لا توجد نتيجة: امسح تحديد القسم واستخدم كلمة أقصر أو اسم المسار؛ الطباعة تحترم التصفية الحالية."
    ]
  },
  {
    "id": "lists",
    "group": "start",
    "group_title": "البداية واستخدام اللوحة",
    "title": "طريقة استخدام القوائم والنماذج",
    "paths": [],
    "paragraphs": [
      "القوائم تعرض سجلات المتجر في صفحات. الفلاتر تغيّر النتائج، وتحديد الصفوف يجهّز إجراء جماعيًا عندما توفره الشاشة."
    ],
    "steps": [
      "اكتب البحث وانتظر تحديث النتائج، ثم اضبط الفلاتر. امسح البحث والفلاتر إذا لم يظهر سجل تتوقعه.",
      "استخدم أزرار الصف: العين للتفاصيل، القلم للتعديل، والأزرار الأخرى حسب تلميحها وصلاحيتك.",
      "في نموذج الإضافة أو التعديل املأ الحقول المطلوبة، واضغط حفظ، وانتظر رسالة النجاح أو الأخطاء تحت الحقول.",
      "إذا فشل تحميل القائمة استخدم إعادة المحاولة؛ إذا رُفض الحفظ صحح الحقول المشار إليها ثم احفظ مرة أخرى."
    ],
    "fields": [
      "الحالة: قد تعني تفعيل السجل، بينما الجدول الزمني يوضح هل العرض جارٍ أو مجدول أو منتهٍ.",
      "الحذف: اقرأ رسالة التأكيد؛ بعض الشاشات تدعم الحذف الناعم والاستعادة، وأخرى لا تدعم الاستعادة.",
      "الأسعار: تُحسب بثلاث خانات عشرية؛ مثال 4.000 وليس 4000."
    ],
    "tips": [
      "لا تعتبر الضغط على حفظ نجاحًا حتى تظهر رسالة النجاح. إغلاق النموذج قبلها قد يفقد التعديلات.",
      "السجل المرتبط بطلبات أو سجلات أخرى قد يرفض الحذف؛ اقرأ السبب واستخدم التعطيل إذا كان متاحًا ومناسبًا."
    ],
    "examples": [
      "عدم ظهور طلب مع بحث قديم: امسح البحث وأعد الفلاتر ثم راجع الصفحة الأولى."
    ],
    "troubleshooting": [
      "الحفظ أظهر خطأ: اقرأ الرسالة والحقل الذي رفض؛ لا تخرج من النموذج قبل حفظ التعديل الصحيح."
    ]
  },
  {
    "id": "operating-checklist",
    "group": "start",
    "group_title": "البداية واستخدام اللوحة",
    "title": "من أين أبدأ؟ تجهيز المتجر ودورة العمل اليومية",
    "paths": [],
    "paragraphs": [
      "هذا المسار يجمع ترتيب العمل من إعداد المتجر إلى بيع الطلب ومتابعته. افتح شرح كل شاشة من البحث قبل تنفيذها للمرة الأولى."
    ],
    "steps": [
      "راجع المتجر الحالي واللغة والعملة والمنطقة الزمنية من ملف المتجر، ثم عيّن حسابات الفريق وأدوارهم.",
      "جهّز الأقسام والتصنيفات والعلامات والخصائص والخيارات، ثم أضف المنتجات والأسعار والمخزون والصور والمتغيرات أو مكونات الباكدج.",
      "حدّد دول التوصيل وطرق الشحن والفروع وأسعار العنوان أو خطط الأوزان. اختبر عنوانًا من كل نطاق واستلامًا من الفرع إذا كان مدعومًا.",
      "راجع إعدادات إتمام الشراء والضريبة وطرق الدفع وقنوات الإشعارات. استخدم إعدادات الاختبار المعتمدة عند اختبار البيع.",
      "في بداية اليوم راجع الطلبات الجديدة والدفع المعلّق ونفاد المخزون وفشل الإرسال والمزامنة.",
      "نفّذ البيع من الطلبات أو POS، وراجع العميل والأصناف والشحن والإجمالي قبل الإنشاء؛ بعدها تابع الدفع والتجهيز والتسليم كلًا على حدة.",
      "عند إرجاع طلب، راجع الاسترداد المالي وإرجاع البضاعة والمخزون والكاش باك من شاشاتها قبل اعتبار المعالجة مكتملة.",
      "في نهاية اليوم طابق المحصّل والمسترد حسب العملة، وراجع الطلبات غير المكتملة ومهام التكامل والإشعارات الفاشلة."
    ],
    "fields": [
      "إعداد المتجر: بيانات تخص المتجر المختار؛ كتالوجه ومخزونه لا يُنسخان تلقائيًا إلى متجر آخر.",
      "المحتوى: البانرات والمجموعات والصفحات تنظّم العرض؛ لا تستبدل تفعيل المنتج أو تسجيل سعر ومخزون صالحين.",
      "نتيجة الإجراء: رسالة نجاح ثم بيانات محفوظة بعد التحديث. إنشاء مهمة في الطابور ليس اكتمال مزامنة أو وصول رسالة."
    ],
    "tips": [
      "استخدم حساب كل موظف باسمه؛ يساعد ذلك في سجل التدقيق وتقرير مبيعات مدخلي الطلبات. لا تستخدم حسابًا مشتركًا إذا كنت تريد معرفة من أنشأ كل طلب."
    ],
    "examples": [
      "بيع من POS: اختيار العميل ← إضافة المنتج والمتغير ← تحديد التوصيل أو الاستلام ← مراجعة الدفع ← إنشاء الطلب ← متابعة التجهيز والتسليم ← مراجعة التقرير."
    ],
    "troubleshooting": [
      "الطلب ظاهر لكن لا يوجد تحصيل: راجع حالة الدفع ووسيلته. تأكيد الطلب أو إرسال فاتورته لا يثبت تحصيل قيمة الدفع عند الاستلام."
    ]
  },
  {
    "id": "operating-concepts",
    "group": "start",
    "group_title": "البداية واستخدام اللوحة",
    "title": "معاني الحالات: الطلب والدفع والمخزون والإرسال",
    "paths": [],
    "paragraphs": [
      "اقرأ اسم الحالة مع نوع السجل. كلمة نشط أو ناجح أو مؤكد لا تعني نفس الشيء في كل الشاشات."
    ],
    "steps": [
      "ابدأ بتحديد هل تراجع منتجًا أم طلبًا أم دفعة أم شحنة أم رسالة أو مزامنة.",
      "افتح السجل المرتبط عندما يكون القرار ماليًا أو متعلقًا بالمخزون؛ لا تعتمد على شارة منفردة.",
      "بعد أي إجراء راجع الحالة والإجمالي والمرجع وآخر نشاط، ثم حدّث الشاشة عند انتظار مهمة خلفية."
    ],
    "fields": [
      "حالة المنتج: تحدد النشر؛ توافره للبيع يحتاج مخزونًا صالحًا للمنتج أو متغيره أو مكونات الباكدج.",
      "حالة الطلب: دورة التنفيذ من الانتظار إلى التجهيز والشحن والتسليم أو الإلغاء؛ منفصلة عن حالة الدفع.",
      "حالة الدفع: توضح المبلغ المحصّل أو المنتظر أو المسترد. وسيلة الدفع ليست حالة الدفع.",
      "جاهزية الصنف وتعيين المندوب: بيانات تنفيذ؛ لا تسجّل تحصيلًا أو تسليمًا تلقائيًا.",
      "مفتوحة في السلات: تشمل نشطة ومتروكة. مدة عدم النشاط فلتر مستقل.",
      "في الانتظار أو مجدولة أو قيد التنفيذ: المهمة لم تُثبت نجاحها النهائي بعد.",
      "ناقص البيانات في الربحية: معلومة غير معروفة، ولا يصح اعتبارها صفرًا."
    ],
    "tips": [
      "كل مبلغ يُقرأ مع عملته، وكل فترة مع منطقتها الزمنية وتعريف تاريخ التقرير. مبلغ مبيعات الطلبات يختلف عن التحصيل وهامش المساهمة."
    ],
    "examples": [
      "طلب دفع عند الاستلام يمكن أن يكون مؤكدًا وتشغيله جارٍ بينما التحصيل ما زال غير مسجل. تابع تنفيذ الطلب والتحصيل في مسارين واضحين."
    ],
    "troubleshooting": [
      "المنتج ظاهر لكنه غير قابل للشراء: راجع حالة المنتج ثم حالة المتغير ومخزونه وحدود الكمية؛ في الباكدج راجع مكونات كل قطعة."
    ]
  },
  {
    "id": "dashboard",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "لوحة التحكم الرئيسية",
    "paths": [
      "/admin/dashboard"
    ],
    "paragraphs": [
      "تعرض ملخص المتجر: الطلبات والمدفوعات والمنتجات والتنبيهات وقائمة النشاط الحديث. الأرقام تتأثر بالفترة والعملة والمنطقة الزمنية."
    ],
    "steps": [
      "راجع المتجر المختار، ثم حدّد نطاق التاريخ والعملة عند توفرهما.",
      "اقرأ وصف البطاقة لمعرفة هل الرقم عدد طلبات أم مبلغ محصّل أم صافي بعد الاسترداد.",
      "اضغط البطاقة أو رابط التفاصيل لفتح القائمة أو التقرير بنفس سياقها، ثم راجع الفلاتر في الصفحة المفتوحة.",
      "راجع الطلبات والمدفوعات الحديثة والتنبيهات التشغيلية، وافتح السجل المطلوب بدل الاعتماد على الإجمالي فقط."
    ],
    "fields": [
      "المحصّل: مبالغ المدفوعات المؤكدة داخل فترة التقرير.",
      "المسترد وصافي التحصيل: الصافي يطرح الاسترداد المعتمد من المحصّل؛ ليس ربح المنتجات.",
      "المخزون المنخفض: منتجات مفعّلة مخزونها 5 وحدات أو أقل."
    ],
    "tips": [
      "لا تجمع عملات مختلفة في مبلغ واحد. قارن التقارير بنفس العملة والفترة.",
      "عدم ظهور بطاقة أو رابط قد يرجع لصلاحية الشاشة المرتبطة، وليس لعدم وجود بيانات."
    ],
    "examples": [
      "قبل مقارنة المحصّل اليومي اختر نفس KWD والفترة في النظرة المالية، ثم افتح المدفوعات المرتبطة."
    ],
    "troubleshooting": [
      "بطاقة غير ظاهرة: راجع صلاحية التقرير أو القائمة التي تفتحها، لا عدد السجلات وحده."
    ]
  },
  {
    "id": "reports",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "مركز التقارير",
    "paths": [
      "/admin/reports"
    ],
    "paragraphs": [
      "يجمع روابط التقارير المتاحة لحسابك. كل تقرير يجيب عن سؤال مختلف؛ استخدم التقرير المناسب قبل تفسير الرقم."
    ],
    "steps": [
      "افتح مركز التقارير وحدد هل تراجع ماليات أو مخزونًا أو عملاء أو تسويقًا.",
      "اختر بطاقة التقرير، ثم اضبط الفترة والعملة والفلاتر التي يعرضها.",
      "قارن النتائج بفترة مماثلة وبنفس العملة، وافتح السجلات التفصيلية عندما تتاح روابطها."
    ],
    "fields": [
      "التقارير المالية: التحصيل والاسترداد والصافي وحالات الدفع وأداء البوابات. تقرير الربحية يشرح هامش المساهمة بعد تكلفة المنتجات والمصاريف المباشرة المسجلة.",
      "التقارير التشغيلية: المخزون وطلبات التوافر والعملاء ومصادرهم والبحث والتسويق."
    ],
    "tips": [
      "ظهور تقرير يتطلب صلاحيته الخاصة. قد لا تظهر كل التقارير لكل موظف.",
      "الفترة الموضحة مع المنطقة الزمنية هي مرجع المقارنة، وليس توقيت جهاز الموظف وحده."
    ],
    "examples": [
      "سؤال من أدخل الطلب يذهب لمبيعات مدخلي الطلبات؛ سؤال من دفع يراجع من المدفوعات."
    ],
    "troubleshooting": [
      "تقرير فارغ: تحقق من متجره والفترة والعملة وتعريف الحالة قبل اعتبار المبيعات صفرًا."
    ]
  },
  {
    "id": "staff-sales-report",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "مبيعات مدخلي الطلبات والموظفون ذوو المبيعات الصفرية",
    "paths": [
      "/admin/reports/staff-sales"
    ],
    "paragraphs": [
      "من التقارير ← مبيعات مدخلي الطلبات تراجع طلبات POS حسب الموظف الذي أنشأ الطلب، وليس العميل الذي اشتراه. يحتاج التقرير صلاحية reports.staff_sales.view."
    ],
    "steps": [
      "راجع المتجر، وحدد من وإلى حسب منطقة المتجر الزمنية، ثم اكتب العملة إذا أردت نتيجة بعملة واحدة.",
      "اترك مدخل الطلب على كل المستخدمين لعرض موظفي المتجر، أو اختر موظفًا بعينه حتى لو لم يدخل أي طلب.",
      "راجع عدد الطلبات وطلبات المبيعات والملغى والمسترد لكل موظف، ثم قارن إجمالي المبيعات بإجمالي مبالغ الطلبات.",
      "راجع كل عملة منفصلة. موظف بلا طلبات مطابقة يظهر بعدادات صفر ومبالغ 0.000، ولا يختفي من الجدول.",
      "لمراجعة التحصيل الحقيقي انتقل للتقارير المالية والمدفوعات بنفس الفترة والعملة؛ هذا التقرير يجمع قيم الطلبات."
    ],
    "fields": [
      "عدد الطلبات: طلبات POS المطابقة للفترة والعملة ومدخل الطلب، بما فيها الملغاة والمستردة.",
      "طلبات المبيعات وإجمالي المبيعات: تستبعد حالة ملغى ومسترد بالكامل؛ قد تشمل طلبات لم يُحصّل دفعها بعد.",
      "إجمالي مبالغ الطلبات: قيمة كل الحالات المطابقة، بما فيها الملغى والمسترد بالكامل.",
      "المستخدمون: عدد الموظفين المعروضين، ويشمل من تظهر أرقامهم صفرًا؛ غير مسجل ليس موظفًا معلومًا.",
      "الموظفون: يجمع تعيينات موظفي هذا المتجر ومدخلي طلباته السابقين، بما يحافظ على أسماء التاريخ المتاحة.",
      "غير مسجل: طلب POS قديم بلا مدخل محفوظ. لا يُنسب للعميل أو لموظف بالتخمين."
    ],
    "tips": [
      "التقرير للقراءة، ولا يغيّر عمولة الموظف أو راتبه أو حالة الطلب. صلاحية إنشاء طلب لا تمنح صلاحية مشاهدة التقرير تلقائيًا."
    ],
    "examples": [
      "لموظف طلب مؤكد 9.000 وطلب ملغى 3.000 KWD: عدد الطلبات 2، وطلبات المبيعات 1، وإجمالي المبيعات 9.000، وإجمالي مبالغ الطلبات 12.000. موظف آخر بلا طلبات يظهر 0.000."
    ],
    "troubleshooting": [
      "الموظف موجود لكن أرقامه صفر: راجع الفترة والعملة وأن الطلب أُنشئ من POS بهذا الحساب؛ الطلبات القادمة من الموقع أو التطبيق لا تُنسب إليه كإدخال يدوي.",
      "التقرير لا يظهر: امنح صلاحية شاشته للموظف المسموح له، وراجع تعيينه للمتجر. صلاحية التقارير العامة وحدها لا تكفي."
    ]
  },
  {
    "id": "reports-reading",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "اختيار التقرير الصحيح ومقارنة الأرقام",
    "paths": [],
    "paragraphs": [
      "اختر التقرير حسب السؤال، ثم وحّد المتجر والفترة والعملة وتعريف التاريخ. اختلاف المبالغ بين تقريرين قد يكون ناتجًا عن اختلاف ما يحسبه كل تقرير."
    ],
    "steps": [
      "لمعرفة من أدخل طلبات POS استخدم مبيعات مدخلي الطلبات. لمعرفة هل الطلب من الموقع أو آيفون أو أندرويد أو POS استخدم مصادر الطلبات.",
      "لمعرفة مصدر تسجيل العملاء وآخر أجهزتهم استخدم مصادر العملاء والأجهزة؛ هذا مختلف عن مصدر طلب محدد.",
      "لمراجعة المحصّل والمسترد والصافي استخدم النظرة المالية وتقارير المدفوعات والبوابات والمرتجعات.",
      "لمراجعة هامش المنتجات بعد التكلفة استخدم الربحية واقرأ جودة البيانات قبل تفسير الناتج.",
      "لمتابعة الكمية والتوافر استخدم تقرير المخزون وطلبات أخبرني عند التوافر؛ ولمراجعة أداء البحث استخدم تحليلات البحث.",
      "قبل المقارنة راجع التاريخ الذي يعتمد عليه التقرير والعملة والمنطقة الزمنية والفلاتر، ثم حدّث النتائج في التقريرين."
    ],
    "fields": [
      "مبيعات الطلبات: قيمة الطلبات وفق شروط التقرير، وقد تشمل طلبًا لم يُحصّل بعد.",
      "المحصّل: مبالغ المدفوعات الناجحة الداخلة في تعريف التقرير وفترته.",
      "صافي التحصيل: المحصّل بعد الاسترداد المعتمد؛ لا يخصم تكلفة البضاعة تلقائيًا ليصبح ربحًا.",
      "هامش المساهمة: يعتمد على الإيراد والتكلفة والمصاريف والمرتجعات المسجلة وجودة بياناتها.",
      "صفر: لا توجد قيمة مطابقة للفلتر، أو موظف بلا طلبات في تقرير الإدخال. غير معلوم أو ناقص البيانات له معنى مختلف.",
      "مصادر الطلبات ومصادر العملاء: تصنيف الطلب يخص عملية الشراء؛ تسجيل العميل وآخر جهاز يخصان الحساب والنشاط."
    ],
    "tips": [
      "المصدر غير المحدد في بيانات قديمة لا يجوز نسبته إلى iPhone أو Android بالتخمين. التقارير لا تنشئ تاريخ أجهزة لم يُسجّل أصلًا."
    ],
    "examples": [
      "طلب POS قيمته 10.000 ولم يُدفع: يمكن أن يدخل في مبيعات مدخل الطلب بينما لا يظهر ضمن تحصيل ناجح. طلب أُنشئ في أكتوبر ودُفع في نوفمبر قد يدخل في فترتين مختلفتين حسب تعريف التقرير."
    ],
    "troubleshooting": [
      "الأرقام مختلفة: قارن التعريف أولًا، ثم حالات الطلب والدفع وتواريخ الإنشاء والتحصيل والاسترداد، وبعدها العملة والفلاتر. لا تغيّر الطلب لمجرد محاولة مطابقة بطاقتين مختلفتين."
    ]
  },
  {
    "id": "profitability-report",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "تقرير الربحية وهامش المساهمة",
    "paths": [
      "/admin/reports/profitability"
    ],
    "paragraphs": [
      "افتح التقارير ثم الربحية لمراجعة هامش الطلبات أو المنتجات في المتجر المختار. الشاشة تحتاج صلاحية reports.profitability.view. هامش المساهمة يخصم تكلفة المنتجات والمصاريف المباشرة المسجلة؛ لا يمثل صافي الربح المحاسبي بعد المصاريف العامة مثل الرواتب والإيجار.",
      "الفترة تختار الطلبات حسب تاريخ إنشائها والتي وصلت إلى التسليم، وفق المنطقة الزمنية المعروضة للمتجر. الاستردادات وتصحيحات التكلفة المسجلة لاحقًا تؤثر على الطلب الأصلي حتى وقت الفحص؛ لذلك قد تتغير نتيجة فترة قديمة بعد تحديث بياناتها.",
      "كل عملة تُعرض منفصلة، والمبالغ بثلاث خانات عشرية. اقرأ جودة البيانات بجانب الهامش: القيمة غير المعلومة ليست صفرًا، والهامش السالب نتيجة يجب مراجعتها ولا يُحوَّل إلى صفر."
    ],
    "steps": [
      "راجع المتجر الحالي، ثم افتح التقارير ← الربحية. ظهور التقرير وفتحه يحتاجان صلاحيته الخاصة، وليس مجرد صلاحية عامة للتقارير.",
      "حدد من وإلى، واكتب كود العملة مثل KWD إذا أردت تصفية النتائج بعملة واحدة. تتحدث النتائج عند تغيير الفلاتر، وتعود القائمة إلى الصفحة الأولى وتُغلق تفاصيل الطلب المختار.",
      "ابدأ بملخص كل عملة. راجع عدد الطلبات المكتملة والتقديرية وناقصة البيانات ونسبة التغطية قبل الاعتماد على مبلغ الهامش.",
      "اختر الطلبات لعرض رقم الطلب والعملة وصافي الإيراد قبل الاستردادات وتكلفة المنتجات والتكلفة المستعادة والمصاريف المباشرة والهامش وجودة البيانات. القائمة مقسمة إلى صفحات من 25 صفًا؛ استخدم السابق والتالي لباقي النتائج.",
      "اضغط التفاصيل أمام طلب لعرض أسباب نقص البيانات، وتوزيع الإيراد، والاستردادات الموزعة وغير الموزعة، والكاش باك، والكميات المعادة للمخزون، وحساب كل بند. اضغط التفاصيل مرة أخرى لإغلاقه.",
      "افتح رقم الطلب لمراجعة مستنداته وتكاليفه إذا كانت لديك صلاحية orders.view. داخل الطلب، عرض تكاليف الطلب الداخلية يحتاج orders.costs.view، وتسجيل التكلفة أو تصحيحها يحتاج orders.costs.manage.",
      "عند نقص التكلفة، راجع تكلفة كل وحدة والمصاريف المباشرة للشحن الفعلي ورسوم الدفع. سجّل القيمة الصحيحة بعملة الطلب وسبب التسجيل أو التصحيح، وحدد تقديري فقط عندما لا تكون القيمة مؤكدة. إذا لم توجد تكلفة فعلية لنوع مصروف، سجّل صفرًا صريحًا له بدل تركه غير مسجل.",
      "ارجع للتقرير واضغط تحديث بعد تصحيح التكلفة أو إتمام الاسترداد أو فحص المرتجع. راجع وقت الفحص وجودة البيانات الجديدة؛ التقرير نفسه للقراءة ولا يعدّل الطلب أو المخزون.",
      "اختر المنتجات للمقارنة حسب المنتج أو المتغير وSKU والعملة، ثم راجع الكمية وصافي إيراد المنتج والاسترداد الموزع وتكلفة البيع والتكلفة المستعادة والهامش. تغيير العرض يعود للصفحة الأولى ويغلق تفاصيل الطلب.",
      "اضغط تصدير CSV لتنزيل جميع النتائج المطابقة للفترة والعملة والعرض المختار، وليس الصفحة الحالية فقط. يُعطَّل التصدير أثناء التحميل أو عند عدم وجود صفوف؛ راجع رسالة الخطأ إذا لم يكتمل التنزيل."
    ],
    "fields": [
      "من / إلى والمنطقة الزمنية: نطاق تاريخ إنشاء الطلبات التي وصلت إلى التسليم؛ ليس فترة تحصيل المدفوعات أو فترة تنفيذ الاستردادات وحدها.",
      "العملة: كود من ثلاثة أحرف مثل KWD أو EGP. تركه فارغًا لا يحوّل العملات إلى عملة واحدة؛ اقرأ ملخص كل عملة بصورة مستقلة.",
      "وقت الفحص: وقت احتساب النتائج المعروضة. الاسترداد أو التصحيح اللاحق قد يغيّر نفس الفترة عند تحديث التقرير.",
      "هامش الطلبات مكتملة البيانات: مجموع هوامش الطلبات المصنفة مكتمل فقط. عند غيابها تظهر رسالة لا توجد طلبات مكتملة البيانات، وليس إجمالي ربح مؤكد بقيمة صفر.",
      "تغطية البيانات المكتملة: عدد الطلبات المكتملة مقسومًا على كل الطلبات المشمولة، مع عرض العدد والنسبة. مثال: 8 من 10 تعني تغطية 80%، وليست هامش ربح 80%.",
      "جودة البيانات: مكتمل للبيانات المطلوبة المؤكدة، وتقديري عند استخدام تقدير أو توزيع تقديري، وناقص البيانات عند غياب معلومات لازمة أو وجود تعارض. هامش الطلبات التقديرية معروض منفصلًا عن الهامش المكتمل.",
      "صافي الإيراد قبل الاستردادات: إيراد الطلب بعد الخصومات واستبعاد الضريبة وفق بياناته المالية المحفوظة، وقبل طرح الاسترداد. يختلف عن المبلغ المحصّل نقديًا في الفترة.",
      "تكلفة المنتجات / تكلفة المنتجات المعروفة: تكلفة الكميات المباعة من تكلفة الوحدة التاريخية المحفوظة أو تصحيحها الموثق. الجزء المعروف في الملخص لا يعني اكتمال تكلفة جميع البنود، وسعر البيع لا يُستخدم لتخمين التكلفة المفقودة.",
      "المصاريف المباشرة المسجلة: تكلفة الشحن الفعلية ورسوم بوابة الدفع وأي مصروف مباشر آخر مسجل للطلب. مبلغ الشحن الذي يدفعه العميل إيراد، وهو مختلف عن تكلفة شركة التوصيل.",
      "الكاش باك المصروف بعد عكسه: تكلفة الكاش باك الذي صُرف بالفعل بعد طرح القيود المعكوسة الصحيحة؛ وجود وعد بكاش باك وحده لا يكفي لاعتباره تكلفة مصروفة.",
      "إجمالي الاستردادات الناجحة / صافي الاستردادات: الإجمالي يشمل ضريبة الاسترداد، والصافي يستبعدها وفق البيانات المحفوظة. الهامش يطرح صافي الاستردادات مرة واحدة.",
      "صافي الاسترداد الموزع على المنتجات: الجزء المنسوب لبنود المنتجات. صافي الاسترداد غير الموزع يبقى على مستوى الطلب؛ لا توزعه يدويًا مرة ثانية عند مقارنة الهوامش.",
      "استردادات معلقة (لا تخصم): مبالغ لم تُعتمد كاسترداد ناجح بعد؛ تُعرض للمتابعة ولا تُطرح من الهامش باعتبارها مكتملة.",
      "تكلفة البضاعة المستعادة / كمية أعيدت للمخزون: التكلفة المستردة للكميات الصالحة للبيع التي رجعت للمخزون فعلًا. التالف لا يستعيد تكلفة، والاسترداد المالي وحده لا يثبت رجوع البضاعة.",
      "إيراد غير موزع على المنتجات: إيراد يبقى على مستوى الطلب مثل الشحن، أو قيمة تعذر توزيعها على البنود بصورة موثوقة. تكلفة دون إيراد منتج موزع توضح تكلفة لا يقابلها إيراد موزع في عرض المنتجات.",
      "توزيع إيراد المنتجات: قد يستخدم بيانات الضريبة المحفوظة لكل بند. في الطلبات القديمة قد يكون تقديريًا بنسبة إجمالي البنود أو الكميات؛ عند تعذر التوزيع الموثوق تبقى القيمة على مستوى الطلب.",
      "هامش الطلب = صافي الإيراد قبل الاستردادات − صافي الاستردادات − تكلفة المنتجات المباعة + تكلفة البضاعة المستعادة − المصاريف المباشرة − الكاش باك المصروف بعد عكسه.",
      "هامش المنتج = صافي إيراد المنتج − صافي الاسترداد الموزع عليه − تكلفة كمياته المباعة + تكلفة كمياته المستعادة. لا يشمل إيراد شحن الطلب أو مصاريفه المباشرة أو الكاش باك أو الاستردادات غير الموزعة."
    ],
    "tips": [
      "مثال بعملة KWD: صافي إيراد 100.000 − صافي استرداد 10.000 − تكلفة منتجات 60.000 + تكلفة مستعادة 6.000 − مصاريف مباشرة 5.000 − كاش باك 2.000 = هامش طلب 29.000، قبل المصاريف العامة، بشرط اكتمال البيانات.",
      "لا تجمع ملخصات العملات، ولا تعتبر مجموع المبالغ المعروفة إجمالي ربح مكتملًا. الطلبات التقديرية وناقصة البيانات مستبعدة من بطاقة هامش الطلبات مكتملة البيانات.",
      "مجموع هوامش المنتجات وحده لا يساوي هامش الطلب. راجع إيراد الطلب غير الموزع ومصاريفه والكاش باك والاستردادات غير الموزعة، ولا تطرح استرداد المنتج مرة ثانية لأنه محسوب داخل هامشه بالفعل.",
      "إذا ظهرت غير معلوم أو ناقص البيانات، افتح التفاصيل واقرأ السبب: تكلفة وحدة مفقودة، مصروف شحن أو رسوم دفع غير مسجلة، تعارض عملة أو ضريبة استرداد، أو قيود مرتجع أو محفظة غير متطابقة. صحّح المصدر ثم حدّث التقرير؛ لا تستبدل المجهول بصفر لتجميل النتيجة.",
      "إذا كانت تكلفة الوحدة تجمع البضاعة وخدمة إضافية دون فصل، قد تبقى تكلفة البضاعة المستعادة غير مؤكدة حتى توثيقها بصورة صحيحة. لا تفترض استعادة تكلفة الخدمة مع البضاعة.",
      "عند عدم ظهور نتائج، راجع المتجر وتاريخ إنشاء الطلب والعملة ووصوله إلى التسليم. وجود طلب مدفوع أو قيد التنفيذ وحده لا يضمن دخوله في التقرير.",
      "عند ظهور رسالة أن تخزين التكاليف غير مثبت، يحتاج المسؤول تجهيز تحديثات قاعدة البيانات الخاصة بالتينانت المعني. إدخال أسعار جديدة للمنتج لا يكمل تاريخ التكلفة للطلبات القديمة تلقائيًا.",
      "عند تعذر التحميل استخدم إعادة المحاولة، واقرأ الخطأ الظاهر. خطأ 404 أو غياب مسار التقرير قد يعني أن نسخة API لا تدعم تقرير الربحية بعد؛ وجود الشاشة في الكنترول وحده لا يكفي. تغيير الفلاتر لا يصلح مسار API مفقودًا.",
      "للوصول لهذا الشرح من دليل الاستخدام ابحث عن الربحية أو هامش المساهمة أو تكلفة البضاعة المستعادة. نفس الشرح متاح للمساعد داخل الكنترول."
    ],
    "examples": [
      "ربح تقديري مع تكلفة ناقصة لا يساوي هامشًا مكتملًا؛ قارن أعمدة جودة البيانات والتغطية قبل الإجمالي."
    ],
    "troubleshooting": [
      "الهامش تغيّر لفترة قديمة: راجع استردادًا أو تصحيح تكلفة أو بضاعة أعيدت على الطلب الأصلي ثم وقت الفحص."
    ]
  },
  {
    "id": "financial-overview",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "نظرة مالية عامة",
    "paths": [
      "/admin/reports/financial-overview"
    ],
    "paragraphs": [
      "هذه الشاشة مرجع المجاميع المالية المعتمدة للفترة، مفصولة حسب العملة. استخدمها لمقارنة المحصّل والمسترد وصافي التحصيل."
    ],
    "steps": [
      "حدد من وإلى والعملة ثم طبّق الفلاتر المتاحة.",
      "اقرأ صف كل عملة منفصلًا، وراجع أعداد المدفوعات بجانب المبالغ.",
      "عند وجود فرق افتح تقرير حالات الدفع أو البوابات أو المرتجعات لنفس الفترة."
    ],
    "fields": [
      "المحصّل: تحصيل مؤكد؛ وجود طلب وحده لا يساوي تحصيلًا.",
      "المسترد: قيمة الاسترداد وفق الفترة وحالة المعالجة المعتمدة.",
      "الصافي: المحصّل ناقص المسترد، ولا يخصم تكلفة المنتجات أو مصروفات التشغيل."
    ],
    "tips": [
      "الدفعة قد تخص طلبًا قديمًا وتم تحصيلها داخل الفترة الحالية؛ لذلك قد يختلف عدد الطلبات المنشأة عن عدد الدفعات."
    ],
    "examples": [
      "استخدم المحصّل والمسترد والصافي بنفس العملة لتقييم التدفق المالي، ثم راجع الربحية لسؤال مختلف عن التكلفة."
    ],
    "troubleshooting": [
      "الصافي أقل من المبيعات: راجع تعريف التحصيل والاسترداد وحالات الدفع وتواريخها قبل افتراض فقد مبلغ."
    ]
  },
  {
    "id": "financial-trend",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "الاتجاه المالي",
    "paths": [
      "/admin/reports/financial-trend"
    ],
    "paragraphs": [
      "يوزع التحصيل والاسترداد والصافي على فترات زمنية حتى تعرف متى زاد أو انخفض النشاط."
    ],
    "steps": [
      "اختر الفترة والعملة وطريقة التجميع الزمنية المتاحة.",
      "اقرأ الرسم مع الجدول؛ قارن المحصّل والمسترد والصافي داخل نفس النقطة الزمنية.",
      "إذا لم تظهر بيانات وسّع الفترة أو غيّر العملة ثم راجع النظرة المالية للمجموع."
    ],
    "fields": [
      "الفترة: وحدة التجميع التي تعرضها الشاشة.",
      "الطلبات: عدد الطلبات حسب تعريف التقرير، وليس قيمة التحصيل.",
      "المحصّل والمسترد والصافي: سلاسل مالية منفصلة داخل نفس العملة."
    ],
    "tips": [
      "انخفاض الصافي يمكن أن ينتج عن زيادة الاسترداد، حتى لو لم ينخفض المحصّل."
    ],
    "examples": [
      "قارن فترتين بنفس طول المدة والعملة والتقسيم الزمني المعروض، ولا تجمع KWD مع EGP."
    ],
    "troubleshooting": [
      "يوم مختلف عن توقيت جهازك: اعتمد منطقة المتجر الزمنية وحدود الفترة الظاهرة."
    ]
  },
  {
    "id": "payment-status-report",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "تقرير حالة المدفوعات",
    "paths": [
      "/admin/reports/payment-status-breakdown"
    ],
    "paragraphs": [
      "يجمع عمليات الدفع حسب الحالة والعملة لتمييز التحصيل الفعلي عن الانتظار أو الفشل."
    ],
    "steps": [
      "اختر الفترة والعملة، ثم راجع عدد كل حالة ومبلغها الأصلي.",
      "قارن نسبة الحالة من العدد ونسبتها من المبلغ؛ دفعة كبيرة قد تؤثر على المبلغ أكثر من العدد.",
      "افتح شاشة المدفوعات وابحث بنفس الفلاتر لمراجعة العمليات الفردية."
    ],
    "fields": [
      "المبلغ الأصلي: مبلغ محاولات الدفع في المجموعة، ولا يعني أن كل المبلغ تم تحصيله.",
      "النسبة من العدد والمبلغ: توزيع داخل نتائج التقرير.",
      "المسترد: المبالغ المستردة المرتبطة بالمجموعة وفق التقرير."
    ],
    "tips": [
      "لا تعتبر المعلّق أو الفاشل مبيعات محصّلة."
    ],
    "examples": [
      "وجود مبالغ معلقة بجوار ناجحة لا يعني أن المبلغين محصّلان؛ افتح حالة الدفع المناسبة."
    ],
    "troubleshooting": [
      "عدد المدفوعات يختلف عن الطلبات: قد توجد عدة محاولات دفع لنفس الطلب؛ راجع المرجع."
    ]
  },
  {
    "id": "payment-gateway-report",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "تقرير بوابات الدفع",
    "paths": [
      "/admin/reports/payment-gateway-breakdown"
    ],
    "paragraphs": [
      "يقارن أداء بوابات الدفع من حيث عدد العمليات ومعدل الفشل والتحصيل والاسترداد."
    ],
    "steps": [
      "حدد الفترة والعملة ثم قارن صفوف البوابات.",
      "راجع معدل الفشل مع عدد العمليات؛ النسبة وحدها قد تكون مضللة مع عينة صغيرة.",
      "عند ارتفاع الفشل افتح عمليات البوابة وسجلات الويب هوك ثم راجع إعداداتها إذا كنت تملك الصلاحية."
    ],
    "fields": [
      "البوابة: وسيلة أو مزوّد الدفع.",
      "معدل الفشل: نسبة المحاولات الفاشلة في بيانات التقرير.",
      "صافي التحصيل: تحصيل البوابة بعد الاسترداد، وليس تسوية البنك أو الربح."
    ],
    "tips": [
      "افصل العملات عند المقارنة، ولا تغيّر مفاتيح البوابة لمجرد وجود دفعة واحدة فاشلة."
    ],
    "examples": [
      "قارن بوابتين بنفس العملة والفترة، وراجع الاسترداد وحالة الدفع بدل إجمالي كل المحاولات."
    ],
    "troubleshooting": [
      "بوابة لا تظهر: قد لا توجد دفعات مطابقة للفترة أو العملة؛ تحقق من المدفوعات الأصلية."
    ]
  },
  {
    "id": "refunds-report",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "تقرير المرتجعات المالي",
    "paths": [
      "/admin/reports/refunds"
    ],
    "paragraphs": [
      "يعرض سجل الاستردادات مقسمًا إلى صفحات مع روابط الدفع والطلب. هو قائمة مراجعة، بينما النظرة المالية مصدر المجاميع."
    ],
    "steps": [
      "حدد من وإلى والعملة أو ابحث بالسبب أو المرجع.",
      "افتح المرتجع أو الدفع المرتبط لمراجعة الحالة وتاريخ المعالجة.",
      "استخدم التنقل بين الصفحات لمراجعة باقي السجلات، ثم ارجع للنظرة المالية لإجمالي الفترة."
    ],
    "fields": [
      "مرجع الاسترداد: مرجع العملية لدى النظام أو المزود.",
      "الحالة: نجاح الاسترداد أو انتظاره أو فشله حسب السجل.",
      "المبلغ: مبلغ السجل بعملته."
    ],
    "tips": [
      "جمع مبالغ الصفحة الحالية فقط لا يعطي إجمالي كل النتائج."
    ],
    "examples": [
      "راجع حالة الاسترداد المعتمد قبل خصمه من المحصّل، ثم افتح سجل المرتجع لتفاصيله."
    ],
    "troubleshooting": [
      "مبلغ مرتجع غير محسوب كما توقعت: راجع الحالة وتاريخ المعالجة والعملة وتعريف التقرير."
    ]
  },
  {
    "id": "search-analytics",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "تحليلات البحث",
    "paths": [
      "/admin/reports/search-analytics"
    ],
    "paragraphs": [
      "توضح ما يبحث عنه عملاء المتجر، وعدد مرات البحث، والكلمات التي لم تُرجع منتجات."
    ],
    "steps": [
      "اختر الفترة ثم راجع إجمالي عمليات البحث والمصطلحات الفريدة والبحث بلا نتائج.",
      "راجع أعلى الاستعلامات لمعرفة الطلب الفعلي، ثم راجع جدول بلا نتائج لفجوات الكتالوج أو التسمية.",
      "جرّب الكلمة في بحث المنتجات وراجع أسماء المنتجات والخصائص القابلة للبحث قبل إضافة منتجات جديدة."
    ],
    "fields": [
      "الاستعلام: عبارة البحث بعد التطبيع المستخدم في التقرير.",
      "متوسط النتائج: متوسط عدد المنتجات التي أرجعتها عمليات البحث.",
      "آخر بحث: أحدث وقت مسجل للمصطلح."
    ],
    "tips": [
      "البيانات تعتمد على عمليات بحث الواجهة التي تُسجل عبر البحث المدعوم؛ غياب البيانات لا يثبت أن العملاء لم يحاولوا البحث بأي وسيلة أخرى."
    ],
    "examples": [
      "كلمة بحث كثيرة النتائج الصفرية قد تكشف اسمًا أو قيمة خاصية لم تُضبط للبحث."
    ],
    "troubleshooting": [
      "لا توجد بيانات: راجع الفترة والمتجر وتسجيل البحث من الواجهة؛ لا تستنتج أن أحدًا لم يزر المتجر."
    ]
  },
  {
    "id": "inventory-report",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "تقرير المخزون",
    "paths": [
      "/admin/reports/inventory"
    ],
    "paragraphs": [
      "يعرض المنتجات المتتبعة والنافدة والمنخفضة وقيمة المخزون، لمساعدة فريق المشتريات على تحديد الأولويات."
    ],
    "steps": [
      "راجع البطاقات ثم جدول المنتجات النافدة أو المنخفضة.",
      "ابحث عن SKU المطلوب وافتح المنتج لمراجعة المخزون والمتغيرات.",
      "راجع تكلفة الوحدة قبل الاعتماد على قيمة المخزون، ثم صحّح المخزون من شاشة المنتج أو المزامنة المعتمدة."
    ],
    "fields": [
      "المنخفض: مخزون 5 وحدات أو أقل وفق التقرير.",
      "الوحدات: كمية المخزون المسجلة، وليست عدد المبيعات.",
      "قيمة المخزون: تعتمد على تكلفة الوحدة المسجلة؛ ليست سعر بيع كل الكمية."
    ],
    "tips": [
      "راجع المتغيرات والباكدجات عند تفسير مخزون المنتج؛ قد يكون المخزون مشتقًا من مكونات أو موزعًا بين متغيرات."
    ],
    "examples": [
      "قيمة المخزون حسب التكلفة تختلف عن قيمة بيع كل الوحدات؛ راجع العمود وعملة العرض."
    ],
    "troubleshooting": [
      "كمية غير متوقعة: راجع المتغيرات ومخزون المكونات وآخر مزامنة خارجية من المنتج."
    ]
  },
  {
    "id": "stock-alerts-report",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "تقرير أخبرني عند التوافر",
    "paths": [
      "/admin/reports/stock-alerts"
    ],
    "paragraphs": [
      "يعرض المنتجات التي طلب العملاء إشعارهم بعودتها للمخزون، وعدد المنتظرين ومن تم إشعارهم."
    ],
    "steps": [
      "راجع عدد المنتجات والطلبات المنتظرة، ثم رتب الأولويات حسب الطلب والمخزون المتاح.",
      "افتح المنتج وانتقل لتبويب الطلبات لمراجعة سجلات التوافر وبياناتها.",
      "بعد إعادة التوريد راجع حالة الإشعار المسجلة؛ وجود الطلب في التقرير لا يعني أن الرسالة أُرسلت بنجاح."
    ],
    "fields": [
      "بانتظار التوفر: طلبات لم تسجل كمنفذة بعد.",
      "تم إشعارهم: الطلبات المسجل لها وقت إشعار.",
      "آخر طلب: أحدث طلب توافر للمنتج."
    ],
    "tips": [
      "قد تعرض الشاشة أول مجموعة من المنتجات فقط مع العدد الكلي؛ راجع عدد المعروض قبل استنتاج أن القائمة كاملة."
    ],
    "examples": [
      "طلب أخبرني عند التوافر لنسخة لون معين يختلف عن الطلب للمنتج العام."
    ],
    "troubleshooting": [
      "عميل لم يصله تنبيه: راجع المتغير المطلوب وتوافره ووقت الإرسال والقناة والسجل."
    ]
  },
  {
    "id": "customers-report",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "تقرير العملاء",
    "paths": [
      "/admin/reports/customers"
    ],
    "paragraphs": [
      "يعرض العملاء الجدد والمتكررين والأعلى إنفاقًا داخل المتجر والفترة المختارة."
    ],
    "steps": [
      "حدد الفترة والعملة المتاحة ثم راجع بطاقات العملاء.",
      "قارن أعداد الجدد والمتكررين، وافتح العميل المطلوب من جدول الأعلى لمراجعة طلباته.",
      "طابق الإنفاق مع الطلبات المعنية قبل استخدام الرقم في متابعة العميل."
    ],
    "fields": [
      "الجدد والمتكررون: تصنيفات التقرير للفترة المختارة.",
      "عدد الطلبات: الطلبات الداخلة في تجميع التقرير.",
      "الإنفاق: قيمة مجمعة بعملة التقرير، وليس رصيد المحفظة."
    ],
    "tips": [
      "استخدم تفاصيل العميل لمراجعة الحالات الفردية؛ إجمالي إنفاقه قد يختلف باختلاف نطاق التاريخ والتعريف المستخدم."
    ],
    "examples": [
      "قارن عدد العملاء بفلتر الفترة المناسب، ثم افتح العميل لمراجعة طلباته بدل اعتبار العدد عدد مشتريات."
    ],
    "troubleshooting": [
      "إنفاق العميل لا يطابق رصيد المحفظة: هذان مقياسان مختلفان ولهما سجلات مستقلة."
    ]
  },
  {
    "id": "order-platforms-report",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "تقرير مصادر الطلبات",
    "paths": [
      "/admin/reports/order-platforms"
    ],
    "paragraphs": [
      "يوضح القنوات أو المنصات التي جاءت منها الطلبات حسب البيانات المسجلة عند إنشاء الطلب."
    ],
    "steps": [
      "اختر الفترة والفلاتر المتاحة ثم قارن المصادر.",
      "راجع عدد الطلبات والمبالغ المعروضة لكل مصدر داخل نفس العملة.",
      "راجع الطلب الفردي إذا ظهر مصدر غير متوقع؛ لا تستنتج مصدره من الجهاز الحالي للعميل."
    ],
    "fields": [
      "المصدر: قناة إنشاء الطلب المسجلة.",
      "غير معروف: السجل لا يحتوي مصدرًا يمكن تصنيفه."
    ],
    "tips": [
      "مصدر الطلب يخص عملية إنشاء الطلب، وهو مختلف عن مصدر تسجيل العميل أو آخر جهاز استخدمه."
    ],
    "examples": [
      "حساب عميل واحد يمكن أن يشتري من الموقع والتطبيق؛ مصدر كل طلب يُقرأ من سجله."
    ],
    "troubleshooting": [
      "مصدر غير محدد: بيانات المصدر غير محفوظة في هذا السجل القديم؛ لا تغيّر التقرير لإخفائها."
    ]
  },
  {
    "id": "customer-sources-report",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "تقرير مصادر العملاء",
    "paths": [
      "/admin/reports/customer-sources"
    ],
    "paragraphs": [
      "يساعد على معرفة مصدر تسجيل العملاء ونشاطهم المسجل، مع الفصل بين المصدر الأصلي والجهاز الحالي."
    ],
    "steps": [
      "حدد الفترة ثم راجع توزيع مصادر العملاء.",
      "راجع تفاصيل العميل عند الحاجة لمعرفة التسجيل والنشاط والطلبات.",
      "اقرأ تلميح الجهاز الحالي قبل تفسيره على أنه جهاز التسجيل."
    ],
    "fields": [
      "مصدر العميل: المصدر المسجل للحساب وفق بيانات التقرير.",
      "الجهاز الحالي: آخر جهاز شوهد في نشاط العميل داخل هذا المتجر مع وقت آخر نشاط.",
      "غير معروف: بيانات المصدر أو الجهاز غير متوفرة."
    ],
    "tips": [
      "تغيير الجهاز الحالي لا يعيد كتابة مصدر التسجيل الأصلي."
    ],
    "examples": [
      "عميل سجّل من أندرويد ثم استخدم الموقع: مصدر التسجيل وآخر جهاز قد يختلفان بصورة صحيحة."
    ],
    "troubleshooting": [
      "آخر جهاز غير معروف: راجع نشاط الجهاز المسجل؛ وجود رقم موبايل لا يثبت نوع الجهاز."
    ]
  },
  {
    "id": "marketing-report",
    "group": "reports",
    "group_title": "لوحة التحكم والتقارير",
    "title": "تقرير التسويق",
    "paths": [
      "/admin/reports/marketing"
    ],
    "paragraphs": [
      "يجمع استخدام العروض ومبالغ الخصم والكاش باك والسلات المفتوحة والمتروكة."
    ],
    "steps": [
      "اختر الفترة ثم راجع الاستخدام وإجمالي الخصم والكاش باك.",
      "راجع جدول العروض لمعرفة الحملات المستخدمة، وافتح استخداماتها للتحقق من الطلبات المرتبطة.",
      "راجع السلات المتروكة للمتابعة من شاشتها، مع مراعاة أن سلة مفتوحة ليست طلبًا مدفوعًا."
    ],
    "fields": [
      "الخصم: مبالغ التخفيض المسجلة في الاستخدامات.",
      "الكاش باك: قيمة المكافأة المسجلة، وليس خصمًا فوريًا من السعر.",
      "قيمة السلات المتروكة: قيمة سلات لم تتحول إلى طلب مكتمل."
    ],
    "tips": [
      "لا تجمع قيمة السلات مع المبيعات المحصّلة؛ استخدم النظرة المالية للتحصيل الفعلي."
    ],
    "examples": [
      "راجع استخدامات العرض ومجموع خصوماته، ثم افتح السلات من شاشتها إذا أردت فلاتر السلات المفتوحة الحديثة."
    ],
    "troubleshooting": [
      "عدد السلات يختلف عن شاشة السلات المفتوحة: التقرير التسويقي يعد الحالة المتروكة، بينما شاشة المتابعة يمكن أن تضم النشطة أيضًا."
    ]
  },
  {
    "id": "catalog",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "قائمة المنتجات والبحث والإجراءات الجماعية",
    "paths": [
      "/admin/catalog/products"
    ],
    "paragraphs": [
      "هذه نقطة البداية للبحث عن المنتجات وتعديلها أو تجميعها لعرض مؤقت. التحديد والفلاتر لا يغيّران الأسعار وحدهما."
    ],
    "steps": [
      "ابحث باسم المنتج أو SKU، ثم افتح الفلاتر وحدد القسم والتصنيف والبراند والحالة أو المخزون حسب المتاح.",
      "للبحث بخاصية اختر الخاصية ثم اكتب قيمتها؛ مثل المؤلف أو نوع التغليف. الجمع بين الفلاتر يضيّق النتائج.",
      "افتح العين للتفاصيل أو القلم للتعديل. لإنشاء منتج اضغط إضافة منتج.",
      "حدّد صفوفًا، أو استخدم تحديد كل نتائج البحث لاختيار النتائج عبر الصفحات ضمن الحد المسموح.",
      "لتجميع مجموعات مختلفة غيّر الفلتر ثم اضغط إضافة نتائج البحث إلى التحديد. بعدها اختر الإجراء الجماعي المسموح، وراجع عدد المنتجات قبل تأكيده."
    ],
    "fields": [
      "التحديد: قد يحتوي منتجات من بحث سابق عند استخدام الإضافة إلى التحديد؛ راجع العدد قبل إنشاء العرض.",
      "الخاصية والقيمة: البحث يكون داخل خصائص المتجر؛ ترك القيمة فارغة يسمح بالبحث عن المنتجات الحاملة للخاصية.",
      "تصدير المنتجات: الكل أو المفعّل أو المخزون القليل، حسب اختيار نافذة التصدير."
    ],
    "tips": [
      "الصلاحيات تحدد ظهور التعديل الجماعي والعرض المؤقت والتصدير. عرض القائمة وحده لا يمنح صلاحية تعديل الأسعار.",
      "الحد الأقصى لتحديد المنتجات للعرض 20000 منتج. المنتجات المختارة تُثبّت عند إنشاء العرض؛ لا تُضاف منتجات مستقبلية تلقائيًا بمجرد مطابقة الفلتر."
    ],
    "examples": [
      "ابحث عن SKU محدد قبل إضافة نسخة ثانية بنفس المنتج، ثم افتح العين لمراجعة المخزون والمتغيرات."
    ],
    "troubleshooting": [
      "لا توجد نتائج بعد فلترة خاصية: راجع القسم والخاصية والقيمة وحالة المنتج والبحث المتبقي."
    ]
  },
  {
    "id": "product-form",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "إضافة وتعديل المنتج: الهوية والوصف والتصنيف",
    "paths": [
      "/admin/catalog/products/new",
      "/admin/catalog/products/:id/edit"
    ],
    "paragraphs": [
      "نموذج المنتج موزع على تبويبات. ابدأ بالبيانات الأساسية والعلاقات والتسعير، ثم احفظ المنتج لفتح العمليات التي تحتاج رقم منتج مثل الصور والمتغيرات."
    ],
    "steps": [
      "في الهوية أدخل الاسم بالعربية والإنجليزية والرابط المختصر وSKU والباركود إن وجد.",
      "في الوصف اكتب الوصف المختصر والتفصيلي لكل لغة. لا تفترض أن النص العربي يُترجم تلقائيًا للإنجليزية.",
      "في علاقات الكتالوج اختر الأقسام والتصنيفات والتصنيفات الفرعية والعلامة والوسوم وفئة الضريبة.",
      "انتقل للتسعير وأدخل السعر والمخزون والحالة، ثم احفظ وانتظر رسالة النجاح.",
      "ارجع للمنتج المحفوظ لإضافة الصور والخصائص والمتغيرات والمنتجات المرتبطة عند الحاجة."
    ],
    "fields": [
      "الرابط المختصر وSKU: معرّفات يجب إدخالها بما يتوافق مع قواعد التفرد في المتجر؛ تُعرض أخطاؤها عند الحفظ.",
      "علاقات الكتالوج: يمكن اختيار أكثر من قسم وتصنيف. اختيار تصنيف أو فرعي يضيف آباءه تلقائيًا.",
      "المنتجات المرتبطة: مشابهة أو مكملة أو أعلى سعرًا من نفس المتجر؛ لا تربط المنتج بنفسه.",
      "السيو: عنوان الميتا ووصف الميتا لكل لغة لعرض معلومات ملائمة لمحركات البحث."
    ],
    "tips": [
      "عند إزالة قسم له تصنيفات مختارة، أزل الاختيارات التابعة له أولًا.",
      "حالة المسودة لا تنشر المنتج للعملاء. انشر باختيار نشط ثم الحفظ."
    ],
    "examples": [
      "منتج بلغتين يحتاج الاسم والوصف لكل لغة؛ حفظ العربية وحدها لا ينشئ ترجمة إنجليزية."
    ],
    "troubleshooting": [
      "تصنيف غير ظاهر في الاختيار: راجع القسم الأب والمتجر والحالة، ثم حدّث قائمة الخيارات."
    ]
  },
  {
    "id": "product-pricing",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "تسعير المنتج والمخزون وحدود الشراء",
    "paths": [],
    "paragraphs": [
      "تبويب التسعير والمخزون يحدد السعر العادي وحدود الكمية والتكلفة. العرض المؤقت يُنشأ من قائمة المنتجات ويطبّق فوق السعر الحالي دون إعادة كتابة السعر الأصلي."
    ],
    "steps": [
      "افتح تعديل المنتج ثم التسعير والمخزون.",
      "أدخل السعر الأساسي، والتكلفة إن كنت تتابع قيمة المخزون، والمخزون والوزن حسب المنتج.",
      "لخصم يدوي دائم اجعل السعر الأساسي هو سعر البيع والسعر قبل الخصم هو المقارنة الأعلى. لعرض بتاريخ بداية ونهاية استخدم العرض المؤقت بدل التعديل اليدوي.",
      "اضبط حدود الطلب والحالة والترتيب والمميز أو الأكثر مبيعًا، ثم احفظ."
    ],
    "fields": [
      "السعر الأساسي: سعر البيع العادي قبل تطبيق حملة سعر مؤقتة.",
      "السعر قبل الخصم: سعر المقارنة المعروض مع السعر الحالي عندما يكون صالحًا وأعلى منه.",
      "التكلفة: معلومة داخلية تستخدم في تقارير قيمة المخزون، وليست سعر البيع.",
      "الحد الأدنى والأقصى للطلب: حدود كمية هذا المنتج في الطلب وفق قواعد النظام.",
      "الحد الأقصى لكل عميل: حد إجمالي شراء العميل لهذا المنتج؛ تركه فارغًا يعني بدون حد."
    ],
    "tips": [
      "راجع أسعار ومخزون المتغيرات أيضًا إذا كان المنتج يحتوي مقاسات أو ألوانًا؛ تعديل سعر المنتج لا يساوي تعديل كل سعر متغير مسجل.",
      "التعديل اليدوي للأسعار ليس عرضًا مجدولًا، ولن يرجع تلقائيًا بتاريخ انتهاء."
    ],
    "examples": [
      "سعر بيع 8.000 وسعر مقارنة 10.000 يعرضان فرق السعر؛ السعر المقارن ليس تكلفة الشراء."
    ],
    "troubleshooting": [
      "انتهت مدة الحملة والسعر اليدوي لم يتغير: السعر اليدوي ليس حملة مؤقتة؛ راجع الحقل الذي عدلته والعرض النشط."
    ]
  },
  {
    "id": "catalog-availability",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "توافر المنتج ونفاد المخزون ومزامنة النظام الخارجي",
    "paths": [],
    "paragraphs": [
      "التوافر يعتمد على الحالة الحالية والمخزون المناسب لنوع المنتج. بيانات الاستيراد القديمة ليست إعدادًا يوميًا لتفعيل أو إيقاف البيع."
    ],
    "steps": [
      "افتح المنتج وحدد نوعه: منتج عادي أم متغيرات أم باكدج.",
      "للمنتج العادي راجع حالته ومخزونه. للمقاسات والألوان راجع تفعيل ومخزون المتغير المطلوب، وليس مخزون الأب وحده.",
      "للباكدج راجع كل مكوّن ومتغيره والكمية اللازمة لبيع قطعة واحدة.",
      "إذا حذفت المتغيرات للعودة لمنتج عادي، راجع سعر ومخزون المنتج نفسه ثم احفظ وافحص واجهة المتجر.",
      "عند تغيّر المخزون بعد الحفظ، راجع تفعيل تحديثات المخزون الخارجية وسجل المنتج وآخر مزامنة قبل تغيير الإعدادات.",
      "راجع إعداد إظهار المنتجات النافدة لمعرفة هل المنتج يُخفى تمامًا أم يبقى ظاهرًا دون شراء."
    ],
    "fields": [
      "نشط: حالة نشر، ولا تعوّض مخزونًا صفرًا أو متغيرًا غير متاح.",
      "مخزون المتغير: كمية النسخة التي يشتريها العميل؛ لا تجمعه يدويًا مع الأب على أنهما مخزونان للبيع نفسه.",
      "مخزون الباكدج: تحدده المكونات وكمياتها، وقد ينفد بسبب مكوّن واحد.",
      "تحديث المخزون الخارجي: قد يعيد كتابة الكمية من المصدر عند المزامنة؛ راجع الاتجاه وآخر نتيجة.",
      "أخبرني عند التوافر: طلب متابعة توفر، وليس حجز كمية للعميل.",
      "المنتج الخدمي: له معالجة مختلفة عن مخزون السلع العددية؛ لا تطبّق عليه تفسير مخزون صفر للمنتج العادي دون مراجعة نوعه."
    ],
    "tips": [
      "لا تعالج اختلاف الكمية بإيقاف المزامنة دون معرفة المصدر المسؤول. راجع أيضًا حدود الطلب والحد الإجمالي لكل عميل عند رفض الإضافة للسلة."
    ],
    "examples": [
      "باكدج يحتاج كتابين من A وكتابًا من B: مخزون A = 8 ومخزون B = 3 يسمحان ببيع 3 باكدجات، لأن B هو المكوّن المحدِّد."
    ],
    "troubleshooting": [
      "تحويل المنتج إلى نشط يرجع بعده للنفاد: راجع المخزون والمتغيرات وسجل التحديث الخارجي؛ إعادة تغيير الحالة وحدها لا تصلح سبب الكمية.",
      "المنتج لا يظهر رغم وجود مخزون: راجع حالة النشر والفلتر والتصنيفات والمتجر وقيود الواجهة، ثم افحص السجل نفسه."
    ]
  },
  {
    "id": "product-images",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "صور المنتج وفيديو يوتيوب",
    "paths": [],
    "paragraphs": [
      "تبويب الصور يدير صور المنتج والصورة الأساسية. يجب حفظ المنتج أولًا قبل رفع الصور أو نسخها من مكتبة الوسائط."
    ],
    "steps": [
      "افتح تعديل منتج محفوظ ثم تبويب الصور.",
      "ارفع صورة من جهازك أو اختر نسخًا من مكتبة الوسائط، وانتظر ظهور الصورة الجديدة.",
      "اضغط النجمة لتعيين الصورة الأساسية، وراجع العلامة التي تؤكد الاختيار.",
      "أضف رابط فيديو يوتيوب عند الحاجة، وراجع المعاينة، ثم احفظ بيانات المنتج.",
      "لحذف صورة استخدم زر حذفها واقرأ التأكيد قبل التنفيذ.",
      "يمكن اختيار عدة صور من جهازك في نفس الرفع. راقب نتيجة كل صورة ثم اسحب الصور لإعادة ترتيبها وانتظر نجاح حفظ الترتيب."
    ],
    "fields": [
      "الصورة الأساسية: الصورة الافتراضية للمنتج؛ للمتغير صورة مستقلة اختيارية.",
      "رابط الفيديو: يقبل روابط يوتيوب المدعومة من youtube.com أو youtu.be، ومنها المشاهدة وShorts والتضمين.",
      "ترتيب الصور: يحدد تسلسل المعرض؛ تعيين الصورة الأساسية بالنجمة اختيار مستقل عن مجرد ترتيبها."
    ],
    "tips": [
      "حذف صورة ليس مثل إزالة اختيارها كصورة أساسية. تأكد من الصورة المقصودة في رسالة الحذف.",
      "إذا لم تظهر المعاينة انتظر اكتمال الرفع وراجع رسالة الخطأ قبل إعادة الرفع."
    ],
    "examples": [
      "ارفع ثلاث صور، عيّن الأساسية بالنجمة، ثم رتّب المعرض وتحقق من النتيجة بعد إعادة فتح المنتج."
    ],
    "troubleshooting": [
      "ترتيب الصور عاد: راجع نجاح حفظ الترتيب وأخطاء الرفع؛ رفع صورة وحفظ بيانات المنتج عمليتان مختلفتان."
    ]
  },
  {
    "id": "product-detail",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "تفاصيل المنتج والطلبات والتقييمات",
    "paths": [
      "/admin/catalog/products/:id"
    ],
    "paragraphs": [
      "تعرض شاشة التفاصيل بيانات المنتج وصوره ومتغيراته، وملخص تقييماته والطلب عليه، بدون الحاجة لتعديل بياناته."
    ],
    "steps": [
      "افتح المنتج بعلامة العين من القائمة، وراجع السعر والمخزون والحالة والعلاقات.",
      "افتح تبويب المتغيرات أو المصفوفة لإدارة المقاسات والألوان حسب صلاحيتك.",
      "افتح تبويب الطلبات لمراجعة آخر 10 طلبات وكميات المنتج وطلبات أخبرني عند التوافر.",
      "راجع ملخص التقييمات وتوزيع النجوم، ثم افتح كل المراجعات عند الحاجة للموافقة أو الرفض.",
      "راجع سجل التحديثات الخارجية لمعرفة مصدر آخر تغيير والحقول والقيم المتاحة في السجل قبل تعديل بيانات مرتبطة بنظام خارجي."
    ],
    "fields": [
      "آخر 10 طلبات: عينة حديثة، وليست سجل مبيعات المنتج كاملًا.",
      "طلبات التوافر: العميل ووسيلة التواصل والمتغير ووقت الطلب والإشعار إن وُجد.",
      "المشتريات الموثقة: مراجعات مرتبطة بشراء مسجل حسب قواعد التقييم."
    ],
    "tips": [
      "السعر هنا معلومة إدارية؛ لمراجعة تجربة العميل مع عرض مؤقت راجع معاينة العرض وواجهة المتجر التي تستهلك أسعار الكتالوج."
    ],
    "examples": [
      "تبويب الطلبات يعرض آخر طلبات المنتج، بينما رقم مبيعات كامل يحتاج تقريرًا وفترة مناسبين."
    ],
    "troubleshooting": [
      "تغيرت كمية أو قيمة دون تعديل منك: راجع سجل التحديث الخارجي وسجل التدقيق قبل إعادة كتابة القيمة."
    ]
  },
  {
    "id": "variants",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "متغيرات المنتج: المقاس واللون والأسعار",
    "paths": [
      "/admin/catalog/products/:id/variants",
      "/admin/catalog/products/:id/variants/new",
      "/admin/catalog/products/:id/variants/:variantId/edit"
    ],
    "paragraphs": [
      "المتغير نسخة قابلة للبيع بتركيبة خيارات محددة، مثل قميص أحمر مقاس كبير، ويمكن أن يحمل سعرًا ومخزونًا وصورة مختلفة."
    ],
    "steps": [
      "أنشئ الخيارات وقيمها من خيارات المنتجات أولًا، ثم افتح متغيرات المنتج أو تبويبها داخل التعديل.",
      "اضغط متغير جديد واختر قيمة واحدة من كل خيار مطلوب للتركيبة.",
      "أدخل SKU والباركود والسعر والسعر قبل الخصم والتكلفة والمخزون والوزن والترتيب والحالة حسب الحاجة.",
      "اختر صورة للمتغير عند الحاجة ثم احفظ، وراجع ظهور التركيبة في القائمة.",
      "للتعديل افتح القلم؛ لتغيير التركيبة نفسها أنشئ متغيرًا بالتركيبة الصحيحة بدل تغيير تركيبة قائمة."
    ],
    "fields": [
      "تركيبة الخيارات: تثبت بعد إنشاء المتغير ولا تُعدّل لاحقًا.",
      "صورة المتغير: تظهر عند اختياره؛ إذا لم توجد يُستخدم افتراضي المنتج.",
      "السعر والمخزون: يخصان المتغير عند تسجيلهما، فراجعهما لكل تركيبة."
    ],
    "tips": [
      "قد يرفض حذف متغير مستخدمًا في سلال نشطة. لا تكرر نفس تركيبة الخيارات للمنتج.",
      "الحملة المؤقتة على المنتج تشمل متغيراته؛ المعاينة توضح عددها، ويُحسب الخصم من سعر كل متغير."
    ],
    "examples": [
      "قميص أحمر كبير له SKU ومخزون مختلفان عن الأزرق الصغير حتى لو كان لهما نفس المنتج الأب."
    ],
    "troubleshooting": [
      "حذف متغير مرفوض: راجع ارتباطه بسلال أو سجلات مستخدمة وسبب الرفض؛ لا تعِد إنشاء نفس التركيبة لتجاوز المشكلة."
    ]
  },
  {
    "id": "variant-matrix",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "مصفوفة المتغيرات",
    "paths": [
      "/admin/catalog/products/:id/variants/matrix"
    ],
    "paragraphs": [
      "المصفوفة تساعد على توليد تركيبات متعددة ومراجعة بياناتها بدل إنشاء كل متغير يدويًا."
    ],
    "steps": [
      "افتح مصفوفة المنتج المحفوظ وحدد الخيارات التي تدخل في التوليد؛ إن تركتها فارغة يستخدم النظام الخيارات المعتمدة للمصفوفة حسب تلميح الشاشة.",
      "اختر وضع إنشاء الناقص فقط لتجنب تكرار الموجود، أو الرفض إذا وُجدت تركيبات عندما تريد اكتشاف التعارض قبل التنفيذ.",
      "أدخل السعر والمخزون الافتراضيين عند الحاجة، ثم نفّذ التوليد أو توليد الناقص وراجع عدد ما أُنشئ أو تُرك دون تغيير.",
      "راجع صفوف المصفوفة وعدّل سعر ومخزون وحالة كل متغير بإجراء الصف، وانتظر نجاح كل حفظ أو اقرأ رسالة رفضه."
    ],
    "fields": [
      "قيم الخيارات: تحدد جميع التركيبات الناتجة من اختيارك.",
      "صف المتغير: يمثل تركيبة واحدة ببيانات بيع ومخزون مستقلة.",
      "الوضع: يحدد التعامل مع التركيبات الموجودة، ولا يحذفها لإعادة إنشاء الكل.",
      "السعر والمخزون الافتراضيان: قيم للتركيبات الجديدة؛ راجع النتيجة قبل البيع.",
      "البحث داخل المتغيرات: يساعد على الوصول بالاسم أو SKU أو الباركود أو قيمة الخيار؛ راجع نفس المنتج قبل إجراء تعديل صف."
    ],
    "tips": [
      "زيادة عدد القيم قد تنتج عددًا كبيرًا من التركيبات. راجع العدد قبل التأكيد ولا تفترض أن كل متغير مولد له مخزون أو سعر مناسب تلقائيًا."
    ],
    "examples": [
      "خياران بهما 3 ألوان ومقاسان ينتجان حتى 6 تركيبات؛ إنشاء الناقص يحتفظ بما هو موجود."
    ],
    "troubleshooting": [
      "صف لا يحفظ: راجع السعر والباركود وSKU والتفرد ورسالة الخطأ الخاصة بالصف."
    ]
  },
  {
    "id": "product-features",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "باكدجات المنتجات والخدمات المرتبطة",
    "paths": [],
    "paragraphs": [
      "من تبويب الباكدج والخدمات تختار هل المنتج عادي أم باكدج، وتربط خدمات اختيارية مثل التغليف أو الطباعة."
    ],
    "steps": [
      "للباكدج اختر نوع باكدج منتجات، ثم ابحث عن المنتج المكوّن وحدد متغيره إن كان له أنواع والكمية داخل الباكدج.",
      "أضف باقي المكونات وراجع الكميات، ثم حدّد سعر بيع الباكدج من التسعير.",
      "للخدمات اختر الخدمات المتاحة لهذا المنتج وحدد ما إذا كان اختيار الخدمة إجباريًا، ثم احفظ.",
      "إذا لم توجد خدمة افتح الخدمات الإضافية وأنشئها، ثم حدّث قائمة الخدمات داخل المنتج."
    ],
    "fields": [
      "سعر الباكدج: السعر الذي تحدده للباكدج، وليس جمع أسعار المكونات تلقائيًا.",
      "مخزون الباكدج: يُحسب من المكونات ويُخصم منها عند الطلب ويعود عند الإلغاء وفق حركة المخزون.",
      "الخدمة: تكلفة اختيارها تُضاف لكل قطعة، ويمكن ربط نفس الخدمة بأكثر من منتج."
    ],
    "tips": [
      "راجع نوع المكوّن والكمية بعناية؛ اختيار منتج صحيح بمتغير غير صحيح يغيّر المخزون المقصود.",
      "خصم حملة سعر المنتج لا يخصم تكلفة خدماته الإضافية."
    ],
    "examples": [
      "سعر باكدج 9.000 وخدمة تغليف 1.000 لكل قطعة يختلفان عن مجموع أسعار المكونات في الكتالوج."
    ],
    "troubleshooting": [
      "الباكدج لا يقبل الإضافة: تحقق من تفعيل كل مكوّن ومتغيره والكمية اللازمة لكل باكدج."
    ]
  },
  {
    "id": "departments",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "الأقسام: القائمة والإضافة والتعديل",
    "paths": [
      "/admin/catalog/departments",
      "/admin/catalog/departments/new",
      "/admin/catalog/departments/:id/edit"
    ],
    "paragraphs": [
      "تستخدم هذه الشاشة لتنظيم كتالوج المتجر، وتعرض السجلات مع البحث والحالة وإجراءات الصف المتاحة."
    ],
    "steps": [
      "ابحث عن السجل وراجع حالته قبل إنشاء سجل جديد بالاسم نفسه.",
      "اضغط إضافة أو افتح التعديل، ثم أدخل الاسم بالعربية والإنجليزية والرابط المختصر.",
      "يمكن ربط خصائص بالقسم لتظهر داخل منتجاته. أنشئ الخصائص من شاشتها إذا لم توجد.",
      "أكمل الوصف والصورة أو البيانات المرئية المتاحة والترتيب والحالة والسيو، ثم احفظ وانتظر رسالة النجاح."
    ],
    "fields": [
      "الاسم المترجم: الاسم المعروض حسب لغة المتجر.",
      "الرابط المختصر: معرّف الرابط؛ راجع خطأ التفرد إذا كان مستخدمًا.",
      "ترتيب العرض: يضبط الأولوية المرئية حيث تدعمها الواجهة.",
      "الحالة: السجل غير النشط لا يُعرض للعملاء وفق استخدامه في الواجهة.",
      "الظهور في الرئيسية: اختيار مستقل عن التفعيل، ويُستخدم في صف الأقسام بواجهة كلمات."
    ],
    "tips": [
      "راجع أثر التعطيل على المنتجات المرتبطة. قد يرفض النظام حذف سجل له ارتباطات؛ اقرأ سبب الرفض قبل اختيار إجراء آخر."
    ],
    "examples": [
      "قسم الكتب يمكن ربطه بخاصية المؤلف، ثم تستخدمها منتجات القسم في بياناتها وبحثها."
    ],
    "troubleshooting": [
      "قسم لا يظهر في الرئيسية: راجع التفعيل والظهور في الرئيسية، وهما مختلفان."
    ]
  },
  {
    "id": "categories",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "التصنيفات: القائمة والإضافة والتعديل",
    "paths": [
      "/admin/catalog/categories",
      "/admin/catalog/categories/new",
      "/admin/catalog/categories/:id/edit"
    ],
    "paragraphs": [
      "تستخدم هذه الشاشة لتنظيم كتالوج المتجر، وتعرض السجلات مع البحث والحالة وإجراءات الصف المتاحة."
    ],
    "steps": [
      "ابحث عن السجل وراجع حالته قبل إنشاء سجل جديد بالاسم نفسه.",
      "اضغط إضافة أو افتح التعديل، ثم أدخل الاسم بالعربية والإنجليزية والرابط المختصر.",
      "اختر القسم الأب قبل الحفظ؛ استخدم فلتر القسم للوصول للتصنيف الصحيح.",
      "أكمل الوصف والصورة أو البيانات المرئية المتاحة والترتيب والحالة والسيو، ثم احفظ وانتظر رسالة النجاح."
    ],
    "fields": [
      "الاسم المترجم: الاسم المعروض حسب لغة المتجر.",
      "الرابط المختصر: معرّف الرابط؛ راجع خطأ التفرد إذا كان مستخدمًا.",
      "ترتيب العرض: يضبط الأولوية المرئية حيث تدعمها الواجهة.",
      "الحالة: السجل غير النشط لا يُعرض للعملاء وفق استخدامه في الواجهة.",
      "الظهور في الرئيسية: اختيار مستقل عن التفعيل، ويُستخدم في صف التصنيفات بواجهة كلمات."
    ],
    "tips": [
      "راجع أثر التعطيل على المنتجات المرتبطة. قد يرفض النظام حذف سجل له ارتباطات؛ اقرأ سبب الرفض قبل اختيار إجراء آخر."
    ],
    "examples": [
      "تصنيف روايات يتبع القسم الذي تختاره؛ راجع الأب قبل حفظ اسم متشابه في أكثر من موضع."
    ],
    "troubleshooting": [
      "منتجات لا تظهر في التصنيف: راجع ربطها وتصنيفاتها وحالتها وفلتر المخزون."
    ]
  },
  {
    "id": "catalog-home-visibility",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "ظهور الأقسام والتصنيفات في الصفحة الرئيسية لكلمات",
    "paths": [],
    "paragraphs": [
      "خيار الظهور في الرئيسية يحدد الأقسام والتصنيفات التي تظهر في واجهة كلمات. تفعيل السجل وظهوره في الرئيسية إعدادان مختلفان."
    ],
    "steps": [
      "افتح قسمًا أو تصنيفًا من الكتالوج، وراجع الاسم والصورة والترتيب والحالة.",
      "اضبط الظهور في الصفحة الرئيسية ثم احفظ وانتظر رسالة النجاح.",
      "راجع الرئيسية في المتجر الصحيح وباللغة المطلوبة بعد تحديثها.",
      "تظهر الأقسام والتصنيفات المحددة في سطرين من الكروت؛ عند زيادة العناصر يمكن تمريرها أفقيًا يمينًا ويسارًا.",
      "إذا لم توجد عناصر مؤهلة لصف كامل، لا تفترض ظهور عنوان فارغ له؛ راجع العناصر المحددة والنشطة."
    ],
    "fields": [
      "نشط: يحدد إتاحة السجل في الاستخدام المعتاد للواجهة.",
      "الظهور في الرئيسية: يختار السجل لصفه في الرئيسية دون استبدال حالة التفعيل.",
      "الترتيب والصورة: يضبطان العرض حسب قالب الواجهة؛ عند غياب صورة قد تظهر أيقونة بديلة.",
      "عدد الأعمدة: يتكيف مع عرض الشاشة، مع بقاء الحد سطرين والتمرير الأفقي للزيادة."
    ],
    "tips": [
      "تعديل أقسام متجر لا يغيّر أقسام متجر آخر. مجموعات عرض المنتجات لها إعداد مستقل في المحتوى."
    ],
    "examples": [
      "إخفاء تصنيف من الرئيسية مع الإبقاء عليه نشطًا يزيل كرته من صف الرئيسية، مع استمرار استخدام التصنيف في مواضعه المدعومة الأخرى."
    ],
    "troubleshooting": [
      "سجل محفوظ لا يظهر في الرئيسية: راجع المتجر والتفعيل وخيار الظهور، ثم حدّث الواجهة وانتظر تحديث بياناتها المحفوظة مؤقتًا عند الحاجة."
    ]
  },
  {
    "id": "subcategories",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "التصنيفات الفرعية: القائمة والإضافة والتعديل",
    "paths": [
      "/admin/catalog/subcategories",
      "/admin/catalog/subcategories/new",
      "/admin/catalog/subcategories/:id/edit"
    ],
    "paragraphs": [
      "تستخدم هذه الشاشة لتنظيم كتالوج المتجر، وتعرض السجلات مع البحث والحالة وإجراءات الصف المتاحة."
    ],
    "steps": [
      "ابحث عن السجل وراجع حالته قبل إنشاء سجل جديد بالاسم نفسه.",
      "اضغط إضافة أو افتح التعديل، ثم أدخل الاسم بالعربية والإنجليزية والرابط المختصر.",
      "صفِّ بالقسم ثم اختر التصنيف الأب. لا يكفي تشابه الاسم لتحديد التصنيف الصحيح.",
      "أكمل الوصف والصورة أو البيانات المرئية المتاحة والترتيب والحالة والسيو، ثم احفظ وانتظر رسالة النجاح."
    ],
    "fields": [
      "الاسم المترجم: الاسم المعروض حسب لغة المتجر.",
      "الرابط المختصر: معرّف الرابط؛ راجع خطأ التفرد إذا كان مستخدمًا.",
      "ترتيب العرض: يضبط الأولوية المرئية حيث تدعمها الواجهة.",
      "الحالة: السجل غير النشط لا يُعرض للعملاء وفق استخدامه في الواجهة."
    ],
    "tips": [
      "راجع أثر التعطيل على المنتجات المرتبطة. قد يرفض النظام حذف سجل له ارتباطات؛ اقرأ سبب الرفض قبل اختيار إجراء آخر."
    ],
    "examples": [
      "اختر القسم ثم التصنيف ثم التصنيف الفرعي لتصل إلى الفرع الصحيح من الشجرة."
    ],
    "troubleshooting": [
      "التصنيف الأب غير صحيح: صحح الاختيار ثم راجع علاقة المنتجات المتأثرة بعد الحفظ."
    ]
  },
  {
    "id": "brands",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "العلامات التجارية: القائمة والإضافة والتعديل",
    "paths": [
      "/admin/catalog/brands",
      "/admin/catalog/brands/new",
      "/admin/catalog/brands/:id/edit"
    ],
    "paragraphs": [
      "تستخدم هذه الشاشة لتنظيم كتالوج المتجر، وتعرض السجلات مع البحث والحالة وإجراءات الصف المتاحة."
    ],
    "steps": [
      "ابحث عن السجل وراجع حالته قبل إنشاء سجل جديد بالاسم نفسه.",
      "اضغط إضافة أو افتح التعديل، ثم أدخل الاسم بالعربية والإنجليزية والرابط المختصر.",
      "أدخل رابط الشعار في الحقل المخصص، ثم اربط العلامة بالمنتجات من تعديل المنتج.",
      "أكمل الوصف والصورة أو البيانات المرئية المتاحة والترتيب والحالة والسيو، ثم احفظ وانتظر رسالة النجاح."
    ],
    "fields": [
      "الاسم المترجم: الاسم المعروض حسب لغة المتجر.",
      "الرابط المختصر: معرّف الرابط؛ راجع خطأ التفرد إذا كان مستخدمًا.",
      "ترتيب العرض: يضبط الأولوية المرئية حيث تدعمها الواجهة.",
      "الحالة: السجل غير النشط لا يُعرض للعملاء وفق استخدامه في الواجهة."
    ],
    "tips": [
      "راجع أثر التعطيل على المنتجات المرتبطة. قد يرفض النظام حذف سجل له ارتباطات؛ اقرأ سبب الرفض قبل اختيار إجراء آخر."
    ],
    "examples": [
      "تعديل اسم علامة يغيّر تعريفها؛ لا يحتاج إنشاء علامة جديدة لكل منتج يحملها."
    ],
    "troubleshooting": [
      "حذف علامة مرتبط بها منتجات مرفوض: راجع الاعتماديات ورسالة الرفض قبل إزالة العلاقات."
    ]
  },
  {
    "id": "tags",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "الوسوم: القائمة والإضافة والتعديل",
    "paths": [
      "/admin/catalog/tags",
      "/admin/catalog/tags/new",
      "/admin/catalog/tags/:id/edit"
    ],
    "paragraphs": [
      "تستخدم هذه الشاشة لتنظيم كتالوج المتجر، وتعرض السجلات مع البحث والحالة وإجراءات الصف المتاحة."
    ],
    "steps": [
      "ابحث عن السجل وراجع حالته قبل إنشاء سجل جديد بالاسم نفسه.",
      "اضغط إضافة أو افتح التعديل، ثم أدخل الاسم بالعربية والإنجليزية والرابط المختصر.",
      "اربط الوسوم من نموذج المنتج لتنظيم المنتجات بصفات تسويقية إضافية خارج التصنيف الأساسي.",
      "أكمل الوصف والصورة أو البيانات المرئية المتاحة والترتيب والحالة والسيو، ثم احفظ وانتظر رسالة النجاح."
    ],
    "fields": [
      "الاسم المترجم: الاسم المعروض حسب لغة المتجر.",
      "الرابط المختصر: معرّف الرابط؛ راجع خطأ التفرد إذا كان مستخدمًا.",
      "ترتيب العرض: يضبط الأولوية المرئية حيث تدعمها الواجهة.",
      "الحالة: السجل غير النشط لا يُعرض للعملاء وفق استخدامه في الواجهة."
    ],
    "tips": [
      "راجع أثر التعطيل على المنتجات المرتبطة. قد يرفض النظام حذف سجل له ارتباطات؛ اقرأ سبب الرفض قبل اختيار إجراء آخر."
    ],
    "examples": [
      "وسم هدية يمكن استخدامه مع منتجات من تصنيفات مختلفة دون نقلها من تصنيفاتها."
    ],
    "troubleshooting": [
      "وسم لا يظهر: راجع ربط المنتج واللغة والحالة ودعم الواجهة لعرض الوسوم."
    ]
  },
  {
    "id": "product-options",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "خيارات المنتجات وقيمها",
    "paths": [
      "/admin/catalog/product-options",
      "/admin/catalog/product-options/new",
      "/admin/catalog/product-options/:id/edit"
    ],
    "paragraphs": [
      "الخيار مثل اللون أو المقاس، وقيمه مثل أحمر وأزرق أو صغير وكبير. الخيارات تخص المتجر ويمكن استخدامها في منتجات متعددة."
    ],
    "steps": [
      "أنشئ خيارًا بالاسمين العربي والإنجليزي والنوع ثم احفظه أولًا.",
      "داخل تعديل الخيار أضف القيم واحدة واحدة بالاسم والرمز والترتيب والحالة ورمز اللون إن كان مناسبًا.",
      "افتح تعديل المنتج وأنشئ المتغيرات باستخدام هذه القيم.",
      "لتعديل قيمة افتحها في محرر القيمة ثم اضغط تحديث القيمة، وراجع الجدول بعد الحفظ."
    ],
    "fields": [
      "نوع الخيار: يحدد كيفية عرض قيمه أو استخدامها.",
      "رمز اللون: قيمة العرض اللوني للخيارات المناسبة، وليس اسم اللون المترجم.",
      "قيمة الخيار: عنصر تستخدمه تركيبة المتغير."
    ],
    "tips": [
      "حذف قيمة مستخدمة في متغيرات قد يُرفض. الخاصية الوصفية مثل المؤلف تُدار في الخصائص، وليس كمتغير بيع إلا إذا كان هذا مقصودًا."
    ],
    "examples": [
      "اللون وقيمتا أحمر وأزرق تُستخدم لإنشاء متغيرين قابلين للبيع، بخلاف خاصية وصفية بلا مخزون مستقل."
    ],
    "troubleshooting": [
      "قيمة الخيار غير متاحة للمتغير: راجع الخيار وقيمه وتفعيله والمتجر قبل إعادة إنشاء القيمة."
    ]
  },
  {
    "id": "product-attributes",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "خصائص المنتجات والبحث بقيمها",
    "paths": [
      "/admin/catalog/product-attributes",
      "/admin/catalog/product-attributes/new",
      "/admin/catalog/product-attributes/:id/edit"
    ],
    "paragraphs": [
      "الخصائص تضيف معلومات مثل المؤلف أو الخامة أو نوع التغليف. يمكن أن تكون نصًا حرًا أو اختيارًا من قائمة وتُربط بأقسام محددة."
    ],
    "steps": [
      "أنشئ خاصية بالاسمين والرمز والنوع، واختر الأقسام التي تستخدمها ثم احفظ.",
      "للنوع الاختياري أضف قيم القائمة، وللنص الحر اكتب القيمة عند تعديل المنتج.",
      "افتح منتجًا تابعًا للقسم واملأ الخصائص؛ يمكن إنشاء الخاصية أو تعديلها من تبويب الخصائص بصلاحية مناسبة.",
      "فعّل ظهور الخاصية في الفلاتر أو البحث بالكلمات في قيمتها حسب الاستخدام المطلوب.",
      "لإنشاء عرض لمنتجات ذات قيمة معينة ارجع لقائمة المنتجات وافتح فلاتر الخاصية والقيمة ثم حدّد النتائج."
    ],
    "fields": [
      "الأقسام: الخاصية تظهر داخل منتجات الأقسام المرتبطة بها.",
      "تظهر في فلاتر البحث: يتيح استخدامها كفلتر حيث تدعمها الواجهة.",
      "البحث بالكلمات في قيم الخاصية: يسمح لبحث المتجر بالعثور على المنتج عبر قيمته بالعربية أو الإنجليزية.",
      "تعديل قيم القائمة: يمكن تعديل القيمة الموجودة بدل إنشاء أخرى مكررة، مع مراجعة رمزها وترجمتها وترتيبها حسب الحقول المعروضة."
    ],
    "tips": [
      "الخاصية لا تنشئ SKU أو مخزونًا مستقلًا؛ استخدم المتغيرات عندما تحتاج نسخة بيع مستقلة."
    ],
    "examples": [
      "تفعيل البحث في خاصية المؤلف يساعد على الوصول إلى كتاب بقيمة المؤلف، ولا ينشئ نسخة مخزون جديدة."
    ],
    "troubleshooting": [
      "البحث بقيمة لا يجد المنتج: راجع ربط الخاصية بقسم المنتج، وحفظ القيمة وخيار البحث فيها، ثم لغة البحث."
    ]
  },
  {
    "id": "product-services",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "الخدمات الإضافية وخياراتها",
    "paths": [
      "/admin/catalog/product-services"
    ],
    "paragraphs": [
      "هذه الشاشة تدير خدمات يمكن ربطها بمنتجات متعددة، مثل التغليف أو الطباعة، مع خيارات خدمة وأسعار لكل خيار."
    ],
    "steps": [
      "ابحث عن الخدمة أو صفِّ بالحالة، ثم اضغط خدمة جديدة أو القلم لتعديل خدمة موجودة.",
      "أدخل اسم الخدمة ورمزها وخياراتها وأسعار الخيارات وحالتها حسب المحرر.",
      "احفظ وانتظر رسالة النجاح، ثم راجع عدد المنتجات المرتبطة وخيارات الخدمة في القائمة.",
      "افتح المنتج واربط الخدمة من تبويب الباكدج والخدمات وحدد هل اختيارها مطلوب."
    ],
    "fields": [
      "خيارات الخدمة: البدائل التي يختارها العميل وتكلفة كل بديل.",
      "المنتجات المرتبطة: عدد المنتجات التي تستخدم الخدمة.",
      "الحالة: تتحكم في إتاحة الخدمة أو الخيار حسب إعداداته."
    ],
    "tips": [
      "تعديل خدمة مشتركة قد يؤثر على اختيارات منتجات متعددة. تكلفة الخدمة تُضاف لكل قطعة في السلة."
    ],
    "examples": [
      "خدمة تغليف بهدية تُربط بمنتجين وتحدد اختياراتها مرة واحدة؛ راجع سعر الاختيار لكل قطعة."
    ],
    "troubleshooting": [
      "خدمة غير ظاهرة في المنتج: احفظها وتأكد من تفعيلها وربطها به واختيارها ضمن خدماته."
    ]
  },
  {
    "id": "reviews",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "مراجعة تقييمات المنتجات",
    "paths": [
      "/admin/catalog/reviews",
      "/admin/catalog/reviews/:id"
    ],
    "paragraphs": [
      "تراجع هذه الشاشة تقييمات العملاء وتحدد ما يظهر منها في المتجر حسب حالتها."
    ],
    "steps": [
      "ابحث وصفِّ التقييمات حسب المنتج أو الحالة والفلاتر المتاحة ثم افتح التقييم.",
      "راجع النص والنجوم والعميل والمنتج ووسم الشراء الموثق قبل اتخاذ القرار.",
      "اختر موافقة للنشر أو رفض مع سبب اختياري، أو إخفاء تقييم منشور، ثم اقرأ نتيجة الإجراء.",
      "استخدم الاستعادة عندما تريد إعادة اعتماد تقييم مخفي، والحذف فقط بعد قراءة تأكيده."
    ],
    "fields": [
      "سبب الرفض: توضيح قرار المراجعة عند إدخاله.",
      "أصوات مفيدة: تفاعل العملاء مع التقييم.",
      "الاعتماد والرفض: تعرض التفاصيل أوقاتهما ومن نفّذهما إذا توفرت البيانات."
    ],
    "tips": [
      "الرفض أو الإخفاء يؤثر على ظهور التقييم. الحذف المعروض هنا نهائي حسب رسالة التأكيد، فلا تعتبره أرشفة."
    ],
    "examples": [
      "افتح التقييم واقرأ نصه ونجومه والمنتج قبل الموافقة أو الرفض، ثم راجع حالته المحفوظة."
    ],
    "troubleshooting": [
      "تقييم لا يظهر للعميل: تحقق من المراجعة والحالة والمنتج والمتجر قبل إعادة إدخاله."
    ]
  },
  {
    "id": "catalog-excel",
    "group": "catalog",
    "group_title": "الكتالوج والمنتجات",
    "title": "رفع وتصدير الكتالوج عبر Excel",
    "paths": [
      "/admin/catalog/excel"
    ],
    "paragraphs": [
      "تستخدم هذه الشاشة لنقل بيانات الكتالوج دفعة واحدة. من شاشة الكتالوج الشاملة تُرفع الشيتات المدعومة معًا، ومن شاشة كيان محدد تُرسل شيت هذا الكيان فقط."
    ],
    "steps": [
      "نزّل القالب أو صدّر البيانات الحالية لتبدأ بأسماء الأعمدة والشيتات الصحيحة.",
      "املأ البيانات مع الحفاظ على slug أو code أو SKU المستخدم للمطابقة؛ راجع العلاقات بين الأقسام والتصنيفات والمنتجات.",
      "ارفع الملف من الشاشة المناسبة وانتظر نتيجة الاستيراد، ثم راجع الأخطاء والصفوف المقبولة في النتيجة.",
      "ابحث عن عينة من السجلات بعد الاستيراد للتأكد من الأسماء والأسعار والعلاقات والمخزون."
    ],
    "fields": [
      "المطابقة: تعتمد على slug أو code أو SKU حسب الشيت، وتسمح بتحديث سجل موجود بدل تكراره.",
      "الخانات الفارغة: لا تُستخدم لمسح قيم موجودة في تحديث الاستيراد.",
      "الشيتات التي تبدأ بـ _: أمثلة لا يتم استيرادها.",
      "تصدير المنتجات: الكل، أو المفعّل، أو المخزون القليل للمنتجات المفعّلة ومخزونها 5 أو أقل."
    ],
    "tips": [
      "الحد 20000 صف. غياب سجل عن الملف لا يحذفه من المتجر، والاستيراد ليس استبدالًا شاملًا للكتالوج.",
      "احتفظ بنسخة من التصدير قبل تعديل ملف كبير، ولا تغيّر المعرّفات لمجرد تعديل الاسم."
    ],
    "examples": [
      "لتحديث أسعار منتجات موجودة احتفظ بـ SKU واكتب السعر بثلاث خانات؛ لا تغيّر المعرّف لتعديل الاسم."
    ],
    "troubleshooting": [
      "الاستيراد تجاهل شيت: راجع اسم الشيت وبادئة _ والشاشة التي رفعت منها، ثم تفاصيل الصفوف المرفوضة."
    ]
  },
  {
    "id": "orders",
    "group": "sales",
    "group_title": "الطلبات والعملاء والمحفظة",
    "title": "قائمة الطلبات والفلاتر",
    "paths": [
      "/admin/orders"
    ],
    "paragraphs": [
      "تعرض طلبات المتجر مع حالات الطلب والدفع والعميل والإجمالي. حالة الطلب التشغيلية مختلفة عن نجاح الدفع."
    ],
    "steps": [
      "ابحث برقم الطلب أو بيانات العميل وفق البحث المتاح، واضبط الحالة والدفع والفترة والعملة ومصدر الطلب عند توفرها.",
      "راجع الإجمالي والعملة وحالة الدفع قبل اعتبار الطلب محصّلًا.",
      "افتح الطلب لعرض الأصناف والعنوان والمدفوعات والشحنات أو تعديل ما تسمح به حالته وصلاحيتك.",
      "لبيع من اللوحة استخدم إنشاء طلب لفتح شاشة الكاشير."
    ],
    "fields": [
      "حالة الطلب: مرحلة التجهيز أو الشحن أو الإكمال أو الإلغاء.",
      "حالة الدفع: انتظار أو نجاح أو فشل أو استرداد وفق الدفعات.",
      "التاريخ: يحدد نطاق إنشاء الطلب في منطقة المتجر الزمنية عند التصفية بالتاريخ."
    ],
    "tips": [
      "وجود الطلب بالقائمة لا يثبت الدفع. عند المقارنة مع لوحة التحكم استخدم نفس الفترة والعملة والفلاتر."
    ],
    "examples": [
      "راجع رقم الطلب مع اسم العميل والعملة وحالة الدفع قبل فتح تعديل أو إرسال مستند."
    ],
    "troubleshooting": [
      "طلب مفقود: امسح فلتر المصدر والحالة والتاريخ والبحث، ثم تأكد من المتجر الصحيح."
    ]
  },
  {
    "id": "order-detail",
    "group": "sales",
    "group_title": "الطلبات والعملاء والمحفظة",
    "title": "تفاصيل الطلب وتعديل الأصناف والجاهزية",
    "paths": [
      "/admin/orders/:id"
    ],
    "paragraphs": [
      "تفاصيل الطلب تجمع العميل والعنوان والأصناف والمجاميع، مع المدفوعات والشحنات والنشاط والمراسلات والمستندات."
    ],
    "steps": [
      "راجع ملخص الطلب وحالة الدفع والعنوان والأصناف قبل التعديل.",
      "استخدم تعديل الكمية أو إضافة صنف أو حذفه فقط عندما تتاح الإجراءات لحالة الطلب وصلاحيتك، ثم راجع الإجماليات الناتجة.",
      "علّم الأصناف جاهزة للشحن منفردة أو علّم الكل. إذا أصبحت كلها جاهزة وكان الانتقال مسموحًا تتغير مرحلة الطلب تلقائيًا.",
      "غيّر الحالة من الإجراء المخصص واختر سببًا أو ملاحظة عند طلبهما؛ الانتقالات غير المسموحة تُرفض.",
      "راجع النشاط والمدفوعات والشحنات للتحقق من تنفيذ كل خطوة."
    ],
    "fields": [
      "جاهزية الصنف: استعداد الصنف للتجهيز، وليست تأكيد تحصيله.",
      "الملاحظات الداخلية: للفريق فقط ولا تظهر للعميل.",
      "الرسائل: تظهر للعميل في صفحة طلبه؛ راجع النص قبل الإرسال.",
      "حذف الصنف: يعالج المخزون وفق قواعد التعديل؛ اقرأ التأكيد وراجع الإجمالي بعده.",
      "قيد الانتظار: طلب أولي ينتظر استكمال أو مراجعة الخطوة التالية.",
      "تم استلام الطلب: الطلب مؤكد تشغيليًا؛ راجع حالة الدفع بصورة مستقلة.",
      "جاري التحضير: الفريق يجهز الأصناف.",
      "جاري شحنه: الطلب في مرحلة التجهيز للخروج أو التوصيل وفق مسار الشحن المعتمد.",
      "تم شحنه: سُجل انتقال الطلب لمرحلة الشحن.",
      "تم التسليم: سُجل تسليم الطلب للعميل.",
      "ملغى: توقف تنفيذ الطلب؛ راجع الحركات المالية والمخزنية المرتبطة.",
      "مسترد: حالة طلب مرتبطة بمسار الاسترداد؛ راجع تفاصيل الدفع والمرتجعات لمعرفة المبلغ الفعلي."
    ],
    "tips": [
      "لا تغيّر حالة الطلب لمجرد رسالة عودة من بوابة الدفع؛ راجع الدفع المؤكد.",
      "الأزرار تتغير حسب الحالة والصلاحيات؛ رفض التعديل قد يكون لحماية طلب دخل مرحلة متقدمة."
    ],
    "examples": [
      "جهّز أصناف طلب واحد ثم راجع حالة الطلب الناتجة والنشاط بدل افتراض أن تحديث بند أكد الدفع."
    ],
    "troubleshooting": [
      "إجراء غير ظاهر: راجع صلاحية الإجراء والحالة الحالية وأي استرداد كامل، وليس صلاحية عرض الطلب وحدها."
    ]
  },
  {
    "id": "order-checks",
    "group": "sales",
    "group_title": "الطلبات والعملاء والمحفظة",
    "title": "دورة الطلب: الدفع والتأكيد والإلغاء والاسترداد",
    "paths": [],
    "paragraphs": [
      "ابدأ من حالة الطلب والدفع معًا. الإلغاء التشغيلي والاسترداد المالي وإرجاع المخزون خطوات ذات آثار مختلفة، ولا يجوز اعتبار أي واحدة منها إثباتًا لاكتمال الأخريات."
    ],
    "steps": [
      "افتح الطلب وتحقق من العميل والإجمالي والعملة وطريقة الدفع والمدفوعات المسجلة.",
      "قبل تأكيد طلب غير مدفوع اقرأ التحذير الواضح واختر المتابعة فقط عندما يكون تنفيذ الطلب مناسبًا لوسيلته وسياسة المتجر.",
      "للإلكتروني راجع نجاح الدفع من المصدر المعتمد؛ وللدفع عند الاستلام راجع المبلغ المطلوب تحصيله دون تسجيل قبض لم يحدث.",
      "بعد التأكيد تابع جاهزية البنود والمندوب والشحنة والتسليم من الإجراءات المسموحة؛ تسجيل إجراء لا يعني السماح بكل انتقال لاحق.",
      "للإلغاء راجع حالة التنفيذ وسبب الإلغاء وأثر المخزون والمدفوعات قبل التأكيد.",
      "للاسترداد افتح الدفع أو مسار مرتجع الطلب، وراجع المبلغ القابل للرد والحالة النهائية. راجع الكاش باك والبضاعة المعادة بصورة مستقلة.",
      "ارجع للنشاط والمطابقة وسجل الحركات للتحقق من النتيجة؛ الطلب المسترد بالكامل لا يُستكمل كبيع جديد بتغيير حالته."
    ],
    "fields": [
      "التأكيد: اعتماد تنفيذ الطلب، ويختلف عن تأكيد قبض مبلغ إلكتروني أو نقدي.",
      "الدفع عند الاستلام: قد يحمل علامة تحقق وفق المسار، مع بقاء التحصيل مستقلًا حتى تسجيله فعليًا.",
      "الاسترداد المعلّق: عملية لم يُعتمد نجاحها بعد؛ لا تكررها لمجرد تأخر الحالة.",
      "المرتجع المخزني: يعيد كمية صالحة للبيع بعد فحصها؛ التالف والمعاد للمخزون لهما أثران مختلفان.",
      "المسترد بالكامل: راجع حالة الدفع والطلب والإجراءات المقفولة قبل محاولة أي انتقال جديد."
    ],
    "tips": [
      "احفظ مرجع الدفع أو الاسترداد ورسالة الرفض عند طلب دعم. لا تُنشئ دفعة أو استردادًا إضافيًا لمجرد تأخر تحديث الشاشة."
    ],
    "examples": [
      "إلغاء طلب إلكتروني مدفوع يستلزم مراجعة رد الأموال من مساره؛ تغيير شارة الطلب إلى ملغى ليس إيصال استرداد. رد جزء من المبلغ لا يثبت رجوع كل وحدات المنتج للمخزون."
    ],
    "troubleshooting": [
      "تحديث الحالة مرفوض: راجع الانتقال المسموح وحالة الدفع والاسترداد واكتمال التنفيذ، ثم اقرأ رسالة الرفض.",
      "دفع ناجح لكن الطلب لا يظهر كما تتوقع: افتح سجل الدفع والطلب المرتبط وحدّث النتائج، ولا تنفذ بيعًا ثانيًا قبل التحقق من مرجع المحاولة الأولى."
    ]
  },
  {
    "id": "order-documents",
    "group": "sales",
    "group_title": "الطلبات والعملاء والمحفظة",
    "title": "مستندات الطلب والفاتورة الضريبية وERP",
    "paths": [],
    "paragraphs": [
      "من تبويبات المستندات وفاتورة ERP يمكن طباعة مستند الطلب وإصدار فاتورة ضريبية أو متابعة إرسالها للنظام الخارجي."
    ],
    "steps": [
      "افتح الطلب ثم المستندات واستخدم طباعة الطلب أو عرض المستند المتاح.",
      "إذا كانت الضريبة مفعّلة لهذا الطلب وصلاحيتك تسمح، اختر إصدار فاتورة ضريبية واقرأ تأكيد تثبيت القيم المالية.",
      "بعد الإصدار افتح PDF أو حمّله؛ عند الحاجة استخدم إعادة إنشاء PDF أو إلغاء الفاتورة مع السبب وفق الصلاحية.",
      "في فاتورة ERP راجع الربط والمرجع وآخر محاولة، ثم أرسل أو أعد المحاولة فقط بعد مراجعة حالة المحاولات السابقة."
    ],
    "fields": [
      "الفاتورة الضريبية: تعتمد بيانات الطلب وقت الإصدار؛ الطلب المعفى من تشغيل الضريبة لا يتيح إصدارها من هذه اللوحة.",
      "إلغاء الفاتورة: يطلب سببًا ولا يعيد استخدام رقم الفاتورة الملغاة.",
      "مرجع ERP: مرجع الإرسال الخارجي، وهو مختلف عن رقم فاتورة النظام."
    ],
    "tips": [
      "إعادة إرسال فاتورة سبق إرسالها لها تأكيد خاص؛ راجع سبب الإعادة قبل تنفيذها.",
      "تعديل إعدادات ضريبة المتجر لاحقًا لا يغيّر البيانات المثبتة للطلبات السابقة."
    ],
    "examples": [
      "طباعة الطلب تُخرج مستند الطلب؛ إصدار فاتورة ضريبية يثبت بياناتها من مسار مستقل."
    ],
    "troubleshooting": [
      "بيانات فاتورة قديمة مختلفة عن إعداد اليوم: راجع لقطة الطلب أو الفاتورة وتاريخ الإصدار قبل تعديل إعداد المتجر."
    ]
  },
  {
    "id": "order-invoice-delivery",
    "group": "sales",
    "group_title": "الطلبات والعملاء والمحفظة",
    "title": "إرسال فاتورة الطلب بالبريد أو واتساب ومتابعة النتيجة",
    "paths": [],
    "paragraphs": [
      "يمكن إرسال فاتورة الطلب من تفاصيله عبر القنوات الجاهزة. فاتورة الطلب المرسلة وPDF المرفق ليست إصدار فاتورة ضريبية؛ إصدار الفاتورة الضريبية له إجراء مستقل."
    ],
    "steps": [
      "افتح تفاصيل الطلب واضغط إرسال الفاتورة عند توفر الصلاحية، ثم راجع القنوات المتاحة وعنوان البريد أو الهاتف قبل التأكيد.",
      "اختر البريد أو واتساب أو القناتين حسب ما يظهر جاهزًا، ثم أرسل مرة واحدة وانتظر تسجيل المحاولة.",
      "في البريد يتلقى العميل نسخة الفاتورة مع مرفق PDF. في واتساب تصله رسالة برابط تحميل موقّع صالح لمدة 7 أيام يبدأ عند تجهيز الإرسال.",
      "راجع آخر محاولات الفاتورة داخل نافذتها، أو افتح الإشعارات ← عمليات الإرسال لمتابعة النجاح أو سبب الفشل والمحاولات.",
      "لتجهيز الإرسال التلقائي راجع إعدادات الإشعارات والبريد وحدث فاتورة الطلب. الدفع الإلكتروني يحتاج تأكيد تحصيل فعلي، بينما يدعم مسار الدفع عند الاستلام إرسال فاتورة طلب دون ادعاء تحصيله.",
      "من إعدادات البريد اضبط عناوين النسخة المخفية BCC لفواتير الطلبات إذا لزم، واحفظ القناة ثم راجع مستلم اختبار معتمد."
    ],
    "fields": [
      "المستلم: يؤخذ من بيانات الطلب المحفوظة ثم بيانات العميل الصالحة عند الحاجة؛ راجعه قبل إرسال مستند يحوي تفاصيل الطلب.",
      "فاتورة الطلب: توضح الأصناف والصور والكميات والأسعار والخصم والشحن وحالة الدفع، مع شعار المتجر عند توفره.",
      "PDF: مرفق في البريد، ويمكن تنزيله من الرابط المخصص في واتساب.",
      "BCC: نسخ مخفية لعناوين إضافية مضبوطة لهذا المتجر، ولا تظهر كقائمة مستلمين للعميل.",
      "في الانتظار أو مجدولة: محاولة مقبولة للمعالجة وليست إثبات وصول الرسالة.",
      "الإرسال التلقائي: يمنع تكرار إرسال نفس حدث الفاتورة للطلب؛ الإرسال اليدوي المقصود محاولة مستقلة."
    ],
    "tips": [
      "راجع بريد المتجر وإعدادات المزوّد والأحداث وطابور المعالجة إذا لم تصل الفاتورة. تعثر البريد لا يلغي نجاح دفع تم تأكيده.",
      "التحقق من الدفع عند الاستلام لا يعني قبض النقود. اقرأ مبلغ التحصيل وحالة الدفع الفعلية في الفاتورة والطلب."
    ],
    "examples": [
      "عميل دفع إلكترونيًا وتم تأكيد الدفع: تُسجّل محاولة فاتورة البريد حسب تفعيل القناة والحدث ووجود البريد. طلب COD قد تُرسل فاتورته مع بقاء المبلغ غير محصّل."
    ],
    "troubleshooting": [
      "زر الإرسال غير ظاهر: راجع صلاحية إرسال الفاتورة. قناة مقفولة: راجع جاهزية مزودها ووجود بريد أو هاتف صالح للمستلم.",
      "المحاولة فشلت: افتح سبب الفشل، وصحح القناة أو بيانات المستلم، ثم استخدم إعادة المحاولة المتاحة بدل تكرار الطلب عشوائيًا.",
      "رابط واتساب انتهى: أرسل محاولة جديدة مقصودة من الطلب بعد مراجعة المستلم بدل تعديل رابط قديم."
    ]
  },
  {
    "id": "pos",
    "group": "sales",
    "group_title": "الطلبات والعملاء والمحفظة",
    "title": "الكاشير وإنشاء طلب من اللوحة",
    "paths": [
      "/admin/orders/create"
    ],
    "paragraphs": [
      "شاشة الكاشير لإنشاء طلب بيع يدوي: عميل ومنتجات ومتغيرات وشحن ومدفوعات، مع إمكانية تعليق سلة واستئنافها."
    ],
    "steps": [
      "ابحث عن العميل أو أضف عميلًا جديدًا عند الحاجة، أو استخدم العميل النقدي وفق نوع البيع.",
      "ابحث باسم المنتج أو SKU أو امسح الباركود، واختر المتغير قبل الإضافة إذا كان للمنتج أنواع.",
      "راجع الكميات والخصومات وسعر الوحدة. تعديل السعر يحتاج صلاحيته وسبب التعديل.",
      "اختر التوصيل أو الاستلام؛ للتوصيل أدخل عنوانًا أو اختر عنوان العميل، وللاستلام اختر الفرع المتاح.",
      "أدخل وسائل الدفع والمبالغ وراجع المتبقي والباقي، ثم اضغط إنشاء الطلب وانتظر نجاح الإنشاء وفتح نتيجته.",
      "يمكن فتح الكاشير من زر POS بجوار اللغة أعلى اللوحة. يظهر عند اختيار متجر وامتلاك صلاحية orders.create."
    ],
    "fields": [
      "تعليق السلة: يحفظ سلة كاشير لاستئنافها؛ الاستئناف قد يستبدل السلة الحالية بعد التأكيد.",
      "المدفوعات: يجب أن تتوافق مع الاستحقاق؛ الرصيد غير الكافي أو مبالغ غير صحيحة تُرفض.",
      "المحفظة: المبلغ لا يتجاوز الرصيد المتاح للعميل.",
      "تعديل السعر: يختلف عن خصم الصنف؛ استخدم استعادة سعر الكتالوج لإلغاء تجاوز السعر عند الحاجة.",
      "المصدر ومدخل الطلب: الطلب المنشأ هنا يسجل POS وحساب الموظف الذي أنشأه، ليظهر في تقرير مبيعات مدخلي الطلبات."
    ],
    "tips": [
      "لا تغادر وفي السلة تغييرات غير محفوظة دون تعليقها أو إكمالها؛ راجع تحذير المغادرة.",
      "راجع العنوان والفرع والمنتج والمتغير قبل الإنشاء؛ إنشاء الطلب إجراء بيع فعلي."
    ],
    "examples": [
      "طلب أدخله موظف من زر POS يظهر باسم مدخله في تقرير المبيعات، وموظف لم يدخل طلبات يظهر بقيم صفر."
    ],
    "troubleshooting": [
      "الزر غير ظاهر: راجع وجود متجر محدد وصلاحية إنشاء الطلب. فشل الإنشاء: راجع الحقول والمخزون والشحن والمبالغ قبل المحاولة التالية."
    ]
  },
  {
    "id": "customers",
    "group": "sales",
    "group_title": "الطلبات والعملاء والمحفظة",
    "title": "قائمة العملاء",
    "paths": [
      "/admin/customers"
    ],
    "paragraphs": [
      "تعرض عملاء المتجر وبياناتهم وحالاتهم ومؤشرات نشاطهم المتاحة، مع البحث للوصول للحساب الصحيح."
    ],
    "steps": [
      "ابحث بالاسم أو البريد أو الهاتف واضبط الفلاتر المتاحة.",
      "راجع بيانات التواصل قبل فتح العميل لتجنب الخلط بين أسماء متشابهة.",
      "افتح التفاصيل لمراجعة الملف والعناوين والطلبات والمحفظة وفق صلاحياتك."
    ],
    "fields": [
      "الحالة: تفعيل الحساب أو تعطيله، وقد يظهر حساب محذوف للمراجعة.",
      "الجهاز الحالي: أحدث جهاز مسجل في نشاط العميل بهذا المتجر، وليس بالضرورة جهاز التسجيل."
    ],
    "tips": [
      "عميل المتجر يُراجع في سياق المتجر المختار؛ لا تستخدم بيانات متجر آخر لتفسير عدد طلباته هنا."
    ],
    "examples": [
      "حسابان لهما اسم واحد يُميَّزان بالبريد أو الهاتف ورقم العميل قبل أي تعديل مالي."
    ],
    "troubleshooting": [
      "عميل غير ظاهر في متجر: راجع سياق المتجر وعلاقته به وفلاتر الحالة والبحث."
    ]
  },
  {
    "id": "customer-detail",
    "group": "sales",
    "group_title": "الطلبات والعملاء والمحفظة",
    "title": "تفاصيل العميل وتفعيل الحساب والتوثيق",
    "paths": [
      "/admin/customers/:id"
    ],
    "paragraphs": [
      "تجمع هذه الشاشة الملف والإحصائيات والعناوين والطلبات والمحفظة. التعديلات الحساسة تظهر حسب صلاحيات الموظف وحالة الحساب."
    ],
    "steps": [
      "راجع الاسم والبريد والهاتف وعلامات التوثيق وآخر جهاز ونشاط.",
      "عدّل الحقول المسموحة ثم احفظ الملف وانتظر رسالة النجاح.",
      "لتعطيل الحساب أو تفعيله افتح الإجراء واقرأ أثره وأدخل السبب الاختياري ثم أكد.",
      "راجع إحصائيات المتجر والعناوين وافتح أي طلب من قائمة الطلبات.",
      "استخدم لوحة المحفظة عند الحاجة لإضافة أو خصم أو كاش باك بصلاحية مالية مناسبة.",
      "لتسجيل خروج العميل من كل الأجهزة اضغط الإجراء من رأس تفاصيله بصلاحية تحديث حالة العملاء، وراجع الحساب في التأكيد ثم افحص رسالة النجاح."
    ],
    "fields": [
      "توثيق البريد والهاتف: علامة إدارية؛ تغييرها يتطلب التأكد من صحة بيانات العميل.",
      "تعطيل الحساب: يمنع الدخول ويلغي رموز API الحالية وفق الإجراء.",
      "الحساب المحذوف نهائيًا: بياناته للمراجعة ولا يمكن استعادته من هذه الشاشة.",
      "تسجيل خروج العميل: يلغي جلساته الحالية ولا يحذف حسابه أو طلباته أو رصيد محفظته. العميل المحذوف لا يعرض إجراءات تعديل الحساب المعتادة."
    ],
    "tips": [
      "إجمالي الإنفاق ومتوسط الطلب يخصان إحصائيات المتجر المعروضة، وليسا إثباتًا لرصيد محفظة العميل."
    ],
    "examples": [
      "بعد تغيير حالة العميل راجع شارة التفعيل والجلسات؛ عدد طلباته لا يتغير إلى رصيد محفظة."
    ],
    "troubleshooting": [
      "تسجيل خروج كل الأجهزة لا يمنع دخولًا جديدًا ببيانات صحيحة؛ للتعطيل استخدم إجراء حالة الحساب بعد مراجعة أثره."
    ]
  },
  {
    "id": "wallet",
    "group": "sales",
    "group_title": "الطلبات والعملاء والمحفظة",
    "title": "المحفظة والكاش باك ومعاملات الرصيد",
    "paths": [
      "/admin/wallet-transactions"
    ],
    "paragraphs": [
      "قائمة معاملات المحفظة تراجع حركة الرصيد، ومن تفاصيل العميل يمكن تنفيذ إضافة أو خصم أو منح كاش باك عند توفر الصلاحية."
    ],
    "steps": [
      "افتح معاملات المحفظة وصفِّ أو ابحث وفق الحقول المتاحة، ثم راجع نوع الحركة وقيمتها ومرجعها وعميلها.",
      "لإجراء تعديل افتح العميل ثم المحفظة، واختر إضافة أو خصم أو كاش باك، وأدخل المبلغ والبيانات المطلوبة.",
      "راجع الرصيد المتاح والمحجوز قبل التأكيد، ثم انتظر نجاح العملية وافحص الحركة الجديدة والرصيد.",
      "إذا ظهر تعارض لمفتاح التكرار راجع نتيجة المحاولة الأولى بدل تنفيذ نفس التسوية بمفاتيح مختلفة دون تحقق.",
      "لعكس مكافأة كاش باك محددة راجع معاملات الكاش باك داخل العميل واستخدم إجراء العكس إن ظهر بصلاحيتك، ثم راجع الحركة والرصيد الناتجين."
    ],
    "fields": [
      "الرصيد والمحجوز: المحجوز ليس مبلغًا متاحًا للإنفاق فورًا.",
      "الكاش باك: يُضاف إلى المحفظة العامة؛ ليس له رصيد منفصل قابل للإنفاق.",
      "ملخص المتجر: يفصل مكافآت هذا المتجر عن الملخص العام عندما تعرضه الشاشة."
    ],
    "tips": [
      "يُضاف كاش باك الطلب عند تأكيد الدفع. بعض حالات الاسترداد الجزئي أو المكافآت المتعددة تحتاج مراجعة يدوية؛ راجع رسالة المطابقة عند الاسترداد.",
      "سجل المحفظة يمثل حركات مالية فعلية؛ راجع السبب والعميل والمبلغ قبل التأكيد."
    ],
    "examples": [
      "رصيد 10.000 ومحجوز 3.000 لا يعني أن كامل 10.000 متاح للصرف؛ راجع الرصيد المتاح المعروض."
    ],
    "troubleshooting": [
      "حركة مكررة محتملة: ابحث عن المرجع ونتيجة الطلب الأول قبل تنفيذ إضافة أو خصم جديد."
    ]
  },
  {
    "id": "payments",
    "group": "finance",
    "group_title": "المدفوعات والمطابقة",
    "title": "المدفوعات وتفاصيل الدفع والتحقق",
    "paths": [
      "/admin/payments",
      "/admin/payments/:id"
    ],
    "paragraphs": [
      "تعرض الشاشة محاولات الدفع وحالاتها والمبلغ القابل للاسترداد، ومن التفاصيل تراجع معاملات العملية وأدلة تأكيدها."
    ],
    "steps": [
      "ابحث برقم الدفع أو المرجع أو الطلب أو العميل، وصفِّ بالحالة والبوابة والفترة ووجود استرداد.",
      "افتح الدفع وراجع المبلغ والمدفوع والمسترد والقابل للاسترداد والطلب المرتبط.",
      "إذا تأخر تأكيد البوابة استخدم التحقق عبر المزود عند توفره، ثم راجع الحالة وتاريخ آخر تحقق.",
      "لرد مبلغ افتح الاسترداد، وأدخل المبلغ والسبب المطلوبين وراجع القابل للاسترداد قبل التأكيد.",
      "بعد الطلب راجع سجل المرتجع وحالته؛ تقديم طلب الاسترداد لا يعني نجاحه فورًا."
    ],
    "fields": [
      "مرجع البوابة ومعرّف المعاملة: يساعدان على المطابقة مع مزود الدفع.",
      "حالة المزود وآخر تحقق: آخر نتيجة تحقق مسجلة وليست ضمانًا بأن كل طلب قيد التنفيذ انتهى.",
      "القابل للاسترداد: المتبقي المسموح رده بعد حساب الاستردادات السابقة."
    ],
    "tips": [
      "عودة المتصفح وحدها لا تثبت الدفع. اعتمد على تأكيد المزود أو الويب هوك أو التحقق المعتمد.",
      "لا تكرر الاسترداد إذا لم تظهر النتيجة سريعًا؛ راجع السجل أولًا لتجنب طلبين لنفس المبلغ."
    ],
    "examples": [
      "عدة محاولات لنفس الطلب لا تعني عدة تحصيلات ناجحة؛ راجع كل حالة ومرجع ومبلغ."
    ],
    "troubleshooting": [
      "المزود يؤكد الدفع والشاشة معلقة: استخدم التحقق المسموح وراجع الويب هوك والمطابقة قبل إنشاء دفعة أخرى."
    ]
  },
  {
    "id": "refunds",
    "group": "finance",
    "group_title": "المدفوعات والمطابقة",
    "title": "المرتجعات ومتابعة استرداد الأموال",
    "paths": [
      "/admin/refunds",
      "/admin/refunds/:id"
    ],
    "paragraphs": [
      "هذه قائمة معاملات استرداد الأموال، وليست قائمة إرجاع مخزني فقط. كل مرتجع مرتبط بدفع وطلب عند توفر الربط."
    ],
    "steps": [
      "ابحث بالسبب أو المرجع أو المعاملة وصفِّ بالحالة والفلاتر المتاحة.",
      "افتح المرتجع وراجع المبلغ والعميل والدفع والمنفذ ووقت الإنشاء والمعالجة.",
      "إذا أتاح المزود تحقق الحالة اضغط التحقق ثم انتظر رسالة النتيجة وتحديث الحالة.",
      "لمراجعة المبلغ المتبقي افتح الدفع الأصلي؛ لإنشاء استرداد جديد استخدم إجراء الاسترداد من الدفع أو الطلب."
    ],
    "fields": [
      "الحالة: تعكس معالجة المزود أو النظام للاسترداد.",
      "تاريخ المعالجة: وقت تسجيل المعالجة إن اكتملت، وقد يختلف عن تاريخ الإنشاء.",
      "السبب والمرجع: لتوثيق التسوية والبحث عنها لاحقًا."
    ],
    "tips": [
      "راجع تحذير مطابقة الكاش باك عندما يظهر. رد الأموال قد يحتاج مراجعة مكافأة العميل بصورة مستقلة في بعض الحالات."
    ],
    "examples": [
      "استرداد 2.000 من دفعة 10.000 لا يلغي بقية قيمة الطلب؛ راجع المتبقي وحالة الاسترداد."
    ],
    "troubleshooting": [
      "المبلغ القابل للاسترداد أقل: راجع الاستردادات السابقة والمعلقة والحدود التي يعرضها المزود."
    ]
  },
  {
    "id": "webhooks",
    "group": "finance",
    "group_title": "المدفوعات والمطابقة",
    "title": "سجلات ويب هوك الدفع",
    "paths": [
      "/admin/payment-webhook-logs",
      "/admin/payment-webhook-logs/:id"
    ],
    "paragraphs": [
      "تعرض إشعارات بوابات الدفع الواردة ونتيجة معالجتها، لتفسير تأخر تأكيد الدفع أو أخطاء استقبال الإشعارات."
    ],
    "steps": [
      "ابحث بالبوابة أو الخطأ، وصفِّ بمعالَج أو غير معالَج حسب الحاجة.",
      "افتح السجل وراجع البوابة والحالة ووقت الاستقبال والمعالجة والملخص الآمن.",
      "طابق المرجع مع الدفع المعني، ثم راجع الدفع نفسه لمعرفة حالته الحالية.",
      "عند تكرار خطأ راجع عنوان الويب هوك من إعداد البوابة أو أرسل المرجع لمسؤول التكامل دون مشاركة الأسرار."
    ],
    "fields": [
      "معالَج: حالة معالجة الإشعار المسجلة، وليست بالضرورة تحصيلًا ناجحًا.",
      "ملخص الحمولة: بيانات آمنة محدودة؛ لا تُعرض الحمولة الكاملة والأسرار."
    ],
    "tips": [
      "الإشعار قد يصف فشلًا أو انتظارًا أو استردادًا. لا تستنتج نجاح الدفع من مجرد وصول ويب هوك."
    ],
    "examples": [
      "راجع حالة المعالجة ومرجع الطلب والدفع من السجل، وليس وصول إشعار إلى المتصفح فقط."
    ],
    "troubleshooting": [
      "ويب هوك مرفوض: راجع سبب الرفض وتوقيع المزود والإعداد الصحيح مع المسؤول؛ لا تعتمد حدثًا غير موثّق يدويًا."
    ]
  },
  {
    "id": "reconciliation",
    "group": "finance",
    "group_title": "المدفوعات والمطابقة",
    "title": "المطابقة المالية وفحص المشكلات وحلها",
    "paths": [
      "/admin/reconciliation",
      "/admin/reconciliation/:id"
    ],
    "paragraphs": [
      "تكشف المطابقة اختلافات بين الطلبات والمدفوعات والمعاملات، وتتيح توثيق المراجعة والحل بصلاحيات مناسبة."
    ],
    "steps": [
      "اضغط فحص واقرأ التأكيد لبدء اكتشاف التناقضات؛ انتظر النتيجة ثم راجع القائمة.",
      "استخدم فلتر غير محلول لرؤية المفتوح والمُقرّ به معًا، أو اختر حالة وفئة وخطورة محددة.",
      "افتح المشكلة وراجع الوصف والمتوقع والفعلي والفرق والحل الموصى به.",
      "استخدم إقرار لتوثيق بدء المراجعة. إذا كانت المشكلة اختلاف أعلام الطلب والدفع استخدم المزامنة بعد مراجعة حقيقة الدفع.",
      "بعد تنفيذ المعالجة الصحيحة اختر حل وأدخل رمز الحل والملاحظة، ثم راجع الحالة الجديدة."
    ],
    "fields": [
      "إقرار: يثبت أن المشكلة قيد المراجعة ولا يعني حلها.",
      "المتوقع والفعلي: الأدلة التي يعتمد عليها وصف المشكلة.",
      "مزامنة حالة الدفع: تحاذي الأعلام مع حقيقة الدفع، ولا تُنشئ دفعًا ناجحًا وهميًا."
    ],
    "tips": [
      "الفحص يكتشف ويحدّث سجلات المشكلات؛ لا يحوّل الدفع إلى ناجح وحده.",
      "لا تستخدم وضع محلول لإخفاء فرق لم يُعالج؛ اكتب ما تم فعله بصورة قابلة للمراجعة."
    ],
    "examples": [
      "مشكلة دفع وحالة طلب لا تتطابق تُراجع من السجلات الأصلية قبل تعليمها محلولة."
    ],
    "troubleshooting": [
      "المشكلة عادت بعد الفحص: راجع سببها الفعلي؛ تعليمها كمراجعة لا يصلح بيانات المصدر تلقائيًا."
    ]
  },
  {
    "id": "shipping",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "إعداد الشحن من البداية",
    "paths": [],
    "paragraphs": [
      "الشحن يعتمد على تفعيل دولة توصيل وطريقة متاحة وتسعير يطابق عنوان العميل وشروط الطلب. وجود الدولة في مرجع البلاد وحده لا يفعّل التوصيل إليها."
    ],
    "steps": [
      "راجع البلاد وأضف الدولة المرجعية إذا لم توجد، ثم فعّلها للمتجر من دول التوصيل.",
      "أنشئ المدن داخل الدولة والمناطق داخل مدنها عندما تحتاج تسعيرًا أو عناوين أكثر دقة.",
      "أنشئ طريقة الشحن وحدد نوعها وحاجتها لعنوان ودعم الدفع عند الاستلام.",
      "أضف أسعار الشحن بنطاق دولة أو مدينة أو منطقة واضبط الشروط والحالة.",
      "اختبر عنوانًا عاديًا وعنوان كل استثناء وقيمة طلب قريبة من حدود الشحن المجاني قبل اعتماد الإعداد.",
      "للتوصيل الدولي بسعر وزن، أنشئ خطة Zones أولًا ثم عيّنها لدولة التوصيل؛ للتسعير العادي استخدم قواعد الدولة أو المدينة أو المنطقة."
    ],
    "fields": [
      "البلاد: المرجع العام لأسماء الدول وأكوادها.",
      "دول التوصيل: الدول المسموح لهذا المتجر أن يوصل إليها.",
      "النطاق: المنطقة أدق من المدينة، والمدينة أدق من الدولة عند اختيار سعر مطابق."
    ],
    "tips": [
      "عند نتيجة غير متوقعة راجع طريقة الشحن والدولة والمدينة والمنطقة والحالة وشروط الوزن والمبلغ، وليس السعر وحده."
    ],
    "examples": [
      "لبلد جديد جهّز دولة التوصيل والطريقة والسعر أو Zone قبل دعوة العميل لإتمام الشراء."
    ],
    "troubleshooting": [
      "البلد ظاهر لكن لا توجد طريقة: وجوده في المرجع لا يثبت تفعيل التوصيل أو وجود سعر مطابق."
    ]
  },
  {
    "id": "countries",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "البلاد: المرجع العام للدول",
    "paths": [
      "/admin/shipping/countries",
      "/admin/shipping/countries/create",
      "/admin/shipping/countries/:id/edit"
    ],
    "paragraphs": [
      "تدير هذه الشاشة اسم الدولة ورمزها وبياناتها المرجعية. هذا المرجع مشترك، بينما السماح بالتوصيل يتم من شاشة دول التوصيل لكل متجر."
    ],
    "steps": [
      "ابحث عن الدولة أولًا حتى لا تنشئ دولة مكررة بكود مختلف.",
      "أضف أو عدّل الاسم العربي والإنجليزي وكود الدولة من حرفين ورمز الاتصال ورمز العملة والترتيب والحالة.",
      "احفظ ثم ارجع لدول التوصيل لتعيين الدولة للمتجر المطلوب."
    ],
    "fields": [
      "كود الدولة: مثل KW أو EG أو SA، ويختلف عن رمز الاتصال الدولي.",
      "رمز العملة: مثل KWD، ولا يغني عن إعداد عملات المتجر.",
      "الحالة: الدولة غير النشطة قد تختفي من قوائم الاختيار."
    ],
    "tips": [
      "راجع أثر أي تعديل لأن البلاد مرجع مشترك بين المتاجر؛ لا تحذف دولة قائمة لمعالجة سعر شحن خاطئ."
    ],
    "examples": [
      "رمز KW يعرّف دولة الكويت، بينما +965 رمز اتصال؛ استخدم كل حقل لوظيفته."
    ],
    "troubleshooting": [
      "الدولة لا تظهر للتوصيل: فعّلها في دول التوصيل للمتجر وراجع إعدادها المرجعي."
    ]
  },
  {
    "id": "delivery-countries",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "دول التوصيل وحدود الطلب",
    "paths": [
      "/admin/shipping/delivery-countries",
      "/admin/shipping/delivery-countries/new",
      "/admin/shipping/delivery-countries/:id/edit"
    ],
    "paragraphs": [
      "تربط دولة موجودة بالمتجر وتحدد إتاحة التوصيل والحدود الاختيارية والتقدير الزمني."
    ],
    "steps": [
      "راجع المتجر الحالي ثم اضغط إضافة دولة توصيل واختر الدولة.",
      "إذا لم توجد الدولة في الاختيار افتح رابط إضافتها من البلاد، ثم ارجع لهذه الشاشة.",
      "أدخل الحد الأدنى للطلب وحد الشحن المجاني وأيام التوصيل التقديرية إذا كنت تحتاجها، واضبط الحالة ثم احفظ.",
      "أضف طريقة وأسعارًا مناسبة للدولة واختبر الشراء بعنوان داخلها."
    ],
    "fields": [
      "الحد الأدنى للطلب: شرط قيمة الطلب للتوصيل وفق قواعد التسعير.",
      "حد الشحن المجاني: عتبة المجانية عند انطباق القواعد.",
      "الأيام التقديرية: أقل وأقصى مدة متوقعة وليست حجز موعد تسليم.",
      "خطة الشحن: اختر التسعير العادي أو Zone من نفس المتجر. تعديل خطة مشتركة يغيّر تسعير الدول المرتبطة بها."
    ],
    "tips": [
      "الدولة لا تتغير في سجل دولة التوصيل بعد إنشائه؛ أنشئ تعيينًا آخر للدولة الصحيحة عند الحاجة.",
      "تفعيل دولة التوصيل لا ينشئ أسعارًا لكل طرق الشحن تلقائيًا."
    ],
    "examples": [
      "دولتان يمكن ربطهما بخطة وزن واحدة؛ حفظ سعر جديد في تلك الخطة يؤثر على الدولتين."
    ],
    "troubleshooting": [
      "سعر دولة لا يتغير: راجع هل تستخدم Standard أو Zone ثم عدّل المصدر المناسب بدل إنشاء قاعدة غير مستخدمة."
    ]
  },
  {
    "id": "cities",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "المدن",
    "paths": [
      "/admin/shipping/cities",
      "/admin/shipping/cities/create",
      "/admin/shipping/cities/:id/edit"
    ],
    "paragraphs": [
      "تُنشأ المدينة داخل دولة محددة لتستخدم في العناوين وأسعار نطاق المدينة."
    ],
    "steps": [
      "صفِّ بالدولة وابحث عن المدينة لتفادي تكرارها.",
      "أضف مدينة واختر الدولة ثم الاسم العربي والإنجليزي والرمز والترتيب والحالة.",
      "احفظ، ثم استخدم المدينة في المناطق أو سعر شحن المدينة."
    ],
    "fields": [
      "الدولة: الأب الذي يحدد المدن المتاحة للعناوين والتسعير.",
      "الرمز: معرّف المدينة وفق بيانات المتجر، وليس بديلًا عن اختيار المدينة الصحيحة."
    ],
    "tips": [
      "مدينتان لهما اسم متشابه في دولتين مختلفتين ليستا نفس السجل. راجع الدولة مع الاسم."
    ],
    "examples": [
      "مدينة تابعة للكويت تُستخدم مع عنوان دولة KW، وليس عنوان دولة أخرى بالاسم نفسه."
    ],
    "troubleshooting": [
      "قائمة المدن فارغة: راجع الدولة المختارة والتفعيل وتحميل بياناتها، ثم أعد الاختيار."
    ]
  },
  {
    "id": "areas",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "المناطق",
    "paths": [
      "/admin/shipping/areas",
      "/admin/shipping/areas/create",
      "/admin/shipping/areas/:id/edit"
    ],
    "paragraphs": [
      "تُنشأ المنطقة داخل مدينة ودولة، وتتيح تسعير استثناءات دقيقة مثل ثلاث مناطق بسعر أعلى من باقي الدولة."
    ],
    "steps": [
      "اختر الدولة ثم المدينة، وتأكد أن المدينة موجودة قبل إضافة المنطقة.",
      "أدخل أسماء المنطقة ورمزها وترتيبها وحالتها ثم احفظ.",
      "ارجع لأسعار الشحن وأضف سعرًا خاصًا بهذه المنطقة للطريقة المقصودة."
    ],
    "fields": [
      "الدولة والمدينة: يحددان المناطق التي تظهر في الاختيار.",
      "المنطقة: أدق نطاق تسعير مدعوم في قواعد أسعار الشحن."
    ],
    "tips": [
      "السعر الاستثنائي يُحفظ في أسعار الشحن، وليس في اسم المنطقة أو بيانات المدينة."
    ],
    "examples": [
      "سعر لمنطقة معينة يُراجع مع المدينة والدولة المقصودتين حتى لو تكرر الاسم."
    ],
    "troubleshooting": [
      "منطقة غير موجودة: اختر المدينة الصحيحة أولًا، ثم تحقق من تفعيل المنطقة وعلاقتها."
    ]
  },
  {
    "id": "shipping-methods",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "طرق الشحن والتوصيل والاستلام",
    "paths": [
      "/admin/shipping/methods",
      "/admin/shipping/methods/new",
      "/admin/shipping/methods/:id/edit"
    ],
    "paragraphs": [
      "طريقة الشحن تحدد الخدمة التي يختارها العميل، مثل التوصيل المحلي أو الاستلام من فرع، بينما السعر التفصيلي يُدار في الأسعار أو تعيين الفروع."
    ],
    "steps": [
      "أنشئ الطريقة بالاسمين والوصف والرمز والنوع والترتيب والحالة.",
      "حدد هل تتطلب عنوانًا وهل تدعم الدفع عند الاستلام، ثم احفظ.",
      "للتوصيل أضف الأسعار المطابقة للدول والمدن والمناطق.",
      "للاستلام احفظ النوع أولًا، ثم اختر الفروع المتاحة واضبط السعر الاختياري لكل فرع واضغط حفظ تعيين الفروع."
    ],
    "fields": [
      "يتطلب عنوانًا: يستخدم في طرق التوصيل التي تحتاج عنوان العميل.",
      "يدعم الدفع عند الاستلام: يحدد توافق الطريقة مع هذا الخيار، ولا يفعّل بوابة الدفع وحده.",
      "نشط للطريقة: تعيين فرع لهذه الطريقة مستقل عن تفعيل الاستلام على الفرع نفسه."
    ],
    "tips": [
      "طريقة غير مفعّلة لا تظهر للعميل. الفرع المعطل للاستلام لا يصبح متاحًا بمجرد اختياره في طريقة."
    ],
    "examples": [
      "طريقة استلام تحتاج فرعًا مفعّلًا ومربوطًا بها؛ لا تستخدم عنوان توصيل بدل الفرع."
    ],
    "troubleshooting": [
      "تغيير العنوان أبقى سعرًا قديمًا: أعد اختيار الطريقة من الأسعار المتاحة للوجهة الجديدة قبل إكمال الطلب."
    ]
  },
  {
    "id": "shipping-rates",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "أسعار الشحن وأولوية الدولة والمدينة والمنطقة",
    "paths": [
      "/admin/shipping/rates",
      "/admin/shipping/rates/new",
      "/admin/shipping/rates/:id/edit"
    ],
    "paragraphs": [
      "السعر يرتبط بطريقة شحن ودولة، ويمكن تخصيصه لمدينة أو منطقة. عند وجود أكثر من سعر مطابق تُقدّم المنطقة ثم المدينة ثم الدولة؛ وترتيب العرض يفصل بين قواعد بنفس درجة التخصيص."
    ],
    "steps": [
      "اضغط إضافة سعر واختر طريقة الشحن والدولة وأدخل السعر والحالة.",
      "لسعر عام للدولة اترك المدينة والمنطقة فارغتين. لسعر مدينة اختر المدينة واترك المنطقة فارغة. لسعر منطقة اختر المدينة والمنطقة.",
      "اضبط شروط قيمة الطلب والوزن وحد المجانية والأيام التقديرية والترتيب إذا كنت تحتاجها، ثم احفظ.",
      "مثال: أنشئ سعر الكويت العام 0.500، ثم سعر Kuwait City بقيمة 4.000؛ اختيار المدينة يطبق 4.000 إذا انطبقت شروطه.",
      "لو كل الكويت بسعر عدا ثلاث مناطق: أضف السعر العام، ثم ثلاث قواعد منفصلة للمناطق بأسعار الاستثناء، وكلها لنفس طريقة الشحن."
    ],
    "fields": [
      "النطاق: يُستنتج من الدولة والمدينة والمنطقة المختارة، وليس اسمًا حرًا.",
      "حدود المبلغ والوزن: قد تجعل قاعدة موجودة غير مطابقة لطلب معين.",
      "حد الشحن المجاني: قد يجعل السعر النهائي صفرًا عند تحقق الشرط.",
      "ترتيب العرض: الرقم الأقل يتقدم عند تساوي درجة تخصيص الأسعار المطابقة."
    ],
    "tips": [
      "إذا ظهر السعر العام بدل الاستثناء، راجع معرّف المدينة أو المنطقة في عنوان العميل والطريقة والحالة والشروط.",
      "لا تجعل سعر الدولة صفرًا لمجرد إضافة استثناء؛ سجّل السعر العام الفعلي وأسعار الاستثناءات بصورة مستقلة."
    ],
    "examples": [
      "مع سعر دولة وقاعدة أدق لمنطقة مؤهلة، تتقدم قاعدة المنطقة؛ راجع شروط المبلغ والوزن أيضًا."
    ],
    "troubleshooting": [
      "الشحن صفر: راجع حد المجانية والسعر والطريقة المختارة قبل اعتباره خطأ تسعير."
    ]
  },
  {
    "id": "shipping-zones",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "خطط أسعار الشحن Zones وجدول الأوزان",
    "paths": [
      "/admin/shipping/zones"
    ],
    "paragraphs": [
      "خطة Zone تجمع تسعير الوزن لتعيينها لدولة توصيل واحدة أو أكثر. اختر بين سعر كامل للشحنة حسب شريحة الوزن، وسعر أول نصف كيلو مع زيادات لكل نصف كيلو لاحق."
    ],
    "steps": [
      "افتح الشحن ← Zones واختر نوع التسعير. صلاحية عرض الأسعار تختلف عن إدارتها وحفظ تغييراتها.",
      "لسعر الشحنة حسب الشريحة، أضف Zone كعمود باسم واضح؛ الأوزان صفوف بالكيلوجرام والأسعار خلايا بعملة المتجر.",
      "أدخل أوزانًا متزايدة أو ولّدها بتحديد البداية والزيادة والحد الأعلى، ثم راجع كل سعر. يمكن تعديل الأوزان وإضافة صفوف أو حذفها من الجدول.",
      "اترك الخلايا الفارغة بعد آخر وزن متاح فقط؛ لا تترك فجوة بين أسعار محددة. راجع الخلايا والأخطاء ثم احفظ الجدول وانتظر النتيجة.",
      "للتسعير التراكمي أدخل اسم الخطة وسعر أول 0.500 كجم، ثم حدود الشرائح وسعر كل نصف كيلو إضافي داخل كل شريحة. فعّل الخطة واحفظها.",
      "افتح دول التوصيل وأضف الدولة أو عدّلها، واختر خطة الشحن المحفوظة بدل التسعير العادي، ثم احفظ.",
      "راجع طرق الشحن النشطة ووزن المنتجات واختبر وجهة في الدولة مع أكثر من وزن، خصوصًا حدود الشرائح والوزن الأعلى."
    ],
    "fields": [
      "سعر الشريحة: قيمة الشحن الكاملة لأول حد وزن يغطي وزن السلة، وليس سعر كل كيلو ولا مجموع أسعار الصفوف السابقة.",
      "سعر أول نصف كيلو: المبلغ الأساسي للتسعير التراكمي. أي جزء من نصف كيلو إضافي يُحسب كنصف كيلو كامل.",
      "حتى وزن: حد تراكمي بالكيلوجرام، وليس طول الشريحة. الحدود تزيد بالترتيب؛ الحد المفتوح إن استُخدم يكون في آخر سطر.",
      "سعر نصف الكيلو الإضافي: يسري على الزيادة داخل الشريحة التراكمية فقط.",
      "الوزن المخصص: يدعم حتى ثلاث خانات عشرية في جدول الشرائح. الشرائح التراكمية تستخدم حدود أنصاف الكيلوجرام.",
      "خطة دولة التوصيل: يمكن إعادة استخدامها لدول متعددة؛ تعديل سعر الخطة يؤثر على الدول المرتبطة بها.",
      "التسعير العادي: يرجع لقواعد أسعار الدولة والمدينة والمنطقة بدل خطة الوزن."
    ],
    "tips": [
      "وزن السلة يعتمد على أوزان المنتجات وكمياتها. ثبّت وحدة الوزن بالكيلوجرام قبل استيراد أو تعديل أسعار الشحن.",
      "تجاوز آخر وزن متاح قد يمنع عرض الطريقة؛ لا تعتبر اختفاء السعر شحنًا مجانيًا.",
      "تحقق من شروط الحد الأدنى والمجانية أيضًا؛ قد تجعل الشحن صفرًا رغم وجود سعر أصلي في الخطة."
    ],
    "examples": [
      "شرائح: حتى 0.500 كجم = 3.780، وحتى 1.000 = 4.800 KWD؛ سلة وزنها 0.750 كجم تُحاسب 4.800 كاملة.",
      "تراكمي: أول 0.500 كجم = 3.000، وكل نصف كيلو إضافي حتى 3.000 كجم = 1.000؛ وزن 1.200 كجم ينتج 5.000 KWD."
    ],
    "troubleshooting": [
      "الخطة موجودة ولا تؤثر على الدولة: افتح دولة التوصيل وتأكد من تعيين نفس الخطة وحفظها وتفعيل الدولة والخطة.",
      "السعر مختلف عند وزن الحد: راجع وزن كل منتج والكمية ونوع التسعير؛ لا تدخل الجرامات في حقل الكيلوجرام.",
      "جدول لا يحفظ: صحح تكرار الأوزان أو ترتيبها أو فجوات الأسعار، وراجع رسالة الخطأ قبل مغادرة الصفحة."
    ]
  },
  {
    "id": "delivery-slots",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "فترات التوصيل والأيام والسعة",
    "paths": [
      "/admin/shipping/delivery-slots"
    ],
    "paragraphs": [
      "تدير هذه الشاشة نوافذ التوصيل مثل صباحًا من 09:00 إلى 12:00، مع أيام الأسبوع وسعة اختيارية لكل فترة."
    ],
    "steps": [
      "راجع الفترات الحالية قبل إنشاء فترة متداخلة أو مكررة.",
      "في نموذج الإضافة أدخل الاسم ووقت البداية والنهاية وحدد يومًا واحدًا على الأقل.",
      "أدخل السعة والترتيب والحالة ثم احفظ وانتظر تحديث القائمة.",
      "للتعديل اضغط تعديل الصف؛ للإيقاف استخدم زر الحالة، وللحذف اقرأ التأكيد."
    ],
    "fields": [
      "الأيام: الأيام التي تعمل فيها الفترة من الأسبوع.",
      "السعة: الحد المسموح حسب آلية الحجز؛ تركها فارغة يعني بلا حد مسجل.",
      "وقت البداية والنهاية: نافذة الفترة، وليست أيام التوصيل التقديرية."
    ],
    "tips": [
      "تأكد من أن النهاية بعد البداية ومن اختيار أيام صالحة. رسالة رفض الحفظ توضح الحقل غير الصحيح.",
      "في واجهة كلمات، إذا لم توجد فترات توصيل مفعّلة لا يظهر اختيار تاريخ ووقت فارغ؛ إعداد الفترات يختلف عن نص المدة التقديرية لطريقة الشحن."
    ],
    "examples": [
      "فترة من 09:00 إلى 12:00 لها أيام عمل وسعة، بينما التوصيل خلال 2 إلى 4 أيام تقدير مختلف."
    ],
    "troubleshooting": [
      "الفترة لا تظهر: راجع التفعيل واليوم والسعة والتاريخ وصحة طريقة التوصيل."
    ]
  },
  {
    "id": "branches",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "الفروع والاستلام وساعات العمل",
    "paths": [
      "/admin/shipping/branches",
      "/admin/shipping/branches/new",
      "/admin/shipping/branches/:id/edit"
    ],
    "paragraphs": [
      "الفروع تستخدم للاستلام وبيانات صفحة التواصل والخريطة وساعات العمل، حسب تفعيل كل خيار."
    ],
    "steps": [
      "أضف الفرع بالاسمين والرمز والهاتف والبريد والعناوين والوصف.",
      "أدخل رابط الخريطة أو الإحداثيات، واضبط الاستلام وإظهار التواصل والفرع الرئيسي والحالة والترتيب.",
      "احفظ الفرع أولًا، ثم افتح تعديله لضبط ساعات العمل الأسبوعية.",
      "اربطه بطريقة الاستلام من طرق الشحن، وأضف قنواته من قنوات التواصل عند الحاجة."
    ],
    "fields": [
      "الاستلام مفعّل: يسمح باستخدام الفرع ضمن طرق الاستلام المعيّنة له.",
      "إظهار في صفحة التواصل: يتحكم في العرض مع إعدادات صفحة التواصل.",
      "ساعات العمل: جدول أسبوعي مستقل عن فترات توصيل الطلبات."
    ],
    "tips": [
      "إنشاء فرع وحده لا يربطه بكل طرق الاستلام. راجع تعيين الفروع داخل الطريقة."
    ],
    "examples": [
      "فرع ظاهر في صفحة التواصل لا يصبح نقطة استلام قبل تفعيل الاستلام وربطه بالطريقة."
    ],
    "troubleshooting": [
      "فرع لا يظهر للاستلام: تحقق من الفرع والطريقة والتعيين والتفعيل، وليس الاسم وحده."
    ]
  },
  {
    "id": "carriers",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "شركات الشحن",
    "paths": [
      "/admin/shipping/carriers",
      "/admin/shipping/carriers/new",
      "/admin/shipping/carriers/:id/edit"
    ],
    "paragraphs": [
      "تعرف هذه الشاشة الناقل المستخدم في الشحنات. المحرك اليدوي هو المتاح حاليًا في نموذج الإعداد."
    ],
    "steps": [
      "ابحث عن الشركة أو أضفها بالاسم والرمز والمحرك المتاح.",
      "أدخل سر الويب هوك فقط إذا كان مطلوبًا للتكامل المعتمد، واضبط الحالة ثم احفظ.",
      "اختر الناقل عند إنشاء شحنة من الطلب، ثم سجّل بيانات التتبع."
    ],
    "fields": [
      "الرمز: معرّف الشركة داخل النظام.",
      "المحرك اليدوي: يتطلب إدارة بيانات الشحنة والتتبع وفق إجراءات الفريق.",
      "السر المضبوط: يعرض وجود القيمة دون كشفها."
    ],
    "tips": [
      "إنشاء اسم شركة لا يعني وجود ربط آلي معها أو شراء بوليصة من مزود خارجي."
    ],
    "examples": [
      "عرّف الناقل ثم اختره عند إنشاء شحنة الطلب وأدخل مرجع التتبع الصحيح."
    ],
    "troubleshooting": [
      "رقم تتبع لا يعمل: راجع الرابط والناقل والمرجع؛ حفظ رقم يدوي لا يؤكد تسجيله عند شركة الشحن."
    ]
  },
  {
    "id": "shipping-drivers",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "مناديب التوصيل وتعيين المندوب للطلب",
    "paths": [
      "/admin/shipping/drivers"
    ],
    "paragraphs": [
      "تدير قائمة مناديب هذا المتجر، ثم تختار المندوب من تفاصيل طلب التوصيل. ملف المندوب يسجل بياناته التشغيلية، ولا ينشئ له حساب دخول تلقائيًا."
    ],
    "steps": [
      "افتح الشحن ← مناديب التوصيل. ابحث بالاسم أو الهاتف وراجع فلتر التفعيل قبل إنشاء سجل مكرر.",
      "اضغط إضافة وأدخل الاسم والهاتف والملاحظات والحالة، ثم احفظ وانتظر ظهوره في القائمة.",
      "افتح طلب توصيل قابلًا للتعديل، ثم بطاقة المندوب، واختر مندوبًا نشطًا من نفس المتجر واحفظ التعيين.",
      "لتغيير المندوب أو إزالة تعيينه، اختر البديل أو بدون مندوب ثم احفظ وراجع بيانات الطلب.",
      "لإيقاف مندوب عن التعيينات الجديدة عدّل ملفه وأوقف التفعيل؛ راجع الطلبات التي سبق تعيينه لها بصورة مستقلة."
    ],
    "fields": [
      "الاسم: اسم المندوب كما يظهر في قائمة الاختيار والطلب.",
      "الهاتف: رقم صحيح مع رمز الدولة؛ يُراجع تفرده داخل المتجر.",
      "نشط: يسمح باختيار المندوب في تعيين جديد. بيانات مندوب سابق قد تبقى ظاهرة في الطلب التاريخي.",
      "الملاحظات: معلومات تشغيلية داخلية وليست رسالة تُرسل للمندوب.",
      "الصلاحيات: عرض المناديب shipping.drivers.view، وإدارتهم shipping.drivers.manage؛ تعيين المندوب يحتاج صلاحية إدارة الشحن أو الشحنات مع الوصول للطلب."
    ],
    "tips": [
      "لا يتاح التعيين لطلب استلام من فرع أو طلب مسلّم أو ملغى أو مسترد، أو عند استرداد الدفع بالكامل.",
      "حفظ المندوب لا يغيّر حالة الشحنة أو يسجل التحصيل أو يرسل له إشعارًا تلقائيًا."
    ],
    "examples": [
      "أضف مندوبًا نشطًا، ثم افتح طلب توصيل قيد التجهيز وعيّنه له. يبقى تحديث التسليم والتحصيل في الإجراءات الخاصة بهما."
    ],
    "troubleshooting": [
      "المندوب غير موجود في الاختيار: راجع المتجر وحالة تفعيله. السجلات غير النشطة لا تُتاح لتعيين جديد.",
      "بطاقة التعيين مقفولة: راجع نوع التنفيذ وحالة الطلب والدفع وصلاحية تعيين المندوب."
    ]
  },
  {
    "id": "shipments",
    "group": "shipping",
    "group_title": "الشحن والتوصيل",
    "title": "الشحنات وإنشاؤها وتتبعها",
    "paths": [
      "/admin/shipping/shipments",
      "/admin/shipping/shipments/:id"
    ],
    "paragraphs": [
      "تراجع قائمة الشحنات بيانات النقل والتتبع والحالة، وتُنشأ الشحنة من تبويب شحنات الطلب المؤكد عندما تسمح حالته."
    ],
    "steps": [
      "افتح طلبًا مؤكدًا ثم الشحنات واضغط إنشاء شحنة؛ اختر ناقلًا أو اتركه للشحن اليدوي عند توفره.",
      "راجع المستلم والعنوان المنسوخين من الطلب وأدخل بيانات التتبع والوزن المطلوبة، ثم أنشئ الشحنة.",
      "من قائمة الشحنات افتح التفاصيل لتحديث رقم أو رابط التتبع ومراجعة الخط الزمني.",
      "حدّث الحالة الصحيحة وأدخل الملاحظة أو تحقق تحصيل الدفع عند الاستلام عندما يظهر، ثم راجع حالة الطلب الناتجة.",
      "إذا احتجت الإلغاء اقرأ تأكيد إلغاء الشحنة وتأكد من عدم الخلط بينه وبين إلغاء الطلب."
    ],
    "fields": [
      "رقم ورابط التتبع: بيانات متابعة الشحنة لدى الناقل.",
      "مبلغ الدفع عند الاستلام: المطلوب تحصيله؛ علامة التحقق توثّق التحصيل ولا تُستخدم قبل التحقق الفعلي.",
      "الخط الزمني: أحداث الشحنة المسجلة."
    ],
    "tips": [
      "تغيير حالة الشحنة قد يحرّك حالة الطلب تلقائيًا. طلبات الاستلام من الفرع لا تستخدم شحنات الناقل بالطريقة نفسها."
    ],
    "examples": [
      "طلب واحد قد يحتاج متابعة حالة الشحنة وبيانات المندوب والتحصيل؛ كل معلومة لها إجراءها."
    ],
    "troubleshooting": [
      "الشحنة لا تُنشأ: راجع حالة الطلب وتأكيده والناقل والصلاحية وسبب الرفض."
    ]
  },
  {
    "id": "catalog-campaign",
    "group": "marketing",
    "group_title": "العروض والخصومات",
    "title": "إنشاء خصم مؤقت على مجموعة منتجات: السعر قبل وبعد",
    "paths": [],
    "paragraphs": [
      "ينشئ العرض المؤقت خصمًا يظهر في سعر المنتج ومتغيراته خلال بداية ونهاية محددتين، ثم يعود السعر العادي تلقائيًا. لا تحتاج تعديل كل منتج يدويًا."
    ],
    "steps": [
      "من المنتجات صفِّ بالقسم أو التصنيف أو البراند أو الخاصية وقيمتها، ثم حدّد المنتجات أو كل نتائج البحث.",
      "لضم مجموعة أخرى غيّر الفلتر واضغط إضافة نتائج البحث إلى التحديد، وراجع إجمالي التحديد.",
      "اضغط عرض مؤقت وأدخل اسم العرض ونوع الخصم وقيمته وتاريخ البداية والنهاية.",
      "اضغط معاينة وراجع عدد المنتجات وعينة أول 10 منتجات وسعر قبل وبعد وعدد المتغيرات. تغيير أي حقل يتطلب معاينة جديدة.",
      "اضغط حفظ بعد مراجعة النتائج، ثم افتح العروض لمتابعة العرض أو تعديله وإيقافه."
    ],
    "fields": [
      "النسبة: أكبر من صفر وحتى 100 بالمائة؛ مثال 20 على سعر 75.500 يعطي 60.400.",
      "القيمة الثابتة: تُخصم من سعر كل قطعة مؤهلة؛ لا ينخفض السعر تحت الصفر.",
      "البداية والنهاية: تُدخل بتوقيت المتصفح الموضح في النافذة، وتُنقل كتوقيت محدد للنظام.",
      "الاختيار: حتى 20000 منتج؛ المعاينة عينة ولا تعرض كل الصفوف."
    ],
    "tips": [
      "الحملة تخص المنتجات المحددة وقت الحفظ، وتشمل متغيراتها، ولا تخصم الخدمات الإضافية.",
      "عند تداخل حملات سعر مؤقتة على المنتج لا تتراكم؛ تُطبّق حملة واحدة بالأولوية الأعلى. راجع بقية عروض السلة بصورة مستقلة عند وجودها.",
      "بدء وانتهاء السعر يُحسمان وقت الطلب. مهمة انتهاء العروض الموجودة في جدولة النظام تحدّث حالة العرض؛ لا تحتاج مهمة Cron جديدة لكل حملة."
    ],
    "examples": [
      "خصم مؤقت على مجموعة منتجات من القائمة يرجع للسعر العادي بعد انتهاء مدته، دون إعادة كتابة السعر الأصلي."
    ],
    "troubleshooting": [
      "المعاينة تضم عددًا غير متوقع: راجع التحديد الحالي والفلاتر والمتغيرات قبل تطبيق الحملة."
    ]
  },
  {
    "id": "marketing",
    "group": "marketing",
    "group_title": "العروض والخصومات",
    "title": "العروض الحالية والسابقة وتفاصيل العرض",
    "paths": [
      "/admin/promotions",
      "/admin/promotions/:id"
    ],
    "paragraphs": [
      "كل العروض، ومنها الخصومات المؤقتة المنشأة من المنتجات، محفوظة هنا. انتهاء العرض لا يحذفه، ويمكن مراجعة مدته وقيمته واستخداماته لاحقًا."
    ],
    "steps": [
      "افتح العروض واترك فلتر الحالة على الكل لرؤية المفعّل وغير المفعّل، وابحث بالاسم أو الكوبون.",
      "اقرأ عمود الجدول: جارٍ للعرض الحالي، مجدول للقادم، منتهٍ لما تجاوز النهاية، وغير نشط لما تم إيقافه دون انتهاء.",
      "راجع قيمة الخصم وتاريخ البداية والنهاية، وافتح العين للتفاصيل أو الإحصائيات لاستخداماته.",
      "للتعديل افتح القلم وراجع النوع والخصم والمدة والأهلية. للإيقاف استخدم إيقاف واقرأ التأكيد.",
      "للسجلات المحذوفة اختر المحذوف فقط، ثم استخدم الاستعادة إذا كنت تملك الصلاحية."
    ],
    "fields": [
      "الحالة والجدول: التفعيل الإداري مستقل عن صلاحية الوقت؛ عرض مفعّل بتاريخ مستقبلي لا يكون جاريًا بعد.",
      "الأولوية: تحدد ترتيب تطبيق الحملات وفق قواعد النظام؛ مهمة عند تداخل عروض سعر المنتج.",
      "الأهلية: المنتجات أو التصنيفات أو العلامات أو طرق الشحن والدول المحددة حسب نوع العرض."
    ],
    "tips": [
      "إعادة تفعيل عرض منتهٍ لا تمدد تاريخه. عدّل النهاية إذا كنت تريد مدة جديدة، وراجع أثرها قبل الحفظ.",
      "الحذف هنا ناعم وتتوفر له استعادة؛ الإيقاف يحافظ على العرض وسجله دون استمرار تطبيقه."
    ],
    "examples": [
      "عرض مفعّل تنتهي مدته أمس يظل سجلًا محفوظًا لكنه منتهٍ؛ إعادة التفعيل وحدها لا تمدد النهاية."
    ],
    "troubleshooting": [
      "عرض لا يعمل: راجع التفعيل والمدة والأهلية والأولوية والكوبون وحدود الاستخدام قبل تعديل سعر المنتج."
    ]
  },
  {
    "id": "promotion-form",
    "group": "marketing",
    "group_title": "العروض والخصومات",
    "title": "إنشاء وتعديل عرض أو كوبون وشروط الأهلية",
    "paths": [
      "/admin/promotions/new",
      "/admin/promotions/create",
      "/admin/promotions/:id/edit"
    ],
    "paragraphs": [
      "استخدم نموذج العروض لقواعد الخصم في السلة والكوبونات والكاش باك وأنواع العروض المتاحة. الحقول والأهلية تتغير حسب النوع."
    ],
    "steps": [
      "اضغط إضافة عرض، وأدخل الاسم والوصف بالعربية والإنجليزية واختر النوع.",
      "حدد نوع الخصم وقيمته وحده الأقصى والأولوية عند توفرها، ثم راجع شروط النوع.",
      "للكوبون أدخل الرمز وحدد يتطلب كوبون، واضبط هل يكون الكوبون عامًا إذا كنت تريد إتاحته في قوائم الواجهة المدعومة.",
      "اختر الأهلية والحد الأدنى والأقصى للطلب وحدود الاستخدام العامة ولكل عميل والمدة حسب هدف العرض.",
      "راجع الحالة وتخفيض سريع وإيقاف العروض التالية ثم احفظ، واختبر سلة مؤهلة وأخرى غير مؤهلة."
    ],
    "fields": [
      "الأهلية: ترك الاختيارات فارغة له دلالة حسب نوع العرض؛ راجع الحقول النشطة وملخص القاعدة.",
      "حد الاستخدام: الفارغ يعني بلا حد حيث توضح الشاشة، وليس صفر استخدامات.",
      "إيقاف العروض التالية: يؤثر على تطبيق قواعد لاحقة بعد هذا العرض وفق المحرك.",
      "التواريخ: تستخدم توقيت المتصفح عند التعديل."
    ],
    "tips": [
      "عرض سعر المنتج المؤقت له قيود خاصة: يبقى خصم منتج دون كوبون أو شروط إجمالي طلب أو حدود استخدام. يرفض الحفظ عند إضافة شروط غير متوافقة.",
      "عرض السلة العادي ليس بالضرورة سعرًا مشطوبًا على بطاقة المنتج؛ استخدم العرض المؤقت من المنتجات لهذا الغرض."
    ],
    "examples": [
      "كوبون بنسبة 10% وحد أقصى 2.000 يختلف عن خصم مبلغ ثابت 10.000؛ اقرأ ملخص القاعدة."
    ],
    "troubleshooting": [
      "الحفظ يرفض شروطًا: قد لا تتوافق مع نوع العرض المختار. لا تغيّر النوع فقط لإخفاء رسالة الرفض."
    ]
  },
  {
    "id": "buy-x-get-y",
    "group": "marketing",
    "group_title": "العروض والخصومات",
    "title": "عرض اشترِ X واحصل على Y",
    "paths": [],
    "paragraphs": [
      "هذا النوع يحدد كمية شراء مطلوبة ومكافأة، مثل اشترِ قطعتين واحصل على الثالثة بخصم. راجع ملخص القاعدة قبل التفعيل."
    ],
    "steps": [
      "اختر نوع اشترِ X واحصل على Y في نموذج العرض، وحدد نطاق المنتجات المؤهلة للشراء وكمية X.",
      "حدد كمية Y ونوع وقيمة خصم المكافأة؛ نسبة 100 تعني المكافأة مجانًا.",
      "اختر منتجات مكافأة مختلفة عند الحاجة، أو اتركها لاختيار الوحدات الأرخص من نفس العناصر المؤهلة.",
      "حدد هل يتكرر العرض لكل مجموعة والحد الأقصى للمكافآت، ثم احفظ واختبر الكميات المختلفة."
    ],
    "fields": [
      "الكمية المجمّعة: أي مزيج من العناصر المؤهلة يمكن أن يحقق X وفق القاعدة.",
      "منتج المكافأة المختلف: يجب أن يضيفه العميل للسلة بنفسه؛ الإضافة التلقائية غير مدعومة.",
      "الوحدات الأرخص: تُختار للمكافأة وفق أسعار العناصر بعد الخصومات السابقة."
    ],
    "tips": [
      "لا تكتب إعلانًا يعد بإضافة هدية تلقائية. جرّب سلة فيها المنتج المؤهل والمكافأة قبل نشر العرض."
    ],
    "examples": [
      "اشترِ 2 واحصل على 1 مجانًا من نفس النطاق يحتاج عدد الوحدات الصحيح في السلة؛ راجع تكرار المجموعات والحد الأقصى."
    ],
    "troubleshooting": [
      "الهدية لم تُضف تلقائيًا: هذا النوع لا يضيف منتج مكافأة مختلفًا؛ يجب إضافته للسلة وفق شروط العرض."
    ]
  },
  {
    "id": "promotion-usages",
    "group": "marketing",
    "group_title": "العروض والخصومات",
    "title": "استخدامات العروض وقياس نتائجها",
    "paths": [
      "/admin/promotions/usages",
      "/admin/promotions/:promotionId/usage"
    ],
    "paragraphs": [
      "تعرض الاستخدامات المسجلة للعروض وروابط العميل والطلب وقيمة الخصم أو الكاش باك ووقت الاستخدام."
    ],
    "steps": [
      "افتح كل الاستخدامات أو استخدم زر الإحصائيات بجوار عرض لرؤية استخداماته وحدها.",
      "صفِّ بالعرض والعميل ورقم الطلب أو ابحث برمز الكوبون حسب المتاح.",
      "راجع كل سجل وافتح الطلب للتحقق من تفاصيل تطبيق الخصم."
    ],
    "fields": [
      "الخصم: قيمة التخفيض المسجلة على الاستخدام.",
      "الاسترداد أو الكاش باك: قيمة المكافأة حسب نوع العرض وحقول السجل.",
      "وقت الاستخدام: وقت تسجيل الاستفادة، وليس عدد مرات مشاهدة المنتج."
    ],
    "tips": [
      "عدد الاستخدامات لا يقيس عدد الزوار الذين شاهدوا الحملة؛ استخدم بيانات الطلبات والتقرير المالي عند تقييم التحصيل."
    ],
    "examples": [
      "صف استخدام كوبون يربط العرض بالعميل والطلب؛ افتح الاسم بدل التخمين من رقم وحده."
    ],
    "troubleshooting": [
      "لا توجد استخدامات رغم تفعيل العرض: التفعيل ليس استخدامًا؛ راجع اكتمال الطلب وشروط تسجيل الاستخدام والفترة."
    ]
  },
  {
    "id": "abandoned-carts",
    "group": "marketing",
    "group_title": "العروض والخصومات",
    "title": "السلات المتروكة Abandoned carts وفلاتر النشاط",
    "paths": [
      "/admin/promotions/abandoned-carts",
      "/admin/promotions/abandoned-carts/:id"
    ],
    "paragraphs": [
      "تعرض السلات المحفوظة على السيرفر التي تحتوي منتجات ولم تتحول إلى طلب. الشاشة تتيح السلات النشطة والمتروكة، ولا يكفي إغلاق التطبيق لتغيير حالة السلة إلى متروكة."
    ],
    "steps": [
      "راجع المتجر الحالي. الشاشة تفتح افتراضيًا على العملاء المسجلين فقط، وحالة مفتوحة، وعدم نشاط يوم واحد على الأقل.",
      "لرؤية سلة أُضيفت منذ نصف ساعة اختر عدم النشاط ← أي نشاط، واترك الحالة مفتوحة (نشطة + متروكة).",
      "إذا كان صاحب السلة زائرًا اختر الزوار فقط أو عملاء وزوار؛ فلتر العملاء فقط يخفي سلال الزوار.",
      "ابحث بالاسم أو البريد أو الهاتف أو رقم السلة، وراجع آخر نشاط والمجموع والعملة قبل فتح التفاصيل.",
      "افتح السلة لمراجعة المنتجات والمتغيرات والكميات وبيانات التواصل، ثم أنشئ كوبونًا عند الحاجة أو افتح قوالب الإشعارات.",
      "لإرسال رسالة فعلية افتح إرسال رسالة واختر العميل والقناة وراجع النص والمستلم، ثم تابع عمليات الإرسال."
    ],
    "fields": [
      "الجمهور: العملاء يعني سلة مرتبطة بحساب؛ الزائر سلة جلسة بلا حساب. قد لا تتوفر له وسيلة تواصل.",
      "مفتوحة: تشمل نشطة ومتروكة؛ اختيار متروكة وحده يخفي السلات التي ما زالت نشطة.",
      "يوم بدون نشاط: يختار السلات التي مر على آخر تحديث لها 24 ساعة على الأقل، وليس السلات التي أُنشئت اليوم.",
      "أي نشاط: يلغي حد انتظار اليوم ويتيح السلات الحديثة المطابقة لباقي الفلاتر.",
      "آخر نشاط: آخر تحديث محفوظ للسلة، وليس إشعارًا مؤكدًا بأن العميل أغلق التطبيق.",
      "رقم السلة: مختلف عن رقم الطلب؛ السلات الفارغة أو التي تحولت إلى طلب ليست ضمن القائمة.",
      "إنشاء كوبون: لا يرسل العرض تلقائيًا للعميل."
    ],
    "tips": [
      "لا توجد حاجة لتعديل السلة أو تعيين حالتها يدويًا لمجرد عرضها؛ راجع فلاتر الجمهور والحالة والمدة أولًا.",
      "ظهور السلة يتطلب أن يحفظ التطبيق الإضافات عبر API. لو لم تظهر مع أي نشاط وفي المتجر الصحيح، راجع أن التطبيق أرسل إضافة السلة فعلًا مع جلسة العميل والمتجر.",
      "لا تعتبر السلة حجز مخزون أو بيعًا مدفوعًا؛ تحقق من الأسعار والتوافر قبل التواصل."
    ],
    "examples": [
      "مسجّل دخول أضاف منتجًا وأغلق التطبيق منذ نصف ساعة: تختفي سلته مع فلتر يوم بدون نشاط، ويمكن أن تظهر مع أي نشاط إذا كانت محفوظة في نفس المتجر وبها منتجات."
    ],
    "troubleshooting": [
      "لا تظهر سلة حديثة: اختر العملاء فقط أو الجمهور المناسب ← مفتوحة ← أي نشاط، وامسح البحث وراجع الصفحات والمتجر.",
      "ما زالت مفقودة: اطلب فحص رقم العميل والمتجر ووقت الإضافة وطلب API؛ إذا كانت محفوظة على الجهاز فقط فلن يستطيع الكنترول إظهارها.",
      "لا يوجد بريد أو هاتف: قد تكون سلة زائر؛ لا تنسبها لحساب آخر اعتمادًا على تشابه المنتجات."
    ]
  },
  {
    "id": "media",
    "group": "content",
    "group_title": "المحتوى والتواصل",
    "title": "مكتبة الوسائط والمجلدات واستخدام الملفات",
    "paths": [
      "/admin/media"
    ],
    "paragraphs": [
      "مكتبة لإدارة ملفات المتجر وإعادة استخدامها في الصور والبانرات والمحتوى. تعرض استخدام الملف لتقليل حذف أصل ما زال مرتبطًا بمحتوى."
    ],
    "steps": [
      "اختر كل الأصول أو مجلدًا، وابحث باسم الملف أو الفلاتر المتاحة.",
      "أنشئ مجلدًا لتنظيم الملفات أو ارفع الملف وانتظر اكتمال الرفع وظهور المعاينة.",
      "افتح الأصل لمراجعة بياناته واستخداماته أو نسخ رابطه، ثم استخدمه من منتقي الوسائط في الشاشة المطلوبة.",
      "قبل الحذف راجع الارتباطات؛ إذا رُفض الحذف لأن الأصل مستخدم عالج استخدامه من الشاشة المرتبطة أولًا."
    ],
    "fields": [
      "المجلد: تنظيم للأصول داخل المكتبة.",
      "الاستخدامات: المواقع المسجلة التي تعتمد على الملف.",
      "نسخ الرابط: ينسخ عنوان الأصل ولا ينسخ الملف إلى منتج تلقائيًا."
    ],
    "tips": [
      "رفع أصل للمكتبة لا ينشره وحده في بانر أو منتج؛ يلزم اختياره أو نسخه من الشاشة المستهدفة."
    ],
    "examples": [
      "ارفع صورة أو PDF في المجلد المناسب ثم اخترها من موضع الاستخدام المدعوم."
    ],
    "troubleshooting": [
      "ملف مرفوض: راجع النوع والحجم ورسالة الحقل؛ تغيير الامتداد لا يغيّر نوع الملف الفعلي."
    ]
  },
  {
    "id": "banners",
    "group": "content",
    "group_title": "المحتوى والتواصل",
    "title": "البانرات وصور الجوال والجدولة",
    "paths": [
      "/admin/content/banners",
      "/admin/content/banners/new",
      "/admin/content/banners/create",
      "/admin/content/banners/:id/edit"
    ],
    "paragraphs": [
      "تدير صور الحملات والعناوين وروابطها ومواضعها في واجهة المتجر، مع صورة جوال وجدول اختياري."
    ],
    "steps": [
      "راجع القائمة وصفِّ بالموضع أو الحالة وابحث عن البانر المطلوب.",
      "أضف بانرًا بالعنوان والعنوان الفرعي لكل لغة، ثم ارفع صورة أو اختر من المكتبة وراجع المعاينة.",
      "حدّد صورة الجوال إن احتجت مقاسًا مختلفًا، ثم رابط الوجهة ونوعه والموضع والترتيب.",
      "اضبط البداية والنهاية والحالة، وأدخل إعدادات JSON فقط عندما تحتاجها وتعرف صيغتها، ثم احفظ."
    ],
    "fields": [
      "الموضع: مثل الرئيسية الرئيسي أو الثانوي أو التصنيف، حسب خيارات الشاشة ودعم واجهة المتجر.",
      "رابط الوجهة: المكان الذي يفتحه العميل عند الضغط؛ جرّبه بعد النشر.",
      "صورة الجوال: بديل مناسب للشاشات الصغيرة عند دعم الواجهة له."
    ],
    "tips": [
      "راجع المعاينة ورسائل رفض الصورة. الحذف ناعم ويخفي البانر من الواجهة؛ التفعيل وحده لا يضمن ظهوره خارج موعده أو موضعه المدعوم."
    ],
    "examples": [
      "بانر مجدول للأسبوع القادم لا يظهر اليوم لمجرد أنه مفعّل؛ راجع صورة الجوال أيضًا."
    ],
    "troubleshooting": [
      "بانر لا يظهر: راجع الموقع والوقت والتفعيل والمتجر ورابط الوجهة وصورة الجهاز."
    ]
  },
  {
    "id": "collections",
    "group": "content",
    "group_title": "المحتوى والتواصل",
    "title": "مجموعات عرض المنتجات",
    "paths": [
      "/admin/content/collections",
      "/admin/content/collections/new",
      "/admin/content/collections/create",
      "/admin/content/collections/:id/edit"
    ],
    "paragraphs": [
      "المجموعة صف منتجات في الرئيسية أو السلة. يمكن اختيار المنتجات يدويًا أو تحميلها تلقائيًا بفلاتر الكتالوج؛ إنشاء مجموعة لا يغيّر الأسعار ولا ينشئ خصمًا."
    ],
    "steps": [
      "أضف المجموعة بالاسم المترجم والمعرّف والموقع وعدد المنتجات وترتيب العرض والحالة.",
      "اختر طريقة التحديد: تلقائي بالفلاتر، أو يدوي لاختيار منتجات بعينها من المتجر.",
      "في التلقائي اضبط البحث والقسم والتصنيف والعلامة والمميز والأكثر مبيعًا والمتاح فقط بحسب المطلوب.",
      "في اليدوي ابحث واختر المنتجات المقصودة، وراجع الاختيارات المحفوظة عند إعادة فتح النموذج.",
      "راجع الفرز وعدد المنتجات، ثم احفظ وافتح موضع المجموعة في الواجهة الصحيحة."
    ],
    "fields": [
      "التحديد التلقائي: نتائج تتغير مع بيانات المنتجات والفلاتر، وليست قائمة ثابتة وقت إنشاء المجموعة.",
      "التحديد اليدوي: يقيّد النتائج بالمنتجات المختارة؛ راجع الفرز بدل افتراض ترتيب الضغط على المنتجات.",
      "الموقع: الرئيسية أو السلة حسب دعم الواجهة.",
      "العدد والترتيب: حد منتجات المجموعة وأولويتها المرئية.",
      "المعرّف: هوية المجموعة التي تستخدمها الواجهة لفتح منتجاتها."
    ],
    "tips": [
      "إنشاء مجموعة لا يغيّر أسعار المنتجات. راجع التفعيل والمخزون والفلاتر والحد العددي إذا لم يظهر منتج مختار."
    ],
    "examples": [
      "مجموعة مختارات يدوية لخمسة منتجات تبقى مقيّدة باختياراتك، بينما مجموعة الأحدث تلقائيًا تتغير عند إضافة منتجات تستوفي فلاترها."
    ],
    "troubleshooting": [
      "المجموعة ناقصة: افتح نفس سجل المجموعة، وراجع نمط التحديد والمنتجات أو الفلاتر والفرز والعدد وحالة المنتجات، ثم حدّث الواجهة."
    ]
  },
  {
    "id": "pages",
    "group": "content",
    "group_title": "المحتوى والتواصل",
    "title": "صفحات المحتوى والسياسات",
    "paths": [
      "/admin/content/pages",
      "/admin/content/pages/new",
      "/admin/content/pages/create",
      "/admin/content/pages/:id/edit"
    ],
    "paragraphs": [
      "تستخدم لإنشاء صفحات مثل من نحن وسياسة الاستبدال والمعلومات التي يحتاجها العميل، باللغات والحقول المتاحة في النموذج."
    ],
    "steps": [
      "ابحث عن الصفحة قبل إضافة نسخة مكررة.",
      "أضف أو عدّل العنوان والرابط المختصر والمحتوى المترجم، واضبط بيانات السيو والحالة والترتيب حيث تتاح.",
      "راجع تنسيق النص والروابط قبل الحفظ وانتظر رسالة النجاح.",
      "افتح الصفحة في واجهة المتجر بعد الحفظ للتأكد من ظهور المحتوى والرابط وفق القالب المستخدم.",
      "لتعديل نصي الشريط في كلمات، افتح صفحة top-bar-text واكتب فقرتين لكل لغة، وفعّل الصفحة واجعل وقت النشر مناسبًا ثم احفظ وافحص الرئيسية."
    ],
    "fields": [
      "الرابط المختصر: عنوان الصفحة داخل مسار المحتوى المدعوم.",
      "المحتوى: نص الصفحة لكل لغة؛ إدخال لغة لا يكتب اللغة الأخرى تلقائيًا.",
      "الحالة: تحدد إتاحة الصفحة حسب الواجهة.",
      "وقت النشر: توقيت النشر المسجل في النموذج؛ راجعه مع الحالة عند متابعة ظهور الصفحة.",
      "المقتطف: ملخص مترجم منفصل عن المحتوى الكامل.",
      "نص الشريط العلوي لكلمات: صفحة منشورة بالمعرّف top-bar-text. أول فقرتين غير فارغتين من محتوى كل لغة تعرضان النصين؛ عنوان الصفحة للتعريف الإداري."
    ],
    "tips": [
      "إضافة صفحة لا تعني إضافتها تلقائيًا لكل قوائم الواجهة؛ راجع طريقة عرض القالب وروابطه."
    ],
    "examples": [
      "صفحة top-bar-text بفقرتين منشورتين تعرض نصي الشريط في كلمات؛ سياسة الإرجاع صفحة مستقلة بمعرّفها."
    ],
    "troubleshooting": [
      "المحتوى لا يظهر: راجع المعرّف والتفعيل ووقت النشر واللغة وربط الواجهة، ثم حدّث الصفحة."
    ]
  },
  {
    "id": "quiz",
    "group": "content",
    "group_title": "المحتوى والتواصل",
    "title": "أسئلة الاختبار",
    "paths": [
      "/admin/content/quiz",
      "/admin/content/quiz/new",
      "/admin/content/quiz/create",
      "/admin/content/quiz/:id/edit"
    ],
    "paragraphs": [
      "تدير أسئلة الاختبار واختياراتها وترتيبها لتستخدمها تجربة الاختبار في الواجهة التي تدعمها."
    ],
    "steps": [
      "راجع قائمة الأسئلة وترتيبها، ثم أضف سؤالًا أو افتح تعديله.",
      "أدخل النصوص المترجمة والاختيارات والبيانات التي يطلبها نوع السؤال في النموذج.",
      "أضف الإجابات بالاسمين والصورة أو الإيموجي والألوان، واربط المنتجات المطلوبة بكل إجابة، وراجع حالة وترتيب الإجابات.",
      "اضبط الترتيب والحالة، ثم احفظ وراجع السؤال واختياراته في القائمة والواجهة المدعومة."
    ],
    "fields": [
      "السؤال: النص الذي يظهر للعميل بحسب اللغة.",
      "الاختيارات: الإجابات المتاحة والبيانات المرتبطة بها في المحرر.",
      "الترتيب والحالة: يحددان تسلسل السؤال وإتاحته وفق تجربة الواجهة.",
      "وضع الاختيار: إجابة واحدة أو اختيارات متعددة حسب النوع المحدد.",
      "مفتاح السؤال والإجابة: معرّفات للمطابقة، مختلفة عن النص المعروض.",
      "صورة الإجابة والإيموجي والألوان: تخص شكل الاختيار؛ راجع المعاينة.",
      "منتجات الإجابة: المنتجات المرتبطة بهذا الاختيار وفق تجربة الاختبار."
    ],
    "tips": [
      "وجود شاشة الأسئلة لا يعني أن كل واجهات المتاجر تعرض نفس تجربة الاختبار؛ راجع الواجهة المستهدفة."
    ],
    "examples": [
      "أضف السؤال واختياراته باللغتين ثم راجع الترتيب والتفعيل في مسار الاختبار المدعوم."
    ],
    "troubleshooting": [
      "سؤال مفقود: راجع التفعيل والترتيب واللغة وموضع استخدام الاختبار في الواجهة."
    ]
  },
  {
    "id": "contact-settings",
    "group": "content",
    "group_title": "المحتوى والتواصل",
    "title": "إعدادات صفحة التواصل ونموذج الرسائل",
    "paths": [
      "/admin/contact/settings"
    ],
    "paragraphs": [
      "تضبط نصوص صفحة التواصل وظهور النموذج والفروع والخريطة وساعات العمل، مع معاينة مباشرة داخل اللوحة."
    ],
    "steps": [
      "أدخل العنوان والوصف بالعربية والإنجليزية وحدد هل الصفحة مفعّلة.",
      "فعّل نموذج التواصل عند الحاجة، وأدخل بريد المستلم ورسالة الخصوصية لكل لغة.",
      "حدد الفرع الافتراضي وخيارات إظهار الفروع والخريطة وساعات العمل.",
      "راجع المعاينة وحالة الجاهزية ثم احفظ، واختبر الصفحة والنموذج في واجهة المتجر."
    ],
    "fields": [
      "بريد المستلم: عنوان متابعة رسائل النموذج وفق إعداد الإرسال.",
      "الفرع الافتراضي: بيانات الموقع الأساسية عندما تعرضها الصفحة.",
      "إظهار النموذج: يختلف عن حفظ قنوات الهاتف والروابط."
    ],
    "tips": [
      "بيانات قنوات التواصل تُدار من شاشتها، ووسائل الإرسال تحتاج إعداد القنوات المناسبة؛ لا تعتبر المعاينة رسالة مرسلة."
    ],
    "examples": [
      "تفعيل نموذج التواصل يختلف عن تفعيل قناة بريد لإرسال الرسائل أو واتساب OTP."
    ],
    "troubleshooting": [
      "النموذج لا يظهر: راجع إعدادات صفحة التواصل ودعم الواجهة، ثم مكان رسائل التواصل الواردة."
    ]
  },
  {
    "id": "contact-channels",
    "group": "content",
    "group_title": "المحتوى والتواصل",
    "title": "قنوات التواصل وروابط الفروع",
    "paths": [
      "/admin/contact/channels"
    ],
    "paragraphs": [
      "تدير الهاتف والبريد والروابط الاجتماعية الظاهرة في صفحة التواصل أو التذييل أو بيانات فرع."
    ],
    "steps": [
      "ابحث عن القناة ثم أضفها أو افتح تعديلها.",
      "حدد النوع والتسمية والقيمة والفرع عند الحاجة، وعلامة أساسي ومواضع الظهور والحالة.",
      "احفظ ثم استخدم التحريك لأعلى أو أسفل لترتيب القنوات.",
      "جرّب الرابط أو رقم الاتصال من واجهة المتجر، واحذف قناة فقط بعد مراجعة تأكيد الحذف."
    ],
    "fields": [
      "القيمة: هاتف أو بريد أو رابط مناسب لنوع القناة.",
      "مواضع العرض: صفحة التواصل والتذييل والفرع حسب الخيارات.",
      "أساسي: تمييز قناة رئيسية ضمن استخدامها المدعوم."
    ],
    "tips": [
      "قناة تواصل اجتماعي ليست إعداد مزود رسائل واتساب أو بريد؛ إعداد الإرسال في قنوات الإشعارات."
    ],
    "examples": [
      "رابط واتساب في صفحة التواصل يفتح قناة تواصل؛ لا يضبط مزود الإشعارات تلقائيًا."
    ],
    "troubleshooting": [
      "رابط غير صحيح: راجع النوع والقيمة والتفعيل وبيانات الفرع، ثم جرّب فتحه من الواجهة."
    ]
  },
  {
    "id": "contact-messages",
    "group": "content",
    "group_title": "المحتوى والتواصل",
    "title": "رسائل التواصل الواردة",
    "paths": [
      "/admin/contact/messages"
    ],
    "paragraphs": [
      "تعرض رسائل نموذج تواصل معنا الواردة من العملاء، مع عدد الجديد والبحث وتغيير حالة المتابعة."
    ],
    "steps": [
      "راجع عدد الرسائل الجديدة، وابحث بالاسم أو البريد أو الموضوع وصفِّ بالحالة والفترة المتاحة.",
      "افتح الرسالة واقرأ الموضوع والنص والهاتف والبريد.",
      "حدّث حالة الرسالة من الإجراء المتاح بما يعكس متابعة الفريق، ثم راجع ظهور الحالة الجديدة.",
      "إذا احتاجت ردًا استخدم وسيلة التواصل المعتمدة مع العميل؛ تغيير الحالة لا يعني إرسال رد تلقائي."
    ],
    "fields": [
      "الحالة: مرحلة متابعة الرسالة داخل الفريق.",
      "بيانات المرسل: بيانات النموذج التي تحتاج مراجعة قبل استخدامها في تواصل آخر."
    ],
    "tips": [
      "عدم وجود رسائل قد يعني عدم وجود نتائج للفلاتر أو عدم تفعيل النموذج؛ راجع إعداداته قبل افتراض عطل الإرسال."
    ],
    "examples": [
      "افتح الرسالة واقرأ المرسل والموضوع والحالة، ثم سجّل المتابعة وفق الإجراءات المتاحة."
    ],
    "troubleshooting": [
      "رسالة متوقعة غير موجودة: تحقق من المتجر والفلاتر وإرسال النموذج فعليًا، وليس إعداد البريد وحده."
    ]
  },
  {
    "id": "operations",
    "group": "operations",
    "group_title": "التكاملات والإشعارات",
    "title": "التكاملات وإعداد الاتصال والمزامنة",
    "paths": [
      "/admin/integrations",
      "/admin/integrations/:id"
    ],
    "paragraphs": [
      "تربط المتجر بأنظمة مثل Odoo أو Focus. إعداد الاتصال يختلف عن تعيين الحقول وعن تنفيذ المزامنة الفعلية."
    ],
    "steps": [
      "افتح التكامل المطلوب من القائمة وراجع وضعه التجريبي وحالته وآخر اتصال.",
      "أدخل الرابط وبيانات الاتصال المناسبة للمزود. في Focus استخدم جذر API الصحيح حسب التلميح، وفي Odoo راجع قاعدة البيانات واسم المستخدم.",
      "أدخل السر الجديد فقط عند استبداله؛ ترك حقل السر فارغًا يحافظ على المخزن. احفظ ثم اختبر الاتصال.",
      "راجع اتجاهات المنتجات والمخزون والطلبات والمزامنة التلقائية، واحفظ التغييرات قبل تشغيلها.",
      "نفّذ مزامنة المخزون من زرها، والمنتجات والتصنيفات من تعيين الحقول، ثم تابع سجلات المزامنة وصحة الطابور."
    ],
    "fields": [
      "الوضع التجريبي: يحدد سلوك الاختبار وفق المزود ولا يثبت نجاح الربط المباشر.",
      "المزامنة التلقائية: إعداد مهام الخلفية المجدولة، ومختلفة عن تفعيل كيان في تعيين الحقول.",
      "الأسرار: لا تُعرض القيم المحفوظة؛ الحقل الفارغ لا يعني عدم وجودها."
    ],
    "tips": [
      "نجاح اختبار الاتصال لا يثبت صحة تعيين كل حقل أو نجاح كل مزامنة. اختبر بعينة وراجع السجل.",
      "لا تفترض توفر إرسال المنتجات للخارج لمجرد ظهور اتجاه؛ استخدم الإجراءات التي تدعمها شاشة المزود فعلًا."
    ],
    "examples": [
      "اختبار اتصال ناجح يسبق معاينة مزامنة عينة؛ كل منهما نتيجة مختلفة عن اكتمال إرسال طلب."
    ],
    "troubleshooting": [
      "لا توجد مزامنة تلقائية: راجع تفعيل التكامل والجدولة والعامل وآخر سجل بدل تكرار المزامنة اليدوية."
    ]
  },
  {
    "id": "integration-field-mapping",
    "group": "operations",
    "group_title": "التكاملات والإشعارات",
    "title": "تعيين حقول أودو والمعاينة قبل المزامنة",
    "paths": [],
    "paragraphs": [
      "من داخل إعداد تكامل أودو تُراجع مطابقة حقول العملاء والأقسام والمنتجات، وتفعّل كل كيان ثم تختبر البيانات قبل المزامنة."
    ],
    "steps": [
      "افتح إعداد أودو وانتقل لتعيين الحقول واختر العملاء أو الأقسام أو المنتجات.",
      "راجع الحقول المحلية ومقابلها في المصدر والمفاتيح المستخدمة للمطابقة، ثم احفظ التعيين.",
      "فعّل الكيان المطلوب واستخدم Dry Run لمراجعة العينة والتحذيرات دون تنفيذ مزامنة فعلية.",
      "صحح الأخطاء ثم استخدم Sync Now عند جاهزية التعيين، وتابع التنفيذ من السجلات."
    ],
    "fields": [
      "Dry Run: معاينة للتحقق قبل التنفيذ الفعلي.",
      "Sync Now: بدء المزامنة المدعومة للكيان، وقد يوضع العمل في الطابور.",
      "تفعيل الكيان: سماح استخدام تعيينه، وليس تفعيل الجدولة التلقائية وحدها."
    ],
    "tips": [
      "الاستيراد قد يغيّر بيانات كتالوج فعلية. راجع جهة المصدر والمطابقة والعينة قبل التنفيذ."
    ],
    "examples": [
      "اربط SKU أو المعرّف الخارجي المناسب للمنتج، ثم راجع Dry Run قبل استيراد كمية كبيرة."
    ],
    "troubleshooting": [
      "منتج تكرر بعد المزامنة: راجع مفتاح المطابقة والتعيين بدل حذف سجلات مرتبطة بطلبات."
    ]
  },
  {
    "id": "integration-payment-settings",
    "group": "operations",
    "group_title": "التكاملات والإشعارات",
    "title": "أودو: شروط السداد وربط بوابات الدفع والخصم والشحن",
    "paths": [],
    "paragraphs": [
      "من التكاملات ← أودو ← تهيئة تضبط شروط السداد ودفتر الدفع لكل بوابة ومنتجات الشحن والخصم عند توفرها. هذه تعيينات للنظام الخارجي ولا تغيّر وسائل دفع المتجر أو حساب تحصيلها."
    ],
    "steps": [
      "احفظ إعداد اتصال أودو واختبره قبل تحميل الاختيارات الخارجية.",
      "افتح قسم شروط السداد وربط بوابات الدفع واضغط تحميل الاختيارات من أودو.",
      "اختر شروط السداد والدفتر المقابل لكل بوابة مع مراجعة اسم السجل الخارجي، ثم احفظ التهيئة.",
      "راجع إعداد منتج الشحن ومنتج الخصم إذا كنت تستخدم بنودًا مستقلة لهما في أمر البيع.",
      "افتح طلبًا مناسبًا للمراجعة، وتابع مرجع أمر البيع وسجل الإرسال لمعرفة نتيجة تعيين وسيلة الدفع والخصم والشحن.",
      "إذا تغيرت وسيلة الدفع بعد الإنشاء، راجع نتيجة تحديث نفس أمر البيع الخارجي بدل البحث عن أمر جديد."
    ],
    "fields": [
      "شروط السداد: سجل Odoo المقابل لـ payment_term_id، وليس موعد فترة التوصيل.",
      "دفتر الدفع: التعيين المقابل لـ payment_journal_id عندما تدعمه نسخة أودو.",
      "بوابة غير معيّنة: راجع سلوك القيمة الافتراضية في التهيئة؛ لا تفترض دفترًا خارجيًا من اسم البوابة وحده.",
      "بند الخصم: منتج خارجي مخصص لبند الخصم المستقل حسب إعداد التكامل.",
      "مرجع الأمر: الرابط بين طلب المتجر وأمر البيع الخارجي، ويستخدمه التحديث وإعادة المحاولة."
    ],
    "tips": [
      "تحميل الاختيارات يقرأ بيانات أودو، بينما الحفظ يضبط الربط. إرسال الطلب أو إعادة إرساله خطوة مستقلة تحتاج مراجعة نتيجة المحاولة السابقة."
    ],
    "examples": [
      "اربط بوابة MyFatoorah بالدفتر المقصود، واحفظ. راجع طلبًا يستخدم البوابة في أودو وتأكد من الدفتر وشروط السداد والإجمالي."
    ],
    "troubleshooting": [
      "الاختيارات لا تُحمّل: راجع الاتصال وصلاحيات مستخدم أودو والحقول التي تدعمها نسخته.",
      "خصم أو شحن غير ظاهر: راجع المنتج الخارجي المعيّن وقيمة الطلب وسجل المحاولة؛ لا تضف بندًا يدويًا قبل التأكد من عدم تسجيله بالفعل."
    ]
  },
  {
    "id": "integration-bundle-orders",
    "group": "operations",
    "group_title": "التكاملات والإشعارات",
    "title": "مزامنة الطلب والبندل إلى أودو ومعالجة Quotation",
    "paths": [],
    "paragraphs": [
      "طلب المتجر يحتفظ بمرجع أمره الخارجي. تصدير البندل يستخدم سطر البندل بسعر بيعه، وتظهر مكوناته تحته بكمياتها وأسعار صفر لتوضيح المحتويات دون مضاعفة إجمالي البيع."
    ],
    "steps": [
      "راجع ربط منتج البندل ومكوناته ومتغيراتها بالمنتجات الخارجية الصحيحة، مع كمية كل مكوّن في القطعة.",
      "افتح تفاصيل طلب البندل وراجع لقطة الأصناف والإجمالي قبل إرسال ERP.",
      "بعد الإرسال راجع المرجع وسجل النتيجة، ثم افحص أمر البيع الخارجي وحالته، وليس مجرد وجود رقمه.",
      "إذا بقي الأمر Quotation، افتح رسالة خطأ التأكيد؛ راجع خرائط المنتجات والمخزون وإعداد أودو ثم عالج السبب قبل إعادة المحاولة.",
      "عند إعادة محاولة طلب مرتبط، راجع نفس المرجع وتأكد من عدم وجود أمر منفصل مكرر، خصوصًا قبل أي تعديل يدوي خارجي."
    ],
    "fields": [
      "سطر البندل: كمية البندل وسعره المعتمد للطلب.",
      "سطر المكوّن: كمية المكوّن داخل البندل مضروبة في عدد البندلات، بسعر صفر في التصدير؛ لا يعني أن سعر كتالوجه صفر.",
      "الشحن والخصم: بنود مستقلة وفق إعداد التكامل، لا تُوزع بإضافة أسعار للمكونات الصفرية.",
      "Quotation: مسودة أو عرض سعر خارجي؛ يختلف عن أمر بيع تم تأكيده.",
      "أمر مؤكد أو مكتمل: لا يُعاد بناء أصنافه عشوائيًا لمجرد إعادة إرسال الطلب."
    ],
    "tips": [
      "إعداد منتج البندل الخارجي وخطة المخزون يجب أن يمنعا خصم مخزون الأب والمكونات لنفس البيع مرتين. راجع حركة أودو إذا كان نوع المنتج الخارجي غير مناسب."
    ],
    "examples": [
      "بندل 9.000 KWD يحتوي قطعتين A وقطعة B: بيع بندلين يصدّر سطر بندل بكمية 2 وإجمالي 18.000، وA بكمية 4 وسعر صفر، وB بكمية 2 وسعر صفر؛ يظل الشحن والخصم حسب الطلب."
    ],
    "troubleshooting": [
      "إجمالي أودو أعلى من المتجر: راجع تكرار أسعار المكونات أو الضرائب أو بنود الشحن والخصم.",
      "المكونات مختلفة عن كتالوج اليوم: الطلب يستخدم بيانات البندل المحفوظة وقت البيع؛ تغيير الكتالوج لا يعيد كتابة الطلب القديم.",
      "خطأ تأكيد: لا تعتبر إنشاء Quotation نجاح دورة الإرسال كاملة؛ احفظ مرجع السجل ورسالة الخطأ وراجع سبب الرفض."
    ]
  },
  {
    "id": "integration-mappings",
    "group": "operations",
    "group_title": "التكاملات والإشعارات",
    "title": "تعيينات التكامل بين السجلات",
    "paths": [
      "/admin/integrations/mappings"
    ],
    "paragraphs": [
      "تعرض روابط الكيانات المحلية بنظائرها الخارجية، لتحديد المنتج أو القسم المقصود عند المزامنة."
    ],
    "steps": [
      "حدد التكامل ونوع الكيان أو الفلاتر التي تعرضها الشاشة.",
      "راجع المعرّف المحلي والخارجي والاتجاه وآخر مزامنة.",
      "طابق السجل مع المصدر عند وجود استيراد غير متوقع، ثم ارجع لتعيين الحقول أو سجل المزامنة للتحقق."
    ],
    "fields": [
      "محلي وخارجي: معرّفا السجلين المرتبطين.",
      "الاتجاه: اتجاه الربط أو المزامنة المسجل.",
      "آخر مزامنة: آخر وقت مسجل للرابط."
    ],
    "tips": [
      "هذه الروابط تختلف عن تعيين أسماء الحقول داخل إعداد أودو؛ لا تخلط بين ربط سجل وربط حقل."
    ],
    "examples": [
      "معرّف محلي لمنتج يربط بمعرّف المنتج الصحيح في أودو؛ تشابه الاسم وحده لا يكفي."
    ],
    "troubleshooting": [
      "تحديث يذهب لسجل مختلف: راجع نوع الكيان والمعرّفين واتجاه الربط في نفس المتجر."
    ]
  },
  {
    "id": "integration-logs",
    "group": "operations",
    "group_title": "التكاملات والإشعارات",
    "title": "سجلات المزامنة وإعادة المحاولة",
    "paths": [
      "/admin/integrations/sync-logs"
    ],
    "paragraphs": [
      "تعرض محاولات الاتصال والمزامنة وحالتها وكيانها وتوقيتاتها، مع بيانات تشخيص محجوبة الأسرار."
    ],
    "steps": [
      "صفِّ بالتكامل أو الإجراء أو الحالة وابحث عن المحاولة المقصودة.",
      "افتح بيانات السجل لقراءة الخطأ والملخص الآمن ومرجع الكيان.",
      "عالج سبب الفشل في المصدر أو الإعداد ثم استخدم إعادة المحاولة عندما يدعمها الإجراء.",
      "انتقل لصحة الطابور لمراجعة المهام المعلّقة والتنفيذ، ثم ارجع للسجل لمعرفة النتيجة النهائية."
    ],
    "fields": [
      "قيد الانتظار أو التنفيذ: لا يعني اكتمال المزامنة بنجاح.",
      "إعادة المحاولة: قد تضع مهمة جديدة في الخلفية؛ لا تفترض أن الضغط أنهى العمل.",
      "الحمولات: تعرض بعد حجب الأسرار؛ لا تشارك بيانات دخول من مصدر آخر."
    ],
    "tips": [
      "لا تكرر إعادة المحاولة إذا كانت المهمة موجودة بالفعل في الطابور؛ اقرأ حالة التنفيذ أولًا."
    ],
    "examples": [
      "فتح محاولة يوضح الخطأ والمرجع والوقت؛ نفس السجل قد يعكس مراحل مهمة واحدة لا طلبات بيع متعددة."
    ],
    "troubleshooting": [
      "إعادة المحاولة لم تنتهِ: راجع المهمة الحالية وصحة الطابور قبل إطلاق محاولة أخرى."
    ]
  },
  {
    "id": "queue-health",
    "group": "operations",
    "group_title": "التكاملات والإشعارات",
    "title": "صحة طابور التكاملات والتنفيذ المنقطع",
    "paths": [
      "/admin/integrations/queue-health"
    ],
    "paragraphs": [
      "تراقب المهام المعلّقة والفاشلة وأقدم مهمة وحالة التشغيل. تعرض الشاشة دليلًا على النشاط لكنها لا تشغّل عامل المهام على السيرفر."
    ],
    "steps": [
      "راجع مشغّل الطابور وأعداد المهام وعمر الأقدم، واقرأ تلميح حالة العامل.",
      "افتح تفاصيل سجل التنفيذ للاطلاع على التقدم وآخر تحديث والخطأ الآمن.",
      "أعد محاولة الفشل المدعوم بعد معالجة سببه إذا لم تكن هناك مهمة قائمة له بالفعل.",
      "إذا تأكدت أن تنفيذًا انقطع استخدم تسجيل انقطاع التنفيذ واقرأ التأكيد ثم وثّق الإجراء.",
      "عند الحاجة لتشغيل العامل انسخ الأمر المعروض لمسؤول السيرفر؛ التنفيذ يتم على السيرفر أو عبر Supervisor."
    ],
    "fields": [
      "نطاق الأعداد: أعداد الطابور تخص العميل الحالي بكل متاجره، بينما سجلات المزامنة المعروضة تخص المتجر المختار.",
      "العامل خامل: عدم وجود مهام لا يثبت أن عملية العامل تعمل أو متوقفة.",
      "تسجيل الانقطاع: يعلّم السجل فاشلًا مع تدقيق؛ لا يقتل عملية ولا يبدأ إعادة محاولة وحده."
    ],
    "tips": [
      "لا تسجّل انقطاعًا لمجرد أن التنفيذ بطيء؛ راجع دليل النشاط أولًا. خطأ قديم لم يُسجّل لا يمكن استعادته من هذا الإجراء."
    ],
    "examples": [
      "أعداد المهام قد تشمل كل متاجر العميل؛ سجل المزامنة المعروض يظل مرتبطًا بالمتجر الحالي."
    ],
    "troubleshooting": [
      "قديم بلا نشاط: راجع العامل والسجل؛ تسجيل الانقطاع إجراء تدقيق ولا يشغّل عاملًا جديدًا."
    ]
  },
  {
    "id": "send-message",
    "group": "operations",
    "group_title": "التكاملات والإشعارات",
    "title": "إرسال رسالة أو عرض للعملاء",
    "paths": [
      "/admin/notifications/send"
    ],
    "paragraphs": [
      "تُرسل رسالة لعميل أو مجموعة عبر قنوات جاهزة، مع متغيرات اسم العميل والمتجر ومعاينة. الإرسال إجراء فعلي وليس مجرد حفظ قالب."
    ],
    "steps": [
      "اكتب الموضوع والنص واستخدم متغيري {{customer_name}} و{{store_name}} عند الحاجة.",
      "اختر القنوات الجاهزة. إن لم توجد قناة راجع قنوات الإشعارات قبل المتابعة.",
      "ابحث عن العملاء بحرفين على الأقل واخترهم، أو اختر كل العملاء النشطين في نطاق المتجر حسب الخيار المعروض.",
      "راجع المعاينة والعدد ثم اضغط إرسال وانتظر ملخص المجدول والمتخطى.",
      "افتح عمليات الإرسال لمتابعة النجاح والفشل لكل قناة ومستلم."
    ],
    "fields": [
      "كل العملاء: النشطون ممن لديهم طلب أو سلة هنا حسب الشاشة، بحد أقصى 300 عميل.",
      "المعاينة: تستبدل المتغيرات لعميل نموذجي ولا ترسل الرسالة.",
      "تمت الجدولة: قبول إنشاء محاولات الإرسال، وليس إثبات وصولها للمستلم."
    ],
    "tips": [
      "راجع الجمهور والنص قبل الإرسال. ظهور الشاشة لا يضمن امتلاك صلاحية تنفيذ الإرسال."
    ],
    "examples": [
      "ابدأ بمستلم اختبار معتمد ومعاينة الاسم والمتجر ثم تابع نتيجة الإرسال قبل استهداف مجموعة."
    ],
    "troubleshooting": [
      "تمت الجدولة ولم تصل: افتح عمليات الإرسال وراجع القناة والعامل وسبب الفشل أو التخطي."
    ]
  },
  {
    "id": "notification-templates",
    "group": "operations",
    "group_title": "التكاملات والإشعارات",
    "title": "قوالب الإشعارات والمتغيرات",
    "paths": [
      "/admin/notifications/templates",
      "/admin/notifications/templates/new",
      "/admin/notifications/templates/create",
      "/admin/notifications/templates/:id/edit"
    ],
    "paragraphs": [
      "القالب يحدد نص رسالة لحدث وقناة ولغة. حفظه لا يرسل رسالة بنفسه، وتستخدمه آلية الإشعارات عند وقوع الحدث المناسب."
    ],
    "steps": [
      "صفِّ بالحدث أو القناة أو اللغة وابحث عن القالب قبل إضافة بديل.",
      "اختر الحدث والقناة واللغة وأدخل الموضوع والمحتوى والحالة.",
      "استخدم المتغيرات التي تدعمها الشاشة مثل {{order_number}} و{{customer_name}} فقط، ثم راجع المعاينة.",
      "احفظ وراجع القالب في القائمة، أو اقرأ تأكيد الحذف إذا لم تعد تحتاجه."
    ],
    "fields": [
      "الحدث: الموقف الذي يطلب الرسالة مثل تغيير متعلق بالطلب.",
      "القناة واللغة: تحددان نسخة النص المطلوبة للإرسال.",
      "المتغيرات: القيم غير المتوفرة قد تظهر فارغة؛ راجع صياغة النص معها."
    ],
    "tips": [
      "تفعيل القالب لا يغني عن تفعيل قناة الإرسال وتهيئة مزودها والحدث الخاص بها."
    ],
    "examples": [
      "نفس الحدث يمكن أن يكون له نص عربي وآخر إنجليزي ولكل قناة صياغتها."
    ],
    "troubleshooting": [
      "تعديل القالب لم يرسل رسالة: الحفظ لا يطلق الحدث؛ راجع تفعيل الحدث والقناة وسجل الإرسال."
    ]
  },
  {
    "id": "notification-deliveries",
    "group": "operations",
    "group_title": "التكاملات والإشعارات",
    "title": "عمليات إرسال الإشعارات والمحاولات",
    "paths": [
      "/admin/notifications/deliveries"
    ],
    "paragraphs": [
      "تتابع نتيجة الإرسال حسب الحدث والقناة والمستلم والحالة وعدد المحاولات، لتعرف هل تم قبول العمل أو نجح أو فشل."
    ],
    "steps": [
      "ابحث بالمستلم أو الحدث وصفِّ بالقناة والحالة والفلاتر المتاحة.",
      "راجع سبب الفشل أو بيانات المحاولة المتاحة، ثم صحح عنوان المستلم أو إعداد القناة عند الحاجة.",
      "استخدم إعادة المحاولة للسجل المؤهل فقط، ثم راقب تحديثه بدل تكرار الضغط."
    ],
    "fields": [
      "المحاولات: عدد محاولات المعالجة المسجلة.",
      "الحالة: مرحلة أو نتيجة الإرسال المسجلة، وليست ضمان أن المستلم قرأ الرسالة."
    ],
    "tips": [
      "قبول مزود الإرسال لا يعني قراءة العميل. راجع فرق الحالات حسب القناة قبل تصعيد المشكلة."
    ],
    "examples": [
      "مجدولة ثم أُرسلت يختلف عن فشل أو تخطٍّ؛ افتح السبب قبل إعادة المحاولة."
    ],
    "troubleshooting": [
      "فاتورة فشلت عند التجهيز: راجع السبب وبيانات الطلب والمستلم والقناة؛ سجل الفشل يبقى مرجع المتابعة."
    ]
  },
  {
    "id": "audit",
    "group": "operations",
    "group_title": "التكاملات والإشعارات",
    "title": "سجل التدقيق ومن نفّذ التغيير",
    "paths": [
      "/admin/system/audit-logs",
      "/admin/system/audit-logs/:id"
    ],
    "paragraphs": [
      "مرجع لمراجعة التغييرات الإدارية والفاعل والعملية والوقت والسجل المتأثر حسب ما تم تسجيله."
    ],
    "steps": [
      "ابحث وصفِّ بالفاعل أو الإجراء أو الكيان أو الفترة وفق الحقول المتاحة.",
      "افتح السجل لمراجعة ملخص التغيير والبيانات المسجلة قبل وبعد إن توفرت.",
      "استخدم المرجع والتوقيت عند التحقيق في تعديل سعر أو صلاحية أو عملية مالية، ثم ارجع للشاشة الأصلية لأي تصحيح."
    ],
    "fields": [
      "الفاعل: المستخدم أو المصدر المسجل للعملية.",
      "الكيان: السجل الذي تأثر بالتغيير.",
      "البيانات: تفاصيل التدقيق المتاحة وليست كشفًا لكلمات المرور أو أسرار المزودين."
    ],
    "tips": [
      "السجل للمراجعة؛ فتحه لا يرجع التغيير تلقائيًا. ظهوره يحتاج صلاحية التدقيق."
    ],
    "examples": [
      "راجع حساب المنفذ ووقت تعديل المنتج عند اختلاف السعر، ثم قارنه بسجل التحديث الخارجي."
    ],
    "troubleshooting": [
      "لا يظهر الحدث المتوقع: راجع المتجر والفترة والفلتر ونوع العملية؛ السجل يعرض ما سُجّل فعلًا."
    ]
  },
  {
    "id": "settings",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "الإعدادات العامة وظهور المنتجات النافدة",
    "paths": [
      "/admin/settings/general"
    ],
    "paragraphs": [
      "تضبط اسم الموقع ووصفه القصير وبيانات الدعم وظهور المنتجات النافدة. شاشة الإعدادات تعتمد القائمة الجانبية الرئيسية للتنقل بين أقسامها."
    ],
    "steps": [
      "راجع اسم المتجر النشط، ثم عدّل اسم الموقع والوصف وبريد الدعم والهاتف.",
      "اضبط إظهار منتجات نفاد المخزون حسب السياسة المطلوبة.",
      "اضغط حفظ وانتظر النجاح؛ استخدم تجاهل التغييرات للرجوع للقيم المحملة بدل حفظها.",
      "راجع واجهة المتجر التي تستخدم الإعداد للتأكد من ظهور النتيجة."
    ],
    "fields": [
      "إظهار النافد: عند الإيقاف تُخفى منتجات النفاد، وعند التشغيل تبقى ظاهرة دون إتاحة شرائها.",
      "قيم false وصفر: قيم صحيحة وليست حقولًا فارغة، فتأكد من اختيارها عن قصد.",
      "تغييرات غير محفوظة: ينبه شريط الحفظ إلى اختلاف القيم الحالية عن المحفوظة."
    ],
    "tips": [
      "بعض الإعدادات يوضح بجانبها أن تطبيقها في الواجهة قد يكون معلقًا؛ اقرأ التلميح ولا تعتبر الحفظ دليلًا على دعم كل قالب لها."
    ],
    "examples": [
      "إظهار المنتجات النافدة يسمح بعرضها دون جعلها قابلة للشراء؛ التوافر له مخزونه وحالته."
    ],
    "troubleshooting": [
      "تغيير لم يُحفظ: راجع شريط التغييرات ورسالة الحفظ ثم أعد فتح الشاشة."
    ]
  },
  {
    "id": "store-profile",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "ملف المتجر والهوية والشعار",
    "paths": [
      "/admin/settings/store"
    ],
    "paragraphs": [
      "تدير الاسم المترجم ورمز الدولة والمنطقة الزمنية وهوية المتجر المرئية، مع عرض اللغة والعملة الافتراضيتين."
    ],
    "steps": [
      "عدّل الاسم بالعربية والإنجليزية ورمز الدولة والمنطقة الزمنية الصحيحة ثم احفظ.",
      "ارفع الشعار من جهازك أو اختره من مكتبة الوسائط، وراجع المعاينة ونتيجة الرفع.",
      "اضبط أيقونة الموقع من محرر الهوية المتاح وراجعها في واجهة المتجر.",
      "لتغيير اللغة أو العملة الافتراضية استخدم شاشة اللغات أو العملات المخصصة."
    ],
    "fields": [
      "المنطقة الزمنية: تؤثر على قراءة أيام التقارير والفترات الخاصة بالمتجر.",
      "الشعار: الصيغ المدعومة JPEG وPNG وWebP وGIF بحد 2 ميجابايت وفق تلميح الرفع.",
      "الرمز: معرّف المتجر المعروض، ويختلف عن الاسم المترجم."
    ],
    "tips": [
      "إدارة النطاقات تتم من إدارة متاجر المنصة بصلاحيتها؛ ملف المتجر ليس شاشة ربط دومين."
    ],
    "examples": [
      "شعار محفوظ للمتجر يُستخدم في المواضع المدعومة مثل مستندات وفواتير الطلب."
    ],
    "troubleshooting": [
      "الشعار لا يظهر: راجع رفع الملف وحجمه والصيغة ثم احفظ وافحص الموضع المقصود."
    ]
  },
  {
    "id": "languages",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "لغات المتجر واللغة الافتراضية",
    "paths": [
      "/admin/settings/languages"
    ],
    "paragraphs": [
      "تربط لغة موجودة أو تنشئ تعريف لغة وتضبط أسماءها واتجاهها وتفعيلها للمتجر."
    ],
    "steps": [
      "اضغط إضافة لغة، واختر ربط لغة موجودة أو إنشاء لغة جديدة.",
      "أدخل الرمز والأسماء والاسم الأصلي والاتجاه عند الحاجة ثم احفظ.",
      "عيّن لغة افتراضية من إجراء الصف، وفعّل أو عطّل اللغات الأخرى حسب سياسة المتجر.",
      "راجع محتوى المنتجات والصفحات لكل لغة فعّلتها قبل إعلان دعمها للعملاء."
    ],
    "fields": [
      "الرمز: معرّف اللغة مثل ar أو en.",
      "الاتجاه: من اليمين لليسار أو العكس.",
      "الافتراضي: لغة المتجر الأساسية؛ لا يمكن تعطيلها مباشرة قبل اختيار بديل."
    ],
    "tips": [
      "تغيير اللغة الافتراضية لا يترجم المنتجات أو يعيد كتابة المحتوى التاريخي."
    ],
    "examples": [
      "اختيار لغة المتجر الافتراضية لا يترجم أسماء المنتجات التي لم تُكتب بتلك اللغة."
    ],
    "troubleshooting": [
      "تعطيل اللغة الافتراضية مرفوض: عيّن بديلًا مناسبًا قبل تغيير تفعيلها."
    ]
  },
  {
    "id": "currencies",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "عملات المتجر وأسعار الصرف",
    "paths": [
      "/admin/settings/currencies"
    ],
    "paragraphs": [
      "تدير العملات المفعّلة والافتراضية وأسماءها ورموزها ومنازل عرضها العشرية وأسعار صرفها الخاصة بالمتجر."
    ],
    "steps": [
      "اضغط إضافة عملة واربط عملة موجودة أو أنشئ تعريفًا جديدًا.",
      "أدخل الرمز والأسماء والرمز المختصر والمنازل العشرية وسعر الصرف الأساسي للمتجر.",
      "أدخل سعرًا مخصصًا إذا أردت تجاوز السعر الأساسي لهذا المتجر ثم احفظ.",
      "عيّن الافتراضية من إجراء الصف وراجع سعر الصرف الفعلي وتوافق بوابات الدفع معها."
    ],
    "fields": [
      "سعر الصرف: وحدات من العملة مقابل 1 دولار، وليس العكس.",
      "السعر المخصص: يستبدل الأساسي داخل هذا المتجر فقط.",
      "الافتراضي: لا يُعطّل قبل تعيين عملة بديلة افتراضية."
    ],
    "tips": [
      "تغيير الافتراضي لا يعيد حساب الطلبات التاريخية. حافظ على فصل العملات في التقارير ولا تعتمد على جمعها دون تحويل واضح."
    ],
    "examples": [
      "إذا كانت العملة 50 وحدة مقابل الدولار فاكتب 50 لا 0.020 وفق اتجاه الحقل."
    ],
    "troubleshooting": [
      "تحويل سعر غير متوقع: راجع السعر الأساسي والمخصص للمتجر والعملة الافتراضية ودقة العرض."
    ]
  },
  {
    "id": "checkout-settings",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "إتمام الشراء والضريبة وهوية الفاتورة",
    "paths": [
      "/admin/settings/checkout"
    ],
    "paragraphs": [
      "تحدد هذه الشاشة اشتراط دخول العميل وإعدادات الضريبة وبيانات البائع القانونية المستخدمة في الفاتورة الضريبية."
    ],
    "steps": [
      "حدد هل يتطلب إتمام الشراء تسجيل الدخول أم يسمح بالشراء كزائر.",
      "اضبط تفعيل الضريبة والنسبة وهل السعر شامل الضريبة وهل تُطبق على الشحن.",
      "أدخل الاسم القانوني والرقم الضريبي والسجل التجاري والعنوان وبادئة الفاتورة عند الحاجة.",
      "اختر إظهار صور المنتجات في PDF حسب إعدادك ثم احفظ، واختبر سلة جديدة لفهم الحساب."
    ],
    "fields": [
      "شامل الضريبة: مثال 115.000 شامل 15 بالمائة ينتج صافي 100.000 وضريبة 15.000.",
      "غير شامل: مثال 100.000 مع ضريبة 15 بالمائة ينتج إجمالي 115.000.",
      "يتطلب الدخول: يخص إتمام الطلب؛ لا يمنع الزائر من استخدام السلة وحده."
    ],
    "tips": [
      "تغيير إعداد الضريبة يؤثر على السلال والطلبات الجديدة؛ بيانات الطلبات الحالية لا يُعاد حسابها تلقائيًا.",
      "راجع فئة ضريبة المنتج أيضًا لأنها قد تخصص المعالجة أو النسبة."
    ],
    "examples": [
      "سعر 115.000 شامل 15% يعني أساسًا 100.000 وضريبة 15.000؛ وضع غير شامل له حساب مختلف."
    ],
    "troubleshooting": [
      "فاتورة قديمة لا تتغير: قيمها محفوظة وقت الطلب أو الإصدار؛ تغيير الإعدادات الحالية لا يعيد كتابتها."
    ]
  },
  {
    "id": "auth-settings",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "دخول العملاء وكود التحقق OTP",
    "paths": [
      "/admin/settings/auth"
    ],
    "paragraphs": [
      "تضبط طريقة دخول العميل بقيمة كلمة مرور أو OTP أو الاثنين، وقنوات الكود وحدود الأمان ومدته."
    ],
    "steps": [
      "اختر وضع الدخول المناسب: OTP فقط، أو كلمة مرور أو OTP، أو كلمة مرور.",
      "حدد القنوات المسموحة والأساسية والبديلة، وراجع جاهزية البريد أو واتساب من مؤشر القنوات.",
      "اضبط طول الكود وصلاحيته ومهلة إعادة الإرسال وعدد المحاولات وحد الإرسال خلال النافذة الزمنية.",
      "حدد السماح بإنشاء عميل تلقائيًا أو اشتراط وجود حساب حسب السياسة، ثم احفظ واختبر الدخول عبر قناة جاهزة."
    ],
    "fields": [
      "OTP فقط: يعطل إتاحة دخول كلمة المرور في قدرات الواجهة.",
      "الصلاحية ومهلة الإعادة: قيم بالثواني حسب عناوين الحقول.",
      "القناة البديلة: مسار بديل ضمن القنوات المسموحة والمهيأة، وليس ضمان وصول دون مزود جاهز."
    ],
    "tips": [
      "اختيار واتساب هنا لا يضبط بيانات مزوده؛ احفظها وفعّلها من قنوات الإشعارات أولًا.",
      "لا تشارك كود تحقق عميل مع موظف آخر أو تضبط قناة غير جاهزة كوسيلة الدخول الوحيدة دون اختبار."
    ],
    "examples": [
      "قناة OTP يجب أن تكون مسموحة وجاهزة قبل اختيارها وسيلة الدخول الأساسية."
    ],
    "troubleshooting": [
      "رمز لم يصل: راجع القناة والمزوّد والمستلم والحد الزمني لإعادة الإرسال؛ لا تكرر الطلب سريعًا."
    ]
  },
  {
    "id": "notification-settings",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "قنوات الإشعارات والمزوّدون والأحداث",
    "paths": [
      "/admin/settings/notifications",
      "/admin/settings/notifications/:channel"
    ],
    "paragraphs": [
      "هذه شاشة إعداد الإرسال الفعلي للبريد وواتساب وSMS والقنوات المتاحة، بما يشمل المزوّد والأسرار والأحداث."
    ],
    "steps": [
      "افتح القناة المطلوبة واختر المزوّد الذي تملكه بالفعل.",
      "املأ حقول الاتصال والعناوين والمعرّفات والأسرار التي يعرضها نموذج المزوّد، ثم احفظ.",
      "فعّل القناة واضبط الأحداث المسموح إرسالها من قسم الأحداث.",
      "راجع جاهزية القناة ثم اختبر برسالة مقصودة لمستلم اختبار من شاشة الإرسال، وتابع سجل عمليات الإرسال."
    ],
    "fields": [
      "المزوّد: مثل SMTP أو Postmark أو Mailgun للبريد أو المزوّد المتاح لواتساب وSMS.",
      "السر المحفوظ: يُحافظ عليه عند ترك الحقل فارغًا حسب تلميحه؛ لا تظهر قيمته الأصلية.",
      "الأحداث: تتحكم في أي رسائل النظام تمر عبر القناة.",
      "فواتير البريد: عناوين BCC الخاصة بالفواتير تُحفظ لكل متجر في إعداد البريد. راجعها عند تغيير فريق المحاسبة أو الدعم."
    ],
    "tips": [
      "تفعيل القناة دون بيانات صحيحة لا يجعلها جاهزة. لا ترسل لحملة عملاء كبيرة قبل مراجعة تجربة إرسال محدودة.",
      "قنوات التواصل العام وروابط الشبكات الاجتماعية ليست قنوات إرسال إشعارات.",
      "مزوّد Wajeez لواتساب يستخدم إعداد اتصاله الصحيح. قد تتنوع صياغة OTP من الرسائل المدعومة تلقائيًا؛ هذا لا يغيّر الكود أو صلاحيته ولا يعني تغيير قالب حدث طلب."
    ],
    "examples": [
      "إرسال الفاتورة للبريد مع BCC لا يساوي إضافة تلك العناوين كمستلمين ظاهرين للعميل."
    ],
    "troubleshooting": [
      "القناة مفعّلة لكنها غير جاهزة: أكمل الحقول والأسرار المطلوبة ثم احفظ وراجع الجاهزية."
    ]
  },
  {
    "id": "mobile-app",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "إصدارات تطبيق الموبايل ورسالة التحديث",
    "paths": [
      "/admin/settings/mobile-app"
    ],
    "paragraphs": [
      "هذه الإعدادات على مستوى العميل وتسري على كل متاجره، وليست خاصة بالمتجر المختار وحده."
    ],
    "steps": [
      "راجع كود العميل ونطاق الإعداد أعلى الشاشة قبل التعديل.",
      "في Android أو iOS حدد تفعيل طلب التحديث والإصدار الحالي مثل 1.2.0 ورابط التطبيق عبر HTTPS.",
      "اكتب رسالة التحديث بالعربية والإنجليزية ثم احفظ وانتظر النجاح.",
      "راجع جهازًا بإصدار أقدم وآخر مساوٍ أو أحدث عند اختبار التطبيق الداعم لهذه الإعدادات."
    ],
    "fields": [
      "الإصدار الحالي: الحد الذي يقارن به التطبيق إصدار المستخدم.",
      "تفعيل طلب التحديث: يطلب التحديث للإصدارات الأقدم؛ المساوي أو الأحدث لا يحتاج تحديثًا.",
      "رابط التطبيق: الرابط الذي يفتح صفحة تنزيل التحديث."
    ],
    "tips": [
      "تغيير المتجر داخل نفس العميل لا ينشئ إعدادًا مستقلًا. تأكد من صحة رابط كل منصة قبل التفعيل."
    ],
    "examples": [
      "تحديث إعدادات التطبيق يخص عميل المنصة بكل متاجره؛ راجع Android وiOS كلًا وفق الحقول."
    ],
    "troubleshooting": [
      "رسالة التحديث لا تظهر: راجع التفعيل والمقارنة بين الإصدار المثبت والحد المضبوط والرابط الصحيح."
    ]
  },
  {
    "id": "tax-classes",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "فئات الضريبة وربطها بالمنتجات",
    "paths": [
      "/admin/settings/tax-classes",
      "/admin/settings/tax-classes/new",
      "/admin/settings/tax-classes/:id/edit"
    ],
    "paragraphs": [
      "تتيح تعريف معالجة أو نسبة ضريبية وربطها بالمنتج، مع فئة افتراضية نشطة واحدة لكل متجر."
    ],
    "steps": [
      "راجع الفئات الحالية، ثم أضف فئة بالاسمين والرمز والوصف.",
      "حدد المعالجة والنسبة والحالة، وفعّل افتراضي المتجر إذا كانت الفئة العامة المطلوبة.",
      "احفظ ثم اربط الفئة من علاقات الكتالوج في المنتج عند الحاجة لتخصيصها.",
      "اختبر سلة جديدة تحتوي المنتج وراجع الضريبة بعد التغيير."
    ],
    "fields": [
      "النسبة: قيمة مئوية وفق نوع المعالجة.",
      "الافتراضية: تستخدم عندما لا يحدد المنتج فئة خاصة وفق أولوية إعدادات النظام.",
      "فئة المنتج: اختيارية؛ يرجع الحساب للفئة الافتراضية ثم إعداد الضريبة العام عند عدم التخصيص."
    ],
    "tips": [
      "لا تعتمد على تعديل النسبة لتصحيح فاتورة قديمة؛ الطلبات السابقة تحتفظ ببياناتها المالية."
    ],
    "examples": [
      "منتج بفئة خاصة يُراجع مع فئته قبل تعديل النسبة الافتراضية لكل المتجر."
    ],
    "troubleshooting": [
      "ضريبة غير متوقعة: راجع فئة المنتج والفئة الافتراضية وإعداد شامل أو غير شامل."
    ]
  },
  {
    "id": "gateways",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "بوابات الدفع وإعدادها وروابط العودة",
    "paths": [
      "/admin/settings/payment-gateways",
      "/admin/settings/payment-gateways/:id"
    ],
    "paragraphs": [
      "تدير وسائل مثل الدفع عند الاستلام والتحويل البنكي والمحفظة وMyFatoorah وPaymob وTap وTabby وHesabe وKPay وDeema (ديما) حسب المتاح للمتجر."
    ],
    "steps": [
      "افتح البوابة وراجع التفعيل والوضع التجريبي والعملات وحقول الجاهزية.",
      "أدخل بيانات التاجر التي يعرضها النموذج، واترك حقل السر فارغًا للحفاظ على قيمته حيث يوضح التلميح ذلك، ثم احفظ.",
      "انسخ رابط العودة والويب هوك المعروضين كما هما إلى لوحة مزود الدفع؛ الروابط تتضمن سياق العميل والمتجر.",
      "نفّذ اختبارًا معتمدًا وراجع الدفع وسجل الويب هوك، ثم انتقل للوضع المباشر وفعّل فقط عند جاهزية بيانات التاجر."
    ],
    "fields": [
      "الوضع التجريبي الوهمي: لا ينفذ خصمًا حقيقيًا؛ يختلف عن ربط مباشر ببيئة اختبار مزود عند توفره.",
      "جاهز: يعتمد على الحقول المطلوبة والعملة والإعدادات، وليس مجرد تفعيل المفتاح.",
      "الويب هوك والعودة: لكل منهما وظيفة؛ تأكيد الدفع يعتمد على دليل المزود المعتمد."
    ],
    "tips": [
      "Deema تدعم KWD، وبعض البوابات لها قيود عملة أو دولة؛ اقرأ التلميحات قبل التفعيل.",
      "لا تعتبر وضع authorized تحصيلًا نهائيًا إذا كانت البوابة تتطلب capture. راجع حالة الدفع المؤكدة من النظام."
    ],
    "examples": [
      "فعّل وسيلة الدفع بعد جاهزيتها للعملة والطريقة المقصودة، ثم راجع نتيجة دفع اختبار معتمدة."
    ],
    "troubleshooting": [
      "بوابة لا تظهر للعميل: راجع التفعيل والجاهزية والعملة وطريقة الشحن وشروط إتمام الطلب."
    ]
  },
  {
    "id": "gateway-fields",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "حقول البوابات الخاصة والتحقق من التحصيل",
    "paths": [],
    "paragraphs": [
      "كل مزود يحتاج بيانات مختلفة. استخدم أسماء الحقول الموجودة في نموذج البوابة وبيانات التاجر المعتمدة، دون وضع الأسرار في ملاحظات الطلب أو رسائل الدعم."
    ],
    "steps": [
      "في Tap راجع المفتاح السري؛ في Tabby راجع المفتاح السري ورمز التاجر وسر الويب هوك.",
      "في Hesabe راجع رمز التاجر ورمز الوصول والمفتاح السري ومفتاح IV.",
      "في KPay راجع معرّف الطرف وكلمة المرور ومفتاح التشفير من 16 حرفًا، ورابط الاستجابة المعروض، ورمز عملة الدينار 414 حيث يطلبه النموذج.",
      "في Deema راجع مفتاح API وسر الويب هوك وبيئة الاختبار أو المباشر، ثم راجع تطابق عملة الطلب.",
      "لباقي البوابات املأ الحقول المطلوبة المعروضة ثم تحقق من الجاهزية قبل التفعيل."
    ],
    "fields": [
      "Tap: يعتمد التحصيل النهائي على حالة CAPTURED المعتمدة.",
      "Tabby: التحصيل بعد capture وفق مسار البوابة.",
      "Hesabe وKPay: تُراجع سلامة الرد والمبلغ قبل اعتماد النجاح.",
      "Deema: حالات captured أو fully_captured للتحصيل، وليست authorized وحدها.",
      "توقيع Tabby: يستخدم سر الويب هوك عبر X-Tabby-Signature وفق إعداد المزود.",
      "توقيع Deema: الهيدر الافتراضي x-deema-signature؛ راجع القيمة المحفوظة في نموذج البوابة."
    ],
    "tips": [
      "لا تستخدم مفاتيح مزود داخل نموذج مزود آخر. القيم المخفية لا تعني أن الحقول لم تُحفظ."
    ],
    "examples": [
      "Authorized وحدها لا تساوي Captured في البوابات التي تفصل التفويض عن التحصيل."
    ],
    "troubleshooting": [
      "رد دفع مرفوض: راجع العملة والمبلغ والمرجع والتحقق من التوقيع مع سجل البوابة."
    ]
  },
  {
    "id": "tracking",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "التتبع والبيكسلات والأحداث",
    "paths": [
      "/admin/settings/tracking",
      "/admin/settings/tracking/:id"
    ],
    "paragraphs": [
      "تضبط مزودي تحليلات وتسويق المتجر والمعرّفات العامة والأحداث، مع فصل الأسرار عن البيانات المعروضة."
    ],
    "steps": [
      "افتح المزود وراجع حالته وجاهزيته والحقول المطلوبة الناقصة.",
      "أدخل معرّفات البيكسل أو التهيئة غير السرية في قسم التهيئة، والأسرار في بيانات الاعتماد فقط.",
      "حدد الأحداث المطلوب إرسالها والترتيب ثم احفظ وفعّل عند الجاهزية.",
      "عند الإيقاف اقرأ التأكيد؛ تتوقف السكربتات والأحداث الخاصة بالمزود بينما تبقى إعداداته محفوظة."
    ],
    "fields": [
      "جاهز: الحقول المطلوبة مكتملة وفق فحص اللوحة.",
      "الأحداث: ما يُرسل للمزود عندما تدعمه الواجهة ويكون مفعّلًا.",
      "مسح كل الأسرار: إجراء مختلف عن تركها فارغة؛ استخدمه فقط عند قصد إزالة بيانات الاعتماد."
    ],
    "tips": [
      "تفعيل مزود لا يثبت استلام كل حدث؛ راجع أدوات المزود وتجربة الواجهة بعد الإعداد دون كشف مفاتيحه."
    ],
    "examples": [
      "معرّف عام للتتبع يختلف عن سر اتصال؛ استخدم حقل كل مزود كما يظهر في النموذج."
    ],
    "troubleshooting": [
      "أحداث غير ظاهرة: راجع دعم الواجهة وتفعيل المزود والحدث والحقول المطلوبة."
    ]
  },
  {
    "id": "staff",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "الموظفون وتعيين المتاجر والأدوار",
    "paths": [
      "/admin/access/staff",
      "/admin/access/staff/create",
      "/admin/access/staff/:id/edit"
    ],
    "paragraphs": [
      "تدير حسابات فريق المتجر وتحدد المتاجر التي يدخلها كل موظف ودوره. يعرض النموذج معاينة للشاشات المتاحة للدور."
    ],
    "steps": [
      "ابحث عن الموظف بالاسم أو البريد، ثم اختر إنشاء حساب جديد أو دعوة حساب موجود حسب النموذج.",
      "للحساب الجديد أدخل الاسم والبريد وكلمة المرور وتأكيدها. دعوة الحساب الموجود تربطه بالمتجر ولا تستخدم لتغيير هويته أو كلمة مروره.",
      "اختر المتاجر المسموح بها والدور وحالة التعيين، وراجع معاينة الشاشات ثم احفظ وانتظر رسالة النجاح.",
      "للتعديل افتح الموظف وراجع الدور والمتاجر والحقول القابلة للتعديل؛ اترك كلمة المرور فارغة إذا كنت لا تريد تغييرها.",
      "لتسجيل الخروج من كل الأجهزة استخدم إجراء الصف، وراجع اسم الحساب والتأكيد؛ إذا نفذته على نفسك تنتهي جلستك أيضًا.",
      "إزالة تعيين المتجر إجراء مستقل عن تعطيل الحساب أو إلغاء جلساته. راجع أثره قبل التأكيد."
    ],
    "fields": [
      "كلمة المرور: 8 أحرف على الأقل حسب النموذج، وتأكيدها مطابق.",
      "المتاجر: الموظف يرى المتاجر المحددة له فقط.",
      "الدور: يسري على المتاجر المعيّن فيها؛ تغييره يغيّر الشاشات المتاحة.",
      "تسجيل الخروج من كل الأجهزة: يبطل جلسات الحساب المقصود ويحتاج صلاحية إدارة الموظفين؛ لا يحذف طلباته السابقة ولا يغيّر دوره."
    ],
    "tips": [
      "الحماية تمنع إزالة آخر مدير للمتجر أو تعطيل تعيينك الإداري على نحو غير مسموح. اطلب من مدير آخر تنفيذ التغيير الذي لا يسمح به حسابك.",
      "Super Admin دور محمي ولا يُعيّن لموظف متجر.",
      "إجراءات الحسابات والمتاجر تتقيد بحدود صلاحية المنفذ. آخر مدير وصلاحية إدارة الموظفين وحساب Super Admin لها حماية خاصة."
    ],
    "examples": [
      "دعوة موظف موجود لمتجر جديد لا تستخدم لإعادة تعيين بريده أو كلمة مروره."
    ],
    "troubleshooting": [
      "إزالة المدير مرفوضة: راجع حماية آخر مدير وحدود المنفذ، ووفّر مديرًا مخولًا قبل التغيير."
    ]
  },
  {
    "id": "roles",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "الأدوار وتعديل الصلاحيات",
    "paths": [
      "/admin/access/roles",
      "/admin/access/roles/new",
      "/admin/access/roles/:roleId"
    ],
    "paragraphs": [
      "الدور مجموعة صلاحيات تستخدمها حسابات متعددة. حفظ تغيير الدور يؤثر على كل موظف يحمل هذا الدور في نطاق تعيينه."
    ],
    "steps": [
      "افتح الأدوار وراجع هل الدور نظامي أو مخصص وقابلًا للتعيين.",
      "أنشئ دورًا مخصصًا أو افتح دورًا قابلًا للتعديل، وأدخل الاسم والوصف حيث يسمح النموذج.",
      "حدد صلاحيات الشاشات والإجراءات اللازمة فقط، ثم احفظ وراجع الأثر على حساب الموظف.",
      "قبل حذف دور أعد تعيين الموظفين المرتبطين به إذا طلب النظام ذلك."
    ],
    "fields": [
      "الدور النظامي: اسمه ثابت، ويمكن تعديل الوصف والصلاحيات للأدوار المسموحة.",
      "Super Admin: مقفول ولا يُعدّل من هنا.",
      "صلاحية الشاشة: تتحكم في ظهورها وفتح رابطها؛ صلاحية الوحدة العامة وحدها لا تضمن الوصول لكل شاشة.",
      "دور مخصص بلا صلاحيات: حفظ قائمة فارغة يعني عدم منح الصلاحيات، وليس الرجوع تلقائيًا إلى صلاحيات النظام."
    ],
    "tips": [
      "بعد تخصيص صلاحيات الدور يعتمد الوصول على اختياراته المحفوظة؛ راجع العرض والتعديل كلًا على حدة.",
      "لا تمنح إدارة موظفين أو تعديل أسعار أو استردادًا ماليًا لمجرد الحاجة لعرض القائمة.",
      "تحديث صلاحيات دور معدل يعتمد على اختياراته المحفوظة. راجع صلاحية الشاشة وصلاحية الإجراء، ثم تجربة فتح مسموحة وأخرى مرفوضة."
    ],
    "examples": [
      "صلاحية عرض المدفوعات يمكن منحها دون صلاحية الاسترداد؛ راجع الإجراءات المالية منفصلة."
    ],
    "troubleshooting": [
      "الدور محفوظ لكن الشاشة مفقودة: راجع مفتاح الشاشة المحدد والمتجر والجلسة؛ الوحدة العامة لا تكفي."
    ]
  },
  {
    "id": "permissions",
    "group": "settings",
    "group_title": "الإعدادات والصلاحيات",
    "title": "كتالوج الصلاحيات",
    "paths": [
      "/admin/access/permissions"
    ],
    "paragraphs": [
      "يعرض مفاتيح الصلاحيات ووصفها وتجميعها وعلامات الحساسية للمراجعة. لا يغير صلاحيات الموظفين مباشرة."
    ],
    "steps": [
      "ابحث بمفتاح الصلاحية أو الوصف المتاح للوصول لصلاحية الشاشة أو الإجراء.",
      "راجع المجموعة وعلامة حساس لفهم أثر منحها.",
      "انتقل للأدوار وحدد الصلاحية هناك، ثم عيّن الدور للموظف من شاشته."
    ],
    "fields": [
      "مفتاح الصلاحية: الاسم التقني الذي يظهر في الكتالوج للربط والمراجعة.",
      "حساس: تنبيه لطبيعة الإجراء عند عرضها، وليس منعًا آليًا لمن يملكها."
    ],
    "tips": [
      "هذه شاشة قراءة فقط؛ لا يوجد حفظ لتعديل تعريف الصلاحية من الكتالوج."
    ],
    "examples": [
      "مفتاح orders.create يتيح إنشاء طلب، بينما reports.staff_sales.view يخص تقرير مدخلي الطلبات."
    ],
    "troubleshooting": [
      "وجود المفتاح في الكتالوج لا يمنحه للحساب؛ أضفه للدور المناسب وفق الصلاحية المسموحة."
    ]
  },
  {
    "id": "platform-stores",
    "group": "platform",
    "group_title": "إدارة المنصة",
    "title": "متاجر المنصة وتفاصيل المتجر",
    "paths": [
      "/platform/stores",
      "/platform/stores/:id"
    ],
    "paragraphs": [
      "هذه الشاشات لمسؤولي المنصة المخولين، وتختلف عن تشغيل متجر واحد. تعرض هوية المتاجر وحالتها وإحصاءاتها وروابط التهيئة والدخول والإدارة."
    ],
    "steps": [
      "ابحث بالاسم أو الرمز أو النطاق، وصفِّ بالحالة عند الحاجة.",
      "افتح تفاصيل المتجر لمراجعة الهوية والحالة والإحصاءات والأقسام الإدارية المتاحة.",
      "استخدم دخول المتجر لتبديل السياق، وراجع اسم المتجر أعلى اللوحة بعد التبديل.",
      "لأي تعديل أو تعطيل اقرأ نطاق الإجراء وتأكيده؛ افتح جاهزية الإطلاق قبل تفعيل متجر غير جاهز."
    ],
    "fields": [
      "الحالة: جاهزية أو نشاط المتجر وفق نظام المنصة.",
      "الإحصاءات: مؤشرات المتجر المعروضة، وليست بديلًا عن تقاريره التفصيلية.",
      "دخول المتجر: تبديل سياق إلى بيانات هذا المتجر، ولا ينسخ بياناته."
    ],
    "tips": [
      "هذه الصلاحيات أوسع من صلاحيات موظف متجر؛ عدم ظهورها لحساب موظف أمر متوقع."
    ],
    "examples": [
      "دخول متجر من المنصة يبدّل السياق؛ راجع اسمه قبل تعديل كتالوجه أو إعداداته."
    ],
    "troubleshooting": [
      "متجر غير جاهز: افتح الجاهزية واقرأ الحواجز بدل تفعيل إعدادات عشوائية."
    ]
  },
  {
    "id": "platform-create",
    "group": "platform",
    "group_title": "إدارة المنصة",
    "title": "إنشاء متجر جديد ومراجعة المعاينة",
    "paths": [
      "/platform/stores/create"
    ],
    "paragraphs": [
      "ينشئ مسار الإنشاء متجرًا بهوية وإعدادات تأسيسية من اختيارك أو من قالب آمن، مع مراجعة البيانات والتحذيرات قبل التنفيذ."
    ],
    "steps": [
      "أدخل الهوية والرمز والدولة والتوطين والبيانات التي تطلبها الخطوات.",
      "اختر القالب أو الأقسام الآمنة المتاحة، وحدد إعداد الوصول وفق النموذج.",
      "نفّذ المعاينة وراجع الأخطاء الحاجزة والتحذيرات قبل إنشاء المتجر.",
      "صحح الحقول ثم أكد الإنشاء مرة واحدة، وانتظر النتيجة وافتح تهيئة الإطلاق."
    ],
    "fields": [
      "الرمز: معرّف المتجر ويخضع للتحقق من التفرد.",
      "القالب: إعدادات تأسيسية محددة، وليس نسخة من بيانات عملاء متجر آخر.",
      "المعاينة: تعرض ما سيتم إنشاؤه والتحذيرات قبل التنفيذ."
    ],
    "tips": [
      "الإنشاء لا يعني الإطلاق للعملاء فورًا؛ أكمل فحوصات الجاهزية والربط والنطاقات قبل الإطلاق."
    ],
    "examples": [
      "عاين إنشاء متجر بهوية جديدة ثم راجع الجاهزية قبل تشغيله للعملاء."
    ],
    "troubleshooting": [
      "الإنشاء رُفض: صحح حقول الهوية والتفرد والحواجز الظاهرة ثم أعد المعاينة."
    ]
  },
  {
    "id": "platform-edit",
    "group": "platform",
    "group_title": "إدارة المنصة",
    "title": "تعديل هوية متجر من المنصة",
    "paths": [
      "/platform/stores/:id/edit"
    ],
    "paragraphs": [
      "تتيح لمسؤول المنصة تعديل هوية المتجر والتوطين والبيانات القانونية التي يعرضها النموذج."
    ],
    "steps": [
      "افتح المتجر الصحيح من القائمة وراجع الاسم والرمز قبل التعديل.",
      "عدّل الحقول المسموحة للهوية والدولة واللغة والعملة والمنطقة الزمنية والبيانات القانونية.",
      "احفظ وانتظر رسالة النجاح، ثم راجع التفاصيل وفحوصات الجاهزية إن تغيرت بيانات مؤثرة."
    ],
    "fields": [
      "الهوية: بيانات تعريف المتجر وإظهاره في المنصة.",
      "التوطين: اللغة والعملة والتوقيت حسب حقول النموذج."
    ],
    "tips": [
      "تعديل اسم أو توقيت لا يعيد حساب الطلبات القديمة. النطاقات لها شاشة إدارة وفحص مستقلة."
    ],
    "examples": [
      "تغيير اسم المتجر يختلف عن تعيين نطاق رئيسي أو نسخ بيانات متجر آخر."
    ],
    "troubleshooting": [
      "حقل غير قابل للتعديل: التزم بالحقول التي يعرضها النموذج وصلاحيات المنصة."
    ]
  },
  {
    "id": "platform-readiness",
    "group": "platform",
    "group_title": "إدارة المنصة",
    "title": "تهيئة المتجر وجاهزية الإطلاق",
    "paths": [
      "/platform/stores/:id/onboarding",
      "/platform/stores/:id/readiness"
    ],
    "paragraphs": [
      "قائمة فحوصات توضح ما يمنع إطلاق المتجر وما يحتاج متابعة، مع روابط إصلاح للمكونات التي تملك صلاحيتها."
    ],
    "steps": [
      "افتح تهيئة المتجر واضغط تحديث القائمة لقراءة الحالة الحالية.",
      "راجع الحواجز أولًا وافتح رابط إصلاح كل بند، ثم احفظ التعديل في شاشته.",
      "ارجع للجاهزية وحدّث الفحوصات؛ التحذير يختلف عن بند حاجز يمنع الإطلاق.",
      "عند اجتياز كل الحواجز راجع الإعداد النهائي ثم استخدم إطلاق المتجر إذا كان هذا قصدك وصلاحيتك تسمح."
    ],
    "fields": [
      "الحواجز: متطلبات لا يمكن الإطلاق قبل حلها.",
      "التحذيرات: ملاحظات متابعة تختلف عن المنع الإلزامي.",
      "متدهور: متجر نشط لم يعد يحقق بعض متطلبات الجاهزية ويحتاج إصلاحًا."
    ],
    "tips": [
      "تعطيل المتجر يحافظ على البيانات لكنه يمنع إتاحته وفق النظام. اقرأ التأكيد ولا تستخدمه كوسيلة لتحديث الفحوصات."
    ],
    "examples": [
      "تصحيح بوابة دفع في شاشتها يحتاج تحديث فحص الجاهزية لقراءة النتيجة الجديدة."
    ],
    "troubleshooting": [
      "حاجز ما زال ظاهرًا: اقرأ الفحص المحدد وأعد تحميله بعد حفظ الإصلاح؛ وجود تحذير يختلف عن حاجز."
    ]
  },
  {
    "id": "platform-domains",
    "group": "platform",
    "group_title": "إدارة المنصة",
    "title": "نطاقات المتجر والتحقق وSSL",
    "paths": [
      "/platform/stores/:id/domains"
    ],
    "paragraphs": [
      "تربط النطاق أو النطاق الفرعي بالمتجر، وتعرض التحقق من الملكية والتوجيه وشهادة SSL قبل الاعتماد عليه."
    ],
    "steps": [
      "أضف النوع واسم المضيف أو النطاق الفرعي والحالة والتحويل للرئيسي عند الحاجة.",
      "احفظ وافتح تعليمات التحقق؛ انسخ سجل التحقق المطلوب لمسؤول DNS ونفّذه كما هو.",
      "بعد انتشار DNS استخدم تحقق الملكية ثم فحص التوجيه وفحص SSL كلًا على حدة.",
      "عيّن النطاق رئيسيًا فقط عند جاهزيته، واختبر فتحه وتحويلاته.",
      "لتغيير رمز التحقق أو حذف نطاق اقرأ أثر الإجراء أولًا ثم راجع بقية الفحوصات."
    ],
    "fields": [
      "الملكية: إثبات التحكم في النطاق، لا يساوي صحة توجيهه.",
      "التوجيه: وصول النطاق إلى الخدمة الصحيحة.",
      "SSL: صلاحية الاتصال الآمن والشهادة.",
      "الرئيسي: النطاق المعتمد الذي قد تتحول إليه النطاقات الأخرى."
    ],
    "tips": [
      "حفظ النطاق داخل اللوحة لا يغيّر DNS عند مزوده تلقائيًا، وفحوصات DNS قد تنتظر انتشار التغيير."
    ],
    "examples": [
      "نطاق له إثبات ملكية قد يظل بلا توجيه أو SSL صحيح؛ راجع الفحوصات الثلاثة."
    ],
    "troubleshooting": [
      "النطاق لا يفتح: راجع تعليمات DNS والتوجيه والشهادة مع مسؤول النطاق وانتشار التعديل."
    ]
  },
  {
    "id": "store-templates",
    "group": "platform",
    "group_title": "إدارة المنصة",
    "title": "قوالب إعداد المتاجر وإنشاء قالب",
    "paths": [
      "/platform/store-templates",
      "/platform/store-templates/:id",
      "/platform/store-templates/create"
    ],
    "paragraphs": [
      "القالب ملف إعداد قابل لإعادة الاستخدام عند إنشاء متاجر جديدة، ويحتوي الأقسام الآمنة التي تختارها دون البيانات التشغيلية أو الأسرار."
    ],
    "steps": [
      "راجع القوالب الحالية وافتح التفاصيل لمعرفة الدولة والنوع والأقسام.",
      "لإنشاء قالب اختر اسمًا ووصفًا ومتجر المصدر ثم الأقسام الآمنة المطلوب تصديرها.",
      "احفظ وراجع القالب، ثم استخدم إنشاء متجر منه عند الحاجة.",
      "لحذف قالب مخصص راجع التأكيد؛ حذف القالب لا يغيّر المتاجر التي أُنشئت منه سابقًا."
    ],
    "fields": [
      "النظامي والمخصص: يوضح مصدر القالب وإجراءات إدارته المتاحة.",
      "الأقسام: الإعدادات الآمنة المشمولة فقط.",
      "المصدر: متجر تُقرأ منه إعدادات القالب، وليس كل محتواه التشغيلي."
    ],
    "tips": [
      "لا تُنسخ العملاء أو الطلبات أو المدفوعات أو المحافظ أو الموظفون أو النطاقات أو الأسرار ضمن هذا المسار."
    ],
    "examples": [
      "قالب إعدادات شحن وتوطين لا يحمل طلبات أو أرصدة أو أسرار متجر المصدر."
    ],
    "troubleshooting": [
      "قسم متوقع غير موجود: راجع الأقسام الآمنة المدعومة والمختارة في القالب."
    ]
  },
  {
    "id": "store-clone",
    "group": "platform",
    "group_title": "إدارة المنصة",
    "title": "استنساخ إعداد متجر مع معاينة",
    "paths": [
      "/platform/stores/:id/clone"
    ],
    "paragraphs": [
      "ينشئ متجرًا جديدًا غير نشط من أقسام إعداد آمنة في متجر مصدر، دون نسخ نشاط العملاء والمبيعات."
    ],
    "steps": [
      "افتح استنساخ إعداد المتجر من المصدر الصحيح وراجع نطاق النسخ الموضح.",
      "أدخل هوية المتجر الجديد وإعداد الوصول واختر الأقسام المتاحة.",
      "نفّذ معاينة الاستنساخ وراجع أعداد السجلات والأخطاء الحاجزة والتحذيرات.",
      "صحح البيانات ثم أكد إنشاء النسخة مرة واحدة وانتظر النتيجة، وبعدها أكمل التهيئة قبل الإطلاق."
    ],
    "fields": [
      "المصدر والهدف: متجران مختلفان؛ النسخ ينشئ هدفًا جديدًا غير نشط.",
      "المعاينة: فحص لما سيُنسخ قبل الإنشاء.",
      "الاستثناءات: العملاء والطلبات والمدفوعات والمحافظ والموظفون والنطاقات والأسرار والبيانات التشغيلية لا تُنسخ."
    ],
    "tips": [
      "الاستنساخ ليس نقلًا لمبيعات متجر إلى آخر، ولا يفعّل بوابات حية تلقائيًا."
    ],
    "examples": [
      "نسخة إعداد متجر تبدأ غير نشطة وتحتاج مراجعة، ولا تمثل نقل مبيعات أو عملاء المصدر."
    ],
    "troubleshooting": [
      "النسخة لم تُطلق: أكمل فحوصات الجاهزية والربط الخاص بها قبل استخدامها."
    ]
  },
  {
    "id": "troubleshooting",
    "group": "start",
    "group_title": "البداية واستخدام اللوحة",
    "title": "حل المشكلات الشائعة والتحقق من النتيجة",
    "paths": [],
    "paragraphs": [
      "ابدأ دائمًا بالمتجر والفلاتر والصلاحيات ورسالة الخطأ، ثم راجع السجل الأصلي أو شاشة المتابعة المناسبة."
    ],
    "steps": [
      "شاشة لا تظهر: راجع تعيين الموظف للمتجر وصلاحية الشاشة نفسها في الدور، ثم تحديث الجلسة عند الحاجة.",
      "سجل مفقود: امسح البحث والفلاتر وراجع الصفحات وحالة الحذف إن كانت الشاشة تدعمها.",
      "خصم لا يظهر: راجع التوقيت والتفعيل والمنتجات المحددة ونوع العرض؛ كوبون السلة مختلف عن عرض سعر المنتج المؤقت.",
      "سعر شحن خاطئ: راجع الطريقة ومعرّفات الدولة والمدينة والمنطقة والشروط والمجانية، ثم أولوية المنطقة فالمدينة فالدولة.",
      "مبلغ لوحة التحكم مختلف: وحّد الفترة والمنطقة الزمنية والعملة وتعريف الرقم، ثم راجع النظرة المالية والدفع أو المرتجع.",
      "رسالة لم تصل: راجع جاهزية القناة وسجل عمليات الإرسال، لا مجرد نجاح حفظ القالب.",
      "مزامنة متأخرة: راجع صحة الطابور وآخر نشاط والسجلات قبل إعادة المحاولة أو تسجيل الانقطاع."
    ],
    "fields": [
      "حفظ مرفوض: اقرأ أخطاء الحقول؛ التاريخ أو التكرار أو علاقة غير صالحة أو صلاحية ناقصة قد تمنع العملية.",
      "القائمة فارغة: قد تكون نتيجة فلتر، وليست دليلًا على حذف البيانات.",
      "النجاح: رسالة نجاح مع نتيجة ظاهرة أو سجل محدث، وليس الضغط وحده."
    ],
    "tips": [
      "عند طلب دعم أرسل اسم الشاشة والمتجر ومرجع السجل والخطوات ورسالة الخطأ، دون كلمات مرور أو مفاتيح أو أكواد تحقق."
    ],
    "examples": [
      "سلة منذ نصف ساعة لا تظهر: فلتر يوم بدون نشاط يخفيها؛ اختر أي نشاط في المتجر الصحيح."
    ],
    "troubleshooting": [
      "لو استمرت المشكلة، أرسل اسم المتجر والشاشة ومرجع السجل والوقت والخطأ والخطوات التي جربتها، دون بيانات دخول."
    ]
  }
]
