وكيل Backend Engineer
ينفذ وكيل Backend Engineer جانب الخادم من ميزة انطلاقا من تصميم موافق عليه، ويذكر الملفات التي يمسها وأثر التغيير في واجهات API. ويعمل في Feature SDLC.
وكيل Backend Engineer ينفذ التغييرات من جهة الخادم. يعمل انطلاقا من تصميم موافق عليه ويصف التغيير: الملفات التي يمسها، والكود الأساسي، والأثر في واجهات API.
أين يعمل
| سير العمل | الخطوة |
|---|---|
| Feature SDLC | Backend |
سير العمل Feature SDLC هو أطول مسارات سير العمل المضمّنة، وله ثماني خطوات: المتطلبات، وخطة التسليم، والتصميم التقني، والواجهة الخلفية، والواجهة الأمامية، والاختبارات الشاملة من البداية إلى النهاية، والمراجعة الأمنية، ووثائق المستخدم. ووكيل Backend Engineer هو الخطوة الرابعة. يأتي مباشرة بعد التصميم التقني الذي يضعه وكيل Architect، وقبل وكيل Frontend Engineer.
المدخلات
- مهمة الجلسة.
- لقطة للقراءة فقط من الملفات ذات الصلة في مستودع المشروع: المسارات والخدمات ونماذج البيانات والاختبارات الموجودة.
- الخطوات السابقة: المتطلبات من وكيل Product Analyst، وخطة التسليم، والتصميم التقني. وفي سير عمل من ثماني خطوات تصله هذه مختصرة.
المخرجات
وصف للتغيير من جهة الخادم، ملفا ملفا، يتضمن:
- نقاط النهاية الجديدة والمعدلة، وهل يكسر أي تغيير فيها عمل من يستدعونها حاليا.
- تغييرات نموذج البيانات، وينبغي أن يكون التصميم قد سماها من قبل.
- معالجة الأخطاء والتحقق من صحة المدخلات.
يبني وكيل Frontend Engineer عمله على واجهة API التي يصفها. وبعد خطوة Frontend، تكتب جولة كتابة الكود في الجلسة الملفات في نسخة مؤقتة من المستودع، وتعمل اختبارات المشروع على تلك الفروقات. ثم تعمل الخطوات الثلاث الأخيرة (E2E tests و Security review و User docs) على التغيير المكتوب، وتراجع جولة الملاحظات الفروقات.
مثال على تشغيل
مثال توضيحي، وليس جلسة مسجلة. لميزة تتيح للعملاء حفظ إعدادات مسبقة للمرشحات، يقترح وكيل Backend Engineer جدولا للإعدادات المسبقة يملكه المستخدم ومساحة العمل، وثلاث نقاط نهاية لعرضها وإنشائها وحذفها، وحدا من 20 إعدادا مسبقا لكل مستخدم مع رسالة خطأ واضحة عند تجاوزه. ويلاحظ أن العرض يجب أن يقتصر على مساحة عمل المستدعي، وأن حذف إعداد مسبق يملكه شخص آخر يجب أن يعيد «غير موجود» لا «ممنوع». ثم يخطط وكيل Frontend Engineer الواجهة على أساس نقاط النهاية تلك.
الحدود
- لا يشغل خادما ولا قاعدة بيانات ولا عمليات ترحيل. إنه يصف الكود.
- تقرأ جولة كتابة الكود قدرا ثابتا مما كتبته الخطوات التي قبلها. وفي Feature SDLC تلك خمس خطوات طويلة، فقد يقع جزء من الخطوات الأخيرة خارج ما تقرؤه. تأكد أن الفروقات تغطي ما خطط له.
- يبلغ عن التغييرات التي تكسر واجهة API نصا. ولا شيء يفرض إدارة الإصدارات ما لم تفرضها اختباراتك. راجع بوابات الجودة.
الأسئلة الشائعة
لماذا لا يستخدم وكيل Builder لهذا العمل؟
يقسم سير العمل Feature SDLC التنفيذ إلى قسمين، لتحصل أعمال الخادم وأعمال العميل كل منها على خطوة مركزة. يتولى وكيل Backend Engineer جانب الخادم، ويتولى وكيل Frontend Engineer جانب العميل.
هل يكتب الملفات بنفسه؟
لا. فهو كغيره من الوكلاء يعيد نصا. أما الملفات فتكتبها جولة كتابة الكود في الجلسة، وتنتج الفروقات بعد خطوة Frontend، وقبل الخطوات التي تفحص العمل.