نقل أوردرات StyleBox

📋 وصف الأداة

الهدف: الأداة نفسها Worker بيستقبل ويبهوك من WooCommerce (stylebox.online) وبينشئ نفس الأوردر على Shopify تلقائيًا. الشاشة دي عرض فقط — بتجاوب على سؤال واحد: هل كل أوردرات StyleBox وصلت شوبيفاي، وإيه اللي وقف؟

المستخدمون المستهدفون: إدارة · متابعة الأوردرات.

⚠️ الشاشة مفيهاش أي أكشن — مفيش إعادة محاولة ولا تعديل. أي تدخل على أوردر واقف بيتعمل من شوبيفاي أو من WooCommerce مباشرة.

كيف تعمل — Workflow

العميل بيعمل أوردر على stylebox.online، والـ COD gateway بيحوّل حالته لـ processing.
WooCommerce بيبعت ويبهوك (Topic: Order updated) للـ Worker، والـ Worker بيتأكد من التوقيع (HMAC).
الـ Worker بيحجز الأوردر في wc_order_sync_ledger (حماية من التكرار)، وبعدين بينشئ Draft Order على شوبيفاي وبيكمّله كأوردر COD حقيقي.
بيكتب رقم أوردر WooCommerce في ميتافيلد custom.stylebox_order_id على أوردر شوبيفاي.
النتيجة بتتسجّل في D1 — created أو skipped أو error — والشاشة دي بتقراها.

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

action	الوصف
`get_summary`	عدّادات الفترة + الفترة السابقة + حالة الـ ledger + آخر حدث
`get_attention`	الأوردرات اللي حالتها `failed` أو `in_progress` عالقة، ومعاها آخر رسالة خطأ
`get_logs`	صفحة من السجل (100 صف) — فلترة وترتيب server-side
`get_logs_count`	إجمالي الصفوف المطابقة للفلاتر (للصفحات)
`get_logs_export`	التصدير لـ XLSX + `cap`/`total`/`truncated`
`get_config` · `diag`	نسخة الـ Worker والفحص الذاتي
`get_employees` · `check_employee` · `register_pin` · `verify_employee` · `log_logout`	شاشة الدخول (Universal D1 Auth)

🔧 تشريح الكود

FEATURE MAP

§CONFIG — الروابط الثابتة · esc() · توقيت القاهرة بـ Intl · apiRequest بمهلة
§SHELL-JS — الإعدادات · النسخة · التوست · الفحص الذاتي · حارس نسخة الـ Worker
§AUTH-JS — شاشة الدخول (4 حالات) والخروج
§TOOL-JS::overview — الطزاجة · مربعات KPI · شريط الـ ledger · جدول الانتباه
§LOG-JS — فلاتر السجل · الترتيب · الصفحات · تصدير XLSX

KEY VARIABLES

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

NOTES / QUIRKS

مفيش عمود «الموظف» في السجل — الأداة مستقبِل ويبهوك، فكل الصفوف بتتكتب من غير موظف. صفوف الدخول/الخروج مستثناة من السجل server-side.
skipped مش فشل — WooCommerce بيبعت order.updated لأي تعديل، فالويبهوك بيتكرر لنفس الأوردر. التكرار بيترفض بالـ ledger، وده السلوك الصح.
in_progress عالق = التنفيذ اتقطع قبل ما يخلص (مهلة Cloudflare 30 ثانية على ctx.waitUntil). الصف بيبقى قابل لإعادة المطالبة بعد 3 دقايق لو جه ويبهوك تاني لنفس الأوردر.
فلتر التاريخ بيقارن بـ UTC والعرض بتوقيت القاهرة — فرق الساعتين/التلاتة ممكن يحط عملية بالليل في يوم UTC اللي بعده.
الأرقام من D1 مباشرة — مفيش كاش ومفيش نداء لشوبيفاي، فكل ضغطة تحديث بترجّع الحالة اللحظية.