يخص: الحزمة الكاملة · لوحة الإدارة

لوحة الإدارة

أقسام اللوحة، ومراحل الطلب، والمنتجات بخياراتها، والكوبونات، والأدوار الثلاثة.

اللوحة على /ar/dashboard و/en/dashboard. يدخل الجميع ببريد وكلمة مرور، وتدوم الجلسة 12 ساعة، ويُتحقق منها مقابل قاعدة البيانات في كل طلب، فإيقاف حساب أو تغيير دوره يسري فورًا.

النظرة العامة

تُحسب من طلباتك دون أي أداة تتبع:

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

الطلبات

قائمة بالبحث (الرمز أو الاسم أو الهاتف أو البريد) وتصفية الحالة والصفحات. في كل طلب القطع والإجماليات والعميل والعنوان والدفع، وسجلّ لكل تغيير مع اسم من أجراه وملاحظة اختيارية.

مراحل الطلب:

NEW ──► CONFIRMED ──► PACKED ──► SHIPPED ──► DELIVERED
 │          │            │                      │
 └──────────┴────────────┴──► CANCELLED         └──► REFUNDED (إرجاع)

(جديد ← مؤكد ← مُجهّز ← تم الشحن ← تم التسليم، مع الإلغاء والاسترداد.)

  • طلب البطاقة ينتقل وحده من جديد إلى مدفوع حين تؤكد «ثواني» الدفع، وقبل ذلك لا يملك الموظف إلا إلغاءه.
  • قبل الشحن يُلغى الطلب غير المدفوع ويُسترد الطلب المدفوع.
  • الإلغاء أو الاسترداد يعيد القطع إلى المخزون، والإلغاء يعيد استخدام الكوبون أيضًا.
  • تم التسليم يجعل الطلب النقدي مدفوعًا.
  • لا يمكن تخطي مرحلة، والإلغاء والاسترداد نهائيان. القواعد في src/lib/rules.ts مع اختباراتها.

المنتجات

تعرض القائمة صورة كل منتج وقسمه وسعره ومخزونه الكلي وعدد خياراته. النجمة ومربع الاختيار يغيّران اختيار الفريق والظهور مباشرة (تعديل سريع لا يمس إلا ذلك الحقل).

في نموذج المنتج:

  • الاسم والوصف بالعربية والإنجليزية جنبًا إلى جنب، مع زر اكتب بالذكاء الاصطناعي (الذكاء الاصطناعي)؛
  • السعر وسعر سابق اختياري (فيظهر المنتج في التخفيضات)؛
  • القسم والتشكيلات والظهور واختيار الفريق وترتيب العرض؛
  • الصور: ارفع JPEG أو PNG أو WebP أو AVIF أو GIF حتى 5 ميغابايت (يُتحقق من محتوى الملف لا من اسمه)، واختر الغلاف، واحذف ما لا تريد؛
  • الخيارات: سطر لكل مقاس ولون فيه SKU وعيّنة اللون وسعر خاص اختياري والمخزون. زر أنشئ الأسطر يبني الجدول من قائمة مقاسات وألوان، ويحتفظ بمخزون الأسطر الموجودة.

الأقسام والتشكيلات

الأقسام هي أبواب المتجر الرئيسية، والتشكيلات مجموعات مختارة تظهر في الصفحة الرئيسية. لكلٍّ منها اسم ووصف باللغتين وصورة وترتيب وخيار ظهور، وللتشكيلات أيضًا «في الصفحة الرئيسية». لا يُحذف قسم ما زالت فيه منتجات.

الكوبونات

نسبة مئوية (من 1 إلى 100) أو مبلغ ثابت، وحد أدنى للطلب، وتاريخ انتهاء اختياري (يبقى صالحًا حتى نهاية ذلك اليوم بتوقيت عُمان)، وحد استخدام اختياري، وتفعيل أو إيقاف. تبيّن القائمة عدد مرات استخدام كل رمز مقابل حده. يُحتسب الاستخدام عند تسجيل الطلب ويُعاد عند إلغائه.

العملاء

العملاء أصحاب الحسابات والضيوف، مجمّعين حسب رقم الهاتف، مع عدد طلباتهم ومجموع مشترياتهم وآخر طلب. تبويب الرسائل يعرض ما وصل من صفحة التواصل؛ علّم كل رسالة «تمت المعالجة» بعد الرد عليها.

المساعد الذكي

محادثة حول بيانات متجرك، وثلاثة مؤشرات تعمل دون ذكاء اصطناعي: الأكثر مبيعًا، والإيرادات حسب القسم، والمنتجات المتوفرة التي لم تُبع منذ 90 يومًا. راجع الذكاء الاصطناعي.

المشرفون والأدوار

الدور ما يفتحه افتراضيًا
مالك كل شيء دائمًا، ومنه أدوار المشرفين
مشرف الطلبات والمنتجات والأقسام والتشكيلات والكوبونات والعملاء والمساعد الذكي والإعدادات
موظف الطلبات والمنتجات والعملاء

في صفحة أدوار المشرفين يحدد المالك ما يفتحه المشرفون والموظفون (ثماني صلاحيات، واحدة لكل قسم؛ والنظرة العامة متاحة للجميع). وتتحقق الـ API من الصلاحيات نفسها، فإخفاء عنصر من القائمة ليس الحماية الوحيدة.

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

الإعدادات

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