قيّم المشروع وسلّمه للتشغيل

ابنِ مجموعة تقييم تمثل الشغل

مجموعة التقييم مش قائمة أمثلة تختارها لأنها نجحت. نحدد أنواع الطلبات المهمة ونكتب النتيجة المرجعية قبل تجربة النسخة الجديدة.

عينة مدار فيها 10 حالات:4 كاملة، 2 ناقصة، 1 تعليمات مضللة، 1 خارج الصلاحية، 1 مكرر، 1 مهلة بعد الأثر. هذه عينة صغيرة للتدريب وليست إثباتًا إحصائيًا للسوق.

كل حالة لها سبب وجود:المكتملة تقيس الفائدة، والناقصة تقيس الامتناع، والبقية تختبر حدود التنفيذ. حذف حالات الفشل يرفع النسبة شكليًا ويضعف التقييم.

نفصل الحالات المستخدمة أثناء تطوير Prompt عن حالات جديدة للاختبار النهائي. حفظ أجوبة الأمثلة لا يعني أن المساعد تعلم التعامل مع طلب مختلف.

التسليم يضم مصادر الحالات والقرارات المتوقعة وأسبابها. عند اختلاف المراجعين نراجع المرجع نفسه بدل اتهام النموذج مباشرة.

مثال محلول
10 حالات:4 كاملة+2 ناقصة+1 مضللة+1 خارج نطاق+1 مكرر+1 مهلة.

الطلب
تحقق من العدد وفسر دور الفئات.

المخرج
المجموع 10. الكاملة للفائدة؛ الناقصة لعدم الاختلاق؛ المضللة لحدود التعليمات؛ خارج النطاق للعزل؛ المكرر لمنع الأثر المزدوج؛ المهلة للاستعادة.

لماذا؟
العينة تغطي السلوك لا أسلوب النص فقط.
العدد قابل للمراجعة.
العينة الصغيرة لا تثبت كل الواقع.

اقرأ الجودة على مستوى الأخطاء

نسبة النجاح مفيدة لكنها قد تخفي خطأ خطيرًا. لو 9 من 10 صحيح والعاشرة كشفت بيانات شركة أخرى، لا نعتبر المشروع جاهزًا لأنه حقق 90%.

نصنف الأخطاء إلى صحة بيانات وإسناد وصلاحية وأثر مكرر. بوابات الصلاحية ومنع الأثر غير المصرح لا يعوضها تحسن الأسلوب أو السرعة.

الحالة الناقصة التي توقفت بشكل صحيح تحسب نجاحًا في الاختبار، ولا تعتبر طلب خدمة مكتملًا. لازم اسم المؤشر يوضح ما نعده.

نراجع كل فشل ونربطه بإصلاح قابل للاختبار. مثال:كشف نطاق آخر يحتاج إصلاح التفويض في الخادم، وليس Prompt ألطف.

التقرير يعرض العدد والمقام وأنواع الفشل وقرار الإطلاق. إذا ظهرت مخالفة حرجة نوقف الإصدار ونصلحها ثم نعيد المجموعة.

مثال محلول
نجحت 9 حالات من 10؛ الفشل الوحيد قراءة طلب T2 بواسطة T1.

الطلب
احسب نسبة الاختبار وقرار جاهزية الإصدار.

المخرج
نجاح الحالات 90%. الإصدار مرفوض بسبب خرق عزل؛ نصلح التفويض ونعيد اختبارات النطاق والحالات الكاملة.

لماذا؟
النسبة لا تخفي شدة الفشل.
السبب مرتبط بطبقة الصلاحيات.
القرار قابل للمراجعة بإعادة الاختبار.

قِس الوقت والتكلفة مع إعادة العمل

القياس التجاري يشمل وقت الإنسان والأداة والتصحيح. السرعة على شاشة المساعد وحدها لا تقول إن العمل كله أصبح أسرع.

في عينة 10 طلبات كان الزمن السابق 60 دقيقة. بعد الحل:10 دقائق تجهيز و 20 مراجعة و 6 تصحيح؛ الإجمالي 36 والوفر 24 دقيقة، أي 40%.

تكلفة التدريب المفترضة لكل استدعاء 0.02 وحدة نقدية؛ استخدمنا 15 استدعاء فالتكلفة 0.30. هذا افتراض حسابي وليس سعر مزود حالي.

لا تحول 24 دقيقة إلى ربح مالي بلا معدل تكلفة عمل واضح وفترة تحقق. وقد يكون الوفر وقتًا متاحًا لتحسين الخدمة، وليس خفضًا فعليًا للمصروف.

التقرير يذكر العينة وطريقة القياس وما استُبعد. مقارنة طلبات سهلة بعد الحل بطلبات صعبة قبله تعطي رقمًا جذابًا لكنه غير عادل.

مثال محلول
10 طلبات؛ قبل 60 دقيقة؛ بعد 10 تجهيز+20 مراجعة+6 تصحيح؛ 15 استدعاء×0.02 وحدة مفترضة.

الطلب
احسب الزمن والوفر والتكلفة وحدود الادعاء.

المخرج
بعد 36 دقيقة؛ الوفر 24 دقيقة=40%. التكلفة 0.30 وحدة افتراضية. لا ادعاء سعر حالي أو ربح محقق.

لماذا؟
كل أجزاء الزمن مشمولة.
الحسابات لها وحدات ومقام واضحان.
التكلفة فرض تدريبي وليست تسعيرًا.

أطلق نسخة صغيرة مع مراقبة وتراجع

الإطلاق قرار تدريجي له حدود حجم وإيقاف، مش نقل كل الشغل مرة واحدة بعد نجاح مثال. نبدأ بمجموعة تدريب أو نطاق مصرح صغير ونراقب النتائج.

نسخة v1 لها عقد و Prompt وسياسة موافقات ومجموعة اختبارات محفوظة. عند تعديل v2 نعيد المجموعة ونقارن قبل تحويل العمل إليها.

خطة الإيقاف توقف بدء آثار جديدة، لكنها لا تمحو آثارًا حدثت بالفعل. العمليات الجارية تحتاج تصالحًا مع سجلات الطرف الخارجي حتى لا تضيع.

الرجوع إلى v1 يعيد سلوك التنفيذ للمحاولات المقبلة وفق خطة، ولا يعني مسح مسودات v2. التفرقة تمنع وعدًا بتراجع كامل لا يقدر النظام عليه.

نحدد من يقرر الإيقاف ومن يعالج الطابور وما الدليل على الاستقرار. لو ظهرت مشكلة حرجة، الأولوية لوقف الأثر وفهم الحالة قبل التوسع.

مثال محلول
v2 فشل في عزل حالة واحدة؛ v1 كانت اجتازت المجموعة؛ 3 عمليات v2 قيد التنفيذ.

الطلب
ضع خطة إيقاف واستعادة توضح حدود الرجوع.

المخرج
أوقف بدء عمليات v2؛ راجع العمليات الثلاث بالاستعلام؛ لا تمح آثارها. أعد اختبار v1 قبل توجيه عمل جديد لها؛ وثق سبب الإيقاف.

لماذا؟
الإيقاف لا ينسف العمليات الجارية.
الرجوع للكود غير إلغاء آثار خارجية.
قرار الاستعادة له دليل.

سلّم دليل تشغيل يفهمه المسؤول

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

لكل عطل نكتب علامة ظاهرة وفحصًا آمنًا وخطوة علاج وحدًا للتوقف. مثال 403:راجع النطاق والاعتماد مع المسؤول، ولا توسع الصلاحيات عشوائيًا.

نحدد مالك العملية ومسؤول الربط ومراجع المحتوى. يمكن أن يجمع شخص أدوارًا في فريق صغير، لكن تبقى المسؤوليات مكتوبة.

ملف الأسرار لا يرفق بالدليل العام. نذكر مكان إدارتها ومن المخول بتغييرها، ونختبر أن شخصًا آخر يستطيع اتباع الدليل ببيانات صناعية.

التسليم لا يكتمل بجلسة شرح فقط؛ المستلم يعيد حالة ناجحة وحالة فشل، ويكتب النتيجة. هذا يكشف الخطوات التي كنت تفترض أنها بديهية.

مثال محلول
عطل 403؛ مالك عملية مشرف؛ مسؤول ربط تقني؛ مرجع محتوى منسق. لا توجد مفاتيح في الدليل.

الطلب
اكتب سطر Runbook ومعيار استلام.

المخرج
403:أوقف المحاولة، تحقق من بيئة الاعتماد ونطاقه عبر المسؤول المخول؛ لا توسع الصلاحيات. الاستلام:المستلم يعيد حالة سليمة وحالة رفض ويحفظ أدلتهما.

لماذا؟
العلاج لا يكسر الحماية.
المسؤول معروف.
إعادة التجربة تثبت قابلية التسليم.

دافع عن مشروعك بدليل وحدود واضحة

مشروع التخرج يجمع المعرفة والأداة والحالة والموافقة والموصل والقياس. الأفضل مشروع صغير مكتمل الأدلة من خريطة كبيرة لا تثبت أي أثر.

في مدار نعرض طلبًا من الاستقبال إلى مسودة معتمدة، وحالة ناقصة، وحالة مكررة، ومهلة. لكل واحدة مصدر وقرار وسجل ونتيجة قابلة للفحص.

التقرير يفصل ما تم تشغيله فعلًا عما اختُبر بالمحاكاة وما ينتظر حسابًا أو مزودًا. لا نضع بيانات دخول مختلقة ولا نسمي ملف JSON اتصالًا حيًا.

المناقشة تسأل لماذا اخترت هذا المصدر وما الذي يمنع إعادة الأثر وكيف توقف النسخة الخاطئة. القدرة على تفسير القرار جزء من القبول، وليست الإجابة المحفوظة وحدها.

التسليم النهائي يشمل ملفات قابلة للتعديل وخريطة العقد والاختبارات ودليل التشغيل والقيود. الانتقال لعميل حقيقي يبدأ من هذه الأدلة وموافقات بيئته، ولا تمنحه الشهادة تلقائيًا.

مثال محلول
مشروع مدار:10 حالات تقييم؛ مسودة D17 إن وُجد إيصالها؛ حدود الموصل والموافقات؛ قياسات العينة.

الطلب
اكتب فهرس تسليم يفصل الدليل الفعلي عن المحاكاة والمعلّق.

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

لماذا؟
التسليم يمكن إعادة فحصه.
حدود الدليل منعت ادعاء تشغيل غير حاصل.
الحزمة تشرح قرارات التصميم والتشغيل.