🏢 MWHEBA ERP - نظام إدارة الموارد المؤسسية

نظام إدارة موارد مؤسسية شامل ومتطور مبني بـ Django

📖 الدليل • 🚀 التثبيت • 💡 الميزات • 📊 لوحة التحكم • 🤝 المساهمة

---

📋 نظرة عامة

MWHEBA ERP هو نظام إدارة موارد مؤسسية متكامل ومتطور، مصمم خصيصاً للشركات والمؤسسات العربية. يوفر النظام حلولاً شاملة لإدارة جميع جوانب العمل من المحاسبة والمالية إلى إدارة المخزون والمبيعات والتسعير المتقدم.

🎯 الهدف من النظام

• تبسيط العمليات التجارية وأتمتة المهام الروتينية
• توحيد البيانات في نظام واحد متكامل
• تحسين الكفاءة وتقليل الأخطاء البشرية
• توفير تقارير دقيقة لاتخاذ قرارات مدروسة

🏆 ما يميز MWHEBA ERP

• ✅ واجهة عربية كاملة مع دعم RTL
• ✅ نظام محاسبي متقدم مع القيود التلقائية
• ✅ نظام تسعير ذكي للطباعة والنشر
• ✅ إدارة مخزون متطورة مع تتبع الحركات
• ✅ تقارير تفاعلية وإحصائيات مفصلة
• ✅ أمان عالي مع نظام صلاحيات متقدم

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

🏦 النظام المالي والمحاسبي دليل حسابات شامل مع الأرصدة الافتتاحية قيود محاسبية تلقائية لجميع المعاملات تزامن المدفوعات بين الأنظمة المختلفة تقارير مالية متقدمة (ميزان المراجعة، الأرصدة) نظام فترات محاسبية مع إقفال تلقائي تكامل Redis لتحسين الأداء 📦 إدارة المخزون والمنتجات تتبع حركات المخزون بدقة عالية إدارة المخازن المتعددة مع نقل البضائع تصنيفات هرمية للمنتجات تتبع تواريخ الانتهاء والدفعات تقارير مخزون شاملة مع التنبيهات باركود ورموز QR للمنتجات

🛒 المبيعات والمشتريات فواتير مبيعات ومشتريات احترافية إدارة العملاء والموردين مع كشوف الحسابات نظام خصومات متقدم وشروط دفع مرنة تتبع المدفوعات والمتأخرات تقارير مبيعات تفصيلية حسب الفترة والعميل إشعارات تلقائية للمتابعة 💰 نظام التسعير الذكي حاسبة تسعير متقدمة للطباعة والنشر دعم الطباعة الأوفست والرقمية مع حسابات دقيقة إدارة الموردين المتخصصين وخدماتهم مقارنة الأسعار التلقائية عروض أسعار احترافية قابلة للتخصيص تتبع تكاليف المواد والخدمات

🎨 واجهة المستخدم والتجربة

• تصميم عربي متجاوب مع دعم RTL كامل
• لوحة تحكم تفاعلية مع إحصائيات مباشرة
• نظام إشعارات متقدم مع تنبيهات ذكية
• جداول بيانات قوية مع تصدير Excel/PDF
• نظام بحث وفلترة متطور
• ألوان وأيقونات متسقة ومهنية

🔐 الأمان والصلاحيات

• نظام مستخدمين متقدم مع أدوار مخصصة
• صلاحيات مفصلة لكل وظيفة
• تسجيل العمليات (Audit Log) الشامل
• حماية CSRF وأمان Django المتقدم
• نسخ احتياطية تلقائية للبيانات الحساسة
• تشفير كلمات المرور وحماية الجلسات

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

📋 المتطلبات الأساسية

• Python 3.8+ (يُفضل 3.11)
• Django 4.2+
• SQLite (افتراضي) أو PostgreSQL 12+
• Redis (اختياري - لتحسين الأداء)
• Git لاستنساخ المشروع

⚡ الإعداد السريع (موصى به)

🔧 للتطوير والاختبار

# 1. استنساخ المشروع
git clone https://github.com/MWHEBA/mwheba_erp.git
cd mwheba_erp

# 2. إنشاء البيئة الافتراضية
python -m venv venv
source venv/bin/activate  # Linux/Mac
# أو
venv\Scripts\activate  # Windows

# 3. تثبيت المتطلبات
pip install -r requirements.txt

# 4. الإعداد التلقائي مع البيانات التجريبية
python setup_development.py

# 5. تشغيل الخادم
python manage.py runserver

🏭 للإنتاج

# نفس الخطوات 1-3 أعلاه، ثم:

# 4. إعداد متغيرات البيئة
cp .env.example .env
# عدّل ملف .env بالقيم المناسبة

# 5. الإعداد للإنتاج (بدون بيانات تجريبية)
python manage.py migrate
python manage.py collectstatic
python manage.py createsuperuser

# 6. تشغيل مع Gunicorn
gunicorn mwheba_erp.wsgi:application

👤 بيانات الدخول التجريبية

المستخدم	كلمة المرور	الصلاحيات
mwheba	mwheba123	مدير النظام
accountant	acc123	محاسب
inventory	inv123	مدير مخزون
sales	sales123	مندوب مبيعات

📊 لوحة التحكم والواجهات

🎛️ لوحة التحكم الرئيسية

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

🗂️ الواجهات المتخصصة

• واجهة المحاسب: تركز على القيود والتقارير المالية
• واجهة مدير المخزون: تتبع المخزون والحركات
• واجهة المبيعات: إدارة العملاء والفواتير
• واجهة الإدارة: تقارير شاملة وإعدادات النظام

🏗️ هيكل المشروع

mwheba_erp/
├── 🏢 core/                    # النواة الأساسية للنظام
├── 👥 users/                   # إدارة المستخدمين والصلاحيات
├── 🏦 financial/               # النظام المالي والمحاسبي
│   ├── models/                 # نماذج البيانات المالية
│   ├── services/               # خدمات الحسابات والتقارير
│   └── signals/                # إشارات التكامل التلقائي
├── 📦 product/                 # إدارة المنتجات والمخزون
├── 💰 pricing/                 # نظام التسعير الذكي
├── 🛒 sale/                    # إدارة المبيعات
├── 🛍️ purchase/               # إدارة المشتريات
├── 👤 client/                  # إدارة العملاء
├── 🏪 supplier/                # إدارة الموردين
├── 🔧 services/                # الخدمات المتخصصة
├── 🛠️ utils/                   # أدوات مساعدة
├── 🌐 api/                     # واجهات برمجة التطبيقات
├── 📄 templates/               # قوالب HTML
│   ├── base.html              # القالب الأساسي
│   ├── components/            # مكونات قابلة للإعادة
│   └── partials/              # أجزاء مشتركة
├── 🎨 static/                  # الملفات الثابتة
│   ├── css/                   # ملفات التنسيق
│   ├── js/                    # ملفات JavaScript
│   ├── img/                   # الصور والأيقونات
│   └── fonts/                 # الخطوط العربية
├── 📋 requirements.txt         # متطلبات Python
├── ⚙️ setup_development.py    # سكريبت الإعداد التلقائي
└── 📖 README.md               # هذا الملف

🔧 التطبيقات والوحدات

🏢 التطبيقات الأساسية core - النواة والإعدادات المشتركة users - المستخدمين والصلاحيات financial - النظام المالي والمحاسبي product - المنتجات والمخزون pricing - نظام التسعير المتقدم 🛒 تطبيقات العمليات sale - المبيعات والفواتير purchase - المشتريات وأوامر الشراء client - إدارة العملاء supplier - إدارة الموردين services - الخدمات المتخصصة

🛠️ التطبيقات المساعدة utils - أدوات وخدمات مشتركة api - واجهات برمجة التطبيقات templates - قوالب HTML المشتركة static - الملفات الثابتة والأصول 📊 الميزات المتقدمة Redis Integration - تحسين الأداء Audit Logging - تسجيل العمليات Signal System - التكامل التلقائي REST APIs - واجهات برمجية Advanced Reporting - تقارير متطورة

🚀 الدليل السريع

🎯 البدء السريع

# استنساخ وتشغيل في 3 خطوات
git clone https://github.com/MWHEBA/mwheba_erp.git
cd mwheba_erp && python -m venv venv && venv\Scripts\activate
pip install -r requirements.txt && python setup_development.py

🔗 الروابط المهمة

الصفحة	الرابط	الوصف
🏠 الرئيسية	http://127.0.0.1:8000/	لوحة التحكم الرئيسية
🏦 المالية	/financial/	النظام المالي والمحاسبي
📦 المخزون	/product/	إدارة المنتجات والمخزون
💰 التسعير	/pricing/	نظام التسعير الذكي
🛒 المبيعات	/sale/	إدارة المبيعات والفواتير
🛍️ المشتريات	/purchase/	إدارة المشتريات
⚙️ الإدارة	/admin/	لوحة إدارة Django

📱 الوصول السريع

• الويب: http://127.0.0.1:8000
• API: http://127.0.0.1:8000/api/
• الوثائق: http://127.0.0.1:8000/docs/

🤝 المساهمة والتطوير

🔧 للمطورين

# إعداد بيئة التطوير
git clone https://github.com/MWHEBA/mwheba_erp.git
cd mwheba_erp
python -m venv venv
source venv/bin/activate  # Linux/Mac
pip install -r requirements.txt
python setup_development.py

# تشغيل الاختبارات
python manage.py test

# إنشاء migration جديد
python manage.py makemigrations

# تطبيق التغييرات
python manage.py migrate

📋 إرشادات المساهمة

1. Fork المشروع من GitHub
2. إنشاء فرع جديد: git checkout -b feature/amazing-feature
3. تطوير الميزة مع كتابة الاختبارات
4. Commit: git commit -m 'إضافة ميزة رائعة'
5. Push: git push origin feature/amazing-feature
6. إنشاء Pull Request مع وصف مفصل

🎨 معايير الكود

• PEP 8 لتنسيق Python
• تعليقات عربية في الكود
• اختبارات شاملة لكل ميزة جديدة
• توثيق واضح للدوال والكلاسات

📞 الدعم والمساعدة

🆘 الحصول على المساعدة

• 📧 البريد الإلكتروني: info@mwheba.com
• 💬 المناقشات: GitHub Discussions
• 🐛 الأخطاء: GitHub Issues
• 📖 الوثائق: Wiki

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

المشكلة	الحل
خطأ في قاعدة البيانات	python manage.py migrate
مشاكل الصلاحيات	python manage.py collectstatic
خطأ في البيانات	python setup_development.py
مشاكل Redis	تحقق من تشغيل Redis أو استخدم LocMem

📄 الترخيص والحقوق

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

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

• Django Community - للإطار الرائع
• Bootstrap Team - للتصميم المتجاوب
• المساهمين - لجهودهم في التطوير
• المستخدمين - لملاحظاتهم القيمة

---

💖 دعم المشروع

MWHEBA ERP مشروع مفتوح المصدر مجاني، ودعمكم يساعدنا في الاستمرار والتطوير!

🌟 طرق الدعم

• ⭐ نجمة على GitHub - أسهل طريقة للدعم
• 💰 GitHub Sponsors - دعم مالي شهري أو لمرة واحدة
• 🐛 الإبلاغ عن الأخطاء - ساعدنا في تحسين النظام
• 💡 اقتراح الميزات - شاركنا أفكارك الرائعة
• 📝 المساهمة في الكود - انضم لفريق التطوير

🏆 شكر خاص للداعمين

كن أول داعم واحصل على مكان مميز هنا!

---

⭐ إذا أعجبك المشروع، لا تنس إعطاؤه نجمة على GitHub! ⭐

صُنع بـ ❤️ في مصر | Made with ❤️ in Egypt