واجهات البرمجة والتكامل — المرحلة 3
#تعريف المرحلة
- اسم المرحلة: تطبيقات الهاتف + Reels/Stories/Notifications
- الأولوية: عالية — توسيع الوصول والتفاعل
- المدة التقديرية: الشهور 8–10 (12 أسبوعًا)
- هدف المرحلة: إطلاق تطبيق رئيسي على Android وiOS مع تكافؤ MVP وتجربة فيديو قصيرة وقصص وإشعارات قابلة للضبط.
- بوابة الخروج: إصدارات متاجر جاهزة أو منشورة تدريجيًا، مع خدمات وسائط وإشعارات مستقرة ومقاييس استخدام وسلامة.
#التفاصيل
- APIs لرفع Reels/Stories، حالة المعالجة، feed الفيديو، المشاهدات والتفاعل والحذف.
- Endpoints لتسجيل push token وتفضيلات الإشعار والقراءة والحذف وdeep-link payloads.
- سياسة payload صغيرة، pagination cursor، prefetch محسوب وURLs قصيرة العمر للوسائط الخاصة.
- Backward compatibility مع إصدارات التطبيق المدعومة وminimum-supported-version قابل للضبط.
- توثيق webhooks/callbacks لمزود الترميز إن استُخدم مع توقيع وإعادة محاولات.
#ضوابط التنفيذ
- لا يُكسر عميل منشور؛ أي تغيير غير متوافق يحتاج إصدارًا وفترة إهمال.
- كل endpoint يوثق المصادقة والصلاحية والlimits والأخطاء والأمثلة.
#آلية العمل والتتبع
- تحويل البنود إلى Epics وStories لها مالك ومعيار قبول واعتماديات.
- مراجعة أسبوعية للتقدم والمخاطر والقرارات والتغييرات، وتحديث الوثائق مع الكود.
- عرض دوري على العميل في بيئة مشتركة، ثم توثيق الملاحظات وقرار القبول أو الإرجاع.
- منع إغلاق أي بند دون اختبار وأثر موثقين حسب طبيعته.
#أدلة الإنجاز المطلوبة
- OpenAPI/AsyncAPI، examples، contract tests وchangelog.
- نسخة مرقمة بتاريخ التسليم ومذكور فيها البيئة والإصدار.
- ربط العيوب أو الاستثناءات المفتوحة بمالك وموعد مستهدف.
#الاعتماديات والانتقال
- قبل البدء: إغلاق بوابة قبول المرحلة 2 أو توثيق استثناء رسمي.
- بعد الإنجاز: توفير مدخلات مستقرة للمرحلة 4 دون نقل دين حرج غير معلن.
#المسؤوليات
- مالك المنتج: اعتماد الأولوية والسلوك ومعايير القبول.
- القائد التقني: اعتماد التصميم الفني والمخاطر وقابلية التشغيل.
- الجودة والأمن: تقديم أدلة الاختبار وعدم وجود موانع إصدار.
- العميل: توفير القرارات والحسابات والمحتوى والموافقات في المواعيد المتفق عليها.