| # Personal Trading System V1 |
|
|
| A personal futures trading system with quantitative strategy support, built with Python (FastAPI) backend and Vue 3 frontend. |
|
|
| ## Features |
|
|
| - **Market Data Simulation**: 12 futures contracts with realistic price movements |
| - **Order Management**: Market / Limit / Stop orders |
| - **Position Tracking**: Real-time P&L and margin calculation |
| - **Quantitative Strategies**: MA Crossover, Bollinger Bands, Dual Thrust |
| - **Risk Management**: Position limits, risk usage monitoring |
| - **Real-time Updates**: WebSocket streaming for live market data |
| - **Dark Theme UI**: Modern dashboard with ECharts candlestick charts |
|
|
| ## Quick Start |
|
|
| ### Backend |
|
|
| ```bash |
| cd backend |
| pip install -r requirements.txt |
| uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload |
| ``` |
|
|
| ### Frontend |
|
|
| ```bash |
| cd frontend |
| npm install |
| npm run dev |
| ``` |
|
|
| Open http://localhost:5173 in your browser. |
|
|
| ## Unified Platform (with ML-Alpha-Research-System) |
|
|
| This folder is integrated into the parent repo as the **web visualization + online launcher** layer. |
|
|
| ### One-command launch (from repo root) |
|
|
| ```bash |
| python scripts/launch_platform.py --enable-research |
| # or start all embedded modules after backend is up: |
| python scripts/launch_platform.py --start-all-modules |
| ``` |
|
|
| ### Service control panel |
|
|
| - **Web UI**: http://localhost:5173/services — start/stop modules by feature |
| - **API**: `GET/POST /api/platform/services/*` |
|
|
| | Module ID | Description | |
| |-----------|-------------| |
| | `trading_api` | FastAPI backend (always running with uvicorn) | |
| | `market_data` | Simulated futures WebSocket + K-lines | |
| | `futures_strategies` | MA / Bollinger / DualThrust engine | |
| | `qlib_research` | Factor registry, operator builder, A-share strategies | |
| | `frontend_ui` | Vue dev server (optional subprocess launch) | |
|
|
| ### Factor research bridge |
|
|
| After starting `qlib_research`, use: |
|
|
| - **Web UI**: http://localhost:5173/research |
| - **API**: `/api/research/factors`, `/operators`, `/strategies` |
|
|
|
|
| ```bash |
| cd backend |
| python3 -m pytest tests/ -v # 17 tests |
| ruff check app/ tests/ # linter |
| ``` |
|
|
| ## Tech Stack |
|
|
| - **Backend**: Python 3.12, FastAPI, SQLAlchemy, NumPy, Pandas |
| - **Frontend**: Vue 3, Element Plus, ECharts, Pinia, Vue Router |
| - **Database**: SQLite (async) |
|
|
