واجهات API وSaaS ومعمارية الأنظمة
يغطي هذا المحور الحدود التي تجعل منتجات SaaS مفهومة وآمنة: سياق العميل والصلاحيات وعقود API والإجراءات الدائمة وعزل قواعد البيانات ومعاني الفشل الواضحة.
كيف تصبح إعادة المحاولة آمنة بين الخدمات والمهام؟
متى يكون Modular Monolith أفضل من الخدمات الموزعة؟
إطار القرار
ابدأ بالحدود، ثم اختر التقنية.
احمِ الحدود
استخرج نطاق العميل والصلاحيات من هوية موثوقة، لا من Payload غير موثوق.
اجعل إعادة المحاولة واضحة
Idempotency Keys وOutbox وDurable Inbox أدوات لصحة العمل، وليست تفاصيل تشغيلية فقط.
وزّع النظام لسبب واضح
افصل الخدمات عندما تبرّر الملكية أو السعة أو عزل الفشل كلفة التنسيق.
أدلة مختارة
كل المقالات ←مقالات تكمل هذا المسار.
Saudi commerce · Webhook operations
تدوير Webhooks في سلة: غيّر العنوان دون فقد الأحداث
خطة تحويل إنتاجية لنقل Webhooks سلة بين العناوين مع حفظ الأحداث والأمان والرجوع وحالة الاشتراكات لكل متجر.
اقرأ الدليلAI infrastructure · Vector searchتعدد العملاء في Qdrant: اعزل الاسترجاع والترتيب والتخزين
تصميم إنتاجي لاسترجاع آمن متعدد العملاء في Qdrant: نطاق موثوق، وإحصاءات Sparse مستقلة، وترقية مدروسة للعملاء الكبار.
اقرأ الدليلAI security · Anthropic CVPبرنامج Anthropic CVP: قيود أقل تحتاج معمارية أقوى
وسّعت Anthropic برنامج CVP إلى ثلاثة مستويات؛ لكن عمل الإنتاج الحقيقي هو الهوية والتفويض والعزل وضبط Egress والاحتفاظ والإلغاء.
اقرأ الدليلAI · Decision infrastructureواجهة OpenAI Decisions API: ابنِ نظام قرار لا عتبة سحرية
تحوّل واجهة OpenAI Decisions API النصوص والصور إلى احتمالات واختيارات ودرجات؛ لكن الجزء الأصعب هو سياسة القرار المحيطة بالنتيجة.
اقرأ الدليلAI infrastructure · Anthropic APIحقل line في Anthropic Models API: توقّف عن تحليل أسماء النماذج
أضافت Anthropic حقلًا لعائلة النموذج إلى Models API. إليك استخدامه للاكتشاف من دون خلط العائلة بالقدرات أو بسياسة الإصدار.
اقرأ الدليلAI · Content provenancetextGrain من OpenAI: ما الذي تثبته العلامة المائية للنص وما الذي لا تثبته
أتاحت OpenAI العلامة المائية للنص اختياريًا لنماذج API محددة. يشرح الدليل textGrain وحدود الكشف ومعمارية Provenance آمنة.
اقرأ الدليلArchitecture · Distributed consistencyTransactional Outbox: امنع Dual Write دون ادعاء Atomicity
دليل إنتاجي لكتابة الحالة والحدث في Transaction واحدة ثم النشر عبر Polling أوCDC مع Ordering وIdempotency وتعافٍ قابل للمراقبة.
اقرأ الدليلAI · Speech generationGemini 3.8 TTS في الإنتاج: الأصوات والبث والموافقة
دليل إنتاجي لـGemini 3.8 Flash TTS وFlash‑Lite يشرح اختيار النموذج، والبث الصوتي، والأصوات الدائمة، والموافقة، والتخزين المؤقت والتقييم.
اقرأ الدليلAI agents · Runtime architectureحلقات GPT‑6 الوكيلة: أدوات غير متزامنة وتوجيه وتعافٍ آمن
دليل إنتاجي لأدوات GPT‑6 غير المتزامنة والتوجيه أثناء التنفيذ مع سجل الأعمال المعلقة والتعافي والموافقات والميزانيات والمراقبة.
اقرأ الدليلAI infrastructure · API latencyوضع OpenAI Ultrafast: هندسة زمن الاستجابة لا سرعة التوكن فقط
دليل إنتاجي لتوجيه طلبات GPT‑6 Astra Ultrafast عبر WebSockets وميزانيات التأخير وحدود المعدل والإقامة والـFallback وضبط التكلفة.
اقرأ الدليلDevOps · Docker BuildKitبناء Docker آمن: Cache سريع بلا تسريب أسرار
دليل إنتاجي لـBuildKit Cache وSecret Mounts وMulti-stage Runtime، مع SBOM وProvenance قابلة للتحقق من دون تسريب الأسرار.
اقرأ الدليلE-commerce engineering · Shopifyحزم Shopify: صمّم عقد تحويل السلة قبل الكود
دليل إنتاجي لحزم Shopify الثابتة والمخصصة: التركيب والتسعير والمخزون وعمليات Cart Transform وسياسة الفشل والمصالحة.
اقرأ الدليل