تطوير البرمجيات
بناء واجهات برمجية إنتاجية باستخدام Python وFastAPI
كثيراً ما يطلق مطورو Python واجهة برمجية تعمل في بيئة التطوير ثم تصطدم بحركة مرور حقيقية وعملاء وحالات خطأ فعلية. يغطي هذا البرنامج المعالجة غير المتزامنة والتحقق عبر Pydantic وحقن التبعيات والمصادقة وعقود OpenAPI المُصدَّرة والأخطاء المنظمة والاختبار والنشر بالحاويات.
نظرة عامة
تعلم عملي قابل للتطبيق في بيئة العمل.
تمتلئ المسافة بين نقطة نهاية FastAPI تعمل وواجهة برمجية إنتاجية بكل ما تتجاهله الشروحات: ماذا يحدث حين يعطّل نداء خارجي حلقة الأحداث، وكيف يعرف العميل أن حقلاً قد تغيّر، وأين تُتحقَّق رموز المصادقة، وما الذي يجب أن يتضمنه جسم الخطأ ليتمكن شريك التكامل من التشخيص دون الاتصال بالدعم. يبني المشاركون خدمة واحدة على امتداد البرنامج: نماذج طلب واستجابة موصوفة بالأنواع، وتبعيات وجلسات قاعدة بيانات محقونة، وتفويض قائم على الرموز، وعقد OpenAPI منشور، ومجموعة اختبارات تعمل دون قاعدة بيانات حية، وصورة حاوية جاهزة للنشر.
المتطلبات المسبقة
معرفة عملية بلغة Python تشمل الدوال والأصناف وإدارة الحزم، ويفيد الإلمام ببروتوكول HTTP وقواعد البيانات العلائقية دون أن يكون شرطاً.
الأهداف
- بناء نقاط نهاية غير متزامنة في FastAPI دون تعطيل حلقة الأحداث.
- نمذجة حمولات الطلب والاستجابة عبر التحقق بـPydantic ومخططات موصوفة بالأنواع.
- إدارة جلسات قاعدة البيانات والإعدادات والعملاء عبر حقن التبعيات.
- تنفيذ مصادقة قائمة على الرموز وقواعد تفويض على مستوى كل مسار.
- نشر عقد OpenAPI وإدارة إصداراته بحيث يبني عليه شركاء التكامل أعمالهم.
- اختبار الخدمة وحوسبتها في حاوية ونشرها مع فحوص صحة وسجلات منظمة.
الفئة المستهدفة
- مطورو Python الذين يبنون خدمات خلفية أو يصونونها
- مهندسو الواجهة الخلفية المنتقلون من Flask أو Django REST Framework
- مهندسو البيانات والتعلم الآلي الذين يتيحون النماذج كخدمات
- مطورو التكامل الذين ينشرون واجهات برمجية للشركاء والفرق الداخلية
- المطورون الشاملون المسؤولون عن طبقة الخدمات الخاصة بهم
- القادة التقنيون الذين يضعون معايير الواجهات البرمجية لفرق Python
محاور البرنامج
هيكل واضح لرحلة التعلم.
محاور البرنامج
تظهر محاور البرنامج في صندوق واحد بدلاً من تحويل كل سطر إلى وحدة منفصلة.
الوحدة 1: أساسيات FastAPI ومعالجة الطلبات غير المتزامنة
التوجيه ومعاملات المسار والاستعلام ودورة حياة الطلب
النقاط المتزامنة وغير المتزامنة وما الذي يعطّل حلقة الأحداث فعلياً
المهام الخلفية وحدود التزامن والعمليات طويلة الأمد
هيكلة مشروع لخدمة ستتجاوز حدود الملف الواحد
الوحدة 2: التحقق من البيانات وتصميم المخططات باستخدام Pydantic
نماذج الطلب والاستجابة وقيود الحقول والمدققات المخصصة
فصل نماذج المجال الداخلية عن مخططات الواجهة البرمجية العامة
التسلسل والأسماء البديلة والتعامل مع الحقول الاختيارية والفارغة
أخطاء تحقق تخبر المستدعي بدقة بما يجب تصحيحه
الوحدة 3: حقن التبعيات والتخزين الدائم والإعدادات
منظومة التبعيات: النطاقات والاستبدالات والموارد المشتركة
جلسات قاعدة البيانات ومجمّعات الاتصال وحدود المعاملات
الإعدادات والأسرار وتهيئة البيئة دون قيم مضمّنة في الشيفرة
حقن عملاء HTTP والذاكرات المؤقتة والخدمات الخارجية لتسهيل الاختبار
الوحدة 4: المصادقة والتفويض وحماية الواجهة البرمجية
تدفقات OAuth2 بكلمة المرور والحامل وإصدار الرموز والتحقق منها
قواعد التفويض على مستوى المسارات وعلى مستوى الموارد
CORS وتحديد معدل الطلبات وضوابط حجم الطلب ومهلته
إدارة بيانات الاعتماد وتدوير المفاتيح وتسجيل الطلبات لأغراض التدقيق
الوحدة 5: العقود والأخطاء وإدارة إصدارات الواجهة البرمجية
توثيق OpenAPI المولّد والحفاظ على دقته مع تطور الشيفرة
أغلفة أخطاء متسقة ورموز حالة وتفاصيل مشكلة موحدة
استراتيجيات الإصدار وإيقاف نقطة نهاية دون كسر تطبيقات العملاء
الترقيم والترشيح وتكافؤ العمليات في طلبات الكتابة
الوحدة 6: الاختبار والتحزيم والنشر الإنتاجي
اختبار نقاط النهاية باستخدام pytest وعملاء الاختبار واستبدال التبعيات
التجهيزات والبدائل الوهمية التي تغني عن قاعدة بيانات حية
تحزيم الخدمة في حاوية باستخدام Uvicorn ومدير عمليات إنتاجي
فحوص الصحة والسجلات المنظمة والمقاييس لخدمة منشورة
المواد المقدمة
- دليل الدورة وأمثلة شيفرة موثّقة وملاحظات مرجعية
- بيئة معملية عملية ومستودعات بداية جاهزة
- تمارين وقوائم تحقق وقوالب شيفرة قابلة لإعادة الاستخدام
- شهادة إتمام من 4D
- دعم فني بعد انتهاء البرنامج
خيارات التدريب
يمكن تقديم البرامج داخل مقر المؤسسة، أو عن بُعد، أو بصيغة مدمجة بحسب جدول الفريق وموقعه وأهداف التعلم. عندما يتضمن البرنامج شهادة أو اختباراً من جهة خارجية، تبقى قواعد الشهادة ورسومها خاضعة لسياسات الجهة المانحة، بينما تقدم 4D التدريب ودعم التحضير.
لماذا البعد الرابع
تكيّف 4D هذا البرنامج مع عمليات التكامل التي يجب أن تدعمها خدمتكم فعلياً، سواء أكان المستهلكون داخليين أم أنظمة شركاء أم نقاط نهاية لخدمة النماذج. ويخرج المشاركون بخدمة FastAPI عاملة وعقد OpenAPI منشور تمت مراجعته وفق متطلبات التكامل لديكم ومنظومة اختبار ونشر قابلة للتوسع فوراً.
دورات ذات صلة
أساسيات البرمجة بلغة Python
مقدمة عملية إلى Python للمهندسين والمحللين الذين يحتاجون شيفرة تعمل فعلاً لا مقتطفات تعليمية. يكتسب المشاركون طلاقة في أنواع البيانات والمجموعات والدوال والملفات ومعالجة الأخطاء، ثم يبنون برنامجاً صغيراً يقرأ بيانات حقيقية وينتج تقريراً قابلاً للاستخدام.
View coursePython المتوسط وممارسات الشيفرة النظيفة
برنامج موجّه للمطورين الذين تعمل شيفرة Python لديهم لكن يصعب تغييرها. يغطي dataclasses والمولّدات والمزخرفات ومديري السياق وتلميحات الأنواع، ثم يطبّق خطوات إعادة الهيكلة التي تحوّل وحدة من تسعمئة سطر إلى وحدات صغيرة مختبَرة تحرسها أدوات black وruff وmypy.
View courseأتمتة المهام المكتبية والبرمجة النصية بلغة Python
برنامج موجّه للفرق التي تهدر ساعات أسبوعية في أعمال متكررة على الملفات والجداول والتقارير. يقوم المشاركون بأتمتة هذه المهام باستخدام Python: معالجة الملفات دفعياً وجداول Excel وCSV واستدعاء واجهات REST وتنبيهات البريد والمهام المجدولة التي تعمل دون إشراف وتبلّغ بوضوح عند الفشل.
View course