الرواتب والموارد البشرية بالمتطلبات السعوديةSaudi payroll and HR

B26العقود والماليةمتطلب وارد في الملفات يحتاج اعتمادًا قانونيًا

Frappe HR يدير الموظفين والحضور والإجازات والرواتب، لكنه لا يغطي التأمينات الاجتماعية السعودية ومكافأة نهاية الخدمة وملف حماية الأجور؛ تُبنى إضافات تقرأ النسب من جداول مؤرخة يعتمدها مستشار رواتب.

بطاقة الميزة

البند	القيمة
1. اسم الميزة	الرواتب والموارد البشرية بالمتطلبات السعودية — Saudi payroll and HR
2. المعرّف (Feature ID)	`B26`
3. مصدر المتطلب	الوثيقة المعمارية: الرواتب، تقييم القرارات الهندسية: Frappe HR
4. تصنيف المحتوى	متطلب وارد في الملفات Frappe HR مع إضافات التأمينات ونهاية الخدمة وملف حماية الأجور. يحتاج اعتمادًا قانونيًا كل النسب والمواد؛ المصادر تختلف لسنة 2026.
الوحدة	العقود والمالية
الأدوار المعنية	محاسب، شريك
درجة الخطورة	عالية
حالة الاعتماد	يحتاج اعتمادًا قانونيًا
المنصات المرتبطة	المؤسسة العامة للتأمينات الاجتماعية، مدد — حماية الأجور، قوى

5الهدف التجاري والمشكلة التي تعالجها

حساب الرواتب خطأً يعرّض المكتب لغرامات ويفسد تكلفة الساعة B21 تكلفة الساعة والربحية.

6المجال القانوني المرتبط للمطوّر غير المتخصص

الوثيقة المعمارية تذكر نسب اشتراكات قديمة وتدرجًا للمسجلين الجدد منذ 2024 ومواد نهاية الخدمة والاستقالة (الوثيقة المعمارية)، وتنبه أن المصادر تختلف في 2026 يحتاج اعتمادًا قانونيًا. لا نكتب هذه النسب هنا كقواعد: تُدخل في Payroll Rule مؤرخة بعد تأكيد مستشار الرواتب من المؤسسة العامة للتأمينات الاجتماعية ونظام العمل.

7المستخدمون والأدوار والصلاحيات

المحاسب أو مسؤول الموارد البشرية. الموظف يرى قسيمته.

8شروط البدء والاعتماديات

Frappe HR مثبت. مستشار رواتب يعتمد الجداول (الوثيقة المعمارية).

9السيناريو الأساسي خطوة بخطوة

بيانات الموظف: الجنسية، تاريخ التسجيل في التأمينات، الراتب الأساسي والسكن.
شهريًا: هيكل الراتب ← خصم حصة الموظف وحساب حصة صاحب العمل من جدول مؤرخ.
مخصص نهاية الخدمة شهريًا من جدول المواد المعتمد.
ملف حماية الأجور بصيغة منصة مدد — حماية الأجور للرفع اليدوي.
تشغيل موازٍ مع الطريقة الحالية قبل الاعتماد (الوثيقة المعمارية).

10السيناريوهات البديلة والاستثناءات

تغير النسب منتصف سنة: سجل جديد بتاريخ سريان. شراء إضافة جاهزة بدل البناء: قرار مفتوح (الوثيقة المعمارية).

11المدخلات والحقول

الاسم العربي	الاسم البرمجي	النوع	إلزامي	التحقق	القيمة الافتراضية	مصدر البيانات
قاعدة: النوع	`rule_kind`	Select	نعم	اشتراك موظف / اشتراك صاحب عمل / مخاطر / نهاية خدمة	—	يحتاج اعتمادًا قانونيًا
قاعدة: الفئة	`applies_to`	Select	نعم	سعودي قديم / سعودي جديد / غير سعودي	—	يحتاج اعتمادًا قانونيًا
قاعدة: النسبة أو الصيغة	`rate / formula`	Percent / Code	نعم	—	—	مستشار الرواتب
ساري من / إلى	`valid_from / valid_to`	Date	نعم	—	—	—
اعتمده	`verified_by`	Link → User	شرط الاستخدام	—	—	—

12المخرجات والإشعارات والسجلات والتقارير

قسائم الرواتب، قيود الرواتب، ملف حماية الأجور، تقرير مخصص نهاية الخدمة.

13قواعد العمل بصيغة قابلة للتحويل إلى كود

قواعد

RULE B26.1  rates read from Payroll Rule valid at payroll date and verified
RULE B26.2  no hardcoded percentages
RULE B26.3  EOSB provision monthly per approved formula

14حالات السجل وانتقالاتها وشروطها

مسير الرواتب: مسودة ← معتمد ← مرحّل.

15نموذج البيانات والعلاقات والقيود والفهارس

Salary Slip وPayroll Entry من Frappe HR، وPayroll Rule اقتراح هندسي.

16DocTypes المطلوبة في Frappe

Payroll Rule، EOSB Provision اقتراح هندسي.

17الشاشات والعناصر والأزرار ورسائل الخطأ

شاشات Frappe HR. تقرير «مقارنة التشغيل الموازي».

18خدمات Backend ومسؤولية كل خدمة

legal_erp.hr.gosi.compute، legal_erp.hr.wps.export.

19واجهات API الداخلية

لا توجد واجهة API خاصة بهذه الميزة.

20الأحداث والمهام الخلفية والجدولة وإعادة المحاولة

شهري: المخصصات.

21التكاملات المرتبطة بالميزة وحدودها

المؤسسة العامة للتأمينات الاجتماعية ومدد — حماية الأجور وقوى: لا ربط آلي موثق في الملفات؛ ملفات للرفع اليدوي.

22الأمن والخصوصية والتدقيق والاحتفاظ والحذف

الرواتب أعلى سرية.

23حالات الاختبار

المعرّف	النوع	السيناريو	النتيجة المتوقعة
`B26-T01`	وحدة	قاعدة غير معتمدة	لا تُستخدم.
`B26-T02`	قبول	تشغيل موازٍ لشهر	يطابق الطريقة الحالية (الوثيقة المعمارية).

24معايير القبول

التشغيل الموازي يطابق.

25تعريف الاكتمال (Definition of Done)

كل قواعد العمل في هذه الصفحة منفذة في الخادم (Controller أو Service)، لا في الواجهة وحدها.
حالات الاختبار المذكورة هنا مكتوبة اختباراتٍ آلية في إطار اختبار Frappe، وتنجح مع كل دفعة كود.
اختبارات الصلاحيات تثبت أن مستخدمًا خارج فريق الملف لا يرى السجل في القائمة ولا برابطه المباشر ولا في البحث العام ولا في العدّادات.
الحقول المخصصة والأدوار ومسارات الاعتماد مُصدَّرة في Fixtures التطبيق، وتظهر بعد تثبيت نظيف على موقع فارغ دون إعداد يدوي.
لا تعديل في ملفات Frappe أو ERPNext.
كل قيمة قانونية (مدة، نسبة، مبلغ، قائمة) محفوظة في إعداد قابل للتعديل، وموسومة بحالة اعتمادها.
نصوص الواجهة ورسائل الخطأ بالعربية، وتخبر المستخدم بما يفعله.
معايير القبول في هذه الصفحة مُتحقق منها ومسجلة في مصفوفة التتبع.

26القرارات المفتوحة والمخاطر والاعتمادات المطلوبة

بناء أم شراء (الوثيقة المعمارية). النسب لسنة 2026 يحتاج اعتمادًا قانونيًا.