ما ستتعلمه
التسليم الناجح يمنح العميل التحكم في مشروعه وأدلة كافية لتشغيل الوظائف المتفق عليها. ستجهز في هذا الدرس سجل الملكية واختبارات القبول ودليل التعامل مع المشكلات. وستفرق بين الرجوع لإصدار سابق من الواجهة واستعادة البيانات المستضافة، مع تحديد الدعم دون افتراض مشاركة الحسابات أو وجود صلاحيات تفويض غير موثقة.
ابدأ تجهيز التسليم قبل اجتماع الإطلاق
تحتاج نطاقا متفقا عليه وملفات المصدر وتكاملا تعمل عليه بتصريح مناسب. استخدم تفضيلات وهمية في هذا الدرس. المشروع المرجعي يشمل الدخول وإعدادات لكل مستخدم؛ وأي إشعار للمالك ميزة اختيارية تحتاج ميزانية معتمدة. لا تحتاج لتنفيذ معاملة دفع أو طلب ذكاء اصطناعي في التمرين.
جهز ثلاثة مخرجات: ورقة الملكية والإعدادات، وسجل القبول، ودليل التشغيل. املأها أثناء التنفيذ بدلا من محاولة تذكر كل شيء في النهاية. يجب أن يجد العميل الملفات الحالية والمسؤولين والخطوة التالية عند المشكلة دون أن يعتمد دائما على اتصال بالمطور الأصلي.
ضع التحكم عند صاحب المشروع الصحيح
لكل شخص حساب Gammal Tech متحقق منه يخصه. يجب أن يتحكم العميل في الحساب والمشروع المستخدمين لتطبيقه. ويوضح دليل التكامل الرسمي أن المدفوعات، عند تشغيلها، تستخدم حساب العميل المتحقق منه وهوية مستفيد مطابقة. لا تجمع مبيعات عميلك عبر حسابك الشخصي.
يدخل العميل معلوماته الخاصة بنفسه. وإذا كنت تشرح الإعدادات في اجتماع، وضح الإجراء واترك المالك ينفذه. لا تطلب كلمة مرور أو PIN أو مستند هوية، ولا تعد بميزة تفويض وصول دون توثيقها. اتفقا بشكل منفصل على كيفية إجراء التغييرات المصرح بها مستقبلا.
| البند | المسؤول | دليل التسليم |
|---|---|---|
| حساب Gammal Tech والمشروع | مالك المشروع لدى العميل | يصل المالك إلى المشروع بنفسه |
| النطاق والاستضافة | مسؤول مصرح له لدى العميل | توثيق التجديد ومسؤولية الوصول |
| مصدر الواجهة والنشر | مسؤول صيانة مسمى في الاتفاق | الإصدار الحالي وتعليمات نشره |
| ميزانية الاستخدام والبريد | المالك لدى العميل | خطوات التمويل وموعد المراجعة |
| الصلاحيات والإجراءات الحساسة | مسؤول العمل والمسؤول التقني | توثيق مكان اتخاذ القرار الموثوق |
سجل الإعدادات دون تجميع أسرار
اكتب معرّف المشروع الفعلي وحدد الملف أو الإعداد الذي يستخدمه. هذا المعرّف عام. أما رموز الجلسات فهي مختلفة ويجب ألا تظهر في الصور أو العناوين أو البريد أو ملاحظات التشخيص. لا تخترع مفتاح API سريا لتسلمه؛ Gammal Tech لا تتطلب مفتاح مطور سريا بهذا الشكل.
سجل نطاقات HTTPS التي يعمل عليها التطبيق فعلا. الحد الموثق أربعة نطاقات، والنطاق الأساسي ونسخته التي تبدأ بـ www يحسبان منفصلين. طابق النشر الحالي، لا عنوانا قديما للتطوير. أضف مصدر SDK ورقم إصدار الواجهة ومكان كود التكامل.
صف شكل البيانات وحدودها. مثال ذلك أن اللغة والموضوع المفضل حقول يعدلها المستخدم، فلا تمنحه إدارة أو وصولا مدفوعا. اكتب أن الحفظ يدمج المفاتيح العليا وأن الكائن الداخلي يستبدل كاملا، حتى لا يحذف مسؤول الصيانة جزءا من بيانات محفوظة بسبب فهم غير صحيح للتحديث.
حدد متى تعتبر التسليم مكتملا
- الملكية: يحدد العميل مشروعه ونطاقاته دون بيانات حساب المطور.
- الدخول: يفتح الزر المتفق عليه المسار المستضاف وتعكس الصفحة نتيجة الدخول.
- البيانات: يظهر التفضيل الوهمي بعد الاسترجاع وبعد دخول لاحق مصرح به للمستخدم نفسه.
- الفصل: عند اختبار مستخدمين، يستخدم شخصان موافقان حسابيهما الشخصيين وبيانات وهمية، ويرى كل منهما النتيجة المتوقعة.
- الفشل: تظهر رسالة محايدة مفيدة دون نجاح وهمي أو بيانات تشخيص حساسة.
- التشغيل: يستطيع المالك إيجاد المصدر والتعليمات وتوقع الاستخدام وجهة الدعم.
سجل التاريخ والإصدار والنتيجة المرصودة لكل حالة. لا تنشئ حسابات شخصية إضافية للاختبار. وإذا كانت حالة الإشعار ستنتج رسالة مدفوعة، احصل أولا على اعتماد الاستخدام المتفق عليه؛ يمكن الاكتفاء في الدرس بمحاكاة ورقية معلنة. نجاح الحالات يثبت سلوك التكامل المتفق عليه، وليس شهادة اختبار اختراق.
اكتب دليل المشكلات حسب العرض الظاهر
نافذة الدخول لا تفتح: تحقق من ضغط المستخدم على الزر ومن منع المتصفح للنافذة ومن مطابقة نطاق HTTPS الحالي للإعدادات. عند التصعيد أرسل الوقت وعنوان الصفحة ووصفا منقحا. لا تطلب رمز جلسة المستخدم.
تفضيل محفوظ لا يظهر: اطلب من المستخدم التأكد أنه دخل بحسابه المقصود. يراجع مسؤول الصيانة معرّف المشروع واكتمال الاسترجاع وطريقة عرض البيانات الفارغة. لا تكرر الكتابة فوق البيانات أثناء البحث ولا تطلب السجل الكامل للعميل عبر البريد.
إشعار اختياري لم يصل: يراجع المالك البريد المتوقع ورصيد المشروع. التمويل يتطلب شحن المحفظة ثم النقل للمشروع. فرق بين قبول الطلب والتأكد من وصول الرسالة، ولا تضف تكرارا آليا عشوائيا للإرسال. يتعامل SDK بالفعل مع إعادة المحاولة لمشكلات الشبكة القصيرة.
اشتباه تغيير غير مصرح به في الموقع: أوقف التشخيص العادي عبر الصفحة المشكوك فيها. استخدم جهازا موثوقا وجهات التواصل المعروفة لتأمين النشر وحفظ الأدلة المناسبة وطلب مساعدة الحوادث اللازمة. وجود البيانات عند مزود خارجي لا يجعل الكود المعدل في الواجهة آمنا.
افصل الرجوع لإصدار عن استعادة البيانات
احتفظ بإصدار معروف من الواجهة واكتب كيف يعيده مسؤول الصيانة المصرح له. تدرب على استعادة الملفات في نسخة مناسبة خارج الإنتاج. الرجوع بملفات الواجهة لا يعيد تلقائيا بيانات المستخدمين الموجودة لدى الخدمة الخلفية.
سجل ترتيبات الاستعادة والاحتفاظ والتصدير والحذف التي أكدها المزود ويحتاجها المشروع، مع الأسئلة التي لم تحسم. لا تخترع ضمان نسخ احتياطي أو أداة تصدير جماعي. حدد كيف يستمر العمل عند تعطل الخدمة وما الأدلة التي يجب حفظها قبل نقل البيانات أو تنظيفها.
إذا أضيف الدفع لاحقا، وسع التسليم ليشمل التحقق الموثوق وملكية سجل الطلبات ومنع تكرار التسليم ورسوم المعاملات والسحب الحالية. صفحة نجاح في المتصفح أو صورة من العميل لا تصلح وحدها مرجعا لتقديم الخدمة.
حدد دعما يستطيع العميل استخدامه
اكتب من يستقبل الطلب وساعات الاستجابة المتفق عليها والأدلة المفيدة وكيف يسعر العمل خارج النطاق الأصلي. ميز بين صيانة تقدمها أنت ودعم المزود. جهة دعم Gammal Tech المنشورة هي support@gammal.tech؛ أرسل وصفا موجزا منقحا دون بيانات دخول أو مستندات هوية.
احتفظ بقائمة مؤرخة للنقاط المفتوحة وموعد لمراجعة الاستهلاك ومكتبات الواجهة وتغييرات المزود. يتناول دليل NIST للشركات الصغيرة الاستجابة والاستعادة إلى جانب الحماية؛ لذلك تدخل تعليمات التشغيل في التسليم ولا تؤجل إلى أول حادث.
اختبر التسليم من دون تدخلك
أعط زميلا المستندات الثلاثة ومشكلة افتراضية: «موضوع التعلم المحفوظ لا يظهر». اطلب منه العثور على المسؤول وحالة القبول المرتبطة وأول خطوات التشخيص ومسار التصعيد. يجب أن يجد الأربعة دون تخمين أو طلب رمز جلسة.
ينجح مخرجك إذا كانت الملكية واضحة، ونتائج القبول مؤرخة، وللتكلفة مسؤول، وأسئلة الاستعادة ظاهرة. الخطأ الشائع اعتبار ملف مضغوط للمصدر هو التسليم كله. الملفات ضرورية، ومعرفة التشغيل والتحكم في المشروع هما ما يجعلها قابلة للاستخدام بعد مغادرة المطور.
أسئلة شائعة
هل أسلم حسابي في Gammal Tech إلى العميل؟
خطط لاستخدام حساب العميل المتحقق منه منذ البداية. لا تنقل بيانات حساب شخصي ولا تفترض وجود ميزة لنقل الحساب أو تفويضه دون توثيق.
هل استعادة ملفات الموقع تعيد بيانات المستخدم المستضافة؟
لا. استعادة الواجهة وبيانات الخدمة عمليتان مختلفتان. تحقق من ترتيبات استعادة البيانات المتاحة لدى المزود وسجل حدودها.
مراجع الدرس
تمت مراجعة التوثيق في 12 أكتوبر 2026. راجع التوثيق الحالي قبل تنفيذ مشروع عميل أو تحديد أسعاره.