عمليات التحقق

عمليات التحقق هي خطوة مراقبة الجودة التي تلي تقديم التقرير. في الإصدار الحالي، لم تعد عمليات التحقق صفحةً مستقلة — فهي تعيش جنبًا إلى جنب مع التقرير المرتبطة به، وتظهر كشارة ضوئية في قائمة التقارير وصفًا مجمَّعة حسب الحالة في عرض التقرير الموسَّع.

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

مكان عمليات التحقق

قائمة التقارير: يعرض كل صف تقرير شارة تحقق إجمالية (رمادية/حمراء/صفراء/خضراء) في عمود خاص بها. تعرض الشارة الحالة الأشد خطورة مع عدد — مثل FAILED · 3 في حال وجود ثلاثة تحققات فاشلة على ذلك التقرير. يكشف التحويم فوق الشارة عن تفصيل حسب الحالة مثل failed: 1, passed: 2.

التقرير الموسّع: فتح تقرير في القائمة يُظهر صفًّا من شارات التحقق مجمَّعة حسب الحالة. يؤدي النقر على أي شارة إلى فتح ValidationEditModal — وهي نافذة منبثقة متكاملة لعرض التحقق أو تعديله أو إنشائه دون مغادرة التقرير.

الجوّال: تظل قائمة مشرف الجوّال على /m/validations دون تغيير. يواصل المحققون عبر الجوّال العمل من خلال التحققات المخصصة لهم في قائمة مخصصة.

عرض الطباعة: تظل صفحة /fulfillment/validations/:id المستقلة كـ عرض للطباعة فقط. تحتوي النافذة المنبثقة على زر طباعة في رأسها يفتح صفحة الطباعة في تبويب جديد. الروابط المباشرة من الإشارات المرجعية القديمة لا تزال تعمل.

فتح تحقق

من قائمة التقارير:

ابحث عن التقرير المطلوب التحقق منه
انقر على شارة التحقق في صف التقرير (أو وسّع الصف لرؤية الشارات مجمَّعةً حسب الحالة)
تفتح ValidationEditModal فوق الصفحة
اعرض التحقق الموجود، أو انقر على إنشاء تحقق إذا لم يكن هناك أي تحقق
سجّل النتائج، وارفع الصور، وحدد الحالة، ثم احفظ

بوابات الوصول:

عرض عمليات التحقق لا يتطلب حقًّا خاصًّا
الإنشاء يتطلب حق المسؤول validationsCreate
التعديل يتطلب حق المسؤول validationsUpdate

الإرسال الموحَّد (التقرير + التحقق معًا)

يوحّد التصميم الجديد التحرير عبر التقرير وعمليات التحقق. عند فتح التقرير والتحقق معًا، يحفظ زر إرسال جميع التغييرات معًا — تُودَع تعديلات التقرير وتعديلات التحقق في خطوة واحدة. لا تحتاج إلى حفظ عمليات التحقق بشكل منفصل عن التقرير.

هيكل عملية التحقق

الحقول الأساسية:

التقرير - الإشارة إلى التقرير المتحقق منه (تُضبط تلقائيًّا عند الفتح من التقرير)
المُحقِّق - المستخدم الذي أجرى فحص مراقبة الجودة
الحالة - pass، fail، needs-revision، approved-with-notes
تاريخ التحقق - تاريخ إجراء فحص مراقبة الجودة
ملاحظات عامة - ملاحظات عامة، ملخص

النتائج التفصيلية:

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

هيكل النتائج

تستهدف كل نتيجة في التحقق بندًا محددًا من قائمة الأعمال المنجزة في التقرير. تتضمن النتائج:

بند العمل الذي يحتوي على مشكلة (بحسب موضعه في قائمة الأعمال المنجزة)
نوع المشكلة — فئة المشكلة (مثل: عدم تطابق الحجم، مشكلة جودة)
الخطورة — حرج، أو تحذير، أو معلومات
الوصف — شرح بلغة واضحة للمشكلة

مثال: يُسجّل تقرير كابل Cat6 (45 م)، وصناديق التوصيل (8 وحدات)، وعمل كهربائي (3.5 ساعات). يكتشف التحقق عدم تطابق في الحجم على الكابل (42 م جُرِّئت فعليًّا مقابل 45 م في التقرير، خطورة: تحذير) ومشكلة جودة حرجة على صندوقَي توصيل مثبَّتَين بشكل غير صحيح.

نقاط رئيسية:

تُشير كل نتيجة إلى بند محدد، مما يُتيح للمحققين تمرير بعض الأعمال والإشارة إلى أخرى في التقرير نفسه
يمكن إضافة نتائج متعددة لكل تقرير
تحافظ الملاحظات التفصيلية على السياق لمراجعة العامل

حالة التحقق

pass - العمل يفي بمعايير الجودة

جميع القياسات دقيقة
التثبيت وفقًا للمواصفات
المواد موثقة بشكل صحيح

fail - العمل لا يفي بالمعايير

مشكلات جودة خطيرة
تباينات كبيرة في القياسات
يتطلب إعادة العمل

needs-revision - مشكلات بسيطة، تصحيحات مطلوبة

اختلافات صغيرة في القياسات (ضمن حدود التفاوت)
الوثائق غير كاملة
مطلوب صور

approved-with-notes - مقبول مع تحفظات

العمل يفي بالحد الأدنى من المعايير
تمت الإشارة إلى المشكلات لتتبعها
أنماط يجب معالجتها في التدريب

أنواع المشكلات

volume_mismatch - الحجم المُبلَّغ عنه لا يتطابق مع القياس الفعلي

مثال: التقرير يذكر كابلًا بطول 50 م، والقياس يُظهر 45 م
الخطورة: تحذير (اختلاف بسيط) أو حرج (تباين كبير)

quality_issue - التثبيت لا يفي بالمعايير

مثال: تركيب غير صحيح، غياب العزل ضد العوامل الجوية، تلف
الخطورة: حرج (خطر على السلامة) أو تحذير (تجميلي)

documentation_incomplete - المعلومات المطلوبة غير موجودة

مثال: غياب الصور، وصف غامض، شهادات مفقودة
الخطورة: معلومات (بسيط) أو تحذير (متطلب تنظيمي)

location_discrepancy - تم تنفيذ العمل في موقع خاطئ

مثال: هندسة التقرير لا تتطابق مع هندسة المهمة
الخطورة: حرج (موقع خاطئ تمامًا) أو تحذير (خطأ طفيف)

consumption_mismatch - المواد المستهلكة لا تتوافق مع العمل المنجز

مثال: الإبلاغ عن عمل كابل بطول 50 م، واستهلاك 80 م من المخزون
الخطورة: تحذير (التحقيق في الهدر/السرقة)

safety_violation - ملاحظة ممارسات غير آمنة

مثال: معدات السلامة مفقودة، إجراءات غير سليمة
الخطورة: حرج (دائمًا)

مستويات الخطورة

حرج - يتطلب تصحيحًا فوريًّا، العمل غير مقبول

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

تحذير - يحتاج إلى اهتمام، لكن العمل مقبول بشكل هامشي

مشكلات جودة طفيفة
تباينات قياس صغيرة
ثغرات في التوثيق
فرص تدريبية

معلومات - تمت ملاحظتها للتتبع، لا تتطلب إجراءً فوريًّا

اقتراحات لأفضل الممارسات
تحسينات في الكفاءة
ملاحظات إعلامية

إنشاء عمليات التحقق

الوصول المطلوب: حق المسؤول validationsCreate

سير العمل:

انتقل إلى التنفيذ → التقارير
افتح (أو وسّع) التقرير المطلوب التحقق منه
انقر على شارة التحقق لفتح ValidationEditModal، أو انقر على إنشاء تحقق إذا لم يكن هناك أي تحقق
راجع العمل المنجز مقارنةً بالموقع الفعلي
لكل مورد في الأعمال المنجزة:
- تحقق من القياسات
- تحقق من جودة التثبيت
- وثّق أي مشكلات في النتائج
ارفع صور مشكلات الجودة
حدد الحالة الإجمالية (pass/fail/needs-revision/approved-with-notes)
أضف ملاحظات عامة (ملخص)
انقر على إرسال لحفظ تعديلات التقرير والتحقق معًا

التحقق الميداني: سير عمل المحقق عبر الجوّال (/m/validations):

التحقق عبر GPS (هل أنت في الموقع؟)
تكامل الكاميرا لالتقاط صور مشكلات الجودة
تحويل الصوت إلى نص للأوصاف
الوضع غير المتصل (إرسال التقرير عند العودة إلى الاتصال)

سير عمل التحقق

العملية النموذجية:

تم إرسال التقرير - ينجز العامل التقرير
الشارة مرئية - تعرض قائمة التقارير شارة رمادية "none" للتقارير التي لا تحتوي على تحققات
يفتح المحقق التقرير - ينقر على الشارة ويفتح النافذة المنبثقة
زيارة الموقع - يزور المحقق الموقع (أو يراجع بناءً على الصور والبيانات)
القياسات - التحقق المادي من العمل
الصور - توثيق الجودة (جيدة أو سيئة)
النتائج - تسجيل أي تباينات داخل النافذة المنبثقة
الحالة - تعيين pass/fail/needs-revision على التحقق
الإرسال - يحفظ التقرير والتحقق ذريًّا
المتابعة - في حال needs-revision، يعالج العامل المشكلات
إعادة التحقق - فتح الشارة مجددًا، وإضافة نتائج إلى التحقق الموجود أو إنشاء تحقق جديد
الموافقة النهائية - تمت الموافقة على التقرير، وصُرف المبلغ

تصفية التقارير حسب حالة التحقق

بما أن عمليات التحقق باتت موجودة على صفحة التقارير، تقبل قائمة التقارير مرشح حالة التحقق:

all — كل التقارير (الافتراضي)
none — التقارير التي لا تحتوي على أي تحقق (تحتاج إلى اهتمام مراقبة الجودة)
any — التقارير التي تحتوي على تحقق واحد على الأقل
failed — التقارير التي تحتوي على تحقق فاشل واحد على الأقل
revision — التقارير التي تحتوي على تحقق واحد على الأقل بحالة needs-revision
passed — التقارير التي نجحت جميع تحققاتها

المرشحات المخصصة لا تزال سارية:

المُحقِّق (من أجرى مراقبة الجودة)
النطاق الزمني
الخطورة (النتائج الحرجة فقط)
نوع المشكلة (volume_mismatch، quality_issue، إلخ)

تكامل الدفع

تتحكم عمليات التحقق في صرف المدفوعات:

تعليق الدفع:

التقارير ذات الحالة fail → يُعلَّق الدفع
التقارير ذات الحالة needs-revision → دفع جزئي (قابل للتكوين)
التقارير التي تحمل حالة approved-with-notes → دفع كامل مع تتبع الملاحظات

صرف الدفع:

تم تقديم التقرير
تم إجراء عملية التحقق عبر الشارة/النافذة المنبثقة
في حالة pass أو approved-with-notes → يُصرَف الدفع
في حالة needs-revision → دفع جزئي، وتلزم إعادة التحقق
في حالة fail → لا يوجد دفع، ويلزم إعادة العمل

الحماية المالية:

يمنع الدفع مقابل العمل دون المستوى المطلوب
يحفّز الجودة
سجل تدقيق لقرارات الدفع

تحليلات التحقق

تتبّع اتجاهات الجودة بمرور الوقت:

حسب العامل:

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

حسب نوع المهمة:

المهام ذات أعلى معدل فشل
مشكلات الجودة الخاصة بالموارد (الكابلات مقابل العمالة مقابل المعدات)
دقة التقدير (تباينات الأحجام تشير إلى تقديرات ضعيفة)

حسب المُحقِّق:

فحوصات الاتساق (هل أحد المحققين صارم/متساهل للغاية؟)
وقت إنجاز التحقق
توزيع خطورة النتائج

أفضل الممارسات

التحقق في الوقت المناسب:

استخدم مرشح none في قائمة التقارير للعثور على التقارير التي تنتظر مراقبة الجودة
احرص على التحقق في غضون 24-48 ساعة من تقديم التقرير
الأدلة الحديثة (المواد لا تزال مرئية، والعامل لا يزال يتذكر)
دفع أسرع للعاملين

النتائج المحددة:

أشِر إلى بند العمل المنجز المحدد بموضعه (البند الأول، الثاني، إلخ) لجعل النتائج قابلة للتنفيذ
تساعد الأوصاف التفصيلية العامل على فهم المشكلة
توفر الصور أدلة لا جدال فيها

التعليقات البناءة:

اعتبرها فرصة تدريبية
اشرح سبب أهمية المشكلة (السلامة، المعايير، التكلفة)
قدّم اقتراحات للتحسين

معايير متسقة:

طبّق نفس المعايير على جميع العمال
وثّق معايير الجودة بوضوح
معايرة منتظمة للمحققين (ضمان الاتساق)

استخدام عرض الطباعة للنسخ الورقية:

افتح ValidationEditModal على تحقق موجود
انقر على زر الطباعة في رأس النافذة المنبثقة
تفتح صفحة الطباعة في تبويب جديد، جاهزة للطباعة الورقية أو تصدير PDF

ثبات عمليات التحقق

الحذف المؤقت: يمكن وضع علامة محذوف على عمليات التحقق مع بقائها في قاعدة البيانات:

يحافظ على سجل مراقبة الجودة
يحافظ على سجل تدقيق المدفوعات
فترة الاحتفاظ قابلة للتكوين
حق المسؤول viewDeleted لرؤية عمليات التحقق المحذوفة

قيود التعديل: بعد صرف الدفعة:

تصبح عمليات التحقق للقراءة فقط (النافذة المنبثقة للعرض فقط)
تتطلب التصحيحات عملية تحقق جديدة مع ملاحظات
يحافظ على النزاهة المالية
يتتبع سجل الإصدارات جميع التغييرات قبل الانتهاء