mirror of
https://github.com/NoFxAiOS/nofx.git
synced 2026-07-05 20:11:13 +08:00
94ef009bb5
Remove the entire AI Debate Arena module (~5,300 lines) to simplify the codebase. This removes the multi-AI debate trading decision system including backend engine, API handlers, database store, frontend page, navigation, translations, and documentation references.
152 lines
6.7 KiB
Markdown
152 lines
6.7 KiB
Markdown
# NOFX Architecture Documentation
|
|
|
|
**Language:** [English](README.md) | [中文](README.zh-CN.md)
|
|
|
|
Technical documentation for developers who want to understand NOFX internals.
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
NOFX is a full-stack AI trading platform for cryptocurrency and US stock markets:
|
|
|
|
- **Backend:** Go (Gin framework, SQLite)
|
|
- **Frontend:** React/TypeScript (Vite, TailwindCSS)
|
|
- **AI Models:** DeepSeek, Qwen, OpenAI (GPT-5.2), Claude, Gemini, Grok, Kimi
|
|
- **Exchanges:** Binance, Bybit, OKX, Hyperliquid, Aster, Lighter
|
|
|
|
---
|
|
|
|
## System Architecture
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ NOFX Platform │
|
|
├─────────────────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────┐│
|
|
│ │ Strategy │ │ Backtest │ │ Live Trading ││
|
|
│ │ Studio │ │ Engine │ │ (Auto Trader) ││
|
|
│ └──────┬──────┘ └──────┬──────┘ └──────────┬──────────┘│
|
|
│ │ │ │ │
|
|
│ └────────────────┴────────────────────┘ │
|
|
│ │ │
|
|
│ ┌─────────▼─────────┐ │
|
|
│ │ Core Services │ │
|
|
│ │ - Market Data │ │
|
|
│ │ - AI Providers │ │
|
|
│ │ - Risk Control │ │
|
|
│ └─────────┬─────────┘ │
|
|
│ │ │
|
|
│ ┌──────────────────────────┼──────────────────────────┐ │
|
|
│ │ │ │ │
|
|
│ ┌──────▼──────┐ ┌─────────▼─────────┐ ┌────────▼────────┐ │
|
|
│ │ Exchanges │ │ Database │ │ Frontend UI │ │
|
|
│ │ (CEX/DEX) │ │ (SQLite) │ │ (React SPA) │ │
|
|
│ └─────────────┘ └───────────────────┘ └─────────────────┘ │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## Module Documentation
|
|
|
|
### Core Modules
|
|
|
|
| Module | Description | Documentation |
|
|
|--------|-------------|---------------|
|
|
| **Strategy Studio** | Strategy configuration, coin selection, data assembly, AI prompts | [STRATEGY_MODULE.md](STRATEGY_MODULE.md) |
|
|
| **Backtest Engine** | Historical simulation, performance metrics, AI decision replay | [BACKTEST_MODULE.md](BACKTEST_MODULE.md) |
|
|
|
|
### Module Overview
|
|
|
|
#### Strategy Module
|
|
Complete strategy configuration system including:
|
|
- Coin source selection (static list, AI500 pool, OI ranking)
|
|
- Market data indicators (K-lines, EMA, MACD, RSI, ATR)
|
|
- Prompt construction (system prompt, user prompt, sections)
|
|
- AI response parsing and decision execution
|
|
- Risk control enforcement
|
|
|
|
**[Read Full Documentation →](STRATEGY_MODULE.md)**
|
|
|
|
#### Backtest Module
|
|
Historical trading simulation engine:
|
|
- Multi-symbol, multi-timeframe backtesting
|
|
- AI decision replay with caching
|
|
- Performance metrics (Sharpe, drawdown, win rate)
|
|
- Real-time progress streaming via SSE
|
|
- Checkpoint and resume support
|
|
|
|
**[Read Full Documentation →](BACKTEST_MODULE.md)**
|
|
|
|
---
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
nofx/
|
|
├── main.go # Entry point
|
|
├── api/ # HTTP API (Gin framework)
|
|
├── trader/ # Trading execution layer
|
|
├── strategy/ # Strategy engine
|
|
├── backtest/ # Backtest simulation engine
|
|
├── market/ # Market data service
|
|
├── mcp/ # AI model clients
|
|
├── store/ # Database operations
|
|
├── auth/ # JWT authentication
|
|
├── manager/ # Multi-trader management
|
|
└── web/ # React frontend
|
|
├── src/pages/ # Page components
|
|
├── src/components/ # Shared components
|
|
└── src/lib/api.ts # API client
|
|
```
|
|
|
|
---
|
|
|
|
## Core Dependencies
|
|
|
|
### Backend (Go)
|
|
|
|
| Package | Purpose |
|
|
|---------|---------|
|
|
| `gin-gonic/gin` | HTTP API framework |
|
|
| `adshao/go-binance` | Binance API client |
|
|
| `markcheno/go-talib` | Technical indicators |
|
|
| `golang-jwt/jwt` | JWT authentication |
|
|
|
|
### Frontend (React)
|
|
|
|
| Package | Purpose |
|
|
|---------|---------|
|
|
| `react` | UI framework |
|
|
| `recharts` | Charts and visualizations |
|
|
| `swr` | Data fetching |
|
|
| `zustand` | State management |
|
|
| `tailwindcss` | CSS framework |
|
|
|
|
---
|
|
|
|
## Quick Links
|
|
|
|
- [Strategy Module](STRATEGY_MODULE.md) - How strategies work
|
|
- [Backtest Module](BACKTEST_MODULE.md) - How backtesting works
|
|
- [Getting Started](../getting-started/README.md) - Setup guide
|
|
- [FAQ](../faq/README.md) - Frequently asked questions
|
|
|
|
---
|
|
|
|
## For Developers
|
|
|
|
**Want to contribute?**
|
|
- Read the module documentation above
|
|
- Check [Open Issues](https://github.com/NoFxAiOS/nofx/issues)
|
|
- Join our community
|
|
|
|
**Repository:** https://github.com/NoFxAiOS/nofx
|
|
|
|
---
|
|
|
|
[← Back to Documentation](../README.md)
|