
درس مصغّر 30 من 30 · تشغيل موقعك وصيانته
جرّب إجراء الزائر
لمن هذا الدرس؟
لمن يريد اكتشاف الأعطال التي يواجهها الزوار وإصلاحها. ستستخدم صفحة معطلة مرفقة؛ يستطيع مساعد البرمجة تعديل الكود بينما تصف المشكلة وتكرر إجراء الزائر.
قد تفتح الصفحة بينما تكون ميزتها المفيدة معطلة.
هدف هذا الدرس
- أعد إنتاج إجراء معطل فعلًا بدل فحص تحميل الصفحة فقط.
- شارك سياقًا آمنًا كافيًا لإصلاح محدد بواسطة المساعد.
- تحقق من الإجراء المصحح وحالة المراقبة ذات الصلة.
شرح ومثال محلول وتدريب
قبل أن تبدأ
تحتاج إلى موقع التدريب المنفصل المرفق ومساعد برمجة. مشروع Sentry تجريبي اختياري لجزء المراقبة؛ أرسل الأخطاء الوهمية المرفقة فقط، ولا تستخدم بيانات زوار خاصة.
تحقّق من مهارات البداية
هذه مهارات مفيدة وليست دروسًا إلزامية تمنع الدخول. ابدأ هنا إن كنت تتقنها، وإلا افتح التحضير المرتبط. ملفات البداية مرفقة، فلا تحتاج إلى موقع شخصي سابق.
- كيف تنشر موقعك من GitHub
اربط مستودعًا تجريبيًا بالاستضافة.
الوقت المتوقع: 19–31 دقيقة
تقديرات باستخدام ملفات البداية المرفقة، مع جاهزية الحسابات والأدوات المطلوبة. يستغرق الإعداد وانتظار النشر وتسليم البريد وتحديث DNS وقتًا إضافيًا. إعداد مزوّد المراقبة وانتظار استلام الأحداث وقت إضافي. استدعاء التقاط محلي ليس دليلًا على استلام تنبيه.
افهم الفكرة
اطلب من المساعد تشغيل مجلد public المرفق عبر HTTP وافتح الصفحة. فعّل Find contact section. تبحث نسخة practice-R1 المرفقة عمدًا عن هدف غير موجود، لذا تعرض الحالة فشل إجراء Contact.
أخبر المساعد بالزر المحدد والوجهة المتوقعة والنتيجة الظاهرة. قد يوجد قسم Contact في الصفحة بينما يفشل الزر في الوصول إليه؛ ولن يكشف تحميل الصفحة الرئيسية وحده هذه المشكلة.
مثال عملي
مثال وصف مفيد للمشكلة: «ضغطت Find contact section في practice-R1. توقعت فتح قسم Contact، لكن الحالة قالت Contact action failed».
استخدم مثال إجراء التواصل المعطل المرفق في موقع تدريب منفصل. أعد إنتاج عطل الزر وحدّد سببًا واضحًا وعدّل الضروري فقط. ساعدني في تكرار الإجراء نفسه والمقارنة قبل التعديل وبعده. إن فُعّلت المراقبة، فاستخدم أخطاء وهمية ومشروعي التجريبي فقط، ولا ترسل بيانات صفحة أو نموذج خاصة. لا تعتبر المشكلة أُصلحت لمجرد وسمها محلولة.ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
ما الذي فشل عندما جرّبت إجراء الزائر المرفق؟
عرض حل نموذجي مشروح
في حالة practice-R1 المرفقة، يفشل الضغط على Find contact section، وتعرض الصفحة رسالة العطل التدريبي المقصود. توقعت الوصول إلى Contact. حُمّلت الصفحة الرئيسية نفسها، لذا فلن يكشف فحص توفر الصفحة وحده فشل هذا الزر.
ما تتضمنه الإجابة السليمة
- يسمي الزر الفعلي ونتيجة Contact المتوقعة والفشل الظاهر.
- يميز فشل إجراء الزائر عن نجاح تحميل الصفحة.
كيف يعمل؟ (اختياري)
اعثر على خطأ في موقع منشور وأصلحه
ابدأ بإجراء زائر فاشل، ثم استخدم تقريرًا لتحديد سببه.
تفيد المراقبة عندما تربط عَرَضًا حقيقيًا بشيفرة يمكنك فحصها. تبحث صفحة التدريب هذه عمدًا عن عنصر تواصل غير موجود، لذا يفشل إجراء التواصل.
نرسل خطأً مصطنعًا ثابتًا فقط إلى مشروع Sentry الخاص بك. يتضمن التقرير تسمية إصدار وموقعًا في المكدس؛ ويربط سجل الحادث ذلك الدليل بما حاول الزائر فعله.
مثال محلول
تُحمّل الصفحة الرئيسية نفسها بنجاح. يفشل النقر على «Find contact section» لأن السكربت يطلب #contact-missing بينما يحتوي HTML الفعلي على id=contact.
تمرين تقني إضافي
لماذا لا يكتشف فحص صفحة رئيسية بحالة HTTP 200 هذا الخطأ؟
عرض حل نموذجي مشروح
قد يُحمّل HTML بصورة صحيحة بينما يفشل إجراء JavaScript لاحق. كرر مهمة التواصل، لا طلب الصفحة فقط.
- تختبر التفاعل المتأثر بعد تحميل الصفحة.
- تميّز الإتاحة عن الصحة الوظيفية.

الخطوة 1 · كيف تجد الأخطاء في موقعك المنشور وتصلحها
اجمع سياقًا مفيدًا وآمنًا فقط
قدّم للمساعد دليلًا دون بيانات زوار خاصة.
شرح ومثال محلول وتدريب
افهم الفكرة
أعط المساعد ملفات التدريب ونسخة الصفحة ووصف المشكلة من الخطوة السابقة. يكفي ذلك لبدء فحص هذا المثال المحلي، دون إرسال نص نموذج أو معلومات حساب لأي زائر حقيقي.
إذا استخدمت مشروع Sentry الاختياري، فاضبط قيمة أداة التحميل العامة فقط وفعّل المراقبة التدريبية قبل إعادة إنتاج الخطأ المنضبط. افحص الحدث التدريبي المطابق وبياناته. ظهور حدث في Sentry منفصل عن وصول تنبيه إلى البريد.
مثال عملي
الخطأ المسموح المرفق هو “Practice: missing contact target”. يمكن أن يتضمن الحدث المفيد الإصدار التدريبي وموضع المصدر، دون رسالة مستخدم حقيقية أو عنوان بريد أو رمز حساب.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
ما السياق الذي ستشاركه؟ وما البيانات الخاصة التي ستستبعدها؟
عرض حل نموذجي مشروح
سأشارك ملفات practice-R1 المرفقة وإجراء Find contact section ورسالة فشله. بعد تفعيل المراقبة، سأبحث عن “Practice: missing contact target” والإصدار المطابق في مشروعي التجريبي. سأستبعد عناوين الزوار ونصوص النماذج ورموز الحسابات؛ ويبقى التنبيه البريدي اختبارًا منفصلًا.
ما تتضمنه الإجابة السليمة
- يشارك الإجراء الافتراضي القابل لإعادة الإنتاج والإصدار التدريبي وسياق الملفات ذات الصلة.
- يستبعد محتوى الزوار الحقيقي ويميز أحداث المراقبة المستلمة عن التنبيهات التي وصلت.
كيف يعمل؟ (اختياري)
أرسل تقرير تشخيص مضبوطًا
اجمع ما يكفي للبحث دون إرسال محتوى مستخدم خام.
اضبط رابط محمّل المشروع العام كما يشرح START-HERE.txt. يحدد السكربت رد نداء التهيئة قبل تحميل SDK، ويعطل التتبع وإعادة الجلسة، ويستخدم قائمة سماح beforeSend لهذا الخطأ التدريبي الثابت.
يستبعد الحدث التشخيصي المعاد بيانات الطلب والمستخدم والإضافات الاعتباطية ومسارات التتبع breadcrumbs. تُزال الاستعلامات وhash من أسماء ملفات المكدس. لموقع حقيقي، راجع كل مصدر لتشخيصات حساسة؛ لا تضمن sendDefaultPii=false وحدها خلو النص الحر أو الروابط من معلومات شخصية.
مرشح beforeSend صارم عمدًا: لا تُرسل إلا الرسالة المصطنعة المطابقة «Practice: missing contact target». تُسقط الرسائل الأخرى. إذا غيرت صياغة الخطأ التدريبي، فحدّث قائمة السماح عن قصد، وإلا فغياب الحدث متوقع. لا تزل المرشح لمجرد جعل اللوحة نشطة؛ افحص حمولة الحدث المسموح بحثًا عن بيانات غير مقصودة.
إذا لم يصل حدث، فافحص أولًا نص الرسالة الثابت وقائمة سماح beforeSend في app.js. يعرض الحدث غير المطابق الآن رسالة محلية عن تصفيته؛ ولا يُحسب مرسلًا. يستخدم محلل الروابط location.origin أساسًا لأسماء الملفات النسبية ويستبدل اسم ملف غير قابل للتحليل بـredacted بدل تمرير أصل قد يكون حساسًا.
يُضبط خيار المحمّل الموثق data-lazy="no" عبر script.dataset.lazy="no"؛ ويطلب تحميل SDK الكاملة مبكرًا. لا تحتفظ أسماء ملفات المكدس إلا بأصل HTTP(S) والمسار بعد إزالة الاستعلام/hash. تُحجب المخططات غير الويب بدل تمريرها دون تغيير.
مثال محلول
تكفي رسالة خطأ ثابتة مثل «Practice: missing contact target» لهذا التدريب. إرسال كائن نموذج كامل يضيف مخاطرة دون المساعدة في تحديد هدف DOM المفقود.
Sentry: محمّل المتصفح والتهيئة المخصصة
تمرين تقني إضافي
هل يجعل تعطيل البيانات الشخصية الافتراضية رسائل خطأ اعتباطية آمنة للإرسال تلقائيًا؟
عرض حل نموذجي مشروح
لا. راجع حمولة الحدث الفعلية وقيّد ما ترسله شيفرتك. قد تظهر بيانات شخصية في الرسائل والروابط وbreadcrumbs والإضافات حتى دون جمع البيانات الشخصية الافتراضي.
- تدرك أن نص التطبيق وروابطه قد تظل تحتوي بيانات خاصة.
- تطبّق حجبًا صريحًا وقائمة سماح.

الخطوة 2 · كيف تجد الأخطاء في موقعك المنشور وتصلحها
نفّذ إصلاحًا واحدًا محددًا
كرّر الإجراء المعطل نفسه بعد التعديل.
شرح ومثال محلول وتدريب
افهم الفكرة
اطلب من المساعد مقارنة وجهة الزر الفاشل بقسم Contact الموجود. يتضمن worked-solution/app.js المرفق إصلاح الهدف الصغير؛ فاطلب تطبيقه وتسمية المراجعة التدريبية المعدلة practice-R2.
افتح صفحة practice-R2 المعدلة وفعّل الزر نفسه مجددًا. ينبغي أن يصل إلى Contact ويعرض “Contact section opened.” تغيير تسمية الإصدار فقط أو وضع علامة الحل في Sentry لا يغير سلوك الزر.
مثال عملي
يبحث السكربت المعطل عن #contact-missing، بينما يعرّف HTML قسم Contact عند #contact. يستطيع المساعد إصلاح التطابق؛ وأنت تقيّم النتيجة باستخدام الزر مجددًا.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
ما الذي تغير؟ وماذا حدث عندما كررت الإجراء الأصلي؟
عرض حل نموذجي مشروح
في الحل المرفق، يغير المساعد البحث من الهدف المفقود إلى قسم #contact الموجود، ويسمي المراجعة practice-R2. الاختبار المتوقع هو وصول الزر نفسه إلى Contact وعرض “Contact section opened.” علامة حل في نظام المراقبة دون إعادة ذلك الاختبار لا تثبت الإصلاح.
ما تتضمنه الإجابة السليمة
- يربط إصلاح الوجهة المحدود بقسم Contact الموجود.
- يكرر الإجراء نفسه على النسخة المعدلة ويفحص النتيجة الظاهرة للمستخدم.
كيف يعمل؟ (اختياري)
طابق التقرير وأصلح السبب وأعد الاختبار
تسمية المشكلة محلولة لا تصلح الشيفرة.
فعّل المراقبة، وأطلق الفشل المصطنع، واعثر على الحدث الفعلي في حسابك. قارن إصداره وإطاره بالمصدر المرفق. إذا لم يصل حدث، فافحص التحميل والموانع وإعداد المشروع وتسليم الشبكة قبل افتراض عدم وجود خطأ.
استبدل السكربت بـworked-solution/app.js، وحدّث تسمية الإصدار وكرر إجراء التواصل. ينبغي أن يظهر الهدف الصحيح بالتمرير إليه. تعليم مشكلة على أنها محلولة في اللوحة لا يستبدل فحص السلوك هذا.
استبدال الملف تمثيل مختبري صغير لإصلاح مصدر. على موقع تدريب مستضاف، سجّل app.js المعدّل وتسمية الإصدار بالتزام، وراجع إصدار المصدر ذاك وانشره، ثم أعد اختبار رابطها العام. تحديث حالة المشكلة أو تسمية الإصدار فقط لا يطبّق إصلاح المحدد.
مثال محلول
يفشل R1 عند #contact-missing؛ ويستخدم R2 القيمة #contact. دليل التعافي المهم هو أن إجراء التواصل يعمل الآن في إصدار المصدر المصحح.
تمرين تقني إضافي
المشكلة معلّمة بأنها محلولة لكن السكربت المنشور لا يزال يستعلم عن #contact-missing. هل أُصلحت المشكلة؟
عرض حل نموذجي مشروح
لا. لا تستطيع حالة لوحة تحكم تغيير السكربت. انشر الإصلاح عبر عملية المراجعة وتحقق من الإجراء في إصدار المصدر ذاك.
- تفحص المصدر المنشور الفعلي وإصداره.
- تكرر الإجراء الذي فشل سابقًا.

الخطوة 3 · كيف تجد الأخطاء في موقعك المنشور وتصلحها
أكمل ملاحظة حادث مفيدة
أبقِ المشكلة والإصلاح والتحقق مترابطة.
شرح ومثال محلول وتدريب
افهم الفكرة
أكمل incident-record.txt بفشل الزر الأصلي وتصحيح الهدف الصغير ونتيجة تكرار الإجراء على الصفحة المعدلة. إذا نشرت التعديل التدريبي، فافحص النسخة المنشورة نفسها، لا الملف المحلي وحده.
أبقِ ملاحظات المراقبة الاختيارية منفصلة: هل وصل الحدث الأصلي إلى Sentry، وهل أعددت تنبيهًا، وهل وصل الإشعار فعلًا؟ ينبغي أن يشرح السجل المهمة التي أُصلحت وأي فجوة باقية، لا أن يدّعي خلو الموقع كله من الأخطاء.
مثال عملي
يربط سجل حادث مختصر فشل Contact في practice-R1 بتصحيح الهدف ونجاح إعادة الاختبار في practice-R2. عبارة «حُلّت المشكلة» وحدها تغفل نتيجة الزائر.
ملفات هذه الخطوة
افتح الملفات أدناه أو نزّلها منفردة. عند حفظ المشروع، احتفظ بمسارات المجلدات الموضحة في أسماء الملفات.
جرّب بنفسك
قدّم سجل الحادث واختبار الإجراء المصحح الفعلي.
ما المطلوب إنجازه: سجل حادث قصير يتضمن المشكلة التي أُعيد إنتاجها والتعديل المحدد وإعادة الاختبار الناجحة الفعلية.
عرض حل نموذجي مشروح
مثال سجل حادث: أبلغ زر Contact في practice-R1 عن فشل؛ وصحح المساعد الهدف المفقود؛ وفي practice-R2 وصل الزر نفسه إلى Contact وأظهر رسالة النجاح. فُحص الحدث الافتراضي بصورة مستقلة في مشروع المراقبة التجريبي. لم تُعد قاعدة تنبيه، لذا لم يُختبر وصول الإشعارات. يغطي هذا السجل عيب Contact، لا كل خطأ مستقبلي في الموقع.
ما تتضمنه الإجابة السليمة
- يربط العرض الأصلي للمشكلة والتعديل المحدد وإعادة اختبار الإجراء نفسه فعلًا بالنسخة المعينة.
- يفصل ملاحظات حدث المزود وتنبيهه، ويحدد أي نطاق ما زال دون اختبار.
كيف يعمل؟ (اختياري)
مهمتك: اكتب ملاحظة حادث مفيدة
اجعل المحقق التالي يفهم السبب والأدلة معًا.
أكمل سجل الحادث بمرجع حدث محجوب البيانات الحساسة والإجراء المتأثر وإطار المصدر والسبب الجذري وإعادة الاختبار الناجحة. إذا أعددت تنبيهًا، فتحقق من الإشعار الفعلي منفصلًا عن استلام الحدث.
أضف فشلًا مصطنعًا ثانيًا في نسخة تدريبك وكرر الحلقة. أبقِ الرسائل ثابتة وحدّث قائمة السماح عن قصد؛ لا توسّع المراقبة بإرسال بيانات صفحة أو نموذج اعتباطية.
مثال محلول
«أُصلح محدد الهدف المفقود من #contact-missing إلى #contact؛ واجتاز R2 إعادة الاختبار» وصف عملي. «كان في Sentry خطأ؛ حُلّ» يترك السبب والتحقق مجهولين.
يتوفر الشرح المرجعي الكامل في reference/assignment-walkthrough.txt. قارن خطواته بنتيجتك؛ واملأ سجل الاختبار بملاحظات من مشروعك أنت.
تمرين تقني إضافي
أنجز ملاحظة حادث وأثبت أن إجراء المستخدم المصحح يعمل.
عرض حل نموذجي مشروح
فعّل محمّل التدريب المعدّ وأطلق الخطأ المصطنع المطابق. إذا غيرت نص الخطأ، فحدّث قائمة السماح الصارمة عمدًا؛ إسقاط رسالة غير مسموح بها متوقع. افحص الحدث المستلم الفعلي من حيث الإصدار والإطار والبيانات غير المرغوبة.
طبّق السكربت المصحح المرفق على public/app.js، وغيّر RELEASE إلى practice-R2. انشر إصدار التدريب ذاك عبر سير العمل المراجَع، ثم كرر Find contact section على الرابط المنشور الفعلي. تغيير تسمية الإصدار أو حالة المشكلة وحدهما لا يصلح المحدد.
سجّل استلام المشكلة منفصلًا عن تسليم إشعار التنبيه. قد يظهر الحدث قبل وصول تنبيه معدّ؛ أبقِ أيًا من الملاحظتين معلقة حتى فحصها. تربط ملاحظة الحادث المرجعية الفشل والإطار وتغيير المحدد وإعادة الاختبار الظاهرة للمستخدم.
- تربط العَرَض والإصدار وسبب المصدر.
- تتحقق من السلوك وتفصل ادعاءات تسليم الحدث والإشعار.
هل أفادك هذا الدرس؟
اترك إعجابًا، أو شاركه مع شخص قد يستفيد منه.