Duplicate Order Checker — سجل فحص الأوردرات المكررة

📋 وصف الأداة

الهدف: عرض سجل عمليات الـ Worker اللي بيفحص الأوردرات الجديدة تلقائيًا وبيكشف التكرار المحتمل بنفس رقم تليفون الشحن. الواجهة دي قراءة فقط — بتعرض اللي حصل، ومابتعملش أي فعل.

المستخدمون المستهدفون: خدمة العملاء والإدارة — لمتابعة الأوردرات اللي اتعلّم عليها Duplicate ومراجعة أي فشل في الويبهوك.

إزاي الأداة الأصلية بتشتغل (الـ Worker)

شوبيفاي بيبعت ويبهوك orders/create على POST /webhook.
الـ Worker بيتحقق من الـ HMAC ويرد 200 فورًا، والشغل بيكمّل في الخلفية.
بيدوّر على أوردرات تانية غير منفَّذة وغير ملغية في آخر 90 يوم بنفس رقم التليفون بعد تنضيفه.
لو لقى مطابقات: بيضيف تاج Duplicate وسطر في نوت الأوردر، وبيسجّل duplicate_found.
لو مفيش: بيسجّل checked_clear. وأي حالة تانية بتتسجّل بنوعها.

إزاي تستخدم الشاشة دي

اختار اسمك وادخل الـ PIN.
افتح الفلاتر واختار نوع العملية أو الفترة، أو ابحث برقم أوردر.
اضغط رأس أي عمود للترتيب (تصاعدي ← تنازلي ← بلا ترتيب).
صدّر XLSX لو محتاج تراجع بره الشاشة — لو الملف اتقص هيظهر بانر أصفر بالرقمين.

الـ Endpoints الرئيسية

action	الوصف
`get_logs`	صفحة ١٠٠ صف من السجل — فلترة وترتيب server-side
`get_logs_count`	العدد الكلي المطابق للفلاتر (رقم «النتائج»)
`get_logs_export`	كل المطابق حتى السقف للتصدير + `cap` · `total` · `truncated`
`get_log_types`	قيم `type` الموجودة فعليًا — بتغذّي فلتر نوع العملية
`get_employees`	قائمة الموظفين النشطين لشاشة الدخول وفلتر الموظف
`check_employee` · `register_pin` · `verify_employee`	الدخول بالـ PIN
`get_config`	نسخة الـ Worker — لحارس الحد الأدنى
`diag`	فحص ذاتي بدون أي كتابة (زرار 🩺 في الإعدادات)

⚙️ معنى كل نوع عملية

النوع	معناه
`duplicate_found`	اتحدد كتكرار محتمل — التاج والنوت اتكتبوا فعلاً على الأوردر
`checked_clear`	اتفحص ومفيش تكرار في آخر ٩٠ يوم — مفيش أي تعديل
`skipped`	اتخطّى: مفيش رقم تليفون · payload فاضي · اتعالج قبل كده · خطأ أثناء المعالجة (السبب في الملاحظات)
`scan_capped`	الفحص وصل لسقف الصفحات قبل ما يخلّص الـ ٩٠ يوم — النتيجة ممكن تكون ناقصة
`hmac_failed`	وصل طلب على مسار الويبهوك والتوقيع مش مظبوط — راجع `SHOPIFY_WEBHOOK_SECRET`

🔧 تشريح الكود

FEATURE MAP

§CONFIG — الروابط الثابتة · esc() · orderLink() · دوال توقيت القاهرة · apiRequest/apiGet/apiPost بمهلة
§SHELL-JS — الإعدادات · النسخة · Changelog · About · التوست · runDiag() · حارس نسخة الـ Worker
§AUTH-JS — شاشة الدخول بخطوتين (اختيار الموظف ← الـ PIN)
§LOG-JS — الفلاتر multi-select · فلتر التاريخ · الترتيب · الصفحات · الرسم · تصدير XLSX
الـ Worker: §AUTH · §LOG-ENDPOINTS · §WEBHOOK (الأخير مالوش أي واجهة هنا)

KEY VARIABLES

currentEmployee — { username, displayName } في الذاكرة فقط، مش localStorage
LS_SECRET = 'duplicate_order_check_worker_secret' — المفتاح الوحيد في localStorage
WORKER_URL — ثابت في الكود (مش سر، مش حقل إعدادات)
TOOL_VERSION — مصدر واحد لرقم نسخة الصفحة · MIN_WORKER_VERSION — أقل Worker مقبول
LOG_PAGE_SIZE = 100 — نفس سقف الـ Worker للصفحة الواحدة

NOTES / QUIRKS

الواجهة دي مابتكتبش أي حاجة — مفيش زرار بيعدّل أوردر، ولا بيعيد تشغيل الفحص، ولا بيمسح صف من السجل.
عمود «الموظف» غالبًا «🔔 ويبهوك تلقائي» — صفوف الأداة دي بيكتبها الـ Worker من الويبهوك، مش موظف. فلتر الموظف موجود للتوافق مع المعيار وهيرجّع صفر نتايج طول ما مفيش صفوف بموظف.
الأداة مابتسجّلش login/logout في D1 — القيمتين مش مسجّلتين لها في ecommoda-constants §7، والقاعدة إن القيمة تتسجّل هناك قبل أول كتابة.
فلتر التاريخ بيقارن بـ UTC والعرض بتوقيت القاهرة — عملية متأخرة بالليل ممكن تقع في يوم UTC اللي بعده. مقبول لفلتر بالأيام، ومكتوب عشان مايتكتشفش كباج.
الترتيب والفلترة والصفحات كلها server-side — applySort() في الواجهة تمرير مباشر، ورقم «النتائج» جاي من get_logs_count مش من طول الصفحة.