Skip to content

torxeon/jamiyati

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

جمعيتي - نظام إدارة الجمعيات الخيرية

نظرة عامة

جمعيتي هو نظام إدارة متكامل للجمعيات الخيرية في الأردن، يوفر واجهة سهلة الاستخدام لإدارة المتبرعين والتبرعات والمتطوعين ومراكز الجمعية.

الميزات

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

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

📍 خريطة المراكز التفاعلية

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

👥 إدارة المستخدمين

  • نظام تسجيل دخول آمن
  • إنشاء حسابات جديدة
  • إدارة ملفات المستخدمين

💰 إدارة التبرعات والمالية

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

🤝 إدارة المتطوعين

  • تسجيل المتطوعين الجدد
  • تتبع ساعات التطوع
  • تنظيم الأنشطة والفعاليات

بنية المشروع

jamiyati-app/
├── frontend/
│   ├── index.html              # لوحة التحكم الرئيسية
│   ├── login_register.html     # صفحة تسجيل الدخول والتسجيل
│   ├── center-map.html         # خريطة المراكز
│   ├── demo-index.html         # نسخة تجريبية من لوحة التحكم
│   ├── demo-center-map.html    # نسخة تجريبية من خريطة المراكز
│   ├── css/
│   │   └── style.css           # ملف التنسيقات الرئيسي
│   ├── js/
│   │   └── app.js              # ملف الجافاسكريبت الرئيسي
│   └── assets/
│       ├── logo.svg            # شعار الجمعية
│       ├── logo.png            # شعار الجمعية (PNG)
│       └── jordan-map.svg      # خريطة الأردن
└── README.md                   # هذا الملف

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

  • HTML5 - بناء صفحات الويب
  • CSS3 - التنسيق والتصميم المتجاوب
  • JavaScript (ES6+) - التفاعل والوظائف الديناميكية
  • SVG - الرسوميات المتجهة (الشعار والخريطة)
  • Responsive Design - متوافق مع جميع الأجهزة

كيفية تشغيل المشروع

المتطلبات

  • متصفح ويب حديث (Chrome, Firefox, Safari, Edge)
  • خادم ويب محلي (اختياري للتطوير)

التشغيل المباشر

  1. قم بتنزيل أو استنساخ المشروع
  2. انتقل إلى مجلد jamiyati-app/frontend
  3. افتح أي من الملفات التالية في متصفح الويب:

الصفحات الرئيسية (تتطلب تسجيل دخول):

  • index.html - لوحة التحكم الرئيسية
  • center-map.html - خريطة المراكز
  • login_register.html - تسجيل الدخول

الصفحات التجريبية (بدون تسجيل دخول):

  • demo-index.html - لوحة التحكم التجريبية
  • demo-center-map.html - خريطة المراكز التجريبية

التشغيل باستخدام خادم محلي

# باستخدام Python 3
cd jamiyati-app/frontend
python -m http.server 8000
# أو باستخدام Node.js (إذا كان مثبتاً)
npx http-server -p 8000
# ثم افتح المتصفح على
# http://localhost:8000

النشر على منصة Railway

  1. ثبت Railway CLI
  2. سجل الدخول: railway login
  3. اربط المشروع: railway init يحدد ملفا railway.json وProcfile أمر البدء (npm start) وإعدادات النشر.

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

للاختبار، يمكنك استخدام البيانات التالية: البريد الإلكتروني: [email protected]
كلمة المرور: admin123 أو البريد الإلكتروني: [email protected]
كلمة المرور: user123

الخصائص التقنية

التصميم المتجاوب

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

الأمان

  • تشفير البيانات الحساسة
  • حماية من هجمات CSRF و XSS
  • نظام مصادقة آمن

الأداء

  • تحميل سريع للصفحات
  • تحسين الصور والموارد
  • كود مُحسَّن للأداء

المراكز المتاحة

يحتوي النظام على 5 مراكز موزعة في المملكة الأردنية الهاشمية:

  1. مركز عمان الرئيسي - شارع الملك حسين، عمان
  2. مركز إربد - وسط البلد، إربد
  3. مركز الزرقاء - شارع الحكومة، الزرقاء
  4. مركز الكرك - قلعة الكرك، الكرك
  5. مركز العقبة - كورنيش العقبة، العقبة

التطوير المستقبلي

الميزات المخطط إضافتها:

  • قاعدة بيانات متكاملة
  • تقارير متقدمة وتصدير البيانات
  • نظام إشعارات فوري
  • تطبيق جوال مصاحب
  • دعم متعدد اللغات
  • نظام دردشة مباشر
  • تكامل مع وسائل الدفع الإلكتروني

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

نرحب بمساهماتكم في تطوير المشروع:

  1. قم بعمل Fork للمشروع
  2. أنشئ branch جديد للميزة المطلوبة
  3. قم بإجراء التعديلات المطلوبة
  4. اختبر التعديلات جيداً
  5. قدم Pull Request

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

للحصول على الدعم أو الإبلاغ عن مشاكل:

الترخيص

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

شكر وتقدير

  • شكر خاص لجميع المتطوعين والمساهمين في تطوير هذا المشروع
  • الشكر موصول للجمعيات الخيرية الأردنية التي ألهمت هذا المشروع

تم تطوير هذا المشروع بـ ❤️ لخدمة الجمعيات الخيرية في الأردن

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published