إثراء
بنية واجهات برمجية لإدارة الإسكان لمشغّلي الحج في المملكة.
- السنة
- 2023
- المنطقة
- Saudi Arabia
- المنصّات
- Backend APIs
- التقنيات
- .NET · REST · SQL Server
الوضع قبل البدء.
يدير مشغّلو الحج آلاف غرف الحجاج في مكة المكرّمة والمدينة المنوّرة، مع تنسيق الحجوزات والتنقلات والإشغال مع الجهات الحكومية والعاملين في الميدان.
المنطق تشغيلي معقّد، والموسم قصير، والبيانات موزّعة على أنظمة متعدّدة من موردين مختلفين — عكس تمامًا لمنتج على أرض بيضاء.
ما الذي طُلب منّا حلّه.
احتاج المشغّل إلى مجموعة موثّقة وقابلة للاختبار من واجهات البرمجة يمكن لتطبيقات المراحل التالية — من أجهزة iPad الميدانية حتى البوابات الحكومية — الاعتماد عليها، دون إعادة تصميم النموذج في كل مرة.
يجب أن تكون الواجهات قابلة للاكتشاف ومحكومة بالإصدار وواضحة لا لبس فيها تحت الجدول الزمني الضاغط للحج، حيث يكلّف أي تغيير سيئ للعقد أيامًا.
كيف بنينا الحل.
وحّدنا المجال في واجهة REST واحدة، مع توثيق OpenAPI واختبارات عقد بوصفها المرجع الوحيد.
غُلِّفت تكاملات الموردين القديمة خلف نقاط نهاية مجال نظيفة لكي لا ترى الفِرق التالية سوى الحجاج والغرف والحجوزات — لا خصائص الموردين خلفها.
ما سلّمناه.
عقود موثّقة
مخطط OpenAPI 3.1، ومكتبات عميل مولّدة، وأمثلة تعمل بوصفها اختبارات تكامل.
تجريد الموردين
محوّلات تعزل كل نظام خارجي؛ يبقى نموذج المجال نظيفًا حتى عند تغيير الموردين.
تفويض قائم على الأدوار
المشغّل والمشرف والوكيل والجهة الحكومية، كل دور يرى الحقول والإجراءات التي يحتاجها فقط.
تدقيق وعدم تكرار
كل استدعاء يغيّر الحالة يحمل مفتاح عدم تكرار ويكتب إلى سجل تدقيق إلحاقي فقط.
ماذا يعني الإطلاق.
- استبدل فوضى تعدّد الموردين
- واجهة واحدة موحّدة
- عقود مقروءة آليًّا
- OpenAPI
- آمنة للتغيير أثناء الموسم
- محكومة الإصدار
- كل تغيير قابل للتتبّع
- قابلة للتدقيق
ماذا تحت الغطاء.
- البيئة
- .NET على Linux
- المواصفة
- OpenAPI 3.1
- التخزين
- SQL Server مع أرشيف Blob
- المصادقة
- OAuth 2.1 بنطاقات أدوار
- الإطلاق المستمر
- Azure DevOps Pipelines
سي لايف كونكت
أول منصّة في مصر تجمع أصحاب القوارب والمستأجرين والمشترين.
لديك كرّاسة شروط؟ لديك فكرة؟ لنبنيها معًا.
نرد على كل استفسار خلال يوم عمل واحد. أخبرنا عن مشروعك والجدول الزمني وكيف يبدو النجاح بالنسبة إليك.