🚀 TradeCopierBot — نسخ الصفقات بسرعة ونظافة ومقاومة للوسيط (محلي/VPS) 🔁✨

انسخ صفقاتك من حساب MASTER إلى واحد (أو أكثر) من حسابات SLAVE باستخدام ناسخ خفيف الوزن مدفوع بالأحداث مصمم لظروف التداول الحقيقية: وسطاء مختلفون، أسماء رموز مختلفة، قواعد لوت مختلفة.
مثالي لـ تنفيذ متعدد الحسابات، تدرج المخاطر، و توزيع الاستراتيجيات—مع سجلات تصحيح مفصلة حتى تعرف دائمًا ما يحدث. 🧠📈

✅ مُحسّن لإعدادات محلي / VPS (نفس الجهاز).
❌ غير مصمم لـ cTrader Cloud (الحالات معزولة، لذا لا يمكن مشاركة الإشارات). ☁️🚫

تنبيه: إذا كان لديك حسابان مختلفان في cTrader، تحتاج إلى شراء اثنين من cBots؛ وإلا فلن تتمكن من نسخهما. نحن في خدمتك لأي معلومات.

🧠 كيف يعمل (MASTER → SLAVE) 🧩

🔁 1) نقل الإشارة (كيف "تنتقل" الصفقات)

يستخدم هذا الناسخ cTrader LocalStorage (نطاق الجهاز) كـ "ناقل رسائل" مشترك.

✅ MASTER

• يستمع لأحداث المراكز: مفتوحة / معدلة / مغلقة
• ينشئ TradeSignal (فتح / تعديل / إغلاق)
• يلحقها إلى قائمة الإشارات في LocalStorageScope .Device
• ينادي Flush() حتى يتمكن SLAVE من قراءتها فورًا

✅ SLAVE

• يشغّل مؤقت كل فترة الاستطلاع ثانية
• ينادي Reload()
• يقرأ قائمة الإشارات
• يعالج فقط الإشارات الجديدة (باستخدام _lastSignalIndexProcessed)

🧷 2) تعيين المراكز (لكي يعمل الإغلاق)

عندما يفتح SLAVE صفقة، يخزن:

🧩 MasterPositionId → SlavePositionId

يتم حفظ هذا التعيين أيضًا في LocalStorage، لذا يبقى بعد إعادة التشغيل:

• ✅ الإغلاق لا يزال يعمل بعد إعادة التشغيل
• ✅ التعديل لا يزال يجد المركز الصحيح

🧭 3) ترجمة الرموز (رمز MASTER → رمز SLAVE)

🗺️ خريطة الرموز (MASTER=SLAVE;...)

تُستخدم عندما تختلف أسماء الرموز بين الوسطاء/الحسابات.

الصيغة:

• MASTER=SLAVE;MASTER2=SLAVE2;...

مثال (حالتك):

• يفتح MASTER USTEC
• يجب على SLAVE التداول بـ US100

➡️ USTEC=US100

✅ الجانب الأيسر = الرمز القادم من MASTER
✅ الجانب الأيمن = الرمز على وسيط SLAVE

📏 4) منطق الحجم (الجزء الأساسي) 🔥

✅ يعمل باللوت/الكمية (يدعم الكسور العشرية)

للتعامل مع الكسور العشرية (0.10، 0.01، إلخ)، يقوم SLAVE بـ:

• حساب اللوتات المطلوبة
• تطبيق المضاعف / الحد الأدنى / الخطوة
• تحويل اللوت → الحجم باستخدام QuantityToVolumeInUnits(lots)
• إرسال الأمر باستخدام تحميل زائد يقبل حجم مزدوج ✅

هذا ما يجعله قويًا حتى عندما يفرض الوسطاء قواعد دقة لوت مختلفة.

⚙️ شرح المعلمات (مع الرموز)

🧩 النواة

• 🧭 الوضع
• • Master = ينشر الإشارات
  • Slave = يقرأ الإشارات وينسخ الصفقات
• 🧷 معرف مجموعة النسخ
• • قناة الاتصال. يجب أن يتطابق MASTER و SLAVE (مثلاً، DEFAULT)
• ⏱️ فترة الاستطلاع (ثواني)
• • يقوم SLAVE بفحص الإشارات الجديدة كل N ثانية
• 🐞 وضع التصحيح
• • يطبع سجلات مفصلة (موصى به أثناء الإعداد)

🗺️ ترجمة الرموز

• 🧾 خريطة الرموز (MASTER=SLAVE;...)
• • مثال: USTEC=US100;XAUUSD=GOLD;NAS100=USTEC

🎚️ تدرج الحجم (الأهم) ✅

🔢 المضاعف العالمي

• ➗ مضاعف الحجم
• • يضبط جميع اللوتات المنسوخة:
  • desiredLots = masterLots * VolumeMultiplier

🎛️ مضاعف لكل رمز (أداتك الرئيسية)

• 🧷 خريطة مضاعف الحجم (SYM=mult;...)
• • يتجاوز المضاعف لكل رمز (رمز جانب SLAVE)
  • مثال:
  • • US100= 0. 10
    • الصيغة الإيطالية مقبولة أيضًا: US100=0,10

✅ هكذا تحقق: 1. 00 على MASTER → 0. 10 على SLAVE

🧱 قيود اللوت للوسيط (الحد الأدنى والخطوة)

• 🧱 الكمية الدنيا الافتراضية (0=إيقاف)
• • الحد الأدنى العالمي للوتات إذا تم التفعيل
• 🧱 خريطة الكمية الدنيا (SYM=val;...)
• • الحد الأدنى للوتات لكل رمز
  • مثال: US100=0. 10
• 🪜 الخطوة الافتراضية للكمية (0=إيقاف)
• • الخطوة العالمية إذا تم التفعيل
• 🪜 خريطة خطوة الكمية (SYM=val;...)
• • الخطوة لكل رمز
  • مثال: US100=0. 10 → القيم المسموح بها: 0. 10، 0 .20، 0.30…

🧯 سلوكيات الأمان

• 🧷 استخدام الكمية الدنيا كلوت ثابت
• • إذا كانت true: يتجاهل SLAVE حجم الماستر ويستخدم دائمًا MinQty (تحديد ثابت)
• ⚠️ سلوك تحت الحد الأدنى
• • UseMin = إذا كان أقل من الحد الأدنى → رفع إلى الحد الأدنى
  • Skip = إذا كان أقل من الحد الأدنى → لا يفتح
• 🔁 محاولات حجم خاطئ
• • إذا أعاد الوسيط حجمًا خاطئًا، يحاول تعديلات صغيرة حتى N مرات

🎯 منطق نسخ SL/TP

• 🛡️ نسخ SL/TP كمسافة عندما يختلف الرمز
• • إذا اختلفت رموز MASTER و SLAVE:
  • يتم نسخ SL/TP كـ مسافة من نقطة الدخول، وليس السعر المطلق
  • هذا يحافظ على اتساق ضوابط المخاطر عبر الأدوات

✅ الإعداد الموصى به (USTEC → US100، لوت SLAVE = 0. 10)

على SLAVE:

🗺️ ترجمة الرموز:

• Symbol Map = USTEC=US100

🎛️ تدرج الحجم:

• Volume Multiplier Map = US100=0,10

🧱 قيود الوسيط:

• Min Qty Map = US100=0,10
• Qty Step Map = US100=0,10

النتيجة:

• ✅ MASTER 1. 00 → SLAVE 0. 10 على US100

☁️ مهم: محلي/VPS فقط (ليس السحابة) ❌

🖥️ محلي/VPS ✅

يعمل لأن MASTER و SLAVE يشتركان في نفس LocalStorageScope .Device (نفس الجهاز/البيئة).

☁️ cTrader Cloud ❌

لا يعمل لأن حالات السحابة معزولة، لذا لا يشاركون LocalStorage ولا يمكن لـ SLAVE رؤية إشارات MASTER.

✅ الخلاصة:

• ✔️ استخدم على نفس الكمبيوتر أو على VPS حيث تعمل الحالتان معًا
• ❌ للسحابة تحتاج إلى مرحل خارجي (خادم HTTP/WebSocket)