README.md

Trading-M3 — Sovereign STI Engine v2.1

منصة التنبؤ بالأسواق باستخدام Sovereign Time Inversion (STI) — محرك تنبؤ مبتكر يقرأ "مالك الوقت" قبل أن يولّد أي إشارة.

المميزات الجديدة في v2.1

• 🧠 Grok Layer — تفسير ذكي بالعربية عبر xAI
• 🔔 Alert Engine — تنبيهات ذكية + Telegram
• 🔗 On-Chain Layer — Fear & Greed + Mempool + Netflow
• 📊 Liquidation Heatmap — مستويات التصفية الحرارية
• 📈 Backtesting — اختبار رجعي كامل
• ⚡ WebSocket Live — بيانات حية من Binance

الأسواق المدعومة

• 🪙 العملات الرقمية (Binance)
• 📈 الأسهم (Yahoo Finance)
• 💱 الفوركس (Yahoo Finance)
• 🥇 المعادن (Yahoo Finance)

البنية التقنية

• Backend: Python (FastAPI) + WebSocket
• Frontend: React + Vite + Tailwind + Lightweight Charts
• AI: xAI Grok Beta
• Deployment: Vercel (Frontend) + Railway (Backend)

التشغيل المحلي

Backend

cd backend
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Frontend

cd frontend
npm install
npm run dev

النشر

• Backend: Railway
• Frontend: Vercel

انظر docs/DEPLOY.md للتفاصيل.