-- ===================================================================
-- تقرير التوافق والتحديث النهائي لنظام المساعدة
-- ===================================================================
--
-- ✅ تقرير التوافق:
-- =================
-- 
-- 1. ملف 01_vouchers_groups_support.sql ← متوافق 100%
--    - جدول vouchers موجود في main.sql ✅
--    - جدول account_groups موجود في main.sql ✅  
--    - جدول bot_groups موجود في main.sql ✅
--    - يضيف فقط حقل target_group_id إلى vouchers
--    - آمن للتنفيذ بدون مشاكل
--
-- 2. ملف 02_user_limits.sql ← متوافق 100%
--    - ينشئ جدول limits_user جديد (غير موجود)
--    - لا يعدل أي جداول موجودة
--    - آمن للتنفيذ بدون تعارض
--
-- 3. تحديث message_templates:
--    - جدول message_templates موجود ✅
--    - المفاتيح help_part1-9 موجودة ✅
--    - يحتاج فقط تحديث النصوص
--
-- ===================================================================

-- نسخة احتياطية
CREATE TABLE IF NOT EXISTS `message_templates_backup_final` LIKE `message_templates`;
INSERT IGNORE INTO `message_templates_backup_final` SELECT * FROM `message_templates`;

-- ============================================
-- تحديثات أساسية للأوامر الموجودة
-- ============================================

-- تحديث help_part2: إضافة /users_count و /allusers المحسّن
UPDATE `message_templates` 
SET `text` = REPLACE(`text`, 
'<b>/allusers</b>
➡️ عرض جميع المستخدمين في النظام (DISTINCT)
📊 يعرض: user_id، عدد البوتات المشترك بها',

'<b>/allusers</b> ✨
➡️ عرض جميع المستخدمين في النظام (DISTINCT)
✅ تقسيم تلقائي للمخرجات الطويلة
📊 يعرض: user_id مميز عبر جميع البوتات

<b>/users_count</b> 🆕
➡️ عدد المستخدمين الإجمالي فقط (بدون تفاصيل)
💡 مثال: <code>/users_count</code>')
WHERE `key` = 'help_part2';

-- تحديث help_part4: إضافة أوامر الربط المتعدد
UPDATE `message_templates` 
SET `text` = CONCAT(`text`,

'\n\n<b>/group_bind_multi</b> <code>group bot1 bot2 ...</code> 🆕
➡️ ربط عدة بوتات بمجموعة واحدة (دفعة واحدة)
💡 <code>/group_bind_multi 36k test1 test2 test3</code>
✅ يعرض ملخص النجاح/الفشل لكل بوت

<b>/group_unbind_multi</b> <code>group bot1 bot2 ...</code> 🆕
➡️ فك ربط عدة بوتات من مجموعة (دفعة واحدة)
💡 <code>/group_unbind_multi vip bot1 bot2</code>')
WHERE `key` = 'help_part4' AND `text` NOT LIKE '%group_bind_multi%';

-- تحديث help_part5: إضافة دعم القسائم للمجموعات
UPDATE `message_templates` 
SET `text` = REPLACE(`text`,
'<b>الأنواع:</b> users | days

💡 <code>/generate_voucher users 100 mybot 1</code>',

'<b>الأنواع:</b> users | days

<b>الأهداف:</b> 🆕
• <code>all</code> - لجميع البوتات (افتراضي)
• <code>bot_label</code> - لبوت محدد فقط
• <code>group:name</code> - لمجموعة محددة 🆕✨

<b>أمثلة:</b>
💡 <code>/generate_voucher users 100</code> → عامة
💡 <code>/generate_voucher users 50 mybot 5</code> → لبوت
💡 <code>/generate_voucher users 200 group:36k 3</code> 🆕 → لمجموعة
   ✅ تعمل فقط في البوتات المرتبطة بالمجموعة')
WHERE `key` = 'help_part5';

-- تحديث help_part6: إضافة نظام الردود الموسع
UPDATE `message_templates` 
SET `text` = CONCAT(`text`,

'\n\n<b>نظام الردود الموسع:</b> 🆕

<b>/response_add</b> <code>key text</code> - إضافة رد جديد
<b>/response_edit</b> <code>key text</code> - تعديل رد
<b>/response_delete</b> <code>key</code> - حذف رد
<b>/response_list</b> - عرض جميع المفاتيح
<b>/response_view</b> <code>key</code> - عرض رد محدد

💡 <code>/response_add welcome مرحباً {username}!</code>')
WHERE `key` = 'help_part6' AND `text` NOT LIKE '%response_add%';

-- ============================================
-- إضافة أقسام جديدة
-- ============================================

-- قسم Webhook
INSERT INTO `message_templates` (`key`, `text`) VALUES 
('help_webhook', '🌐 <b>قسم Webhook</b> 🆕

<b>/webhook_create</b> <code>bot</code>
<b>/webhook_enable</b> <code>bot</code>
➡️ إنشاء وتفعيل Webhook لبوت
💡 <code>/webhook_create mybot</code>

<b>/webhook_reset</b> <code>bot</code>
➡️ إعادة ضبط Webhook

<b>/webhook_delete</b> <code>bot</code>
➡️ حذف Webhook

<b>/webhook_info</b> <code>bot</code>
➡️ معلومات Webhook الحالي

💡 يعرض رابط Webhook الكامل مع أمثلة التفعيل')
ON DUPLICATE KEY UPDATE `text`=VALUES(`text`);

-- قسم الإحصاءات
INSERT INTO `message_templates` (`key`, `text`) VALUES 
('help_stats', '📊 <b>قسم الإحصاءات والتقارير</b> 🆕

<b>/stats_bots</b>
➡️ إحصاءات البوتات + أكثر 5 نشاطاً

<b>/stats_users</b>
➡️ إحصاءات المستخدمين + أكثر 5 في آخر 7 أيام

<b>/stats_groups</b>
➡️ إحصاءات المجموعات + أكبر 5 مجموعات

<b>/stats_vouchers</b>
➡️ إحصاءات القسائم (مستخدمة/نشطة/منتهية)

<b>/stats_broadcast</b>
➡️ إحصاءات البث + آخر 5 عمليات
✅ تقسيم تلقائي للمخرجات الطويلة

<b>/stats_all</b>
➡️ ملخص شامل للنظام كاملاً

📊 <b>ما يتم عرضه:</b>
✅ الإجمالي والنشط/المحظور
✅ أفضل 5 (الأكثر نشاطاً/مستخدمين)
✅ إحصاءات الفترة الأخيرة
✅ بيانات في الوقت الفعلي من قاعدة البيانات

💡 <code>/stats_all</code> - نظرة سريعة على كل شيء')
ON DUPLICATE KEY UPDATE `text`=VALUES(`text`);

-- ============================================
-- تحديث help_part9: إضافة حدود المستخدمين
-- ============================================
UPDATE `message_templates` 
SET `text` = CONCAT(`text`,

'\n\n<b>🙍 حدود المستخدمين:</b> 🆕✨

<b>/set_user_limit</b> <code>user_id mode per_day [cap] [ban] [bot]</code>
➡️ حد خاص لمستخدم تيليجرام محدد
💡 <code>/set_user_limit 123456 weekly 5 20 7</code>
💡 <code>/set_user_limit 123456 daily 3 - - mybot</code>

<b>/clear_user_limit</b> <code>user_id [bot]</code>
➡️ حذف حد المستخدم
💡 <code>/clear_user_limit 123456</code>

<b>/show_user_limit</b> <code>user_id</code>
➡️ عرض حدود مستخدم معين

<b>⚙️ ترتيب الأولويات المحدّث:</b>
1️⃣ override_account (حساب Steam) - أعلى
2️⃣ limits_user (مستخدم Telegram) 🆕
3️⃣ limits_bot (بوت محدد)
4️⃣ limits_global (عام) - أقل')
WHERE `key` = 'help_part9' AND `text` NOT LIKE '%set_user_limit%';

-- ============================================
-- تحديث help_part1: تحسينات البوتات
-- ============================================
UPDATE `message_templates` 
SET `text` = REPLACE(`text`,
'<b>/list</b>
➡️ عرض جميع البوتات المسجلة مع تفاصيلها
📊 يعرض: الاسم، عدد المستخدمين، الحالة، القناة',

'<b>/list</b> ✨
➡️ عرض جميع البوتات المسجلة مع تفاصيلها
📊 يعرض: الاسم، عدد المستخدمين، الحالة، القناة
✅ يدعم التقسيم التلقائي للرسائل الطويلة

<b>/show_welcome_messages</b> 🆕
➡️ عرض جميع رسائل الترحيب لكل البوتات
✅ تقسيم تلقائي للمخرجات الطويلة')
WHERE `key` = 'help_part1';

-- ============================================
-- رسالة نجاح
-- ============================================
SELECT '
═══════════════════════════════════════
✅ تم تحديث نظام المساعدة بنجاح!
═══════════════════════════════════════

📋 التحديثات المُطبقة:
• ✅ إضافة أمر /users_count
• ✅ تحسين /allusers مع تقسيم تلقائي
• ✅ إضافة /group_bind_multi و /group_unbind_multi
• ✅ دعم القسائم للمجموعات (group:name)
• ✅ نظام الردود الموسع (5 أوامر جديدة)
• ✅ قسم Webhook كامل (5 أوامر)
• ✅ قسم الإحصاءات (6 أوامر)
• ✅ حدود المستخدمين (3 أوامر)
• ✅ تحسين /list و /show_welcome_messages

📌 المفاتيح الجديدة:
• help_webhook
• help_stats

📌 المفاتيح المحدثة:
• help_part1
• help_part2
• help_part4
• help_part5
• help_part6
• help_part9

🔧 الخطوة التالية:
تأكد من تنفيذ:
1. sql_updates/01_vouchers_groups_support.sql
2. sql_updates/02_user_limits.sql
3. هذا الملف (FINAL_HELP_UPDATE.sql)

═══════════════════════════════════════
' as 'نتيجة التحديث';
