Skip to content

labeebnaji/modular-erp-system-PySide6-and-PostgreSQL

Repository files navigation

🏢 (ERP System)

View

نظام إدارة شامل ومتكامل للمؤسسات والشركات

Python PySide6 SQLAlchemy PostgreSQL

العربية | English


📋 نظرة عامة

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

🎥 استعراض النظام

Fiscal Period

ملاحظة: هذا الفيديو يعرض جزءاً بسيطاً من إمكانيات النظام الواسعة


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

🎯 معمارية وحدات متقدمة

النظام مبني على أساس وحدات معمارية (Modular Architecture) يوفر:

  • الاستقلالية: كل موديول مستقل تماماً ويمكن تطويره وصيانته بشكل منفصل
  • قابلية التوسع: إضافة موديولات جديدة دون التأثير على الموديولات الموجودة
  • سهولة الصيانة: تحديث أو إصلاح موديول معين دون الحاجة لإيقاف النظام بالكامل
  • إعادة الاستخدام: استخدام نفس الموديول في مشاريع مختلفة
  • التطوير المتوازي: فرق متعددة يمكنها العمل على موديولات مختلفة في نفس الوقت

🔧 الموديولات المتاحة

1️⃣ موديول إدارة العملاء (Customer Module)

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

2️⃣ موديول إدارة الموردين (Supplier Module)

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

3️⃣ موديول المخزون (Inventory Module)

  • إدارة المخزون بالوقت الفعلي
  • تتبع حركة المواد والمنتجات
  • نقل المخزون بين الفروع
  • تقارير المخزون التفصيلية
  • تنبيهات إعادة الطلب التلقائية

4️⃣ موديول المبيعات والمشتريات (Sales & Purchase Module)

  • إدارة أوامر البيع والشراء
  • إصدار الفواتير والعروض
  • تتبع حالة الطلبات
  • إدارة المرتجعات والخصومات

5️⃣ موديول الإعدادات (Settings Module)

  • إدارة الشركات والفروع
  • إعدادات العملات وأسعار الصرف
  • طرق الدفع المتعددة
  • إعدادات برامج الولاء
  • تخصيص واجهة المستخدم

6️⃣ موديول التقارير المالية (Financial Reports)

  • الميزانية العمومية (Balance Sheet)
  • قائمة الدخل (Income Statement)
  • قائمة التدفقات النقدية (Cash Flow Statement)
  • ميزان المراجعة (Trial Balance)
  • التقارير الضريبية

7️⃣ موديول الإدارة العامة (Application Module)

  • إدارة الحسابات المحاسبية
  • إدارة الفترات المالية
  • اليوميات والقيود المحاسبية
  • إدارة الموظفين والرواتب
  • إدارة الأصول الثابتة

Fiscal Period


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

1. PySide6 (Qt for Python) 6.7.2

لماذا PySide6؟

  • واجهات احترافية: إنشاء واجهات مستخدم عصرية وجذابة
  • متعدد المنصات: يعمل على Windows, Linux, macOS بنفس الكود
  • أداء عالي: مبني على Qt C++ Framework الشهير
  • دعم RTL كامل: دعم ممتاز للغة العربية والكتابة من اليمين لليسار
  • مكونات غنية: مجموعة واسعة من الأدوات والمكونات الجاهزة
  • قابلية التخصيص: تصميم واجهات مخصصة بالكامل باستخدام QSS (Qt Style Sheets)

2. Python 3.10+

لماذا Python؟

  • سهولة التطوير: بناء جملة واضح وسهل القراءة يسرع عملية التطوير
  • مكتبات غنية: نظام بيئي ضخم من المكتبات الجاهزة
  • متعدد الاستخدامات: مناسب لتطبيقات سطح المكتب والويب والذكاء الاصطناعي
  • مجتمع نشط: دعم مستمر وتحديثات منتظمة
  • أداء ممتاز: خاصة مع المكتبات المحسّنة مثل SQLAlchemy

3. SQLAlchemy 2.0.31

لماذا SQLAlchemy؟

  • ORM قوي: تعامل مع قواعد البيانات كأنها كائنات Python
  • استقلالية قاعدة البيانات: التبديل بين PostgreSQL, MySQL, SQLite بسهولة
  • أمان عالي: حماية تلقائية من SQL Injection
  • أداء محسّن: استعلامات فعالة وإدارة ذكية للاتصالات
  • علاقات معقدة: إدارة سهلة للعلاقات بين الجداول (One-to-Many, Many-to-Many)

4. PostgreSQL

لماذا PostgreSQL؟

  • موثوقية عالية: قاعدة بيانات مفتوحة المصدر وموثوقة للغاية
  • أداء ممتاز: معالجة سريعة للاستعلامات المعقدة
  • دعم JSON: تخزين واستعلام البيانات شبه المهيكلة
  • ACID Compliance: ضمان سلامة البيانات في جميع الأوقات
  • قابلية التوسع: يدعم قواعد بيانات ضخمة ومعاملات متزامنة

5. Werkzeug 3.0.1

لماذا Werkzeug؟

  • أدوات مساعدة: مجموعة من الأدوات المفيدة لتطوير التطبيقات
  • أمان البيانات: تشفير كلمات المرور وإدارة الجلسات
  • معالجة الطلبات: أدوات فعالة لمعالجة البيانات والطلبات

🏗️ المعمارية والتصميم

Domain-Driven Design (DDD)

النظام يتبع مبادئ التصميم الموجه بالنطاق:

  • فصل الطبقات: UI, Business Logic, Data Access منفصلة تماماً
  • Models غنية: كائنات تحتوي على منطق الأعمال
  • Repository Pattern: طبقة وسيطة للوصول للبيانات

Clean Architecture

  • الاستقلالية: كل طبقة مستقلة عن الأخرى
  • قابلية الاختبار: سهولة كتابة اختبارات الوحدة
  • المرونة: تغيير التقنيات دون التأثير على منطق الأعمال

📦 التثبيت والتشغيل

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

Python 3.10 أو أحدث
PostgreSQL 12 أو أحدث

خطوات التثبيت

  1. استنساخ المشروع
git clone https://github.com/labeebnaji/Erp-System.git
cd erp-system
  1. إنشاء بيئة افتراضية
python -m venv venv
source venv/bin/activate  # على Linux/Mac
venv\Scripts\activate     # على Windows
  1. تثبيت المتطلبات
pip install -r requirements.txt
  1. إعداد قاعدة البيانات
  • قم بإنشاء قاعدة بيانات PostgreSQL جديدة
  • قم بتحديث إعدادات الاتصال في ملف الإعدادات
  1. تشغيل النظام
python main.py

🎨 لقطات الشاشة

View

إعدادات النظام

System Settings

تفاصيل الفترة المالية

Fiscal Period


🔐 ملاحظة هامة

⚠️ النسخة المتاحة هنا تحتوي على الموديولات الأساسية فقط

موديول نقاط البيع (POS Module) ومعظم الموديولات الأخرى غير مضمن في هذه النسخة المجانية

💼 للحصول على النظام الكامل مع بقية الموديولات :

📧 البريد الإلكتروني: labeebderhem@gmail.com

🔗 GitHub: @labeebnaji


🌍 دعم اللغات

النظام يدعم حالياً:

  • 🇸🇦 العربية (كامل)
  • 🇬🇧 الإنجليزية (بشكل شبه كامل)

مع إمكانية إضافة لغات جديدة بسهولة من خلال نظام الترجمة المدمج.


📝 الترخيص

هذه النسخة متاحة للاستخدام الشخصي والتعليمي. للاستخدام التجاري، يرجى التواصل معي.


👨‍💻 المطور

Labeeb Naji


🤝 المساهمة

المساهمات مرحب بها! إذا كنت ترغب في المساهمة:

  1. Fork المشروع
  2. أنشئ فرع للميزة الجديدة (git checkout -b feature/AmazingFeature)
  3. Commit التغييرات (git commit -m 'Add some AmazingFeature')
  4. Push للفرع (git push origin feature/AmazingFeature)
  5. افتح Pull Request

📞 الدعم

إذا واجهت أي مشاكل أو لديك استفسارات:



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

About

A comprehensive modular ERP system built with PySide6, and PostgreSQL. Features inventory, sales, purchases, financial reports, and full Arabic/English support.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages