01
مسئله مهندسی
برنامه تصمیمگیری پایتون نباید مستقیماً به بروکر فرمان بدهد. یک عامل داخل ترمینال لازم است تا تازگی و ساختار فرمان را بررسی کند، کنترلهای محلی را اعمال کند، جلوی اجرای تکراری را بگیرد و نتیجه واقعی عملیات در MetaTrader را گزارش دهد.
02
راهکار سامانه
SignalFileTrader از یک رابط فرمان فایلمحور میان Python و MT4 استفاده میکند. فرمانهای واجد شرایط را پردازش میکند، کنترلهای ترمینال و سفارش را انجام میدهد، ورود یا اقدامات مدیریت پوزیشن را اعمال میکند، چرخه فرمان را ثبت میکند و نتیجه را به برنامه تصمیمگیر متصل بازمیگرداند.
03
دامنه مهندسی
- خواندن Signal ورود از CSV با کنترل Freshness، Timestamp، Duplicate، Score، Confidence، ATR، Spread، Cooldown، Daily Loss و Position Limit.
- Sizing ثابت یا درصد ریسک با ATR Stop، Fixed-Pip Fallback، حداقل Stop، Slippage Buffer، Commission Audit، Symbol Risk Cap و کاهش ریسک براساس Drawdown.
- تأیید کیفیت اجرای M1/M5 با Structure، ATR Shock، Breakout، Momentum، Body/Wick/Close-Edge، Sweep و Trigger لحظه ورود.
- Order، SL/TP، Trailing، Break-even، Partial Close، De-risking، Reverse و Retry Queue.
- فرمان خارجی EXIT، REDUCE، ADD، EXIT_AND_REVERSE، History و Snapshot.
- مسیر محافظتشده ADD/Pyramiding با Profit-Funded Sizing، Lock-Before-ADD، Common SL، Margin/Basket Risk، Approval و Emergency Control.
- پنل PM Core، Live Confirmation، ADD، REDUCE، Risk، Bridge Scan، Compact Monitor و Command Diagnostic.
- Heartbeat، Position، History، Audit، Lineage، Trade Ops، Pause، Kill Switch و AutoTuner OHLC Bridge.
04
لایههای معماری و مسئولیت
تحلیل و Policy خارجی
سیستمهای Python تصمیم پیشنهادی را میسازند و فرمان ورود یا PM را در فایل ساختاریافته مینویسند.
Endpoint اجرای MT4
SignalFileTrader فرمان را Parse میکند، وضعیت محلی را میسنجد، ریسک را محاسبه میکند و Order یا Retry را مدیریت میکند.
لایه عملیات Broker
MetaTrader محدودیت Order، Stop، Lot، Margin، Spread، Slippage و Trade Operation را اعمال میکند.
بازخورد و Observability
Heartbeat، Position، History، Completion، Audit، Lineage، OHLC و Diagnostics به Python و اپراتور برمیگردند.
05
گردشکار عملیاتی
- ردیف ورود در TradePicker_Entries.csv یا فرمان PM در TradePicker_Commands.csv دریافت میشود.
- Symbol، Direction/Action، Timestamp، Score، Confidence، شناسه و Metadata Parse میشود.
- Age، Timestamp، Duplicate، Spread، Cooldown، Daily Loss، Position Limit، Confidence، Score و ATR بررسی میشود.
- در صورت فعالبودن، M1/M5 Local Confirmation بهعنوان Gate نهایی کیفیت اجرا اعمال میشود.
- Lot، SL، TP، Slippage، Commission-Aware Risk و محدودیت Broker محاسبه میشود.
- Trade Operation ارسال یا برای خطای موقت واجد شرایط وارد Retry Queue میشود.
- پوزیشن با Trailing، Break-even، Partial Close، Reverse، ADD، REDUCE و قواعد حفاظتی مدیریت میشود.
- Processed State، Heartbeat، Position، History، Risk Audit، Lineage و Trade Ops نوشته میشود.
- Pause/Kill Switch کنترل و Runtime در پنلها و Journal نمایش داده میشود.
06
رابطهای داده و فرمان
| رابط | جهت | کاربرد |
|---|---|---|
| TradePicker_Entries.csv | Python → MT4 | پیشنهاد ورود و Metadata مربوط به Score و Confidence را حمل میکند. |
| TradePicker_Commands.csv | Python → MT4 | فرمان EXIT، REDUCE، ADD، Reverse، History و Bridge را حمل میکند. |
| PM_AddRequests / PM_AddApprovals / PM_AddReadiness | MT4 ↔ Python | هماهنگی Approval برای ADD و Diagnostic آمادگی را پشتیبانی میکند. |
| PM_Positions.csv / PM_ClosedTrades.csv | MT4 → Python | Snapshot پوزیشن باز و تاریخچه بستهشده را برای Monitoring و Policy Review صادر میکند. |
| MT4_Bridge_Status و Audit/Log | MT4 → Monitoring/Audit | Heartbeat، محاسبه ریسک، Lineage، چرخه معامله، Retry و خطای Operation را گزارش میکند. |
| AutoTuner OHLC Request/Response/Status | Python ↔ MT4 | داده Candle با زمان محلی را بهصورت On-Demand یا Continuous برای Tuning فراهم میکند. |
| STAGE25_PAUSE / STAGE25_KILL_SWITCH | کنترل خارجی → MT4 | Interlock مستقل از مسیر اصلی Signal و Command فراهم میکند. |
07A
خروجیهای سامانه
- عملیات Entry، SL/TP و مدیریت پوزیشن در Broker
- Processed Entry و وضعیت فرمان PM
- Snapshot پوزیشن باز و تاریخچه بستهشده
- Heartbeat و وضعیت ترمینال
- Risk Audit و Signal/Profile Lineage
- Trade Lifecycle و Retry Diagnostic
- OHLC Response و Readiness State
07B
لایههای ایمنی و کنترل
- Age، Future Skew، Timestamp Parsing، Duplicate ID، Score، Confidence، Spread، Cooldown، Daily Loss و Position Limit قبل از ورود اعمال میشوند.
- ATR، حداقل Stop، Min-Lot Overshoot، Slippage، Commission، Symbol Risk، Margin، Basket Risk و Drawdown، Sizing و Execution را محدود میکنند.
- ADD، REDUCE، EXIT و Reverse دارای Age، Repeat، Cooldown، Rate، Pending و Urgency Control هستند.
- Pause و Kill Switch خارجی Interlock مستقل ایجاد میکنند.
08
شواهد اعتبارسنجی
- گزارش Public Demo، بررسی هویت سورس، Forbidden API، Private Include/Compiled Artifact، Delimiter، Handlerهای MQL4 و تولید Manifest/SHA-256 را ثبت کرده است.
- کامپایل MetaEditor بهدلیل نبود Compiler اختصاصی در محیط آمادهسازی انجام نشده و Compile محلی و تست چارت با AutoTrading خاموش همچنان لازم است.
- Public Demo به سرویس خصوصی Python، حساب Broker، پروتکل CSV Production یا منطق اختصاصی Risk/Confirmation متصل نمیشود.
09
مرز اطلاعات عمومی و خصوصی
شواهد منتشرشده
مسئولیت عامل اجرا، تحویل فرمان، اعتبارسنجی سمت ترمینال، عملیات سفارش و پوزیشن، وضعیت تأیید و نتیجه، پنلهای زمان اجرا و تصاویر تشخیصی منتخب.
پیادهسازی محافظتشده
سورس کامل، Schema و نمونه فرمان خصوصی، تنظیمات بروکر و حساب، لاگهای تولیدی، اطلاعات ورود، جزئیات استقرار و کنترلهای حساس محلی.
10
نحوه تفسیر و محدودیتها
- SignalFileTrader عامل اجراست و موتور پژوهش، ساخت سیگنال یا تصمیمگیری چنددارایی نیست.
- رفتار بروکر، قوانین نماد، Slippage، Spread، وضعیت ترمینال و شرایط استقرار باید جداگانه تست شوند.
- تصاویر و مستندات عمومی، آمادگی اجرای بدون نظارت یا عملکرد معاملاتی را اثبات نمیکنند.
11
شواهد تکمیلی رابط
شواهد استخراجشده از بکاپ GitHub
این تصاویر مستقیماً از بکاپ GitHub ارسالی استخراج شدهاند و بدون بخش مخفی، در همین صفحه نمایش داده میشوند.
جزئیات منبع
منبع: SignalFileTrader-PRO-for-MetaTrader/docs/screenshots/main-panel-light.pngجزئیات منبع
منبع: SignalFileTrader-PRO-for-MetaTrader/docs/screenshots/pm-core-cfg.pngجزئیات منبع
منبع: SignalFileTrader-PRO-for-MetaTrader/docs/screenshots/pm-lc-cfg.pngجزئیات منبع
منبع: SignalFileTrader-PRO-for-MetaTrader/docs/screenshots/pm-add-cfg.pngجزئیات منبع
منبع: SignalFileTrader-PRO-for-MetaTrader/docs/screenshots/pm-reduce-panel.pngجزئیات منبع
منبع: SignalFileTrader-PRO-for-MetaTrader/docs/screenshots/journal-add-commands.pngجزئیات منبع
منبع: SignalFileTrader-PRO-for-MetaTrader/docs/screenshots/journal-reduce-commands.pngجزئیات منبع
منبع: SignalFileTrader-PRO-for-MetaTrader/docs/screenshots/risk-micro-panel.pngجزئیات منبع
منبع: SignalFileTrader-PRO-for-MetaTrader/images/public-demo.pngشواهد قبلی پورتفولیو