نسخه استراتژی Price Action چندتایم‌فریمی — Paper Trading

منطق ورود:
- فقط کندل بسته‌شده؛ Grid هرگز به‌تنهایی سیگنال ورود نیست.
- جهت در 4H با ساختار HH/HL، LH/LL، BOS و CHoCH ارزیابی می‌شود.
- الگوهای Bullish Engulfing، Pin Bar صعودی، Hammer و Morning Star در 1H بررسی می‌شوند.
- 15M فیلتر مومنتوم است.
- حمایت/مقاومت 30 روزه، Order Block ساده و FVG سه‌کندلی محاسبه می‌شوند.
- RSI(14)، ATR(14)، حجم کندل در برابر میانگین 10 دوره و RR در 8 معیار ورود نقش دارند.
- شروط حیاتی: ساختار مناسب، محل معتبر، الگوی ورود، Stop معتبر و RR حداقل 1:1.5؛ حداقل 6 معیار از 8 لازم است.

مدیریت ریسک:
- ریسک هر معامله حداکثر 0.5٪ سرمایه و حجم بر اساس فاصله ورود تا Stop محاسبه می‌شود.
- حداکثر 10 پوزیشن هم‌زمان و 80٪ سرمایه درگیر.
- Drawdown از 8٪: ریسک معامله جدید نصف؛ از 12٪: ورود جدید متوقف.
- در 1.5R حد ضرر به نقطه ورود منتقل و Trailing با فاصله 1.2×ATR فعال می‌شود.
- در 2.5R نیمی از حجم بسته می‌شود؛ نیمه دوم با Trailing مدیریت می‌شود.
- خروج با Stop/Trailing یا CHoCH نزولی یا تأیید نزولی در مقاومت/Order Block/FVG.
- Grid شامل 25 سطح در دامنه 30 روزه است و فقط برای محدودکردن اندازه موقعیت/تقسیم سرمایه استفاده می‌شود؛ اگر دامنه کمتر از 4٪ باشد Grid غیرفعال می‌شود.

داده، پایداری و گزارش:
- Cron پیشنهادی هر 15 دقیقه است؛ اسکن فقط کندل‌های بسته‌شده را استفاده می‌کند.
- فاصله درخواست‌های API حداقل 12 ثانیه، حداکثر سه تلاش و مکث حداقل 30 ثانیه پیش از retry.
- چارت کندلی با خطوط Entry/Stop/Target/Support/Resistance و پنل جداگانه RSI؛ گزارش روزانه، Win Rate، Profit Factor، Max Drawdown، RR تحقق‌یافته، میانگین زمان نگهداری و لاگ API اضافه شده است.
- ستون‌های entry_atr و initial_risk هنگام اولین اجرای PaperBroker در دیتابیس موجود اضافه می‌شوند؛ برای نصب تازه در schema.sql نیز تعریف شده‌اند.

نصب:
1) از پوشه فعلی و دیتابیس بکاپ بگیرید.
2) ZIP را استخراج و فایل‌های مسیر trade/traderbot را روی نسخه قبلی کپی کنید. config.php خود را حفظ کنید.
3) Cron را مطابق traderbot/cron/README.txt هر 15 دقیقه تنظیم کنید.
4) ابتدا Paper Bot را خاموش نگه دارید، سایت را باز کنید و یک اسکن دستی/اجرای Cron را بررسی کنید. پس از تأیید لاگ‌ها، Paper Bot را فعال کنید.

امنیت و محدودیت:
- این نسخه فقط Paper Trading است و هیچ سفارش واقعی ارسال نمی‌کند. کلید خصوصی API استفاده نمی‌شود و فیلدهای کلید در config خالی می‌مانند. قابلیت معامله واقعی و همگام‌سازی سفارش‌های واقعی در این پروژه پیاده‌سازی نشده است؛ برای افزودن آن باید جداگانه با نگهداری رمزنگاری‌شده سمت سرور، همگام‌سازی سفارش‌ها/پوزیشن‌ها و تأیید روشن کاربر پیاده‌سازی و ممیزی شود.
- بک‌تست از موتور جدید استفاده می‌کند، اما نتایج گذشته تضمین‌کننده سود آینده نیست. کارمزد، لغزش قیمت، محدودیت API و ترتیب حرکت قیمت داخل یک کندل می‌توانند تفاوت ایجاد کنند.
