https://github.com/9de/expense-tracking-system

نظام تتبع المصاريف هو تطبيق ويب بسيط ولكنه قوي يتيح للمستخدمين تتبع مصاريفهم اليومية وإدارة ميزانيتهم الشخصية.
https://github.com/9de/expense-tracking-system

Last synced: about 1 year ago
JSON representation

نظام تتبع المصاريف هو تطبيق ويب بسيط ولكنه قوي يتيح للمستخدمين تتبع مصاريفهم اليومية وإدارة ميزانيتهم الشخصية.

• Host: GitHub
• URL: https://github.com/9de/expense-tracking-system
• Owner: 9de
• License: mit
• Created: 2025-03-21T11:37:08.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-21T11:43:52.000Z (about 1 year ago)
• Last Synced: 2025-03-21T12:42:29.734Z (about 1 year ago)
• Language: JavaScript
• Homepage: https://9de.github.io/Expense-Tracking-System/
• Size: 16.6 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# نظام تتبع المصاريف (Expense Tracking System)

## نظرة عامة (Overview)

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

### لماذا هذا التطبيق؟

- **تنظيم المالية الشخصية**: تعقب جميع نفقاتك في مكان واحد بطريقة منظمة

- **الوعي المالي**: فهم أنماط الإنفاق الخاصة بك وتحديد مجالات التوفير المحتملة

- **سهولة الاستخدام**: واجهة بسيطة وبديهية تجعل تتبع المصاريف عملية سهلة وسريعة

- **خصوصية البيانات**: جميع البيانات تُخزن محليًا على جهازك، مما يضمن خصوصية معلوماتك المالية

## المميزات (Features)

### ✅ إدارة الراتب

- تسجيل الراتب الشهري وتحديثه بسهولة

- عرض ملخص واضح للراتب والإنفاق والمتبقي

- تتبع نسبة الإنفاق من الراتب بشكل مرئي

### ✅ تسجيل المصاريف

- إضافة مصاريف جديدة مع تفاصيل شاملة

- تصنيف المصاريف حسب فئات متعددة (طعام، مواصلات، تسوق، إلخ)

- تسجيل بيانات إضافية مثل اسم التاجر والتاريخ والملاحظات

### ✅ التحليل المالي

- عرض إحصائيات فورية عن عدد المصروفات ومتوسطها وأعلاها

- رسم بياني تفاعلي يوضح توزيع المصاريف حسب التصنيف

- تتبع اتجاهات الإنفاق مع مرور الوقت

### ✅ البحث والتصفية المتقدمة

- تصفية المصاريف حسب التصنيف أو الفترة الزمنية

- عرض نتائج البحث في جدول منظم

- إعادة ضبط معايير البحث بنقرة واحدة

### ✅ إدارة البيانات

- تصدير جميع المصاريف أو نتائج البحث المحددة إلى ملف Excel

- حفظ البيانات تلقائيًا في التخزين المحلي للمتصفح

- استرجاع البيانات عند إعادة فتح التطبيق

### ✅ تخصيص واجهة المستخدم

- التبديل بين الوضع الفاتح والوضع الداكن

- واجهة مستجيبة تعمل على جميع أحجام الشاشات

## التقنيات المستخدمة (Technologies Used)

- **HTML5** - لهيكلة صفحة الويب

- **CSS3** - للتصميم والتنسيق وتأثيرات واجهة المستخدم

- **JavaScript (Vanilla)** - للوظائف التفاعلية وإدارة البيانات

- **[Chart.js](https://www.chartjs.org/)** (v3.9.1) - لإنشاء وعرض الرسوم البيانية التفاعلية

- **[SheetJS (xlsx)](https://sheetjs.com/)** (v0.18.5) - لتصدير البيانات إلى تنسيق Excel

- **[FileSaver.js](https://github.com/eligrey/FileSaver.js)** (v2.0.5) - لحفظ الملفات المُصدّرة

## متطلبات التشغيل (Requirements)

- متصفح ويب حديث (Chrome, Firefox, Safari, Edge)

- اتصال بالإنترنت لتحميل المكتبات من CDN (مطلوب فقط عند تحميل الصفحة لأول مرة)

- 5 ميجابايت من مساحة التخزين المحلي (كحد أدنى)

## كيفية الاستخدام (How to Use)

### 1. التثبيت والإعداد

```bash

# استنساخ المستودع

git clone https://github.com/9de/Expense-Tracking-System.git

# الانتقال إلى مجلد المشروع

cd expense-tracker

# فتح التطبيق في المتصفح

open index.html  # على macOS

# أو

start index.html  # على Windows

```

### 2. دليل الاستخدام السريع

1. **إعداد الراتب**: أدخل راتبك الشهري في قسم "إدارة الراتب" واضغط على "حفظ الراتب"

2. **إضافة مصروف**:

   - اختر التصنيف المناسب

   - أدخل اسم التاجر والمبلغ والتاريخ

   - أضف ملاحظات اختيارية إذا رغبت

   - انقر على "إضافة مصروف"

3. **عرض البيانات وتحليلها**:

   - راجع الملخص المالي والإحصائيات المعروضة تلقائيًا

   - استكشف الرسم البياني لفهم نمط إنفاقك

4. **البحث والتصدير**:

   - استخدم قسم الاستعلام للبحث عن مصاريف محددة

   - انقر على "تصدير إلى Excel" لتنزيل البيانات

## هيكل الملفات (File Structure)

```

Expense-Tracking-System/

├── index.html       # الصفحة الرئيسية للتطبيق

├── styles.css       # ملف التنسيق والمظهر العام

├── script.js        # كود JavaScript لتشغيل وظائف التطبيق

├── images/          # مجلد الصور والأيقونات (اختياري)

├── LICENSE          # ملف ترخيص المشروع

└── README.md        # توثيق المشروع (هذا الملف)

```

## آلية تخزين البيانات (Data Storage)

يستخدم التطبيق تقنية `localStorage` المدمجة في المتصفح لتخزين البيانات، مما يوفر:

- **الاستمرارية**: البيانات تبقى محفوظة حتى بعد إغلاق المتصفح أو إعادة تشغيل الجهاز

- **الخصوصية**: لا يتم نقل أو تخزين البيانات على أي خادم خارجي

- **السرعة**: الوصول الفوري للبيانات دون الحاجة لاتصال إنترنت

> ⚠️ **ملاحظة**: يُنصح بعمل نسخة احتياطية من البيانات دوريًا عن طريق تصديرها إلى ملف Excel، حيث أن حذف بيانات التصفح أو إعادة تثبيت المتصفح قد يؤدي إلى فقدان البيانات المخزنة.

## التخصيص (Customization)

### تعديل التصنيفات

لإضافة أو تعديل تصنيفات المصاريف، قم بتحرير الخيارات في ملف `index.html`:

```html

    اختر تصنيف

    طعام

    

    اسم التصنيف الجديد

```

### تغيير ألوان الواجهة

لتعديل ألوان التطبيق، قم بتغيير متغيرات CSS في بداية ملف `styles.css`:

```css

:root {

    --primary-color: #3498db;

    --secondary-color: #2ecc71;

    /* قم بتعديل الألوان هنا */

}

```

## حل المشكلات الشائعة (Troubleshooting)

| المشكلة | الحل المحتمل |

|---------|--------------|

| لا يتم حفظ البيانات | تأكد من تفعيل JavaScript وعدم حظر التخزين المحلي في إعدادات المتصفح |

| عدم ظهور الرسم البياني | تحقق من اتصال الإنترنت لتحميل مكتبة Chart.js |

| خطأ عند التصدير إلى Excel | تأكد من وجود بيانات للتصدير وتحميل مكتبات SheetJS وFileSaver |

| مشاكل في العرض | جرّب تحديث الصفحة أو استخدام متصفح آخر |

## التطوير المستقبلي (Future Development)

- [ ] إضافة دعم للعملات المتعددة

- [ ] إمكانية إنشاء حسابات متعددة (شخصي، عائلي، عمل)

- [ ] عرض تقارير ورسوم بيانية شهرية وسنوية

- [ ] إضافة إشعارات للميزانية والمدفوعات المتكررة

- [ ] تطوير نسخة تطبيق للهواتف الذكية

## المساهمة (Contributing)

نرحب بمساهماتكم في تطوير هذا المشروع! لإضافة ميزات جديدة أو إصلاح الأخطاء:

1. قم بعمل Fork للمستودع

2. أنشئ فرع جديد (`git checkout -b feature/amazing-feature`)

3. قم بعمل Commit للتغييرات (`git commit -m 'إضافة ميزة رائعة'`)

4. ادفع التغييرات إلى الفرع (`git push origin feature/amazing-feature`)

5. افتح طلب Pull Request

## الترخيص (License)

هذا المشروع مرخص بموجب [ترخيص MIT](https://opensource.org/licenses/MIT) - راجع ملف LICENSE للمزيد من التفاصيل.

## شكر وتقدير (Acknowledgments)

- [Chart.js](https://www.chartjs.org/) لتوفير مكتبة الرسوم البيانية سهلة الاستخدام

- [SheetJS](https://sheetjs.com/) لتسهيل تصدير البيانات إلى Excel

- [cdnjs](https://cdnjs.com/) لاستضافة المكتبات المستخدمة

---



  
تم تطويره بواسطة [تركي] © 2025

  
⭐ لا تنسَ إعطاء نجمة للمشروع إذا أعجبك! ⭐