RockDeals - نظام إدارة المبيعات ونقاط البيع

نظرة عامة

RockDeals هو نظام شامل لإدارة المبيعات ونقاط البيع (POS) مصمم خصيصاً للشركات والمتاجر التي تحتاج إلى حل متكامل لإدارة عملياتها التجارية. يتميز النظام بواجهة مستخدم حديثة وجذابة، ووظائف متقدمة لإدارة المبيعات والمخزون والعملاء.

الميزات الرئيسية

🎯 لوحة التحكم التفاعلية

• إحصائيات شاملة للمبيعات والطلبات والزوار
• رسوم بيانية تفاعلية لتتبع الأداء
• مؤشرات الأداء الرئيسية (KPIs) مع نسب التغيير
• تحليل عادات العملاء ونموهم الجغرافي

💰 نظام نقاط البيع (POS) المتقدم

• واجهة كاشير سهلة الاستخدام
• البحث السريع بالاسم أو الباركود
• إدارة السلة مع تعديل الكميات
• حساب الضرائب والخصومات تلقائياً
• طرق دفع متعددة (نقدي، بطاقة ائتمان)
• حساب الباقي للدفع النقدي
• طباعة الفواتير والإيصالات

📊 إدارة المنتجات والمخزون

• إضافة وتعديل المنتجات
• تتبع المخزون في الوقت الفعلي
• تصنيف المنتجات حسب الفئات
• إدارة الموردين والأسعار
• تقارير المخزون المنخفض

👥 إدارة العملاء

• قاعدة بيانات شاملة للعملاء
• تتبع تاريخ المشتريات
• برامج الولاء والخصومات
• تحليل سلوك العملاء

📈 التقارير والتحليلات

• تقارير المبيعات اليومية والشهرية والسنوية
• تحليل الأداء حسب المنتج والفئة
• تقارير الربحية والخسائر
• إحصائيات العملاء والزوار

🎨 التصميم والواجهة

• تصميم حديث وأنيق بألوان RockDeals المميزة
• واجهة مستخدم متجاوبة تعمل على جميع الأجهزة
• دعم الوضع الداكن والفاتح
• أيقونات واضحة ومفهومة
• تجربة مستخدم محسّنة

التقنيات المستخدمة

الواجهة الأمامية (Frontend)

• React 19.1.0 - مكتبة JavaScript لبناء واجهات المستخدم
• Vite - أداة بناء سريعة ومحسّنة
• Tailwind CSS - إطار عمل CSS للتصميم السريع
• Lucide React - مكتبة أيقونات حديثة
• React Router - للتنقل بين الصفحات

الواجهة الخلفية (Backend)

• Flask - إطار عمل Python للتطبيقات الويب
• SQLAlchemy - ORM لإدارة قاعدة البيانات
• SQLite - قاعدة بيانات خفيفة وسريعة
• Flask-CORS - لدعم طلبات CORS

قاعدة البيانات

• SQLite مع الجداول التالية:
  • Users (المستخدمين)
  • Products (المنتجات)
  • Categories (الفئات)
  • Customers (العملاء)
  • Sales (المبيعات)
  • SaleItems (عناصر المبيعات)
  • Suppliers (الموردين)
  • Inventory (المخزون)

متطلبات النظام

الحد الأدنى

• نظام التشغيل: Windows 10, macOS 10.15, Ubuntu 18.04 أو أحدث
• المعالج: Intel Core i3 أو AMD Ryzen 3
• الذاكرة: 4 GB RAM
• التخزين: 2 GB مساحة فارغة
• المتصفح: Chrome 90+, Firefox 88+, Safari 14+, Edge 90+

الموصى به

• المعالج: Intel Core i5 أو AMD Ryzen 5 أو أحدث
• الذاكرة: 8 GB RAM أو أكثر
• التخزين: 5 GB مساحة فارغة
• الاتصال: اتصال إنترنت مستقر

التثبيت والإعداد

1. تثبيت المتطلبات الأساسية

# تثبيت Node.js (الإصدار 18 أو أحدث)
# تثبيت Python (الإصدار 3.8 أو أحدث)
# تثبيت Git

2. تحميل المشروع

git clone https://github.com/your-repo/rockdeals.git
cd rockdeals

3. إعداد الواجهة الخلفية

cd rockdeals_backend
python -m venv venv
source venv/bin/activate  # على Windows: venv\Scripts\activate
pip install -r requirements.txt
python src/app.py

4. إعداد الواجهة الأمامية

cd rockdeals_frontend
npm install
npm run dev

5. الوصول للنظام

• الواجهة الأمامية: http://localhost:5174
• الواجهة الخلفية: http://localhost:5000

دليل الاستخدام

تسجيل الدخول

1. افتح المتصفح وانتقل إلى http://localhost:5174
2. استخدم بيانات الدخول الافتراضية:
   • اسم المستخدم: admin
   • كلمة المرور: admin123

استخدام نظام الكاشير

1. انقر على "POS" في القائمة الجانبية
2. ابحث عن المنتجات باستخدام الاسم أو الباركود
3. انقر على المنتج لإضافته للسلة
4. اختر طريقة الدفع وأدخل المبلغ
5. انقر على "Process Sale" لإتمام البيع

إدارة المنتجات

1. انقر على "Product" في القائمة الجانبية
2. استخدم الأزرار لإضافة أو تعديل أو حذف المنتجات
3. تتبع مستويات المخزون والتنبيهات

عرض التقارير

1. انقر على "Dashboard" لعرض الإحصائيات العامة
2. انقر على "Report" لعرض التقارير المفصلة
3. استخدم الفلاتر لتخصيص التقارير

الأمان

حماية البيانات

• تشفير كلمات المرور باستخدام bcrypt
• جلسات آمنة مع انتهاء صلاحية تلقائي
• حماية من هجمات CSRF و XSS
• نسخ احتياطية تلقائية لقاعدة البيانات

صلاحيات المستخدمين

• مدير النظام: وصول كامل لجميع الميزات
• مدير المتجر: إدارة المنتجات والعملاء والتقارير
• كاشير: استخدام نظام POS فقط

الدعم والصيانة

النسخ الاحتياطية

• نسخ احتياطية يومية تلقائية
• إمكانية الاستعادة السريعة
• تخزين آمن للبيانات

التحديثات

• تحديثات أمنية منتظمة
• ميزات جديدة كل شهر
• دعم فني مستمر

استكشاف الأخطاء

• سجلات مفصلة للأخطاء
• أدوات تشخيص مدمجة
• دليل استكشاف الأخطاء

الترخيص

هذا المشروع مرخص تحت رخصة MIT. راجع ملف LICENSE للمزيد من التفاصيل.

التواصل والدعم

• البريد الإلكتروني: [email protected]
• الهاتف: +20 1093741039
• الموقع الإلكتروني: https://www.rockdeals.com
• الدعم الفني: https://support.rockdeals.com

المساهمة في المشروع

نرحب بمساهماتكم في تطوير RockDeals! يرجى قراءة دليل المساهمة قبل إرسال طلبات السحب.

الشكر والتقدير

شكر خاص لجميع المطورين والمصممين الذين ساهموا في إنجاح هذا المشروع.

---

© 2025 RockDeals. Ahmed Hajjaj official جميع الحقوق محفوظة.