عقرها — الباك إند لتطبيق عقاري للبيع والإيجار والخدمات
Laravel · PHP 8 · REST APIs
الواجهات البرمجية والتكاملات
يصمّم عمر خالد واجهات REST ويربط تطبيقات Laravel ببوابات الدفع ومزوّدي OAuth ونماذج ذكاء اصطناعي مثل Google Gemini وخدمات منفصلة مكتوبة بـ Python، مع أخطاء محدّدة النوع ومهلات زمنية وإعادة محاولة واختبارات تثبّت شكل التعامل بين الأنظمة.
01 — المشكلة
التكاملات هي المكان الذي تنكسر فيه الأنظمة: مزوّد يتأخر في الرد، أو إشعار يصل مرتين، أو نموذج ذكاء اصطناعي يُطلب منه ما لا يحق للمستخدم فعله.
التكامل المتين يعامل كل اتصال خارجي على أنه غير مضمون، وكل مدخل خارجي على أنه غير موثوق.
02 — ما الذي ستحصل عليه
نقاط REST بإصدارات وموارد وتحديد معدّل الطلبات وتوثيق.
الدفع وتسجيل الدخول عبر OAuth وشركات الشحن وجداول البيانات ومزوّدي البريد.
مساعدات بنماذج لغوية تُفحص أدواتها على الخادم حسب الصلاحيات؛ فالنموذج ليس حدًّا أمنيًا أبدًا.
عملاء برمجيون محدّدو الأنواع ومهلات زمنية وإعادة محاولة حيث تكون آمنة فقط واختبارات للعقد ببيانات ثابتة.
03 — كيف سنعمل
نحدّد الأهداف والمستخدمين والقيود ومعنى "الإنجاز". تحصل على نطاق عمل مكتوب بالأولويات وتقدير ثابت أو بسقف واضح.
نتفق على نموذج البيانات والشاشات الأساسية والتكاملات قبل كتابة الكود، فتظهر المفاجآت مبكرًا وبتكلفة أقل.
نسخة تعمل على خادم تجريبي كل أسبوع، مغطاة باختبارات آلية، مع تحديث مكتوب مختصر.
نشر على بيئة الإنتاج ومراقبة وتوثيق وجولة تعريفية على لوحة الإدارة، ثم دعم مستمر عند الحاجة.
05 — FAQ
نعم. النهج المستخدم في الإنتاج: لا يستطيع المساعد سوى استدعاء أدوات على الخادم، وكل أداة تتحقّق من صلاحيات المستخدم، ولا يرى النموذج أي بيانات لا يستطيع المستخدم الوصول إليها مباشرة.
نعم. يُوثَّق كل من نقاط الوصول والمصادقة وصيغ الأخطاء وأمثلة الطلبات ضمن التسليم.
الخطوة التالية
أخبرني عن مشروعك أو فريقك في بضعة أسطر، وستصلك إجابة خلال 24 ساعة بالخطوات التالية، دون أي أسلوب بيعي.
أو راسلني على contact@omarkhaled.info