ثوابت وحالات طرق الدفع البرمجية (Payment Reference)

يوفر هذا المرجع التقني الثوابت البرمجية لطرق الدفع في منصة Skool.Cool وكيف تترجم فنيًا في قاعدة البيانات والواجهات البرمجية.

---

1. أكواد طرق الدفع المعتمدة (Payment Methods Enum)

معرفة فنيًا في ملف skoolCoolPaymentMethod.ts بالأكواد التالية:

الكود البرمجي (Value)	اسم الثابت فنيًا (Enum Key)	الترجمة التشغيلية	الوصف
1	Cash	دفع نقدي	يتم السداد يدوياً في صندوق المدرسة وتأكيد الحركة يدوياً من الإدارة.
2	Online	دفع إلكتروني	يتم السداد عبر بطاقات الدفع البنكية ومدى وتحديث الحالة آلياً عبر StreamPay.
3	Free	نشاط مجاني	لا يتطلب دفع رسوم ويتم تفعيل الطالب تلقائياً فور اعتماده الإداري.

---

2. مصفوفة علاقة الحالات التشغيلية بالمدفوعات

يوضح الجدول التالي ترجمة حالة السداد المالي للطلب وأين تظهر فنيًا في الحالات التشغيلية:

كود حالة التسجيل	اسم الحالة الفني	الوصف المالي للطلب	هل يسمح بأخذ حضور الطالب؟
3	Awaiting_Payment	بانتظار سداد ولي الأمر للرسوم.	❌ لا يسمح
5	UserPaid	العميل سدد إلكترونياً وتنتظر التسوية النهائية (مرحلية).	❌ لا يسمح
6	Paid	تم السداد بالكامل وإثباته (نقدي بإيصال أو إلكتروني).	✅ يسمح
4	Cancelled_Due_To_No_Payment	إلغاء الطلب آلياً لانتهاء مهلة السداد دون دفع.	❌ لا يسمح
12	Refunded	تم إرجاع المبالغ المدفوعة مسبقاً للعميل وإلغاء تسجيله.	❌ لا يسمح

---

3. الصلاحيات المالية في لوحة الإدارة (Financial Permissions)

تُفصل الصلاحيات المالية الدقيقة في النظام لمنع تداخل المسؤوليات بين المنسق والمشرف المالي:

• Registrations:Confirm_Payment (تأكيد الدفع):
  • الوظيفة: صلاحية خاصة بـ Finance و Cashier لإدخال رقم الإيصال يدوياً وتفعيل الكاش.
  • لا تمنح هذه الصلاحية للمدربين أو المنسقين العاديين لمنع التلاعب المالي.
• Registrations:Switch_To_Online_Payment (التحويل لإلكتروني):
  • الوظيفة: تحويل سياق الدفع لإلكتروني لإرسال الرابط للعميل. متاح للمنسقين ومدراء المدارس.