# نظام الكابتن لإدارة الأكاديميات الرياضية — الدليل الشامل

## نظرة عامة

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

---

## فهرس الوحدات (Modules)

| # | الوحدة | الملف | الوصف |
|---|--------|-------|-------|
| 01 | تسجيل الدخول والهوية | [01-الهوية-والمنظمة.md](01-الهوية-والمنظمة.md) | تسجيل الدخول، الأدوار، الفروع، المستخدمين |
| 02 | المشتركين وأولياء الأمور | [02-المشتركين.md](02-المشتركين.md) | تسجيل المشتركين، الحالات، أولياء الأمور، الاستيراد |
| 03 | البرامج التدريبية والمجموعات | [03-البرامج-والمجموعات.md](03-البرامج-والمجموعات.md) | إنشاء البرامج، المجموعات، الجداول، الحصص |
| 04 | التسجيل (Enrollment) | [04-التسجيل.md](04-التسجيل.md) | تسجيل المشتركين في المجموعات، قوائم الانتظار، النقل |
| 05 | الحضور والغياب | [05-الحضور.md](05-الحضور.md) | تسجيل الحضور، التأخير، الغياب التلقائي، التنبيهات |
| 06 | المنشآت والمساحات | [06-المنشآت.md](06-المنشآت.md) | إدارة الملاعب، التخطيطات، الحجوزات، كشف التعارض |
| 07 | التعيينات (Assignments) | [07-التعيينات.md](07-التعيينات.md) | تعيين المدربين للمجموعات والحصص |
| 08 | المالية والفواتير | [08-المالية.md](08-المالية.md) | الفواتير، المدفوعات، القيد المزدوج، المحافظ |
| 09 | محرك التسعير | [09-التسعير.md](09-التسعير.md) | الأسعار الأساسية، قواعد الخصم، العروض، الكوبونات |
| 10 | نقطة البيع (POS) | [10-نقطة-البيع.md](10-نقطة-البيع.md) | محطة البيع، الورديات، الإيصالات |
| 11 | المخزون | [11-المخزون.md](11-المخزون.md) | المنتجات، المخازن، الحركات، الجرد |
| 12 | الموارد البشرية | [12-الموارد-البشرية.md](12-الموارد-البشرية.md) | الموظفين، المدربين، الرواتب، السلف |
| 13 | الإشعارات والمستندات | [13-الإشعارات-والمستندات.md](13-الإشعارات-والمستندات.md) | قوالب الإشعارات، المستندات، الموافقات |
| 14 | التقييمات | [14-التقييمات.md](14-التقييمات.md) | معايير التقييم، تقييم المشتركين |
| 15 | التقارير والإعدادات | [15-التقارير-والإعدادات.md](15-التقارير-والإعدادات.md) | التقارير المالية، الحضور، الإعدادات، لوحات التحكم |
| 16 | مكتب الاستقبال | [16-مكتب-الاستقبال.md](16-مكتب-الاستقبال.md) | ويزارد التسجيل الجديد، تسجيل موجود، تحصيل دفعة |
| 17 | مخططات الدورات الشاملة | [17-مخططات-الدورات.md](17-مخططات-الدورات.md) | 13 مخطط Mermaid: كل الدورات في مكان واحد |

---

## الأدوار المتاحة في النظام

| الدور | المستوى | الوصف |
|-------|---------|-------|
| مدير النظام (super_admin) | 100 | تحكم كامل بجميع الأكاديميات |
| مالك الأكاديمية (academy_owner) | 90 | تحكم كامل بأكاديمية واحدة |
| مدير الأكاديمية (academy_admin) | 80 | إدارة يومية كاملة |
| مدير الفرع (branch_manager) | 70 | إدارة فرع واحد |
| رئيس المدربين (head_trainer) | 60 | إشراف على المدربين |
| مدرب (trainer) | 50 | تسجيل حضور + تقييم |
| موظف استقبال (receptionist) | 40 | تسجيل مشتركين + تحصيل |
| محاسب (accountant) | 35 | عمليات مالية فقط |
| إدخال بيانات (data_entry) | 30 | إدخال بيانات فقط |
| ولي أمر (parent) | 5 | متابعة أبنائه فقط |

---

## دورات العمل الأساسية (Business Cycles)

### الدورة الكاملة لمشترك جديد:
```
تسجيل ← اختيار برنامج ← اختيار مجموعة ← حساب السعر ← إنشاء فاتورة ← دفع ← تفعيل ← حضور ← تقييم ← تخرج/تجديد
```

### الدورة المالية اليومية:
```
فتح وردية ← عمليات بيع/تحصيل ← إقفال وردية ← مطابقة
```

### دورة الحضور:
```
إنشاء حصة ← توليد سجلات متوقعة ← تسجيل الحضور ← غياب تلقائي ← تنبيهات ← إيقاف تلقائي
```

---

## المهام المجدولة (Automated Jobs)

| المهمة | التوقيت | الوظيفة |
|--------|---------|---------|
| غياب تلقائي | كل ساعة | تحويل "متوقع" إلى "غائب" بعد انتهاء الحصة بساعتين |
| فحص حدود الحضور | 06:00 يومياً | إيقاف تلقائي عند 5 غيابات متتالية |
| تنبيهات الحضور | 20:00 يومياً | إرسال تنبيهات لأولياء الأمور |
| فواتير متأخرة | 01:00 يومياً | تحويل فواتير منتهية الأجل إلى "متأخرة" |
| توليد حصص | 02:00 يومياً | إنشاء حصص الأسبوع القادم |
| تنظيف السجلات | أسبوعياً | حذف سجلات التدقيق الأقدم من سنة |
| انتهاء المستندات | 06:00 يومياً | تحديث حالة المستندات المنتهية |
| ملخص يومي | 07:00 يومياً | إرسال ملخص للإدارة |
| تهنئة أعياد الميلاد | 08:00 يومياً | إرسال رسائل تهنئة |
| كشف تعثر الأقساط | 08:00 يومياً | تنبيه عند تأخر قسط |
| مخزون منخفض | 09:00 يومياً | تنبيه عند وصول مخزون للحد الأدنى |
| تذكير اشتراكات تنتهي | 10:00 يومياً | تذكير قبل 7 و 3 أيام |
| تذكير أقساط | 11:00 يومياً | تذكير قبل 3 و 1 يوم |
| فواتير متأخرة (تذكير) | الاثنين + الخميس | إرسال تذكير المتأخرات |
| مصالحة أعداد المجموعات | 03:00 يومياً | تصحيح عدادات المجموعات |
| إنهاء اشتراكات منتهية | 00:30 يومياً | تعطيل الاشتراكات المنتهية |
| مصالحة مالية | أسبوعياً (الأحد 04:00) | فحص تطابق القيود |
| تقرير أسبوعي لأولياء الأمور | السبت 12:00 | إرسال تقرير أسبوعي |
| تنبيه امتلاء المجموعات | 08:00 يومياً | تنبيه عند وصول 90% من السعة |

---

## كيف تقرأ هذا الدليل

كل وحدة (Module) تحتوي على:
1. **وصف الشاشات** — كل شاشة بالتفصيل مع الحقول والأزرار
2. **دورات العمل** — مخططات Mermaid توضح تسلسل العمليات
3. **أمثلة عملية** — سيناريوهات واقعية مع أرقام
4. **لماذا يحتاج عملك هذا** — المبرر التجاري لكل ميزة
5. **التكاملات** — كيف تتصل هذه الوحدة بالوحدات الأخرى
