معمار ربات معاملاتی

نقش تو: مهندس ارشد سیستم‌های معاملاتی خودکار با تمرکز بر قابلیت اطمینان.

وظیفه: معماری یک ربات معاملاتی برای استراتژی زیر طراحی کن.

استراتژی: {{STRATEGY}}
بازار و صرافی: {{EXCHANGE}}
فرکانس معامله: {{FREQUENCY}}
سرمایه: {{CAPITAL}}
زبان و زیرساخت مورد نظر: {{STACK}}

ساختار خروجی:

■ ۱. معماری کلی
اجزای اصلی و مسئولیت هر کدام:
- دریافت داده
- محاسبه سیگنال
- مدیریت ریسک و اندازه پوزیشن
- اجرای سفارش
- پایش وضعیت و آشتی‌سازی (reconciliation)
- لاگ‌گیری و هشدار
- ذخیره وضعیت
نمودار متنی جریان داده بین اجزا.

■ ۲. محافظ‌های ایمنی — مهم‌ترین بخش
هر محافظ را با منطق پیاده‌سازی توضیح بده:
- سقف دراودان روزانه: ربات پس از رسیدن به آن، معامله را متوقف می‌کند
- حداکثر تعداد معامله در بازه زمانی
- سقف اندازه پوزیشن و سقف ارزش کل پوزیشن‌ها
- بررسی معقول بودن قیمت دریافتی (رد قیمت‌های پرت)
- سقف اسپرد مجاز برای اجرا
- توقف در صورت خطای مکرر API
- کلید توقف اضطراری دستی
- محدودیت نرخ فراخوانی API

■ ۳. مدیریت خطا
برای هر سناریو، رفتار مشخص تعریف کن:
| سناریو | رفتار ربات |
- قطع اتصال شبکه
- عدم پاسخ صرافی
- سفارش رد شده
- سفارش پر شده به‌صورت جزئی
- دریافت داده ناقص یا تکراری
- خطای احراز هویت
- راه‌اندازی مجدد ربات با پوزیشن باز

■ ۴. آشتی‌سازی وضعیت
حیاتی‌ترین بخش: ربات پس از هر راه‌اندازی و به‌صورت دوره‌ای باید وضعیت داخلی خود را با وضعیت واقعی صرافی تطبیق دهد. اگر اختلافی وجود دارد، منبع حقیقت صرافی است.
منطق این تطبیق را شرح بده.

■ ۵. ذخیره وضعیت
چه چیزی باید ذخیره شود تا پس از راه‌اندازی مجدد، ربات بداند در چه وضعیتی بوده؟ ساختار داده پیشنهادی.

■ ۶. لاگ‌گیری
چه چیزهایی باید لاگ شوند، در چه سطحی، و چطور قابل جست‌وجو باشند. هر تصمیم ربات باید بعداً قابل بازسازی باشد.

■ ۷. پایش و هشدار
چه معیارهایی باید پایش شوند و در چه شرایطی به من هشدار داده شود؟

■ ۸. امنیت
- مدیریت کلیدهای API و دسترسی‌های محدود (غیرفعال کردن دسترسی برداشت)
- محدودیت IP
- جداسازی محیط تست و واقعی
- عدم ذخیره کلید در کد

■ ۹. مسیر استقرار
مراحل از توسعه تا اجرای واقعی:
۱. تست واحد اجزا
۲. بک‌تست
۳. اجرا روی داده زنده بدون ارسال سفارش (paper trading)
۴. اجرا با حجم بسیار کوچک
۵. افزایش تدریجی حجم
برای هر مرحله، معیار عبور تعریف کن.

■ ۱۰. ساختار پوشه و فایل پیشنهادی

هشدار اجباری: هیچ رباتی نباید بدون گذراندن کامل مسیر استقرار، با سرمایه واقعی اجرا شود.