🏫

منظومة متابعة المسوقين والمدارس والمحاسبة | School CRM

FRMS & StoreSystem Swagger UI v2.0

التوثيق التفاعلي الشامل للـ APIs، مصفوفة الصلاحيات المركزية، البحث الديناميكي، ومحرك السندات المالية المزدوج

👥 الأدوار والصلاحيات المركزية (Centralized Permission Filter)

  • ADMIN (أدمن): صلاحيات شاملة، تصفير أرقام السندات السنوي، إدارة المناطق الجغرافية والثوابت، تعيين المسوقين، وسجل التدقيق UserAuditLogs.
  • MARKETER (مسوق ميداني): يرى تلقائياً المدارس المربوطة به فقط، يوثق الزيارات مع GPS، يطلب جلسات الإرشاد، وينشئ الطلبيات والفواتير.
  • ADVISOR (مرشد تربوي): يستقبل إشعارات SignalR لطلبات الإرشاد ويوثق الجلسات وعدد الحصص الإرشادية.
  • CUSTOMER_CARE (العناية بالزبائن): يتابع تقييمات رضا المدارس عن الكتب والخدمات والشكاوى والمنافسين.
  • ACCOUNTANT & WAREHOUSE_KEEPER: إدارة شجرة الحسابات، سندات القبض والصرف، والمستودعات.

📦 القالب الموحد للردود والأخطاء (Unified Response Envelope)

  • رد الخطأ أو انعدام الصلاحية الموحد:
    {
      "status": "error",
      "code": 503,
      "type": "no_permissions",
      "descriptions": "لا توجد صلاحية معرفة"
    }

🔍 البحث الديناميكي في أي حقل ومنع انفجار الاستعلامات

  • جميع مسارات GET تدعم البحث في أي حقل عبر معاملات الاستعلام الموحدة:
  • GlobalSearch: بحث شامل في كافة الحقول النصية والرقمية.
  • SearchField & SearchValue: بحث دقيق في حقل معين (مثل Code أو Region.NameAr).
  • Filters: فلاتر متعددة مثل Status=Scheduled,AcademicYear=2025-2026.
  • SortBy, SortDesc, Page, PageSize.
0
إجمالي الـ APIs
0
GET (استعلام)
0
POST (إضافة)
0
PUT (تحديث)
0
DELETE (حذف)
جاري تحميل مواصفات الـ Swagger API...