مدد — حماية الأجورMudad (WPS)
ملف حماية الأجور يُصدَّر من ERPOS بالصيغة المطلوبة ويرفعه المحاسب يدويًا (الوثيقة المعمارية).
1ما المنصة، ومن الجهة المالكة، وما اختصاصها؟
منصة الرواتب وحماية الأجور.
2ما الإجراء الذي ينفذه المحامي فيها؟
—
3متى يحتاج إليها المحامي؟
شهريًا.
4ميزات ERPOS المرتبطة بها
B26 الرواتب والموارد البشرية بالمتطلبات السعودية.
5الخدمة المحددة المطلوبة من المنصة
رفع ملف الأجور.
6نوع الحاجة: قراءة أو إرسال أو مزامنة أو إشعارات
يدوي.
7البيانات الداخلة والخارجة وحساسيتها ومصدرها
رواتب الموظفين: عالية الحساسية.
8هل يوجد API رسمي موثق لهذه الخدمة تحديدًا؟
لم نجد في الملفات ولا في المصادر التي رُوجعت واجهة برمجية رسمية موثقة لهذه الخدمة تحديدًا: غير مثبت في المصادر التي تمت مراجعتها. لا نكتب endpoints أو حقولًا.
9المصدر الرسمي وتاريخ التحقق
| المصدر | الرابط | ما تحقّقنا منه | تاريخ التحقق |
|---|---|---|---|
| مدد | https://mudad.com.sa | تفتح «مدد الأعمال»: «الواجهة الرسمية لبرنامج حماية الأجور». لا توثيق API ظاهر | 2026-11-04 |
10حالة التحقق
MANUAL_ONLY
MANUAL_ONLY.
11ما الذي يثبته المصدر الرسمي وما الذي لا يثبته؟
—
12التسجيل والاعتماد والتفويض والمصادقة وبيئة الاختبار
حساب المكتب.
13خطوات الربط من جهة ERPOS
تصدير ثم رفع.
14تصميم Adapter مستقل للمنصة
واجهة XAdapter مستقلة في legal_erp/integrations/x.py ترث النمط الموحد نمط موصل التكامل بعمليات: fetch. تنفيذان: يدوي (يفتح نموذج إدخال للموظف ويسجل المصدر «يدوي») ورسمي (لا يُكتب قبل استلام توثيق رسمي وموافقة)، ويُختار من الإعداد لكل مكتب اقتراح هندسي.
15تدفق البيانات ومخطط التسلسل
16نموذج الطلب والاستجابة
صيغة الملف من المنصة.
17انتهاء المهلة وانقطاع الخدمة والرفض وتضارب الحالة
- انتهاء المهلة ← فشل مؤقت ← إعادة أسية في الطابور.
- انقطاع الخدمة أو أخطاء متتالية ← إيقاف الموصل وتنبيه المدير B43 طبقة التكامل المركزية.
- رفض (صلاحية، تفويض) ← فشل دائم يظهر للمسؤول بلا إعادة.
- تضارب الحالة مع البيانات المحلية ← سجل فرق يقرره إنسان؛ لا كتابة صامتة ولا حذف محلي عند استجابة فارغة.
18منع التكرار وإعادة المحاولة الآمنة
كل عملية صادرة بمفتاح عدم تكرار يُحفظ مع السجل؛ إعادة المحاولة ترسل المفتاح نفسه، وكل حدث وارد يُتجاهل إن تكرر معرّفه أو بصمته B43 طبقة التكامل المركزية.
19حفظ المصدر ووقت الجلب وإيصال الجهة وسجل التدقيق
يُحفظ مع كل قيمة: data_source (يدوي/الجهة)، وقت الجلب، معرّف الاستدعاء أو رقم الإيصال من الجهة إن وُجد، والمستخدم أو المهمة المجدولة. سجل الاستدعاء لا يحفظ جسم الاستجابة ولا بيانات شخصية (خطة ناجز ص14).
20المسار اليدوي المصرح به
رفع الملف لا يمكن أتمتته من ERPOS في الوضع الحالي. الموظف المخوّل ينفذه بنفسه في المنصة الرسمية بحسابه، ثم يسجل النتيجة والمرجع في ERPOS مع إرفاق ما يثبت. لا يُطلب من المحامي كلمة مروره ولا تُستخدم جلسته الشخصية (خطة ناجز ص17).
21اختبارات التكامل والفشل والتفويض والتكرار والعزل
| المعرّف | النوع | السيناريو | النتيجة المتوقعة |
|---|---|---|---|
INT-MDD-01 | تكامل | بيئة وهمية تعيد نجاحًا | تُحفظ القيمة بمصدرها ووقتها. |
INT-MDD-02 | فشل | مهلة ثم نجاح | إعادة واحدة بلا تكرار. |
INT-MDD-03 | تفويض | مفتاح أو تفويض غير صالح | فشل دائم وتنبيه، لا إعادة. |
INT-MDD-04 | تكرار | إرسال الحدث نفسه مرتين | يُعالج مرة. |
INT-MDD-05 | عزل | مكتبان على الخادم نفسه | لا يرى أحدهما بيانات الآخر ولا مفتاحه. |
22المخاطر والقرارات التي تحتاج موافقة الجهة
تغيّر الصيغة.