توثيق ERPOSالمرجع التنفيذي للمطورين

قوىQiwa

UNKNOWNوزارة الموارد البشرية والتنمية الاجتماعيةغير مثبت

منصة خدمات العمل (العقود، التأشيرات). ورد ذكرها في تقرير التدقيق (Gemini) ضمن كتالوج التكاملات بتقدير غير مثبت (تقرير التدقيق (Gemini)) غير مثبت. لا ربط مخطط في الوثائق الأساسية.

1ما المنصة، ومن الجهة المالكة، وما اختصاصها؟

خدمات العمل.

2ما الإجراء الذي ينفذه المحامي فيها؟

قضايا عمالية قد تتطلب الاطلاع على عقود العمل الموثقة.

3متى يحتاج إليها المحامي؟

—

4ميزات ERPOS المرتبطة بها

B26 الرواتب والموارد البشرية بالمتطلبات السعودية.

5الخدمة المحددة المطلوبة من المنصة

غير محدد.

6نوع الحاجة: قراءة أو إرسال أو مزامنة أو إشعارات

—

7البيانات الداخلة والخارجة وحساسيتها ومصدرها

بيانات موظفين.

8هل يوجد API رسمي موثق لهذه الخدمة تحديدًا؟

لم نجد في الملفات ولا في المصادر التي رُوجعت واجهة برمجية رسمية موثقة لهذه الخدمة تحديدًا: غير مثبت في المصادر التي تمت مراجعتها. لا نكتب endpoints أو حقولًا.

9المصدر الرسمي وتاريخ التحقق

المصدرالرابطما تحقّقنا منهتاريخ التحقق
قوىhttps://qiwa.saيفتح بعنوان «قوى» لكن المحتوى لم يكتمل تحميله؛ لم نتحقق من أي خدمة2026-11-04

10حالة التحقق

UNKNOWN

UNKNOWN.

11ما الذي يثبته المصدر الرسمي وما الذي لا يثبته؟

—

12التسجيل والاعتماد والتفويض والمصادقة وبيئة الاختبار

—

13خطوات الربط من جهة ERPOS

لا شيء قبل تحديد الحاجة.

14تصميم Adapter مستقل للمنصة

واجهة XAdapter مستقلة في legal_erp/integrations/x.py ترث النمط الموحد نمط موصل التكامل بعمليات: fetch. تنفيذان: يدوي (يفتح نموذج إدخال للموظف ويسجل المصدر «يدوي») ورسمي (لا يُكتب قبل استلام توثيق رسمي وموافقة)، ويُختار من الإعداد لكل مكتب اقتراح هندسي.

15تدفق البيانات ومخطط التسلسل

—

16نموذج الطلب والاستجابة

لا يوجد.

17انتهاء المهلة وانقطاع الخدمة والرفض وتضارب الحالة

18منع التكرار وإعادة المحاولة الآمنة

كل عملية صادرة بمفتاح عدم تكرار يُحفظ مع السجل؛ إعادة المحاولة ترسل المفتاح نفسه، وكل حدث وارد يُتجاهل إن تكرر معرّفه أو بصمته B43 طبقة التكامل المركزية.

19حفظ المصدر ووقت الجلب وإيصال الجهة وسجل التدقيق

يُحفظ مع كل قيمة: data_source (يدوي/الجهة)، وقت الجلب، معرّف الاستدعاء أو رقم الإيصال من الجهة إن وُجد، والمستخدم أو المهمة المجدولة. سجل الاستدعاء لا يحفظ جسم الاستجابة ولا بيانات شخصية (خطة ناجز ص14).

20المسار اليدوي المصرح به

أي إجراء في قوى لا يمكن أتمتته من ERPOS في الوضع الحالي. الموظف المخوّل ينفذه بنفسه في المنصة الرسمية بحسابه، ثم يسجل النتيجة والمرجع في ERPOS مع إرفاق ما يثبت. لا يُطلب من المحامي كلمة مروره ولا تُستخدم جلسته الشخصية (خطة ناجز ص17).

21اختبارات التكامل والفشل والتفويض والتكرار والعزل

المعرّفالنوعالسيناريوالنتيجة المتوقعة
INT-QIW-01تكاملبيئة وهمية تعيد نجاحًاتُحفظ القيمة بمصدرها ووقتها.
INT-QIW-02فشلمهلة ثم نجاحإعادة واحدة بلا تكرار.
INT-QIW-03تفويضمفتاح أو تفويض غير صالحفشل دائم وتنبيه، لا إعادة.
INT-QIW-04تكرارإرسال الحدث نفسه مرتينيُعالج مرة.
INT-QIW-05عزلمكتبان على الخادم نفسهلا يرى أحدهما بيانات الآخر ولا مفتاحه.

22المخاطر والقرارات التي تحتاج موافقة الجهة

—