دليل المهندس لتكاملات المنصّات الحكومية السعودية: نفاذ، أبشر، واثق، إيجار، سكني — ما يتكرّر في كل مشروع

كل منتج جادّ في السعودية يصل إلى اللحظة نفسها: «نحتاج الربط مع نفاذ». ثم واثق للسجل التجاري، ثم إيجار للعقود، ثم سكني أو أبشر أو مقيم حسب القطاع. فعلناها في منصّات العقار والحجز والتوقيع والتوظيف، وهذا ما يتكرّر بغضّ النظر عن المنصّة.

الخريطة: من يفعل ماذا

• نفاذ: المصادقة الوطنية الموحّدة — «سجّل الدخول بهويتك». يمنحك هوية موثّقة وبيانات أساسية.
• أبشر / يقين: التحقق من بيانات الأفراد (الهوية، تاريخ الميلاد) ومطابقتها.
• واثق: بيانات السجل التجاري والمنشآت — من يملك الشركة ومن يمثّلها.
• إيجار: توثيق عقود الإيجار السكنية والتجارية.
• سكني: بوابة السكن — المشاريع والوحدات والدعم.
• مقيم / مساند: بيانات المقيمين والعمالة — لأنظمة الموارد البشرية والرواتب.
• فاتورة (ZATCA): الفوترة الإلكترونية — لكل من يبيع.

القاعدة 1: الاعتماد (Onboarding) هو المشروع الحقيقي

الكود يستغرق أسبوعين؛ الحصول على الاعتماد، الشهادات، بيئة الاختبار، والتوقيعات يستغرق شهرين. ابدأ الأوراق يوم توقيع العقد لا يوم اكتمال الواجهة.

القاعدة 2: طبقة تجريد واحدة لكل جهة

وحدة داخلية اسمها Identity خلفها نفاذ، ووحدة Business خلفها واثق، ووحدة Tenancy خلفها إيجار. منطق العمل يتحدّث إلى وحداتنا لا إلى واجهات الجهات. حين تغيّر جهة إصدار واجهتها (وستفعل)، يتغيّر ملف واحد.

لا تدع كلمة «نفاذ» تظهر في أكثر من مجلد واحد في مستودعك.

القاعدة 3: كل استدعاء له سجل وسبب

الجهات الحكومية تسأل: لماذا استعلمتَ عن هذا الشخص؟ سجّل: من طلب، لأي عملية، متى، وما النتيجة — قبل أن يُطلب منك. هذا أيضاً ما يجعل امتثال PDPL حقيقياً لا ورقياً.

القاعدة 4: صمّم للانقطاع والبطء

• مهلات صريحة وإعادة محاولة بتراجع أسّي.
• مسار بديل بشري: «تعذّر التحقق الآن — سنكمل خلال ساعة وسنُشعرك».
• لا تُوقف عملية العميل كلها بسبب استعلام ثانوي؛ اجعل التحقق غير المتزامن حيث يمكن.

القاعدة 5: بيئة المحاكاة أولاً

لكل تكامل نبني محاكياً محلياً يعيد نفس الأشكال والأخطاء التي رأيناها في الإنتاج. الفريق يطوّر ويختبر بلا اعتماد على توفّر بيئة الجهة، والاختبارات الآلية تشمل حالات الفشل الحقيقية (شهادة منتهية، رقم غير موجود، مهلة).

أنماط حسب القطاع

• العقار: نفاذ + إيجار (+ سكني للدعم). المستأجر والمالك موثّقان والعقد موثّق قبل أي دفعة.
• الموارد البشرية والرواتب: مقيم/مساند + حماية الأجور. في أنظمتنا للرواتب، ملف حماية الأجور يُولَّد من المسيّر المعتمد لا من ملف Excel يدوي.
• التوقيع الإلكتروني: نفاذ للهوية + ختم زمني + سجل تدقيق — كما في توقيعك.
• التجارة: واثق لتوثيق التاجر + فاتورة للفوترة.

خلاصة لصاحب القرار

التكاملات الحكومية ليست ميزة تُضاف في النهاية؛ هي ما يحدّد إن كان منتجك يُعتمد أصلاً. ابدأها مبكّراً، اعزلها معمارياً، سجّل كل شيء، وابنِ المحاكي قبل الواجهة. الفرق بين مشروع يُطلق في الموعد وآخر يتأخّر نصف سنة هو غالباً هذا الفصل.