الصفحة دي جزء من الهب — الدخول بيحصل مرة واحدة في الشاشة الرئيسية، والهوية بتوصل هنا من sessionStorage.

🔴 الأداة دي هدّامة — حراسها ما اتلمستش

• نافذة التأكيد بالتأكيدين الإلزاميين (مراجعة المخزون + قطع الفاتورة).
• شرط displayFinancialStatus = PENDING (COD غير مسدد).
• restock: false مفروضة من الواجهة والـ Worker — دفاع مزدوج.
• الرجوع للوضع الافتراضي بعد أي حذف ناجح.
• انتقال custom.manual_status → Pending Edit بشرطه، وcancel_manual_reason → المنتج غير متوفر.

الفتح التلقائي من طابور التغليف

⚠️ ?order= بيوصل لقايمة المنتجات بس — مش بيحذف ومش بيختار بند. قرب الأداة بضغطة من جدول التغليف معناه إنها هتتستخدم أكتر، يعني حراسها بقت أهم مش أقل.

الهدف: إزالة منتج واحد لسه ما اتشحنش (Unfulfilled بالكامل) من أوردر معين، بدل إلغاء الأوردر كله — مفيد لو العميل رجع في منتج واحد بس من أوردر فيه أكتر من منتج.

المستخدمون المستهدفون: فريق خدمة العملاء / إدارة الأوردرات.

كيف تعمل — Workflow

1. الموظف يدخل رقم الأوردر ويضغط بحث.
2. الأداة تجيب الأوردر وتعرض بس المنتجات اللي حالتها Unfulfilled بالكامل.
3. لو الأوردر مش مؤهل (متسدد أونلاين / ملغي / مقفول) — بانر أحمر واضح بالسبب، ومفيش حذف متاح.
4. الموظف يختار منتج ويضغط "حذف من الأوردر" — نافذة تأكيد بتاعتين إلزاميتين: مراجعة المخزون + قطع الفاتورة.
5. الأداة تنفّذ Order Editing (Shopify) لإزالة البند بالكامل — بدون استرجاع مخزون أبدًا.
6. لو الانتقال مسموح: تحديث custom.manual_status إلى "Pending Edit" وcustom.cancel_manual_reason إلى "المنتج غير متوفر".
7. النتيجة تظهر كـ toast وتتسجّل في سجل العمليات — نجاح / تحذير / فشل — والأداة ترجع لوضعها الافتراضي (مربع بحث فاضي).

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

action	الوصف
lookup_order	البحث عن أوردر بالاسم وجلب منتجاته Unfulfilled
remove_item	حذف بند من الأوردر (Order Editing API — quantity → 0، بدون استرجاع مخزون) + تحديث ميتافيلدات الحالة/السبب
get_logs / get_logs_count / get_logs_export	سجل العمليات — صفحات + تصدير XLSX
diag	فحص ذاتي: الصلاحيات (write_order_edits) و تعريفات الميتافيلدز و D1 والاتصال

⚙️ إجراءات كل حذف

الإجراء	التفاصيل
حذف البند	Order Editing API — orderEditSetQuantity(quantity: 0) ثم Commit
استرجاع المخزون	معطّل دائمًا — restock: false مفروضة من السيرفر بغض النظر عن أي مدخل
تحديث الحالة	custom.manual_status → Pending Edit — بس لو الحالة الحالية Confirmed أو Ready (أو Pending Edit بالفعل)، وإلا يتم تخطيها مع تحذير
تحديث سبب الإلغاء	custom.cancel_manual_reason → المنتج غير متوفر — دايمًا، بغض النظر عن حالة الأوردر. القيمة لازم تكون ضمن خيارات تعريف الميتافيلد، والحارس بيتأكد من ده قبل الحذف

⚠️ قيود مهمة

• الأداة تشتغل بس على أوردرات financial status = PENDING (يعني COD غير متسدد بعد) — الأوردرات المتسددة أونلاين ممنوع الحذف منها من هنا (قرار: منع كامل، لا استرجاع تلقائي مطبَّق).
• بس البنود اللي كميتها كلها Unfulfilled (مفيش أي جزء اتشحن) هي القابلة للحذف الكامل.
• استرجاع المخزون معطّل دائمًا — الأداة مخصّصة فقط للمنتجات المكتشف إنها غير متوفرة بالمخزن وقت التجهيز.
• الحذف مش بيرجع تاني تلقائيًا — لو غلط، لازم يتضاف المنتج يدويًا للأوردر من شوبيفاي.

FEATURE MAP

• §AUTH — Universal D1 Auth
• §TOOL — بحث الأوردر + عرض المنتجات + حذف بند (Order Editing API)
• §LOG — سجل العمليات (جدول + صفحات + تصدير)

KEY VARIABLES

• currentEmployee — { username, displayName } في الذاكرة فقط
• روابط الـ Workers — ثوابت في shared/shell.js § CONFIG (مش في التخزين المحلي — Standards #28)
• LS_SECRET = 'order_item_remover_worker_secret' — المفتاح الوحيد في localStorage
• TOOL_NAME = 'order_item_remover' — قيمة tool في جدول logs
• currentOrder — آخر أوردر تم البحث عنه (في الذاكرة)

NOTES

• الحذف بيتم عبر orderEditSetQuantity(quantity: 0) — مفيش mutation مباشرة لحذف بند في Shopify.
• محتاج صلاحية write_order_edits + read_order_edits على تطبيق شوبيفاي — مختلفة عن write_orders العادية. استخدم زرار "فحص النظام" في الإعدادات للتأكد.
• restock مفروضة false من الواجهة **و**من الـ Worker (دفاع مزدوج) — الشيك بوكس في الواجهة معطّل ومقفول دايمًا.
• تحديث custom.manual_status بيتحقق من صحة الانتقال قبل الكتابة (ecommoda-order-lifecycle §1.4) — بيتخطى الكتابة بأمان لو الحالة الحالية مش Confirmed/Ready، بدل ما يكتب انتقال غير مسموح.
• نوع الميتافيلد (type) بيتقرا ديناميكيًا من تعريف الحقل في شوبيفاي وقت التنفيذ — مش hardcoded.