SpendWise هو برنامج مخصص لإدارة المصاريف و الدخل الشخصي. و يوفر واجهة مستخدم نظيفة و سهلة الاستخدام مع دعم للسمات المتعددة (فاتح/داكن) و دعم متعدد اللغات (الإنجليزية/العربية) و غيرها.
مميزات البرنامج
- إدارة المعاملات المالية: إضافة و تعديل و حذف معاملات الدخل و المصروفات.
- حفظ البيانات محلياً في ملف JSON
- لوحة معلومات و رسوم بيانية توضح توزيع المصاريف حسب الفئة.
- تصفية المعاملات حسب التاريخ و الفئة.
- يدعم الوضع الفاتح و الداكن.
- يدعم اللغتين العربية و الإنجليزية.
- تخصيص العملة المستخدمة في التطبيق.
هيكلة المشروع
التطبيق منظم في عدة مجلدات رئيسية:
- core - يحتوي على نماذج البيانات و إدارة البيانات.
- widgets - يحتوي على مكونات واجهة المستخدم.
- utils - يحتوي على أدوات مساعدة مثل إدارة اللغات و السمات.
- resources - يحتوي على الموارد الثابتة مثل الأيقونات و الترجمات.
التقنيات المستخدمة
- لغة بايثون - الإصدار 3.6 أو أي إصدار أحدث.
- مكتبة PyQt5 - لإنشاء الواجهة الرسومية للبرنامج.
- مكتبة PyQtChart - لإنشاء جداول إحصائية.
طريقة التشغيل
1- قم بتحميل المشروع.
2- فك الضغط عنه.
3- إفتح سطر الأوامر (CMD) و توجه لمسار المشروع.
4- لضمان عدم حدوث تعارض بين المكتبات المثبتة و المكتبات التي يحتاجها المشروع، قم بإنشاء و تفعيل بيئة افتراضية باستخدام الأمر التالي.
python -m venv venv
5- قم بتفعيل البيئة الإفتراضية و هنا عليك استخدام الأمر المناسب لنظام التشغيل الذي تستعلمه أنت.
- في حال كنت تستعمل نظام ويندوز إستخدم الأمر التالي.
venv\Scripts\activate
- في حال كنت تستعمل نظام لينكس/ماك إستخدم الأمر التالي.
source venv/bin/activate
6- قم بتثبيت المكتبات التالية بواسطة مدير الحزم pip باستخدام الأمر التالي.
pip install -r requirements.txt
7- قم بتشغيل المشروع باستخدام الأمر التالي.
python -m spendwise.main
