عن المشروع

منصة AI Multi-Agent Cryptocurrency Futures هي نظام لأبحاث وتنفيذ عقود العملات الرقمية الآجلة موجه للإنتاج، مخصص لـ Binance USD-M Futures و OKX perpetual swaps. تم هيكلتها كـ pnpm workspace تضم تطبيق ويب Next.js وواجهة برمجة تطبيقات Node.js API، مدعومة بـ PostgreSQL عبر Prisma، و Redis و BullMQ، ويتم شحنها مع إعداد Docker Compose. المبدأ الأساسي المعلن هو أن الذكاء الاصطناعي استشاري فقط: لا يمكن للوكلاء استدعاء محول البورصة مباشرة، ويجب أن تمر الطلبات المؤتمتة عبر مسار Decision/Judge ومحرك مخاطر (Risk Engine) حتمي قبل أن يتمكن محرك التداول (Trading Engine) من تنفيذها. الأمان والحسابات: مصادقة متعددة المستخدمين، جلسات مدعومة بـ Redis، حماية CSRF، مصادقة ثنائية TOTP، سجلات تدقيق، تشفير كلمات المرور بـ Argon2id، وتشفير بيانات اعتماد المزود بـ AES-256-GCM. يتم تكوين إعادة تعيين كلمة المرور عبر وسيلة نقل بريد إلكتروني واحدة (SMTP أو رابط webhook مع سر)، وتنتهي صلاحية روابط إعادة التعيين بعد 15 دقيقة، وهي صالحة للاستخدام مرة واحدة، ولا يتم تخزينها أو تسجيلها بنص صريح، ويؤدي تغيير كلمة المرور بنجاح إلى إلغاء كل جلسة قائمة للحساب. تكاملات البورصات: تغطي محولات Binance Futures و OKX بيانات السوق العامة، حالة الحساب الخاصة، المراكز، الطلبات المفتوحة، سجل الطلبات، وضع الطلبات، الإلغاء، وتعديل الطلبات الوقائية حيثما تدعمه البورصة. بيانات السوق والبيانات الخارجية: تدفقات سوق في الوقت الفعلي، شموع موحدة، مؤشرات، كشف الفجوات، ملء البيانات السابقة، لقطات Redis ومساحة اسم Socket.IO عند /market. وتتعامل طبقة استيعاب منفصلة مع الأخبار، إعلانات البورصة، الحوادث، تحليل المشاعر، Reddit والتقويم الماكرو، مع طوابير استيعاب، وإزالة التكرار، وتسجيل الأهمية، وتُنشر من خلال أحداث /external-data في الوقت الفعلي. البنية التحتية للذكاء الاصطناعي: طبقة ذكاء اصطناعي مستقلة عن المزود مع استدعاء أدوات محدود، إدارة دورة حياة الوكيل، وكيل قرار (Decision Agent)، ضوابط حكم (Judge)، جدولة مسار BullMQ، وإعادة التشغيل، والإلغاء، وتقارير الحالة والمقاييس. المخاطر والمحفظة والأبحاث: تقييم مخاطر حتمي، ضوابط تعرض المحفظة، تخصيص الاستراتيجية وإعادة التوازن، حلقات الأداء والتأمل، التعلم الذاتي عبر shadow/canary، الاختبار العكسي (backtesting)، التحقق، القياس المرجعي، المحاكاة، اكتشاف العوامل والتوصيات الكمية. التنفيذ: تداول DEMO/LIVE مدعوم من البورصة مع مفتاح إيقاف (kill switch)، معرفات طلبات عملاء غير متكررة (idempotent)، مزامنة الحالة، حماية TP/SL ومدير مراكز (Position Manager)، تظهر من خلال مساحة اسم لوحة تحكم /live-trading في الوقت الفعلي. إدارة المراكز و TP/SL التكيفية: بدلاً من اشتقاق مستويات جني الأرباح ووقف الخسارة دائماً من نسب البيئة، يستخدم محرك خطة التداول (Trade Plan Engine) الحتمي ATR، الدعم/المقاومة، EMA20/EMA50، ADX، نسبة الكفاءة، حالة الاختراق، هيكل السوق، الرسوم ومتطلبات المخاطرة/المكافأة المكونة لتصنيف الظروف كـ TREND_UP أو TREND_DOWN أو RANGING أو BREAKOUT أو HIGH_VOLATILITY، وينتج نوع الخطة المطابق: تراجع الاتجاه، دخول وحدود النطاق والهدف، الاختراق/إعادة الاختبار، أو التحكم في التقلبات. يرفض المحرك مواقع الدخول السيئة، ووقف الخسارة المفرط هيكلياً، والأهداف التي تكون مكافأتها الصافية مقابل المخاطرة أقل من السياسة؛ تظل إعدادات مثل STOP_LOSS_PCT و RISK_REWARD_RATIO كقيم افتراضية للسياسة وملاذاً عند عدم توفر بيانات ATR والهيكل. بعد الدخول، يقوم مدير المراكز بمزامنة حالة البورصة ويمكنه نقل وقف الخسارة إلى نقطة التعادل زائد هامش الرسوم، أو التتبع بواسطة ATR بعد حركة مواتية كافية، أو جني ربح جزئي عند 1R، وإبقاء المراكز الراكدة مفتوحة حتى يحدث إغلاق وقائي صريح أو يدوي أو من البورصة أو مصرح به من الاستراتيجية، وتعديل أو إلغاء/إعادة إنشاء الطلبات الوقائية عبر المحول، وتنظيف الحماية اليتيمة بعد إغلاق المركز. القيمة الافتراضية لـ LIVE_POSITION_SYNC_INTERVAL_MS هي 30 ثانية؛ يتم تحديد استيراد سجل طلبات البورصة ولوحة تحكم Live Trading بآخر 20 طلباً، بينما لا يتم اختصار المراكز وفحوصات السلامة/الحماية. بوابات السلامة: الوضع TRADING_MODE=DEMO هو الافتراضي الآمن. قبل التنفيذ، يتحقق النظام من GLOBAL_TRADING_ENABLED و LIVE_TRADING_ENABLED، وحالة الاتصال الموثقة، وإذن الاتصال بالإنتاج، والمصادقة الحديثة، و TTL موافقة المخاطر، وحدود التعرض، وحدود الرافعة المالية، وفترة التهدئة وحالة مفتاح الإيقاف. يتطلب وضع LIVE أن يكون LIVE_TRADING_ENABLED=true، وتظل اتصالات البورصة الإنتاجية معطلة ما لم يتم تفعيلها صراحة. ينصح ملف README باستخدام بيانات اعتماد demo/testnet مخصصة أثناء التحقق من السلوك وعدم استخدام مفاتيح API قادرة على السحب. الإعداد والعمليات: المتطلبات هي Node.js 22.13 أو أحدث (مطلوب لـ pnpm 11)، و pnpm 11 أو أحدث، و Docker Desktop مع Docker Compose. يتضمن الإعداد المحلي نسخ .env.example إلى الجذر ومواقع apps/api و apps/web، وتثبيت التبعيات، وتشغيل Postgres و Redis و Adminer عبر Compose، وتوليد عميل Prisma، وتطبيق التهجيرات وتشغيل خوادم التطوير؛ يمكن أيضاً تشغيل المكدس الكامل باستخدام docker compose up -d --build. الخدمات الموثقة تشمل تطبيق الويب على المنفذ 3000، و API على 3001 مع /api و /docs و /api/health، و Adminer على 8080. تغطي السكربتات التطوير، البناء، lint، فحص أنواع TypeScript الصارم، مجموعات Vitest للوحدات، اختبارات تكامل API، الاختبارات الشاملة (e2e)، فحوصات التنسيق، و Prisma generate و migrate و studio. يتم الإشارة إلى وثائق إضافية في ARCHITECTURE.md و API_CONTRACT.md و DATABASE.md و DIRECTORY_STRUCTURE.md و ROADMAP.md و PROJECT_CONTEXT.md و DEFINITION_OF_DONE.md و PROJECT_RULES.md. الحدود المعروفة للمشروع: توجد سجلات ورقية/ظلية (Paper/shadow) تدعم التقييم والتعلم الذاتي، ولكن لا توجد واجهة برمجة تطبيقات تنفيذ تداول ورقي مستقلة قابلة للمقارنة بـ Live Trading. لا تضمن الاختبارات العكسية وتشغيلات demo وثقة النموذج الربحية في الإنتاج، ويتطلب الانتقال للإنتاج عينات كافية ومراجعة للتراجع (drawdown). تحديثات الكود لا تؤثر على الحاويات التي تعمل حتى يتم إعادة بناء أو إعادة تشغيل خدمات API والويب.