Gameya – منصة إدارة الجمعيات المالية

# Gameya – منصة إدارة الجمعيات المالية

**نبذة عن المشروع**

قمت بتطوير منصة ويب لإدارة الجمعيات المالية الدوارة (الجمعية الشهرية)، بهدف تحويل العمليات الحسابية والإدارية التقليدية إلى نظام رقمي متكامل، يساعد أصحاب الجمعيات على إدارة الأعضاء، ومتابعة الاشتراكات، وتنظيم مواعيد القبض، وتسجيل المدفوعات، ومراجعة الحسابات المالية بسهولة ودقة.

المنصة مصممة لدعم إدارة أكثر من جمعية من خلال حساب واحد، مع إمكانية متابعة كل عضو والتزاماته المالية عبر الجمعيات المختلفة، وتوفير تقارير مالية باللغة العربية قابلة للتنزيل بصيغة PDF والإرسال عبر البريد الإلكتروني.

**أهم المميزات والوظائف**

- **إدارة الجمعيات:** إنشاء الجمعيات وتحديد تاريخ البداية، ومدة الجمعية، والاشتراك الشهري، وإدارة الأعضاء والحصص وتوزيعات القبض.

- **إدارة الأشخاص:** تسجيل بيانات الأعضاء وأرقام هواتفهم وأكوادهم التعريفية، مع إمكانية مشاركة الشخص في أكثر من جمعية.

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

- **إدارة المدفوعات:** تسجيل المدفوعات النقدية ووسائل الدفع المختلفة، مع توزيع المبالغ تلقائيًا على الالتزامات المستحقة عبر الجمعيات.

- **الحسابات المالية:** حساب الاشتراكات المستحقة، والمتأخرات، والمبالغ المتبقية، والمدفوعات الجزئية، والدفعات المقدمة، مع تتبع كل عملية حسب شهر الاستحقاق الفعلي.

- **متابعة القبض والتسويات:** متابعة المستفيدين الذين يحين موعد قبضهم، وحساب صافي المبلغ المستحق بعد خصم الالتزامات الشهرية ذات الصلة.

- **لوحة تحكم تفاعلية:** عرض ملخص مالي للجمعيات، ونسب التحصيل، والمتأخرات، وأعداد الأعضاء، مع إمكانية تصفية البيانات حسب الشهر والسنة.

- **التقارير المالية:** إنشاء تقارير عربية بصيغة PDF، مع دعم تنزيل التقارير وإرسالها بالبريد الإلكتروني.

- **إدارة الصلاحيات:** دعم أدوار مختلفة للمستخدمين، مع تقييد الوصول إلى الجمعيات والبيانات وفقًا لصلاحيات كل حساب.

- **تجربة استخدام عربية:** واجهة Angular باللغة العربية مع دعم RTL وتصميم متجاوب مع الشاشات المختلفة.

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

- **Backend:** ASP.NET Core Web API – .NET 8

- **Frontend:** Angular وTypeScript

- **Database:** SQL Server وEntity Framework Core

- **Architecture:** Clean Architecture

- **Authentication & Authorization:** ASP.NET Identity وJWT وRole-Based Access Control

- **PDF Generation:** QuestPDF

- **Email Integration:** SMTP

- **Deployment:** نشر التطبيق على MonsterASP

**التحديات التقنية التي يركز عليها المشروع**

يتطلب النظام التعامل مع حسابات مالية مترابطة عبر عدة جمعيات، وتوزيع المدفوعات على أقدم الالتزامات أولًا، والحفاظ على دقة السجلات التاريخية، وحساب المتأخرات وفق تواريخ الاستحقاق، ومنع تكرار احتساب المبالغ.

كما يركز على فصل منطق الأعمال عن الواجهة، وتطبيق التحقق من الصلاحيات على مستوى الـ API، وتحسين أداء الاستعلامات باستخدام Pagination وEF Core، مع الحفاظ على قابلية التوسع والصيانة.

**الهدف من المشروع**

توفير منصة SaaS تساعد أصحاب الجمعيات على إدارة عملياتهم اليومية بصورة أكثر تنظيمًا ووضوحًا، وتقليل أخطاء الحسابات اليدوية، وتسهيل متابعة التحصيل والقبض وإعداد التقارير المالية من مكان واحد.