شخّص الحد لا العرض وحده
تحدث معظم مشكلات KayanOS عند حد: مؤسسة خاطئة أو إصدار منشور غير متاح أو عدم تطابق دور/نطاق أو قيمة حقل مفقودة أو خطوة مزامنة غير متصلة أو قاعدة دورة حياة سجل أو استعلام مصدر لوحة أو اتصال أو شرط تزامن API. لا يكفي زر ظاهر أو قائمة فارغة أو رسالة خطأ عامة لتحديد السبب. استخدم هذا المسار لطلب خدمة مواطن قبل تغيير إعداد أو مطالبة مستخدم بإعادة عمل. ابدأ بسجل غير إنتاجي مضبوط متى أمكن. لا توسع دوراً ولا تنشر نموذجاً ولا تعِد إجراءً ولا تنشئ طلباً من جديد لمجرد رؤية اختفاء العرض.
التقط سجل حادث آمن أولاً
اجمع ما يكفي من الدليل لإعادة الإنتاج وتوجيه المشكلة من دون نسخ أسرار أو محتوى خاص:
أعط الحادث عنواناً قصيراً يذكر الحد: «لا يستطيع مفتش تسليم معاينة غير متصلة بعد إعادة الاتصال» قابل للتنفيذ؛ «KayanOS معطل» ليس كذلك.
اتبع ترتيب التشخيص نفسه
- أعد الإنتاج بأمان. هل يستطيع الدور المقصود إعادة العرض بطلب غير إنتاجي معتمد؟ سجل الخطوات الدقيقة والنتيجة المتوقعة.
- افحص المؤسسة والهوية. أكد المؤسسة المختارة والعضو/المشارك العام المسجل والدور والنطاق ومالك جلسة النموذج أو مالك رمز التكامل.
- افحص الإتاحة. أكد أن الميزة صادرة وأن النموذج/الإصدار/القالب/اللوحة/الاتصال مضبوط لهذا الاستخدام وأن شروط النشر/الانتهاء/الحد اللازمة متحققة.
- افحص البيانات والحالة. راجع القيم المطلوبة وأنواع الحقول والخيارات والعلاقات وحالة السجل وحالة جلسة النموذج والإصدار وقاعدة دورة الحياة الحالية.
- افحص الحد القابل للتدقيق. افحص دليل التشغيل/المهمة/الطلب/الجلسة/المرجع الآمن. لمشكلة API احتفظ بـ
x-request-id؛ ولأتمتة KayanOS احتفظ بمعرف التشغيل؛ ولجلسة غير متصلة احتفظ بمعرف الإرسالة المحلي ومعرف جلسة الخادم إن توفر. - اختر أصغر معالجة آمنة. صحح إعداداً/قيمة خاطئة معروفة واحدة ثم أعد اختبار الحالة نفسها. لا تجمع تغييرات غير مترابطة.
- وثق النتيجة. سجل السبب الجذري والتغيير ونتيجة الاختبار والخطر المتبقي والمالك. إن لم يثبت السبب، صعّد بدلاً من التخمين.
فهرس الأعراض
فشل الصلاحية والإتاحة
عندما يغيب شيء أو يعطل أو يرفض، ميّز الرؤية عن التفويض. قد يظهر مدخل تنقل بينما يرفض العمل على سجل محدد. قد يكون محدد مرئياً بينما تقع كل النتائج المؤهلة خارج نطاق العضو. قد يظهر تعبير نموذج زراً بينما يرفض الخادم الإجراء. افحص بهذا الترتيب:- المؤسسة الصحيحة والهوية النشطة.
- المورد والفعل الدقيق المطلوب للعملية.
- نطاق السجل/الجلسة المستهدف وعلاقة الهيكل.
- قاعدة قراءة/تحديث مستوى الحقل إن تعلق الأمر بحقل محدد.
- قاعدة الحالة أو الإجراء أو التوقيع أو دورة الحياة الحالية.
- شرط النشر/الاتصال/الميزة للسطح المختار.
فشل النماذج والجلسات
لمشكلة إجراء/توقيع، سجل مفتاح الإجراء والحالة قبل/بعد والفاعل والاستجابة—لا الحمولة الحساسة الكاملة.
فشل المزامنة غير المتصلة
تملك الجلسات غير المتصلة حالاتpending وsyncing وfailed وsynced. ليست الجلسة المحلية المسلمة مستلمة مركزياً حتى تكون synced. أبق الجهاز وملفاته المحلية سليمين أثناء التشخيص.
- سجل معرف الإرسالة المحلي والنموذج/الإصدار وأوقات إنشاء/إرسال الجهاز وحالة الطابور والمحاولات ووقت الإعادة التالي وآخر خطأ آمن.
- أكد اتصال الجهاز وأن البادئ يملك جلسة موثقة قابلة للاستخدام. لا تدخل بيانات اعتماد شخص آخر «لفك التعليق».
- افحص التخزين المحلي وكل ملف مرفق. لا يحل فشل رفع ملف بحذف الملف.
- دع مسار الإعادة المعتمد يعمل بعد استعادة الاتصال/التوثيق. يستخدم العميل تراجعاً محدوداً؛ وقد يخلق الإرسال اليدوي المتكرر ارتباكاً.
- عند
syncedافتح جلسة الخادم وقارن الحقول والمكررات والملفات والطوابع. إن كانت جلسة الخادم ناقصة، صعّد بالمرجعين المحلي والخادمي.
فشل نموذج البيانات والمعرف التسلسلي والحقل المحسوب والقالب
حقول الكيانات وتخطيطات
افحص مفتاح الحقل ونوعه وقاعدة الإلزام/الافتراضي وقيمة خيار الاختيار وهدف العلاقة ورؤية التخطيط وصلاحية الحقل الخاصة. تسمية العرض ليست المفتاح المخزن، وقد يملك الحقل المخفي قيمة محفوظة أو يكون غير متاح لسبب لا علاقة له بالتخطيط.المعرفات التسلسلية
التقط إعداد حقل التسلسل وتعبير مساحة الاسم/التنسيق وقيمة التسلسل/البداية ومدخلات التاريخ/المنطقة ووضع التوليد وحالة السجل الحالية والمرجع المتوقع. لا تحرر تسلسلاً يدوياً لإخفاء تصادم أو فجوة. اختبر بسجل مضبوط وقارن المعاينة/الإعداد بالنتيجة المخزنة. راجع المعرفات التسلسلية.الحقول المحسوبة
التقط الصيغة ونوع القيمة وإعداد العلاقة المباشرة/العكسية وقيم المصدر والنتيجة والحالة وتوقيت إعادة الحساب. افحص null والقوائم الفارغة والعلاقات المفقودة قبل معاملة نتيجة صفر/فارغة كفشل منطق. لخطأ تبعية/حلقة، أوقف تحرير الحسابات المرتبطة بكثرة واعزل أصغر حلقة. راجع الحقول المحسوبة.قوالب المستندات
التقط القالب/الإصدار والسجل المستهدف وتنسيق المخرج وتعبير اسم الملف ووضع المتصل/المدير وقائمة السماح الإدارية غير الفارغة إن استخدمت والوسم/التعبير والناتج المصير. اختبر القيم الاختيارية الغائبة والعلاقات الفارغة وأهداف البحث المسموحة/المرفوضة واسم الملف منفصلة. لا تلصق مستنداً فعلياً أو بيانات اعتماد في طلب دعم. راجع قوالب المستندات ووسوم قوالب المستندات والتصيير.فشل اللوحة وAPI والتصدير والأتمتة
لوحات المعلومات
قارن عنصراً بسجل مصدر معروف واحد. التقط نوع العنصر والكيان/المصدر والمرشحات الثابتة ومرشحات المشاهد وأساس التجميع/التاريخ ودور/نطاق المشاهد وما إذا كانت الواجهة تعرض لا بيانات أو رفض صلاحية. لا تستبدل استعلام كيان مرفوضاً برقـم يدوي حساس منسوخ؛ صحح وصول/إعداد المصدر.الواجهة البرمجية العامة
سجل حالة HTTP ورمز/رسالة الخطأ وx-request-id واسم/تلميح الرمز ونقطة النهاية ومفتاح الكيان ومفتاح الحقل وجسم الطلب المنقح وترويسات الحد وETag/If-Match عند اللزوم. تشمل المعالجات الشائعة تدوير/إعادة تفويض رمز وتمكين كيان وتصحيح حقل/مرشح قابل للاستعلام العام واحترام retry-after أو إعادة القراءة بعد 412 PRECONDITION_FAILED. لا تعِد إنشاء/حذفاً بلا تدقيق بعد مهلة.