استيراد أسعار Zones الحقيقية لكلمات الكويت — KWD
================================================

المحتويات:
- api/scripts/import-kalemat-zone-rates.php: سكريبت CLI واحد يحتوي الجدول كاملًا.
- ملفات migration الثلاثة الخاصة بالشحن (نص مدة التوصيل وميزة Zones)، لتجهيز تينانت كلمات فقط إذا لزم الأمر.

قبل التشغيل:
ارفع تحديث ميزة Zones إلى السيرفر أولًا، بما فيه منطق حساب سعر الشحنة حسب
نطاق الوزن. هذه الحزمة تستورد الأسعار وتحتوي migrations الميزة؛ لا تحتوي
كل ملفات الواجهة والـAPI الخاصة بالميزة ولا تنشرها بدلًا منك.
فك الحزمة داخل /home/pixipinestore/public_html/ecommerce مع الحفاظ على المسارات.
السكريبت لا يعمل من رابط في المتصفح؛ شغّله من Terminal بحساب cPanel.

1) معاينة فقط، بدون كتابة أسعار أو تشغيل migrations:

cd /home/pixipinestore/public_html/ecommerce/api
php scripts/import-kalemat-zone-rates.php

2) استيراد الأسعار وتجهيز migrations الميزة الناقصة فقط:

php scripts/import-kalemat-zone-rates.php --apply --prepare-schema

إذا كانت migrations مطبقة بالفعل، يكفي:

php scripts/import-kalemat-zone-rates.php --apply

التينانت ثابت: kalemat. يختار متجر الكويت KW بعملة KWD داخل هذا التينانت.
لا يعتمد على رقم متجر أو اسم قاعدة بيانات من البيئة المحلية.
لو وُجد أكثر من متجر KW/KWD، حدّد كود المتجر في المعاينة والتنفيذ مثلًا:

php scripts/import-kalemat-zone-rates.php --store=kw
php scripts/import-kalemat-zone-rates.php --store=kw --apply --prepare-schema

استخدم نسخة PHP CLI الملائمة للمشروع، ويمكن استبدال php بمسارها الكامل.

البيانات والسلوك:
- 8 خطط Z1 إلى Z8، كل خطة بها 53 وزنًا، أي 424 سعرًا بثلاث خانات عشرية.
- الأوزان مطابقة للجدول: أنصاف كيلو حتى 10، ثم 11 إلى 30، ثم 35 إلى 70
  بزيادة 5، ثم 80 و90 و100 و200 و300. لا يُضاف أي صف من عند السكريبت.
- كل سعر للشحنة بالكامل حتى وزن الصف. مثلًا 10.2 كجم يستخدم صف 11 كجم،
  و100.1 كجم يستخدم صف 200 كجم. أكثر من 300 كجم ليس له سعر في هذه الخطط.
- يطابق الخطة الموجودة بالاسم أو الكود Z1..Z8 دون حساسية لحالة الحروف،
  ويحافظ على رقم الخطة وكودها وربط الدول بها. الخطط الأخرى تظل كما هي.
- يعيد تسعير الخطط الثمانية بالجدول المرفق، ويحافظ على حالات التفعيل الحالية.
- لو طابقت أكثر من خطة نفس العمود، أو كانت لها عدة أسعار شحن منفصلة، يتوقف
  قبل كتابة أي سعر ويطلب إزالة الالتباس.
- يمكن إعادة التشغيل: الأسعار المطابقة تُتخطى دون إنشاء خطط أو أسعار مكررة.
- لا يربط الدول تلقائيًا؛ بعد الاستيراد اختر Zone المناسبة لكل دولة من
  لوحة التحكم > الشحن > دول التوصيل. لا تتغير أسعار الشحن العادية.
- التنفيذ كله معاملة واحدة. لو فشل عمود، لا تُحفظ أسعار الأعمدة الأخرى.

التقارير والنسخ الاحتياطية:
api/storage/app/private/kalemat-zone-rates/
يُنشئ backup-*.json قبل أي تغيير، وreport-*.json بنتيجة التشغيل وأرقام الخطط.
مسار النسخة الاحتياطية والتقرير يظهران في Terminal؛ لا تنشر محتوياتهما.
المعاينة أو إعادة التشغيل دون تغييرات لا تحتاج نسخة احتياطية جديدة.

--prepare-schema لا يعمل إلا مع --apply. يشغّل فقط الملفات الثلاثة:
2026_10_22_180500_add_estimated_delivery_text_to_shipping_tables.php
2026_10_28_140000_add_zone_weight_shipping.php
2026_10_28_160000_add_zone_weight_range_pricing.php
على قاعدة تينانت kalemat بعد التحقق منها. لا يشغّل migrate لكل التينانت،
ولا fresh أو reset أو rollback أو أي seeder.
