الإعداد الأولي للتطبيق

يقدم MagicTradeBot v6.0 نظام إعدادات مُعاد تصميمه بالكامل. جميع الإعدادات أصبحت الآن معيارية ومنظمة وموجودة داخل مجلد /settings.

💡 موصى به: استخدم مُهيّئ البوت عبر الواجهة الرسومية بدلاً من تعديل ملفات YAML يدوياً:
https://magictradebot.com/en/bot-configuration

⚠️ التعديل اليدوي مخصص للمستخدمين المتقدمين فقط.

---

📁 هيكل الإعدادات

/settings/
├── application.yaml
├── connection.yaml
├── trading.yaml
├── position_sizing.yaml
├── money_management.yaml
├── risk_limits.yaml
├── order_execution.yaml
├── decision_engine.yaml
├── signal_registry.yaml
├── tradeview.yaml
├── market_data.yaml
├── market_watch.yaml
├── whale_tracking.yaml
├── dca.yaml
├── trading_gap_rules.yaml
├── excluded_symbols.yaml
├── manual_trade.yaml
└── notifications.yaml

يتحكم كل ملف في نظام فرعي محدد من البوت، مما يسمح بضبط دقيق وسهولة في الصيانة.

---

🧠 وحدات الإعدادات الأساسية

---

📊 وحدات السوق والاستراتيجية

• market_data.yaml — معالجة بيانات الشموع
• market_watch.yaml — مراقبة التقلب والتداول التلقائي
• dca.yaml — نظام متوسط تكلفة الشراء
• trading_gap_rules.yaml — منطق الربح المتحرك الديناميكي
• whale_tracking.yaml — نسخ تداول الحيتان في Hyperliquid

---

🧩 وحدات التحكم والأدوات

• excluded_symbols.yaml — منع التداول على أزواج محددة
• manual_trade.yaml — إدخال صفقات يدوية مشروطة
• notifications.yaml — التنبيهات (تيليجرام، ديسكورد، إلخ)

---

🔐 متغيرات البيئة (موصى به)

يجب عدم تخزين مفاتيح API والبيانات الحساسة في ملفات YAML. استخدم متغيرات البيئة بدلاً من ذلك.

# مثال
BINANCE_API_KEY=your_key
BINANCE_API_SECRET=your_secret

⚠️ متغيرات البيئة تتجاوز دائماً إعدادات YAML.

---

⚠️ قيود مهمة لوضع التداول في المنصات

• Bybit: وضع الاتجاه الواحد فقط (Hedge Mode غير مدعوم)
• Binance: يدعم وضع التحوط
• Bitget: يدعم وضع التحوط
• OKX: يدعم وضع التحوط

استخدام وضع غير صحيح قد يؤدي إلى:

• فشل تنفيذ الأوامر
• حسابات غير صحيحة للأرباح والخسائر
• عدم اتساق إدارة المخاطر

---

🚀 البدء السريع (v6.0)

1. افتح مُهيّئ البوت
2. قم بإعداد استراتيجيتك عبر الواجهة
3. صدّر إعدادات YAML
4. استبدل مجلد /settings
5. أضف مفاتيح API عبر ملف .env
6. شغّل MagicTradeBot

✅ لا حاجة لقاعدة بيانات (SQLite افتراضي)
✅ لا حاجة لإعداد Backend
✅ نظام معياري بالكامل وقابل للتوسع