واجهات البرمجة والتكامل — المرحلة 4

#تعريف المرحلة

• اسم المرحلة: Messenger + الصوت/الفيديو + المجموعات/المجتمعات
• الأولوية: متوسطة إلى عالية — التواصل الفوري والمجتمعات
• المدة التقديرية: الشهور 11–14 (16 أسبوعًا)
• هدف المرحلة: إطلاق تطبيق مراسلة مستقل ومحادثات موثوقة ومكالمات صوت/فيديو ومجموعات ومجتمعات آمنة وقابلة للتوسع.
• بوابة الخروج: Messenger مستقر مع مزامنة متعددة الأجهزة، جودة مكالمات مقبولة وعمليات سلامة وتشغيل واضحة.

#التفاصيل

• REST لإنشاء المحادثات والتاريخ والمرفقات والإدارة، وWebSocket للأحداث والرسائل والحضور.
• Client-generated IDs ورسائل idempotent وsequence/ack/resume بعد انقطاع الاتصال.
• Call signaling آمن للعروض/الإجابات/ICE مع authorization لكل session ومدة صلاحية قصيرة.
• APIs للمجموعات والقنوات والأدوار والدعوات والحظر والكتم والبلاغات.
• حدود حجم ومعدل ومشاركة ملفات وواجهات مستقرة لإصدارات التطبيق القديمة.

#ضوابط التنفيذ

• لا يُكسر عميل منشور؛ أي تغيير غير متوافق يحتاج إصدارًا وفترة إهمال.
• كل endpoint يوثق المصادقة والصلاحية والlimits والأخطاء والأمثلة.

#آلية العمل والتتبع

1. تحويل البنود إلى Epics وStories لها مالك ومعيار قبول واعتماديات.
2. مراجعة أسبوعية للتقدم والمخاطر والقرارات والتغييرات، وتحديث الوثائق مع الكود.
3. عرض دوري على العميل في بيئة مشتركة، ثم توثيق الملاحظات وقرار القبول أو الإرجاع.
4. منع إغلاق أي بند دون اختبار وأثر موثقين حسب طبيعته.

#أدلة الإنجاز المطلوبة

• OpenAPI/AsyncAPI، examples، contract tests وchangelog.
• نسخة مرقمة بتاريخ التسليم ومذكور فيها البيئة والإصدار.
• ربط العيوب أو الاستثناءات المفتوحة بمالك وموعد مستهدف.

#الاعتماديات والانتقال

• قبل البدء: إغلاق بوابة قبول المرحلة 3 أو توثيق استثناء رسمي.
• بعد الإنجاز: توفير مدخلات مستقرة للمرحلة 5 دون نقل دين حرج غير معلن.

#المسؤوليات

• مالك المنتج: اعتماد الأولوية والسلوك ومعايير القبول.
• القائد التقني: اعتماد التصميم الفني والمخاطر وقابلية التشغيل.
• الجودة والأمن: تقديم أدلة الاختبار وعدم وجود موانع إصدار.
• العميل: توفير القرارات والحسابات والمحتوى والموافقات في المواعيد المتفق عليها.