================================================================================
                        دليل البدء السريع - Quick Start
                    Migration: Packagemaker → fixed_v2
================================================================================

📌 الملفات المُنشأة:
────────────────────────────────────────────────────────────────────────────
  ✓ migration_plan.txt                  → خطة الترحيل الكاملة والتحليل
  ✓ migrate_core_no_templates.sql       → سكريبت SQL للترحيل اليدوي
  ✓ migrate_core_no_templates.php       → سكريبت PHP ذكي (موصى به)
  ✓ README_MIGRATION.md                 → دليل الاستخدام الشامل
  ✓ QUICK_START.txt                     → هذا الملف

================================================================================
⚡ الخطوات السريعة (3 دقائق فقط!)
================================================================================

الخطوة 1️⃣: نسخة احتياطية (ضرورية!)
────────────────────────────────────────────────────────────────────────────
mysqldump -u root -p supehgku_fixed_v2 > backup_fixed_v2.sql

الخطوة 2️⃣: اختبار (Dry-Run)
────────────────────────────────────────────────────────────────────────────
php migrate_core_no_templates.php --dry-run

الخطوة 3️⃣: الترحيل الفعلي
────────────────────────────────────────────────────────────────────────────
php migrate_core_no_templates.php

الخطوة 4️⃣: ضبط نظام الحدود
────────────────────────────────────────────────────────────────────────────
mysql -u root -p supehgku_fixed_v2

UPDATE limits_global 
SET mode='weekly', per_day=2, weekly_cap=6, ban_days=7 
WHERE id=1;

الخطوة 5️⃣: التحقق
────────────────────────────────────────────────────────────────────────────
SELECT 'sub_bots' as t, COUNT(*) FROM supehgku_fixed_v2.sub_bots
UNION ALL
SELECT 'steam_accounts', COUNT(*) FROM supehgku_fixed_v2.steam_accounts
UNION ALL
SELECT 'allowed_users', COUNT(*) FROM supehgku_fixed_v2.allowed_users;

النتائج المتوقعة: sub_bots=26, steam_accounts=102, allowed_users=358

================================================================================
🔧 تخصيص الاتصال بقاعدة البيانات
================================================================================

إذا كنت تستخدم اتصال مختلف:

Windows (PowerShell):
────────────────────────────────────────────────────────────────────────────
$env:DB_USER="your_username"
$env:DB_PASS="your_password"
php migrate_core_no_templates.php

Linux/Mac:
────────────────────────────────────────────────────────────────────────────
export DB_USER="your_username"
export DB_PASS="your_password"
php migrate_core_no_templates.php

================================================================================
❓ أوامر إضافية مفيدة
================================================================================

ترحيل مع جلسات التحكم:
────────────────────────────────────────────────────────────────────────────
php migrate_core_no_templates.php --with-sessions

استئناف بعد فشل:
────────────────────────────────────────────────────────────────────────────
php migrate_core_no_templates.php
(يستأنف تلقائياً من آخر نقطة)

مراجعة السجلات:
────────────────────────────────────────────────────────────────────────────
cat migrate_execution.log
# أو على Windows:
type migrate_execution.log

التحقق من المجموعات الافتراضية:
────────────────────────────────────────────────────────────────────────────
SELECT COUNT(*) FROM supehgku_fixed_v2.bot_groups bg
JOIN supehgku_fixed_v2.account_groups ag ON bg.group_id = ag.id
WHERE ag.is_default = 1;
-- يجب أن يكون 26 (عدد البوتات)

================================================================================
⚠️ تحذيرات مهمة
================================================================================

  1. لا تشغل السكريبت أثناء استخدام النظام بكثافة
  2. تأكد من النسخة الاحتياطية قبل البدء
  3. اختبر بـ --dry-run أولاً
  4. لا تقاطع التنفيذ - دعه يكمل

================================================================================
🆘 حل المشاكل الشائعة
================================================================================

مشكلة: "Connection refused"
الحل: تحقق من MySQL يعمل وأن بيانات الاتصال صحيحة

مشكلة: السكريبت توقف في منتصف steam_requests
الحل: أعد التشغيل - سيستأنف تلقائياً

مشكلة: أريد البدء من الصفر
الحل: rm .migrate_state.json ثم أعد التشغيل

================================================================================
📊 ما يحدث أثناء الترحيل
================================================================================

1. sub_bots (26 سجل)        → ~2 ثانية
2. steam_accounts (102)      → ~5 ثوان
3. allowed_users (358)       → ~10 ثوان
4. steam_requests (3411)     → ~30-60 ثانية
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
الإجمالي: 1-2 دقيقة تقريباً

================================================================================
✅ Checklist
================================================================================

قبل الترحيل:
  [ ] نسخة احتياطية من fixed_v2
  [ ] اختبار --dry-run
  [ ] النظام في وضع صيانة (إن أمكن)

بعد الترحيل:
  [ ] التحقق من عدد السجلات
  [ ] ضبط limits_global
  [ ] اختبار بوت واحد
  [ ] مراجعة system_logs

================================================================================
📚 للمزيد من التفاصيل
================================================================================

راجع الملفات التالية:
  • migration_plan.txt       → التحليل الكامل والتفاصيل الفنية
  • README_MIGRATION.md      → دليل الاستخدام الشامل مع الأمثلة

================================================================================
🎉 انتهى - بالتوفيق!
================================================================================
