# نظام الموارد البشرية — THE CLUB ERP

## نظرة عامة

نظام موارد بشرية متكامل مبني داخل منظومة THE CLUB ERP، مصمم وفقاً لقانون العمل المصري رقم 12 لسنة 2003 وقانون التأمينات الاجتماعية رقم 148 لسنة 2019. يغطي النظام دورة حياة الموظف بالكامل من التعيين حتى نهاية الخدمة.

**البنية التحتية:** 28 جدول قاعدة بيانات | 16 وحدة تحكم | 12 خدمة حسابية | 35 صلاحية | 80+ مسار

---

## 1. إدارة الموظفين

### 1.1 ملفات الموظفين
- ملف شامل لكل موظف يتضمن: الرقم القومي، تاريخ الميلاد، الجنس، الحالة الاجتماعية، الديانة، الحالة العسكرية
- ربط تلقائي مع حساب المستخدم في النظام (جدول employees) عبر مفتاح أجنبي 1:1
- تسجيل تاريخ التعيين وفترة الاختبار ونوع التوظيف (دوام كامل / جزئي / عقد / مؤقت)
- تتبع الحالة الوظيفية: نشط، في إجازة، موقوف، مُنهى خدمته، مستقيل
- بيانات بنكية كاملة للتحويلات: اسم البنك، رقم الحساب (IBAN)
- رقم التأمين الاجتماعي والراتب التأميني
- حقول الإعاقة والاحتياجات الخاصة
- بحث وفلترة متقدمة حسب القسم والحالة والمسمى الوظيفي
- أرشفة ناعمة (Soft Delete) — لا يُحذف أي سجل نهائياً

### 1.2 الأقسام والإدارات
- هيكل تنظيمي شجري (كل قسم يمكن أن يكون تابعاً لقسم أعلى)
- تعيين مدير لكل قسم
- ربط الأقسام بالفروع
- إضافة / تعديل / أرشفة الأقسام

### 1.3 المسميات الوظيفية
- تعريف المسميات مع الدرجة الوظيفية (Grade Level)
- تحديد الحد الأدنى والأقصى للراتب لكل مسمى
- إضافة / تعديل / أرشفة المسميات

---

## 2. العقود

### 2.1 إدارة العقود
- دعم أنواع العقود: محدد المدة، غير محدد المدة، تجريبي
- تسجيل تفاصيل العقد: تاريخ البدء والانتهاء، الراتب الأساسي، ساعات العمل، فترة الإنذار
- فترة اختبار (Probation) قابلة للتحديد — حد أقصى 3 شهور وفقاً للقانون

### 2.2 دورة حياة العقد
- **تجديد العقد**: إنشاء عقد جديد مرتبط بالعقد السابق مع تحديث التواريخ تلقائياً
- **إنهاء العقد**: تسجيل سبب وتاريخ الإنهاء مع تحديث حالة الموظف تلقائياً
- تنبيهات قبل انتهاء العقد بـ 30 يوم (عبر مهمة مجدولة)
- تنبيه عند انتهاء فترة الاختبار

---

## 3. الهيكل الراتبي

### 3.1 هياكل الرواتب
- تعريف هياكل رواتب متعددة (مثال: "الهيكل القياسي للنادي")
- كل هيكل يحتوي على مكونات مخصصة

### 3.2 مكونات الراتب
- 14 مكون افتراضي مُعرّف مسبقاً:
  - **استحقاقات**: الراتب الأساسي، بدل سكن، بدل انتقال، بدل وجبات، بدل اجتماعي، بدل طبيعة عمل، أجر إضافي
  - **استقطاعات**: حصة التأمينات، ضريبة كسب العمل، أقساط سلف، خصم جزاءات، اشتراك نقابة، خصم غياب
- كل مكون يحدد:
  - النوع: ثابت / نسبة من الأساسي / معادلة
  - خاضع للضريبة أم لا
  - خاضع للتأمينات أم لا
  - يؤثر على حساب الأجر الإضافي أم لا
- تعيين مكونات خاصة لكل موظف مع تاريخ سريان

---

## 4. الحضور والانصراف

### 4.1 تسجيل الحضور
- تسجيل يومي فردي أو جماعي (Bulk Entry) لكل القسم مرة واحدة
- دعم طرق التسجيل: يدوي، بصمة إصبع، كارت، تعرف على الوجه
- تسجيل وقت الدخول والخروج مع حساب الساعات الفعلية تلقائياً

### 4.2 المتابعة والتحليل
- حساب تلقائي لدقائق التأخير والانصراف المبكر
- حساب ساعات العمل الإضافي
- حالات الحضور: حاضر، غائب، متأخر، إجازة، عطلة رسمية، يوم راحة، نصف يوم
- عرض شهري لحضور كل موظف مع ملخص إحصائي
- اعتماد جماعي لسجلات الحضور

### 4.3 جداول العمل
- تعريف جداول عمل متعددة: 6 أيام، 5 أيام، وردية ليلية
- دعم ساعات رمضان (7 ساعات بدلاً من 8 للمسلمين — مادة 80)
- تعريف وردية ليلية (7 مساءً - 7 صباحاً) بـ 7 ساعات عمل
- تعيين جدول عمل لكل موظف مع تاريخ سريان
- كشف تلقائي لجدول رمضان حسب ديانة الموظف

### 4.4 العطلات الرسمية
- تعريف العطلات الوطنية والدينية
- دعم العطلات المتكررة سنوياً
- عطلات خاصة بديانة معينة (مثال: شم النسيم للمسيحيين)
- 7 عطلات مصرية مُعرّفة مسبقاً

---

## 5. إدارة الإجازات

### 5.1 أنواع الإجازات (وفقاً لقانون العمل المصري)
10 أنواع إجازات مُعرّفة مسبقاً وفقاً للقانون:

| النوع | المدة | النسبة المدفوعة | المرجع القانوني |
|-------|-------|-----------------|-----------------|
| سنوية (1-10 سنوات) | 21 يوم | 100% | مادة 47 |
| سنوية (10+ سنوات أو 50+ سنة) | 30 يوم | 100% | مادة 47 |
| سنوية (أعمال خطرة) | 45 يوم | 100% | مادة 47 |
| عارضة | 7 أيام/سنة (حد 2 متتالية) | 100% | مادة 51 |
| مرضية (أول 3 شهور) | 90 يوم | 75% | مادة 54 |
| مرضية (ثاني 3 شهور) | 90 يوم | 85% | مادة 54 |
| وضع (أمومة) | 90 يوم، حد 3 مرات بالمسيرة | 100% | مادة 91 |
| حج | 30 يوم، مرة واحدة بالمسيرة | بدون راتب | مادة 53 |
| زواج | 3 أيام | 100% | — |
| عزاء | 5 أيام | 100% | — |

### 5.2 إدارة الأرصدة
- رصيد تلقائي لكل موظف لكل نوع إجازة لكل سنة
- حساب الاستحقاق والمُستخدم والمُعلّق والمُرحّل والتعديلات
- ترحيل الرصيد السنوي (Carry Over) بحد أقصى 3 سنوات تراكم
- حد أدنى 6 أيام متتالية من الإجازة السنوية
- تعديل يدوي للأرصدة مع تسجيل السبب

### 5.3 طلبات الإجازة
- تقديم طلب إجازة مع تحديد النوع والتاريخ والمدة
- دعم نصف يوم إجازة (صباحي / مسائي)
- إرفاق مستندات (مثال: تقرير طبي للإجازة المرضية)
- سير عمل الاعتماد: معلق ← معتمد / مرفوض ← منفذ / ملغى
- إشعار SMS تلقائي عند اعتماد أو رفض الطلب
- خصم تلقائي من الرصيد عند الاعتماد
- إلغاء الطلب مع استرداد الرصيد تلقائياً

### 5.4 تقويم الإجازات
- عرض تقويم شهري لجميع الإجازات المعتمدة
- يساعد في التخطيط وتجنب تضارب الإجازات

---

## 6. كشوف الرواتب

### 6.1 محرك حساب الرواتب الآلي
محرك حسابي متكامل ينفذ 11 خطوة لكل موظف تلقائياً:

1. تحميل الهيكل الراتبي ومكوناته الفعالة
2. حساب أيام العمل والغياب والأجر الإضافي من سجل الحضور
3. حساب إجمالي الاستحقاقات: أساسي + بدلات + أجر إضافي
4. حساب حصة التأمينات الاجتماعية (موظف + صاحب عمل)
5. حساب ضريبة كسب العمل من الشرائح التصاعدية
6. حساب أقساط السلف المستحقة
7. حساب خصومات الجزاءات التأديبية
8. حساب خصومات الغياب
9. صافي الراتب = الإجمالي - جميع الاستقطاعات
10. تسجيل كشف الراتب + سجل المكونات + سجل التأمينات + سجل الضرائب
11. تحديث إجماليات الفترة

**جميع العمليات الحسابية تستخدم مكتبة bcmath بدقة رقمين عشريين — لا يُستخدم float أبداً**

### 6.2 فترات الرواتب
- فترة شهرية لكل شهر بدورة حياة كاملة:
  - **مفتوحة** ← **قيد المعالجة** ← **محسوبة** ← **معتمدة** ← **مدفوعة** ← **مغلقة**
- إعادة الحساب ممكنة قبل الاعتماد (يحذف السجلات السابقة ويعيد الحساب)
- بعد الإغلاق: السجلات مجمدة — أي تصحيحات تُرحّل للفترة التالية
- قفل الفترة لمنع التعديل

### 6.3 مفردات الراتب (Salary Slip)
- كشف راتب تفصيلي لكل موظف لكل فترة
- يعرض كل مكون (استحقاق / استقطاع) مع المبلغ
- إمكانية عرض مفردات الراتب الشخصي (للموظف نفسه)
- تسجيل JSON كامل لتفاصيل الحساب للمراجعة

### 6.4 الأجر الإضافي (Overtime)
- حساب تلقائي وفقاً للمادة 85:
  - **نهاري**: 135% من أجر الساعة
  - **ليلي**: 170% من أجر الساعة
- النسب قابلة للتعديل من إعدادات النظام

---

## 7. التأمينات الاجتماعية

### 7.1 الحساب الآلي (قانون 148 لسنة 2019)

| البند | حصة الموظف | حصة صاحب العمل |
|-------|------------|----------------|
| الأساسي | 9% | 12% |
| المتغير | 2% | 6.75% |
| **الإجمالي** | **11%** | **18.75%** |

- سقف تأميني قابل للتحديث سنوياً من الإعدادات
- حساب تلقائي مع كل كشف رواتب
- تسجيل تفصيلي لكل مكون (أساسي / متغير) لكل موظف لكل فترة

### 7.2 التقارير والنماذج
- **استمارة 1**: بيان اشتراك موظف جديد
- **استمارة 6**: كشف اشتراكات شهري لجميع الموظفين
- سجل تأمينات لكل فترة ولكل موظف
- تاريخ تأميني كامل لكل موظف

---

## 8. ضريبة كسب العمل

### 8.1 الحساب التصاعدي (شرائح 2024-2025)

| الشريحة | النسبة |
|---------|--------|
| حتى 40,000 ج.م | 0% |
| 40,001 — 55,000 | 10% |
| 55,001 — 70,000 | 15% |
| 70,001 — 200,000 | 20% |
| 200,001 — 400,000 | 22.5% |
| 400,001 — 1,200,000 | 25% |
| أكثر من 1,200,000 | 27.5% |

- إعفاء شخصي: 20,000 ج.م سنوياً
- إعفاء التأمينات: حصة الموظف مُعفاة من الضريبة
- **تتبع تراكمي (YTD)**: حساب الضريبة على أساس الدخل السنوي التراكمي لمنع الزيادة أو النقصان في الاستقطاع الشهري
- سجل ضريبي تفصيلي لكل موظف لكل شهر مع JSON لتفاصيل الشرائح

---

## 9. السلف والقروض

### 9.1 أنواع السلف
- **سلفة راتب**: استلاف من الراتب المقبل
- **قرض شخصي**: قرض بأقساط شهرية
- **قرض طوارئ**: لحالات الطوارئ

### 9.2 دورة حياة السلفة
- تقديم طلب ← اعتماد / رفض ← صرف ← سداد (أقساط) ← تسوية كاملة
- إشعار SMS عند اعتماد السلفة
- تحديد عدد الأقساط ومبلغ كل قسط وتاريخ بداية الخصم

### 9.3 جدول الأقساط
- إنشاء تلقائي لجدول الأقساط عند اعتماد القرض
- ربط كل قسط بكشف الراتب الشهري
- تتبع الأقساط: معلق، مخصوم، مُتخطى، ملغى
- خصم تلقائي من الراتب الشهري عبر محرك الرواتب
- تتبع المبلغ المتبقي والأقساط المسددة

---

## 10. الإجراءات التأديبية

### 10.1 الامتثال لقانون العمل (مواد 58-68)
- **تحقيق إلزامي** قبل أي عقوبة
- **حد أقصى لخصم الراتب**: 5 أيام شهرياً (مادة 58) — النظام يرفض تلقائياً ما يتجاوز الحد
- **حد أقصى للإيقاف**: 6 أيام شهرياً — النظام يرفض تلقائياً ما يتجاوز الحد
- **حق التظلم**: 7 أيام من تاريخ القرار — النظام يحسب المهلة تلقائياً

### 10.2 دورة الحياة الكاملة
تحت التحقيق ← في انتظار القرار ← تم تحديد العقوبة ← منفذ / متظلم ← تم مراجعة التظلم / ملغى

### 10.3 أنواع الجزاءات (تدرج تصاعدي)
1. إنذار
2. خصم من الراتب
3. تأجيل علاوة
4. إيقاف عن العمل
5. تنزيل درجة
6. فصل

### 10.4 التظلم
- تقديم تظلم مع كتابة السبب
- مراجعة التظلم من صاحب الصلاحية
- تسجيل نتيجة التظلم

### 10.5 الربط مع الرواتب
- خصومات الجزاءات التأديبية تُخصم تلقائياً من كشف الراتب الشهري
- حساب المبلغ المخصوم: (الراتب الأساسي ÷ 30) × عدد أيام الخصم

---

## 11. نهاية الخدمة

### 11.1 أنواع إنهاء الخدمة
- استقالة، فصل، انتهاء عقد، تقاعد، وفاة، عجز، اتفاق مشترك

### 11.2 حساب المستحقات الآلي

| البند | الصيغة |
|-------|--------|
| مكافأة أول 5 سنوات | نصف شهر × عدد السنوات |
| مكافأة بعد 5 سنوات | شهر كامل × عدد السنوات |
| تعويض فترة الإنذار | الراتب الشامل × عدد الأشهر (2 أو 3) |
| رصيد الإجازات | (الراتب ÷ 30) × الأيام المتبقية |
| خصم السلف | المبلغ المتبقي من جميع القروض النشطة |
| **الصافي** | **إجمالي المستحقات - إجمالي الخصومات** |

- فترة الإنذار: شهرين (أقل من 10 سنوات)، 3 شهور (10 سنوات فأكثر)
- **حماية الأمومة (مادة 91)**: النظام يرفض تلقائياً إنهاء خدمة موظفة أثناء إجازة الوضع أو خلال سنة من العودة

### 11.3 دورة الاعتماد
مسودة ← تم الحساب ← في انتظار الاعتماد ← معتمد ← تم الصرف

- عند الاعتماد: تتحدث حالة الموظف تلقائياً إلى "مُنهى خدمته"
- تسجيل تاريخ الصرف

---

## 12. تقييم الأداء

### 12.1 دورات التقييم
- دعم دورات: سنوية، نصف سنوية، ربع سنوية
- إنشاء مراجعات تلقائية لكل موظف عند فتح دورة تقييم

### 12.2 معايير التقييم
8 معايير مُعرّفة مسبقاً (قابلة للتخصيص):
1. جودة العمل
2. الإنتاجية
3. الانتظام والحضور
4. العمل الجماعي
5. المبادرة والإبداع
6. التواصل
7. القيادة
8. المهارات الفنية

- تقييم كل معيار من 1 (ضعيف) إلى 5 (ممتاز)
- تقييم عام إجمالي مع تصنيف تلقائي: ممتاز، جيد جداً، جيد، مقبول، ضعيف

### 12.3 سير العمل
بانتظار التقييم ← قيد التقييم ← مكتمل ← تم الإقرار

- تسجيل نقاط القوة ومجالات التحسين والأهداف للفترة القادمة
- ملاحظات المقيّم
- إقرار الموظف بالاطلاع على التقييم

---

## 13. مستندات الموظفين

### 13.1 أنواع المستندات
- بطاقة الرقم القومي، جواز السفر، شهادة الميلاد
- الشهادات العلمية
- شهادة تأدية/إعفاء الخدمة العسكرية
- استمارات التأمينات (1 و 6)
- التقارير الطبية
- صحيفة الحالة الجنائية
- شهادات الخبرة
- نسخ العقود
- صور شخصية
- مستندات أخرى

### 13.2 إدارة الملفات
- رفع ملفات بصيغ PDF, JPEG, PNG (حد أقصى 5 ميجابايت)
- تسجيل اسم الملف الأصلي وحجمه ونوعه
- تتبع تاريخ الانتهاء مع تنبيه قبل 30 يوم (عبر مهمة مجدولة)
- التحقق من صحة المستند من قبل المختص
- أرشفة المستندات المنتهية أو غير المطلوبة

---

## 14. التقارير

8 تقارير متخصصة:

| التقرير | الوصف |
|---------|-------|
| **القوى العاملة** (Headcount) | توزيع الموظفين حسب الأقسام والحالة والجنس |
| **ملخص الرواتب** | إجماليات الرواتب لكل فترة: استحقاقات، استقطاعات، صافي |
| **ملخص الحضور** | أيام الحضور والغياب والتأخير والإضافي لكل قسم |
| **ملخص الإجازات** | أرصدة الإجازات المُستخدمة والمتبقية لكل نوع |
| **ملخص التأمينات** | حصص الموظفين وأصحاب العمل لكل فترة |
| **ملخص الضرائب** | الضرائب المستقطعة شهرياً وتراكمياً |
| **ملخص السلف** | القروض النشطة والأقساط المسددة والمتبقية |
| **العقود المنتهية** | العقود القريبة من الانتهاء أو المنتهية فعلاً |

---

## 15. المهام المجدولة (Cron Jobs)

7 مهام تعمل تلقائياً:

| المهمة | التكرار | الوظيفة |
|--------|---------|---------|
| تنبيه انتهاء العقود | يومياً | إشعار قبل 30 يوم من انتهاء العقد |
| تنبيه انتهاء فترة الاختبار | يومياً | إشعار عند اقتراب انتهاء فترة التجربة |
| تجديد أرصدة الإجازات | 1 يناير سنوياً | حساب الترحيل وإنشاء أرصدة السنة الجديدة |
| تذكير كشف الرواتب | يوم 20 شهرياً | تنبيه إذا كانت فترة الرواتب مازالت مفتوحة |
| تذكير أقساط السلف | يوم 1 شهرياً | التحقق من الأقساط المعلقة للخصم |
| تنبيه انتهاء المستندات | يومياً | إشعار قبل 30 يوم من انتهاء صلاحية المستندات |
| إغلاق الحضور التلقائي | يومياً منتصف الليل | إغلاق سجلات الحضور المفتوحة (بدون تسجيل خروج) |

---

## 16. الإشعارات

7 قوالب SMS بالعربية:
1. اعتماد طلب إجازة
2. رفض طلب إجازة
3. إصدار مفردات الراتب
4. اقتراب انتهاء العقد
5. انتهاء فترة الاختبار
6. اعتماد السلفة
7. انتهاء صلاحية مستند

---

## 17. الأمان والصلاحيات

### 35 صلاحية مُفصّلة:
- **الأقسام**: عرض، إدارة
- **المسميات الوظيفية**: عرض، إدارة
- **الموظفون**: عرض، إدارة، عرض الرواتب، إدارة الرواتب
- **العقود**: عرض، إدارة
- **الحضور**: عرض، إدارة، اعتماد
- **الإجازات**: عرض، طلب، اعتماد، إدارة
- **الرواتب**: عرض، تشغيل، اعتماد + عرض مفردات الراتب الشخصي
- **التأمينات**: عرض، إدارة
- **الضرائب**: عرض
- **الإجراءات التأديبية**: عرض، إدارة
- **السلف**: عرض، إدارة، اعتماد
- **نهاية الخدمة**: عرض، إدارة، اعتماد
- **تقييم الأداء**: عرض، إدارة
- **المستندات**: عرض، إدارة
- **التقارير**: عرض
- **العطلات**: إدارة
- **جداول العمل**: إدارة

### حماية البيانات
- حماية CSRF على جميع النماذج
- تنظيف المدخلات (XSS Protection)
- أرشفة ناعمة (Soft Delete) — لا يُحذف أي سجل نهائياً
- تسجيل تلقائي لمن أنشأ ومن عدّل كل سجل (created_by, updated_by)
- سجل مراجعة (Audit Trail) للعمليات الحساسة: تغيير الراتب، اعتماد كشف الرواتب، إنهاء الخدمة

---

## 18. الإعدادات القابلة للتخصيص

~25 إعداد في `system_config` تحت مفتاح `hr.*`:

| الإعداد | القيمة الافتراضية | الوصف |
|---------|-------------------|-------|
| نسبة الأجر الإضافي نهاري | 1.35 (135%) | مادة 85 |
| نسبة الأجر الإضافي ليلي | 1.70 (170%) | مادة 85 |
| حد خصم الراتب الشهري | 5 أيام | مادة 58 |
| حد الإيقاف الشهري | 6 أيام | مادة 58 |
| مهلة التظلم | 7 أيام | مادة 68 |
| نسبة تأمين الموظف (أساسي) | 9% | قانون 148/2019 |
| نسبة تأمين الموظف (متغير) | 2% | قانون 148/2019 |
| نسبة تأمين صاحب العمل (أساسي) | 12% | قانون 148/2019 |
| نسبة تأمين صاحب العمل (متغير) | 6.75% | قانون 148/2019 |
| سقف الأجر التأميني (أساسي) | قابل للتحديث سنوياً | — |
| سقف الأجر التأميني (متغير) | قابل للتحديث سنوياً | — |
| الإعفاء الشخصي الضريبي | 20,000 ج.م سنوياً | — |
| شرائح الضريبة | 7 شرائح | — |
| مكافأة نهاية الخدمة (أول 5 سنوات) | 0.5 شهر/سنة | — |
| مكافأة نهاية الخدمة (بعد 5 سنوات) | 1.0 شهر/سنة | — |
| فترة إنذار (أقل من 10 سنوات) | شهرين | — |
| فترة إنذار (10 سنوات فأكثر) | 3 شهور | — |

**جميع النسب والحدود قابلة للتعديل من لوحة الإدارة بدون تعديل كود — يكفي تحديث القيمة في جدول الإعدادات.**

---

## 19. التكامل مع باقي الأنظمة

| النظام | نوع التكامل |
|--------|------------|
| **المستخدمون** | ربط ملف الموظف مع حساب الدخول (1:1) |
| **الفروع** | الأقسام مرتبطة بالفروع + فلترة الرواتب حسب الفرع |
| **الإشعارات / SMS** | 7 قوالب إشعار للإجازات والرواتب والعقود والسلف والمستندات |
| **سجل المراجعة** | تسجيل تلقائي لجميع العمليات الحساسة |
| **الأحداث** | نظام أحداث (EventBus) للربط مع أي نظام مستقبلي |

---

## ملخص تنفيذي

| البند | القيمة |
|-------|--------|
| جداول قاعدة البيانات | 28 |
| وحدات التحكم | 16 |
| الخدمات الحسابية | 12 |
| ملفات العرض | ~50 |
| المسارات (Routes) | 80+ |
| الصلاحيات | 35 |
| المهام المجدولة | 7 |
| قوالب SMS | 7 |
| أنواع الإجازات | 10 |
| مكونات الراتب الافتراضية | 14 |
| إعدادات قابلة للتخصيص | ~25 |
| المرجعية القانونية | قانون العمل 12/2003 + قانون التأمينات 148/2019 |
