প্রকল্প সম্পর্কে

AI Multi-Agent Cryptocurrency Futures Platform হলো Binance USD-M Futures এবং OKX perpetual swaps-এর জন্য একটি প্রোডাকশন-ওরিয়েন্টেড ক্রিপ্টোকারেন্সি ফিউচারস রিসার্চ এবং এক্সিকিউশন সিস্টেম। এটি একটি pnpm workspace হিসেবে গঠিত, যার মধ্যে রয়েছে একটি Next.js ওয়েব অ্যাপ্লিকেশন এবং একটি Node.js API, যা Prisma-র মাধ্যমে PostgreSQL, Redis এবং BullMQ দ্বারা সমর্থিত এবং Docker Compose সেটআপের সাথে সরবরাহ করা হয়েছে। এর মূল নীতি হলো AI শুধুমাত্র পরামর্শদাতা হিসেবে কাজ করবে: এজেন্টরা সরাসরি এক্সচেঞ্জ অ্যাডাপ্টার কল করতে পারে না এবং স্বয়ংক্রিয় অর্ডারগুলোকে Trading Engine-এ কার্যকর হওয়ার আগে অবশ্যই Decision/Judge পাইপলাইন এবং একটি ডিটারমিনিস্টিক Risk Engine-এর মধ্য দিয়ে যেতে হবে। নিরাপত্তা এবং অ্যাকাউন্ট: মাল্টি-ইউজার অথেন্টিকেশন, Redis-ব্যাকড সেশন, CSRF সুরক্ষা, TOTP টু-ফ্যাক্টর অথেন্টিকেশন, অডিট লগ, Argon2id পাসওয়ার্ড হ্যাশিং এবং AES-256-GCM এনক্রিপ্টেড প্রোভাইডার ক্রেডেনশিয়াল। পাসওয়ার্ড রিসেট একটি ইমেল ট্রান্সপোর্টের (SMTP, অথবা একটি ওয়েবহুক URL এবং সিক্রেট) মাধ্যমে কনফিগার করা হয়েছে; রিসেট লিঙ্কগুলো ১৫ মিনিট পর মেয়াদোত্তীর্ণ হয়, একবার ব্যবহারযোগ্য, এবং কখনোই প্লেইনটেক্সটে সংরক্ষিত বা লগ করা হয় না। সফল পাসওয়ার্ড পরিবর্তনের পর ওই অ্যাকাউন্টের সমস্ত বিদ্যমান সেশন বাতিল হয়ে যায়। এক্সচেঞ্জ ইন্টিগ্রেশন: Binance Futures এবং OKX অ্যাডাপ্টারগুলো পাবলিক মার্কেট ডেটা, প্রাইভেট অ্যাকাউন্ট স্টেট, পজিশন, ওপেন অর্ডার, অর্ডারের ইতিহাস, অর্ডার প্লেসমেন্ট, বাতিলকরণ এবং এক্সচেঞ্জ সমর্থন করলে প্রোটেক্টিভ-অর্ডার সংশোধন কভার করে। মার্কেট এবং এক্সটারনাল ডেটা: রিয়েলটাইম মার্কেট স্ট্রিম, নরমালাইজড ক্যান্ডেল, ইন্ডিকেটর, গ্যাপ ডিটেকশন, ব্যাকফিল, Redis স্ন্যাপশট এবং /market-এ একটি Socket.IO নেমস্পেস। একটি পৃথক ইনজেশন লেয়ার নিউজ, এক্সচেঞ্জ ঘোষণা, ইনসিডেন্ট, সেন্টিমেন্ট, Reddit এবং একটি ম্যাক্রো ক্যালেন্ডার পরিচালনা করে, যেখানে ইনজেশন কিউ, ডিডুপ্লিকেশন এবং ইমপোর্টেন্স স্কোরিং রয়েছে, যা /external-data রিয়েলটাইম ইভেন্টের মাধ্যমে প্রকাশিত হয়। AI ইনফ্রাস্ট্রাকচার: বাউন্ডেড টুল কলিং, এজেন্ট লাইফসাইকেল ম্যানেজমেন্ট, একটি Decision Agent, Judge কন্ট্রোল, BullMQ পাইপলাইন শিডিউলিং, রিপ্লে, বাতিলকরণ, হেলথ রিপোর্টিং এবং মেট্রিক্স সহ একটি প্রোভাইডার-ইনডিপেন্ডেন্ট AI লেয়ার। রিস্ক, পোর্টফোলিও এবং রিসার্চ: ডিটারমিনিস্টিক রিস্ক অ্যাসেসমেন্ট, পোর্টফোলিও এক্সপোজার কন্ট্রোল, স্ট্র্যাটেজি অ্যালোকেশন এবং রিব্যালেন্সিং, পারফরম্যান্স এবং রিফ্লেকশন লুপ, শ্যাডো/ক্যানারি সেলফ-লার্নিং, ব্যাকটেস্টিং, ভ্যালিডেশন, বেঞ্চমার্কিং, সিমুলেশন, ফ্যাক্টর ডিসকভারি এবং কোয়ান্টিটেটিভ রিকমেন্ডেশন। এক্সিকিউশন: কিল সুইচ সহ এক্সচেঞ্জ-ব্যাকড DEMO/LIVE ট্রেডিং, আইডেমপোটেন্ট ক্লায়েন্ট অর্ডার আইডি, স্টেট সিনক্রোনাইজেশন, TP/SL সুরক্ষা এবং একটি Position Manager, যা /live-trading রিয়েলটাইম ড্যাশবোর্ড নেমস্পেসের মাধ্যমে প্রদর্শিত হয়। অ্যাডাপ্টিভ TP/SL এবং Position Manager: পরিবেশের শতাংশ থেকে সর্বদা টেক-প্রফিট এবং স্টপ-লস লেভেল নির্ধারণ করার পরিবর্তে, ডিটারমিনিস্টিক Trade Plan Engine ATR, সাপোর্ট/রেজিস্ট্যান্স, EMA20/EMA50, ADX, এফিসিয়েন্সি রেশিও, ব্রেকআউট স্টেট, মার্কেট স্ট্রাকচার, ফি এবং কনফিগার করা রিস্ক/রিওয়ার্ড রিকয়ারমেন্ট ব্যবহার করে কন্ডিশনগুলোকে TREND_UP, TREND_DOWN, RANGING, BREAKOUT বা HIGH_VOLATILITY হিসেবে ক্লাসিফাই করে এবং সেই অনুযায়ী প্ল্যান টাইপ তৈরি করে: ট্রেন্ড পুলব্যাক, রেঞ্জ-বাউন্ডারি এন্ট্রি এবং টার্গেট, ব্রেকআউট/রিটেস্ট, অথবা ভolatility-কন্ট্রোলড। ইঞ্জিনটি দুর্বল এন্ট্রি লোকেশন, স্ট্রাকচারালি অতিরিক্ত স্টপ এবং এমন টার্গেট প্রত্যাখ্যান করে যার নেট রিওয়ার্ড/রিস্ক পলিসির নিচে। STOP_LOSS_PCT এবং RISK_REWARD_RATIO-এর মতো সেটিংসগুলো পলিসি ডিফল্ট হিসেবে থাকে এবং ATR ও স্ট্রাকচার ডেটা অনুপলব্ধ থাকলে ফলব্যাক হিসেবে ব্যবহৃত হয়। এন্ট্রির পর, Position Manager এক্সচেঞ্জ স্টেট সিনক্রোনাইজ করে এবং স্টপকে ব্রেক-ইভেন প্লাস ফি বাফারে মুভ করতে পারে, পর্যাপ্ত অনুকূল মুভমেন্টের পর ATR দ্বারা ট্রেল করতে পারে, 1R-এ আংশিক প্রফিট নিতে পারে এবং নির্দিষ্ট প্রোটেক্টিভ, ম্যানুয়াল, এক্সচেঞ্জ বা স্ট্র্যাটেজি-অনুমোদিত ক্লোজ না হওয়া পর্যন্ত পজিশন খোলা রাখতে পারে। LIVE_POSITION_SYNC_INTERVAL_MS ডিফল্টভাবে ৩০ সেকেন্ড; এক্সচেঞ্জ অর্ডার-হিস্ট্রি ইমপোর্ট এবং লাইভ ট্রেডিং ড্যাশবোর্ড সাম্প্রতিক ২০টি অর্ডারে সীমাবদ্ধ, তবে পজিশন এবং সেফটি/প্রোটেকশন চেক ট্রাঙ্কেট করা হয় না। সেফটি গেটস: TRADING_MODE=DEMO হলো নিরাপদ ডিফল্ট। এক্সিকিউশনের আগে সিস্টেমটি GLOBAL_TRADING_ENABLED, LIVE_TRADING_ENABLED, ভেরিফাইড কানেকশন স্টেট, প্রোডাকশন কানেকশন পারমিশন, সাম্প্রতিক অথেন্টিকেশন, রিস্ক অ্যাপ্রুভাল TTL, এক্সপোজার লিমিট, লেভারেজ লিমিট, কুলডাউন এবং কিল-সুইচ স্টেট চেক করে। LIVE মোডের জন্য LIVE_TRADING_ENABLED=true প্রয়োজন এবং প্রোডাকশন এক্সচেঞ্জ কানেকশনগুলো স্পষ্টভাবে এনাবল না করা পর্যন্ত ডিজেবল থাকে। README-তে আচরণ যাচাই করার সময় ডেডিকেটেড ডেমো/টেস্টনেট ক্রেডেনশিয়াল ব্যবহার করার এবং উইথড্রয়াল-ক্ষমতা সম্পন্ন API কী ব্যবহার না করার পরামর্শ দেওয়া হয়েছে। সেটআপ এবং অপারেশনস: প্রয়োজনীয়তা হলো Node.js 22.13 বা তার নতুন সংস্করণ (pnpm 11-এর জন্য প্রয়োজনীয়), pnpm 11 বা তার নতুন সংস্করণ এবং Docker Compose সহ Docker Desktop। লোকাল সেটআপে .env.example ফাইলটি রুট, apps/api এবং apps/web লোকেশনে কপি করা হয়, ডিপেন্ডেন্সি ইনস্টল করা হয়, Compose-এর মাধ্যমে Postgres, Redis এবং Adminer চালু করা হয়, Prisma ক্লায়েন্ট জেনারেট করা হয়, মাইগ্রেশন প্রয়োগ করা হয় এবং ডেভ সার্ভার চালানো হয়; সম্পূর্ণ স্ট্যাকটি docker compose up -d --build দিয়েও চালু করা যেতে পারে। ডকুমেন্ট করা সার্ভিসগুলোর মধ্যে রয়েছে পোর্ট ৩০০০-এ ওয়েব অ্যাপ, পোর্ট ৩০MDE১-এ /api, /docs এবং /api/health সহ API, এবং ৮০৮০-তে Adminer। স্ক্রিপ্টগুলোর মধ্যে রয়েছে dev, build, lint, স্ট্রিক্ট TypeScript টাইপচেকিং, Vitest ইউনিট স্যুট, API ইন্টিগ্রেশন টেস্ট, এন্ড-টু-এন্ড টেস্ট, ফরম্যাটিং চেক এবং 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-এ রেফারেন্স করা হয়েছে। প্রজেক্টের জানা সীমাবদ্ধতা: পেপার/শ্যাডো রেকর্ড বিদ্যমান এবং মূল্যায়ন ও সেলফ-লার্নিং সমর্থন করে, তবে লাইভ ট্রেডিংয়ের মতো কোনো স্বতন্ত্র পেপার-ট্রেডিং এক্সিকিউশন API নেই। ব্যাকটেস্ট, ডেমো রান এবং মডেল কনফিডেন্স প্রোডাকশন প্রফিটেবিলিটির গ্যারান্টি দেয় না এবং প্রমোশনের জন্য পর্যাপ্ত স্যাম্পল এবং ড্রডাউন রিভিউ প্রয়োজন। কোড আপডেটগুলো API এবং ওয়েব সার্ভিসগুলো রিবিল্ড বা রিস্টার্ট না করা পর্যন্ত রানিং কন্টেইনারগুলোকে প্রভাবিত করে না।