ريان - التوثيق الرسمي
نظام متجر إلكتروني متكامل مبني لرفع كفاءة عمليات البيع عبر الإنترنت وداخل الفروع، مع إدارة دقيقة لكل تفاصيل التجارة الإلكترونية.
PWA (تطبيق الويب التقدمي)
يدعم التثبيت على الجوال كأيقونة تطبيق وتصفح أسرع وإشعارات فورية.
SPA (صفحة واحدة)
يعتمد على Vue.js لضمان انتقال فوري بين الصفحات دون انتظار التحميل.
نقطة بيع (POS)
واجهة مخصصة للكاشير مرتبطة لحظياً بالمخزون والمبيعات المركزية.
🏗️ البنية التقنية (Technology Stack)
تم بناء ريشة شوب باستخدام أقوى التقنيات الحديثة لضمان الاستقرار والأداء العالي.
🛡️ معايير الأمان والحماية المتقدمة
نظام محمي بأعلى معايير البرمجة الآمنة لضمان سلامة بياناتك وبيانات عملائك:
تشفير البيانات الحساسة
جميع كلمات المرور يتم تشفيرها باستخدام خوارزميات Bcrypt القوية. كما يتم حماية بيانات الجلسات وتشفير الكوكيز لضمان عدم التلاعب بها.
الحماية من الهجمات الشائعة
يتضمن النظام دروعاً برمجية مدمجة ضد هجمات SQL Injection و XSS و CSRF، مما يجعل اختراق قاعدة البيانات أو تزييف الطلبات أمراً شبه مستحيل.
بروتوكول HTTPS و API Security
تم تصميم الواجهات البرمجية (APIs) لتكون متوافقة مع بروتوكولات الأمان SSL/TLS، مع استخدام JWT للتحقق من هوية المستخدمين.
📊 لوحة التحكم والتحليلات
لوحة تحكم مركزية تمنحك نظرة شاملة على أداء متجرك في مكان واحد.
متابعة إجمالي المبيعات، الطلبات، المنتجات، والعملاء من الشاشة الرئيسية.
عرض عدد الطلبات الجديدة والمبيعات اليومية لتكون دائماً على اطلاع.
إشعارات فورية بالمنتجات التي أوشكت على النفاد لاتخاذ إجراء سريع.
🛒 نظام نقطة البيع (POS)
حول أي جهاز إلى كاشير ذكي بلمسات بسيطة.
- البحث الذكي: اعثر على المنتجات بالباركود أو الاسم بلمح البصر.
- إدارة الزبائن: أربط كل عملية بيع بعميل مسجل مسبقاً لمتابعة ولائه.
- تعدد الدفع: اقبل مبالغ كاش، فيزا، أو خصم من المحفظة في نفس الفاتورة.
📦 إدارة المشتريات والمخزون
نظام لإدارة الطلبيات من الموردين، متابعة موازين الموردين، وتسجيل عمليات الشراء.
يتم تحديث الكميات تلقائياً عند استلام المشتريات أو إجراء مبيعات، ما يضمن دقة البيانات.
إمكانية تسجيل المنتجات التالفة لخصمها من المخزون مع ذكر السبب للتدقيق لاحقاً.
👥 الموظفون والصلاحيات
تحكم كامل في فريق عملك مع نظام صلاحيات مرن ودقيق.
إنشاء أدوار وظيفية مثل (كاشير، مدير مستودع) وتحديد ما يسمح لكل دور برؤيته أو القيام به.
ربط كل موظف بفرع معين وضمان عدم تداخل الصلاحيات بين الموظفين.
📢 التسويق وإدارة التنبيهات
أدوات متكاملة لإبقاء عملائك على اطلاع دائم وبناء قاعدة عملاء وفية.
إرسال تنبيهات جماعية
يمكنك إرسال إشعارات فورية عبر نظام Firebase لكافة العملاء دفعة واحدة للإعلان عن تخفيضات أو منتجات جديدة.
إدارة مراجعات العملاء
يسمح النظام للعملاء بتقييم المنتجات وكتابة آرائهم، مع إمكانية مراجعتها قبل ظهورها للعامة.
التواصل الاجتماعي
ربط حسابات متجرك على منصات التواصل لتظهر روابطها في تذييل الموقع، مما يسهل على العملاء متابعتك.
📊 تقارير المبيعات
النظام مزود بلوحة تحكم تحليلية تساعدك على فهم أداء عملك:
لمتابعة النمو المالي الأسبوعي والشهري وتحديد أيام الذروة.
عرض تفصيلي لعدد الطلبات المكتملة، الملغاة، والمرتجعة.
نظرة سريعة على إجمالي المنتجات والعملاء المسجلين في النظام.
قائمة بأفضل المنتجات التي تحقق أعلى مبيعات في متجرك.
💰 المدفوعات والمحفظة (Wallet)
نظام مالي مرن يدعم جميع طرق الدفع الحديثة.
💳 بوابات الدفع
يدعم النظام الربط المباشر مع بوابات الدفع العالمية والمحلية الرائدة: (Stripe, PayPal, PayTabs, Moyasar). توفر هذه البوابات خيارات دفع متنوعة تشمل بطاقات الائتمان (Visa/MasterCard)، ومدى (Mada)، و STC Pay، بالإضافة إلى Apple Pay، مما يوفر للعملاء مرونة وأماناً فائقاً عند إتمام عمليات الشراء.
🧪 بيانات تجربة الدفع (Test Cards)
لتجربة عملية الدفع والتأكد من إعدادات البوابات بشكل صحيح قبل الإطلاق الرسمي، يمكنك استخدام البيانات التالية في بيئة الاختبار (Test Mode):
| نوع البطاقة | رقم البطاقة | CVC | التاريخ |
|---|---|---|---|
| بطاقة مدى (Mada) | 4201 3201 1111 1010 | 123 | تاريخ مستقبلي |
| بطاقة Stripe | 4242 4242 4242 4242 | أي 3 أرقام | تاريخ مستقبلي |
* لبطاقة مدى، يمكنك استخدام أي اسم عند الطلب.
👛 محفظة العميل
تعمل المحفظة كأداة لإدارة المبالغ المسترجعة؛ ففي حال إلغاء طلب أو إرجاع منتجات، يتم إيداع القيمة المالية مباشرة في محفظة العميل. يمكن للعميل استخدام هذا الرصيد كطريقة دفع في طلباته القادمة. تنبيـه: لا يدعم التطبيق شحن رصيد المحفظة بمبالغ مالية مسبقة، بل تعتمد فقط على عمليات الارتجاع.
سجل العمليات: يمكن للعميل والمدير الاطلاع على سجل كامل لعمليات المحفظة (إيداع/سحب) لضمان الدقة المالية والشفافية التامة.
👥 إدارة العملاء والمدراء (مصفوفة الصلاحيات)
تحكم كامل في قاعدة البيانات البشرية لمتجرك مع تحديد دقيق للأدوار.
نظام الصلاحيات (Roles Matrix)
يمكنك إنشاء أدوار مخصصة (مثل: كاشير، مدير مستودع، محاسب) وتحديد صفحات وأزرار معينة لهم فقط. هذا يضمن أن الموظف يرى فقط ما يحتاج إليه لإتمام عمله، مع حماية البيانات الحساسة.
- العملاء: متابعة طلبات كل عميل، رصيده، ومراجعاته، مع إمكانية حظر العملاء المزعجين.
- المدراء والموظفون: إضافة حسابات للموظفين مع ربطهم بأدوارهم المحددة.
🎁 العروض والترويج
أدوات قوية لزيادة المبيعات وتحفيز المشترين.
🎟️ الكوبونات
أنشئ كود خصم بنسبة مئوية أو مبلغ ثابت، مع تحديد حد أدنى للطلب وتاريخ انتهاء.
قيود الاستخدام: يمكنك تحديد عدد مرات استخدام الكوبون للعميل الواحد أو إجمالي عدد المرات، مما يمنحك تحكماً كاملاً في ميزانية حملاتك التسويقية.
🔥 فلاش سيل
عروض محدودة بوقت محدد تظهر في الصفحة الرئيسية مع عداد تنازلي.
🏷️ أقسام المنتجات
أنشئ أقساماً ترويجية (مثل: "وصل حديثاً" أو "الأكثر مبيعاً") لتبرزها في متجرك.
📱 ميزة الطلب عبر الواتساب (WhatsApp Ordering)
يوفر ريشة شوب تكاملاً ذكياً مع تطبيق الواتساب لتسهيل عملية الشراء وزيادة التفاعل مع العملاء.
كيف تعمل هذه الميزة؟
تتيح ميزة WhatsApp Ordering للعملاء إرسال تفاصيل طلباتهم مباشرة إلى رقم الواتساب الخاص بالمتجر. بعد قيام العميل بتأكيد طلبه على الموقع، يظهر له خيار "المتابعة عبر واتساب" (إذا تم تفعيل هذه الميزة)، وهو ما يقوم بفتح تطبيق الواتساب برسالة مجهزة تحتوي على ملخص احترافي للطلب (رقم الطلب، المنتجات، الأسعار، وعنوان التوصيل) لتسهيل التواصل المباشر مع التاجر.
فوائد الطلب عبر الواتساب:
- تأكيد فوري: يحصل التاجر على تفاصيل الطلب كاملة في محادثة الواتساب فور إتمام العميل للطلب.
- تواصل مباشر: تمنح العميل فرصة للتنسيق حول موعد التوصيل أو الاستفسار عن تفاصيل إضافية.
- توثيق الطلب: تضمن وصول نسخة من ملخص الطلب للعميل وللتاجر في تطبيق المراسلة الأكثر استخداماً.
🏢 إعدادات العمل (Business Setup)
يوفر نظام ريشة شوب واجهة إدارية شاملة تسمى "الإعدادات" (Settings)، وهي المركز الرئيسي الذي يمكنك من خلاله ضبط كافة تفاصيل هويتك التجارية وعملياتك التشغيلية.
إعدادات الهوية والمنصة
- الشركة (Company): ضبط الاسم، العنوان، الشعار (Logo)، والبيانات الضريبية الأساسية.
- الموقع (Site): تخصيص إعدادات الواجهة الأمامية، وصف الموقع، والأيقونة المصغرة (Favicon).
- المظهر (Theme): التحكم في ألوان المتجر والهوية البصرية.
- السلايدر (Sliders): إدارة الصور الإعلانية المتحركة في الصفحة الرئيسية.
- الصفحات (Pages): إنشاء وتعديل الصفحات التعريفية (مثل سياسة الخصوصية).
إعدادات المنتجات والتوريد
- التصنيفات (Categories): تنظيم المنتجات في مجموعات هرمية.
- السمات (Attributes): ضبط مقاسات وألوان وخيارات المنتجات.
- العلامات التجارية (Brands): ربط المنتجات بالشركات المصنعة.
- الموردون (Suppliers): إدارة بيانات الشركات التي تورّد لك البضائع.
- الوحدات (Units): تحديد وحدات القياس (كيلو، قطعة، إلخ).
إعدادات التشغيل واللوجستيات
- الشحن (Shipping): ضبط مناطق الشحن وأسعار التوصيل.
- الفروع (Outlets): إدارة مواقع التسليم ونقاط البيع المختلفة.
- المرتجعات (Returns): تحديد أسباب الإرجاع المسموح بها.
- أرصدة المزايا (Benefits): إدارة المزايا التي يحصل عليها العملاء.
الإعدادات التقنية والبوابات
- بوابات الدفع: ضبط Stripe, PayPal, PayTabs, Moyasar.
- بوابات الرسائل (SMS): ربط خدمة إرسال رسائل التحقق للتسجيل.
- التنبيهات (Notifications): تخصيص رسائل التنبيه والبريد (Mail).
- الأمان والربط: إعدادات OTP، ملفات تعريف الارتباط (Cookies)، والتحليلات (Analytics).
⚙️ الإعدادات المتقدمة
إنشاء فئات ضريبية مخصصة وربطها بالمنتجات ليقوم النظام بحساب الضريبة تلقائياً عند الدفع النهائي.
🔄 دورة حياة الطلب
كيف ينتقل الطلب من "قيد الانتظار" إلى "تم التسليم" مع تتبع كامل لكل مرحلة:
🚚 تتبع الطلبات والتنبيهات (Order Tracking & Notifications)
اجعل عملاءك على اطلاع دائم بكل خطوة من خلال ميزة تتبع الطلبات والتنبيهات اللحظية، مما يعزز الشفافية ويبني الثقة.
تتبع الطلب لحظياً
يمكن للعميل الدخول إلى "طلباتي" لمتابعة حالة طلبه الحالية (قيد الانتظار، تم التأكيد، تم الشحن، إلخ) ومعرفة التوقيت المتوقع لكل مرحلة.
إشعارات فورية
يصل العميل إشعار فوري (عبر البريد الإلكتروني أو إشعارات الجوال) عند حدوث أي تغيير في حالة طلبه، مما يضمن بقاءه متصلاً بالمتجر دون الحاجة للمتابعة اليدوية.
📱 تطبيق الويب (PWA) وتحسين محركات البحث (SEO)
تم تصميم ريشة شوب ليكون صديقاً لمحركات البحث ومتوافقاً مع معايير الويب الحديثة، مما يضمن لك وصولاً أوسع لعملائك.
تطبيق PWA والسرعة
يمكن للمستخدمين إضافة المتجر إلى شاشتهم الرئيسية كأنه تطبيق جوال. يتميز بسرعة فائقة بفضل تقنية الـ Caching المتطورة، مما يسمح بتصفح المنتجات حتى في حالات ضعف الاتصال.
تحسين SEO والأرشفة
يدعم النظام توليد تلقائي للـ Meta Tags والـ Sitemaps. كما يستخدم هيكلية JSON-LD
لمساعدة محركات البحث في فهم تفاصيل منتجاتك وأسعارها وتقييماتها بشكل احترافي.
🔗 إعدادات Firebase للإشعارات
لتفعيل الإشعارات الفورية على الجوال، يتطلب النظام ربطه بـ Google Firebase لضمان وصول التنبيهات في لمح البصر:
service-account-file.json الخاص بصلاحيات الإرسال.
4. أدخل هذه البيانات في لوحة التحكم (الإعدادات > إشعارات Firebase).
🚚 خيارات الشحن وتكلفة التوصيل
النظام يدعم إعدادات شحن مرنة لتناسب احتياجاتك:
إمكانية تحديد تسعيرة شحن مختلفة لكل منطقة جغرافية لضمان دقة التكاليف.
تقديم عرض الشحن المجاني للعملاء كجزء من الحملات الترويجية.
يمكن للعميل متابعة مراحل طلبه مباشرة من حسابه الشخصي في المتجر.
🎨 تخصيص المظهر، الخطوط، والهوية البصرية
تحكم مطلق في شكل متجرك ليعكس هوية علامتك التجارية بأفضل صورة ممكنة.
الألوان والخطوط
اختر ألوانك التجارية من لوحة الألوان وسيتم تطبيقها على كامل المتجر. كما يمكنك اختيار خطوط Cairo أو Inter أو أي خط من مكتبة Google Fonts بضغطة زر.
الشعار والأيقونات (Logo & Favicon)
ارفع شعار متجرك بأحجام مختلفة (للصفحة الرئيسية، الفاتورة، والبريد الإلكتروني). كما يدعم المتجر رفع الـ Favicon التي تظهر في لسان المتصفح لتعزيز احترافية علامتك.
💻 متطلبات السيرفر (Server Requirements)
لضمان تشغيل ريشة شوب بأفضل أداء واستقرار، يجب أن توفر بيئة الاستضافة المتطلبات التالية:
- PHP Version: الإصدار 8.3 (مطلوب لضمان التوافق والأمان).
- MySQL Version: الإصدار 8.0 (مطلوب لمعالجة البيانات الضخمة والبحث السريع).
- Memory Limit: يفضل 512M كحد أدنى لضمان سرعة معالجة الصور الكبيرة.
- Extensions: BCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML, GD (ضرورية لمعالجة الصور وتوليد الباركود).
- Web Server: Nginx أو Apache مع تفعيل موديول
mod_rewriteالضروري للروابط الصديقة.
🛠️ استكشاف الأخطاء وإصلاحها (Troubleshooting Specialist)
في حال واجهت بعض التحديات التقنية، اتبع هذه الحلول المتقدمة:
أخطاء التحميل (Assets 404)
إذا ظهر الموقع بدون تنسيق CSS، تأكد من تنفيذ php artisan storage:link وتأكد من أن
رابط الموقع في ملف .env يطابق الرابط الحقيقي تماماً.
الشاشة البيضاء (Internal Server Error)
قم بالتحقق من مجلد storage/logs لمعرفة الخطأ بالتفصيل. غالباً ما يكون السبب هو نقص
صلاحيات المجلدات أو إصدار PHP غير متوافق.
- تحديث الإعدادات: عند تغيير ملف
.env، شغّلphp artisan optimize:clearلمسح كافة أنواع الكاش دفعة واحدة. - مشاكل الدخول (Login Issues): تأكد من عدم وجود مسافات فارغة في ملف
.envخاصة حول كلمات مرور قاعدة البيانات.
💾 النسخ الاحتياطي والصيانة الدورية
حماية بياناتك هي مسؤوليتك الأولى، اتبع هذا الجدول الزمني للصيانة:
| المهمة | التكرار |
|---|---|
| نسخ قاعدة البيانات (SQL) | يومياً |
| نسخ صور المنتجات (Storage) | أسبوعياً |
| مسح الكاش والملفات المؤقتة | شهرياً |
🚀 دليل التنصيب والتثبيت الشامل
اتبع هذه الخطوات الاحترافية لرفع متجرك للعالم:
1. تجهيز الملفات
ارفع الملفات لمجلد public_html. تأكد من إظهار الملفات المخفية (مثل .htaccess)
لأنها ضرورية لعمل الروابط.
2. إنشاء قاعدة البيانات
من لوحة تحكم الاستضافة (مثل cPanel)، قم بإنشاء قاعدة بيانات MySQL جديدة، وقم بإنشاء مستخدم بصلاحيات كاملة عليها. ستحتاج لاسم القاعدة، المستخدم، وكلمة المرور في مرحلة التثبيت عبر المتصفح.
3. بناء مجلد المكتبات (Vendor) - الخطوة الأهم
الخيار المفضل: عبر SSH نفذ:
الخيار البديل: بناء المجلد محلياً على جهازك ورفعه عبر FTP (يستغرق وقتاً أطول ولكنه مضمون لمن لا يمتلك SSH).
4. التثبيت عبر المتصفح
توجه إلى yourdomain.com/install واتبع التعليمات. سيطلب منك النظام بيانات قاعدة البيانات التي
أنشأتها، وسيقوم تلقائيًا بإنشاء الجداول اللازمة وإعداد حساب المدير الأول.
5. تأمين المتجر بعد التثبيت
- احذف مجلد
install(إذا لم يتم حذفه تلقائياً). - تأكد من أن ملف
.envغير قابل للوصول من المتصفح. - قم بتغيير كلمة مرور قاعدة البيانات بشكل دوري.
❓ الأسئلة الشائعة (FAQ) - إجابات تفصيلية
من لوحة التحكم، توجه إلى الإعدادات > الفروع (Outlets)، قم بإضافة اسم الفرع، العنوان، ورقم الهاتف. سيظهر هذا الفرع تلقائياً للكاشير عند تسجيل الدخول ليتمكن من اختيار الفرع الذي يعمل منه.
نعم، من قسم الرسائل في الإعدادات يمكنك تفعيل "الطلب عبر واتساب" وإضافة الرقم المخصص. سيظهر زر "المتابعة عبر واتساب" للعملاء في مرحلة الدفع أو بعد تأكيد الطلب بنجاح، ليتمكنوا من إرسال ملخص الطلب إليك.
تأكد من تنفيذ الأمر php artisan storage:link. إذا كنت على استضافة مشتركة لا تدعم
SSH، يمكنك إنشاء ملف PHP بسيط يحتوي على الكود Artisan::call('storage:link');
وتشغيله من المتصفح لمرة واحدة مرّة.
توجه إلى الإعدادات > العملات. يمكنك إضافة عملات غير محدودة وتحديد العملة الافتراضية. تأكد من إدخال "سعر الصرف" (Exchange Rate) بالنسبة لعملتك الأساسية ليقوم النظام بتحويل الأسعار آلياً.
يمكنك استخدام خاصية "نسيت كلمة المرور" في صفحة تسجيل الدخول (في حال إعداد SMTP بشكل صحيح)، أو
تغييرها مباشرة من قاعدة البيانات في جدول users باستخدام تشفير Bcrypt.
تحقق من إعدادات SMTP في الإعدادات المتقدمة. تأكد من صحة Host، Port، واسم المستخدم وكلمة مرور خادم البريد. نوصي باستخدام خدمات مثل SendGrid أو Mailgun أو Gmail SMTP.
نعم، من لوحة التحكم توفر واجهة سهلة لمسح الكاش، أو عبر الأوامر:
php artisan config:cache و php artisan view:clear.
بدايةً، أنشئ ضريبة في الإعدادات > الضرائب، ثم عند إضافة أو تعديل منتج، اختر الضريبة المناسبة من قائمة الضرائب ليتم حسابها تلقائياً عند الدفع.
على Android: سيظهر شريط في أسفل المتصفح يطلب "إضافة إلى الشاشة الرئيسية". على iOS (Safari): يجب على العميل الضغط على زر "مشاركة" ثم اختيار "إضافة إلى الشاشة الرئيسية" (Add to Home Screen).
نعم، من خلال إعدادات الشحن يمكنك إضافة المناطق والمدن وتحديد تكلفة توصيل خاصة لكل منها، كما يمكنك تفعيل الشحن المجاني لمناطق معينة.
من الإعدادات > العملات، اختر العملة التي تريدها واضغط على زر "تعيين كافتراضية". سيقوم النظام فوراً بتحويل كافة مبالغ المنتجات والتقارير بناءً على سعر الصرف المحدد لهذه العملة.