# AI-Quant Edge — Cloudflare Pages Demo

全球首个基于自然语言驱动的边缘计算量化策略平台演示版本。

## 📁 项目结构

```
├── index.html              # Chat-first 主页
├── strategies.html         # 策略列表页
├── settings.html           # 用户设置页
├── purchase.html           # VIP 购买页
├── styles.css              # 全局样式
├── scripts.js              # 前端逻辑
├── functions/              # Cloudflare Pages Functions (API)
│   └── api/
│       ├── parse-strategy.js      # 策略解析
│       ├── backtest.js            # 回测引擎
│       ├── strategies.js          # 策略 CRUD
│       ├── purchase.js            # 购买/订阅
│       ├── auth/
│       │   └── google.js          # Google OAuth
│       ├── user/
│       │   ├── settings.js        # 用户设置
│       │   └── test-notify.js     # 测试通知
│       └── webhook/
│           └── payment.js         # 支付回调
├── migrations/             # D1 数据库迁移脚本
│   ├── 001_init.sql
│   └── 002_seed.sql
├── prd.md                  # 完整产品需求文档
├── prd-*.md                # 功能拆分 PRD 文档
├── wrangler.toml           # Cloudflare Workers 配置
└── package.json            # 项目依赖
```

## 🚀 快速开始

### 方式一：Cloudflare Pages 部署（推荐）

1. **推送代码到 GitHub**
   ```bash
   git push origin main
   ```

2. **在 Cloudflare 创建 Pages 项目**
   - 登录 [Cloudflare Dashboard](https://dash.cloudflare.com)
   - Workers & Pages → Create Application → Pages → Connect to Git
   - 选择此仓库
   - 构建设置：
     - Framework preset: `None`
     - Build command: (留空)
     - Build output directory: `/`
   - 点击 Save and Deploy

3. **配置环境变量（可选）**
   - Settings → Environment variables
   - 添加生产环境变量：
     ```
     DEEPSEEK_API_KEY=sk-2c434e20890240a4a16e7d8db3827d1d
     STRIPE_SECRET_KEY=sk_...
     JWT_SECRET=your-secret
     ```

4. **配置 D1 数据库（可选）**
   ```bash
   # 创建 D1 数据库
   wrangler d1 create ai-quant-edge-db
   
   # 执行迁移
   wrangler d1 execute ai-quant-edge-db --file=migrations/001_init.sql
   wrangler d1 execute ai-quant-edge-db --file=migrations/002_seed.sql
   ```
   
   然后在 Pages 项目中绑定 D1：Settings → Functions → D1 database bindings

### 方式二：本地开发

1. **安装依赖**
   ```bash
   npm install
   ```

2. **本地运行**
   ```bash
   npm run dev
   ```
   访问 http://localhost:8788

3. **本地预览 Functions**
   ```bash
   npm run preview
   ```

### 方式三：Wrangler 命令行部署

```bash
# 安装 Wrangler
npm install -g wrangler

# 登录
wrangler login

# 部署
npm run deploy
```

## 🎯 功能特性

### 已实现（Demo 版本）
- ✅ Chat-first 自然语言策略输入
- ✅ 策略解析（基于 DeepSeek Chat API）
- ✅ 回测引擎（真实技术指标计算）
- ✅ 策略列表管理
- ✅ 用户设置页（通知配置）
- ✅ VIP 购买流程（UI）
- ✅ 完整的 API 端点结构

### 待实现（需要配置）
- ✅ DeepSeek API 集成（已完成）
- ⏳ 真实历史数据回测（R2 历史数据加载）
- ⏳ Google OAuth 认证
- ⏳ Stripe 支付集成
- ⏳ Telegram/Discord 通知
- ⏳ D1 数据持久化
- ⏳ 实时监控 Cron

## 📚 技术栈

- **前端**: 原生 HTML/CSS/JS（零依赖）
- **后端**: Cloudflare Pages Functions
- **数据库**: Cloudflare D1（SQLite）
- **存储**: Cloudflare R2（历史 K 线数据）
- **缓存**: Cloudflare KV
- **AI**: DeepSeek Chat API
- **支付**: Stripe
- **通知**: Telegram Bot / Discord Webhooks

## 🔧 开发指南

### API 端点

| 端点 | 方法 | 描述 |
|------|------|------|
| `/api/parse-strategy` | POST | 解析自然语言策略 |
| `/api/backtest` | POST | 执行回测 |
| `/api/strategies` | GET/POST | 策略列表/创建 |
| `/api/user/settings` | GET/PUT | 用户设置 |
| `/api/user/test-notify` | POST | 测试通知 |
| `/api/purchase` | POST/GET | 购买/查询订单 |
| `/api/auth/google` | POST | Google OAuth |
| `/api/webhook/payment` | POST | 支付回调 |

### 数据库迁移

```bash
# 应用迁移
wrangler d1 execute DB_NAME --file=migrations/001_init.sql

# 查询数据
wrangler d1 execute DB_NAME --command="SELECT * FROM Users"
```

### 环境变量

在 `wrangler.toml` 或 Cloudflare Dashboard 中配置：

```toml
[env.production.vars]
DEEPSEEK_API_KEY = "sk-2c434e20890240a4a16e7d8db3827d1d"
STRIPE_SECRET_KEY = "sk_..."
JWT_SECRET = "your-secret"
```

## 📖 文档

- [完整 PRD 文档](./prd.md)
- [认证设计](./prd-auth.md)
- [排行榜设计](./prd-leaderboard.md)
- [测试规范](./prd-testing.md)
- [实施细节](./prd-supplement.md)
- [文档索引](./DOCS-INDEX.md)

## 🎨 自定义

1. **修改样式**: 编辑 `styles.css`
2. **添加页面**: 创建新的 `.html` 文件
3. **添加 API**: 在 `functions/api/` 下创建新文件
4. **修改数据库**: 添加新的迁移文件到 `migrations/`

## ⚠️ 注意事项

- 当前版本为 **演示版本**，API 返回模拟数据
- 生产环境需要配置真实的 API 密钥和数据库
- 免费版 Cloudflare Pages 限制：
  - 500 次构建/月
  - 100,000 次请求/天
  - 函数执行时间 < 10ms（Workers 限制）
  - D1: 5GB 存储 + 500 万行读取/天

## 📝 许可证

MIT License

## 🤝 贡献

欢迎提交 Issue 和 Pull Request！
# AI-Quant Edge - AI驱动的量化策略平台

## 项目概述

AI-Quant Edge 是一个基于自然语言驱动的边缘计算量化策略平台，让用户无需编程即可创建、回测和监控加密货币交易策略。

### 核心特性

- 🗣️ **自然语言输入** - 用自然语言描述策略，AI自动转换为可执行代码
- ⚡ **边缘计算回测** - 基于Cloudflare Workers，毫秒级响应
- 📊 **可视化分析** - 直观的策略表现展示和AI诊断建议
- 🔔 **实时监控** - 24/7自动监控市场并发送Telegram通知

## 技术栈

- **前端**: Next.js 14 + Tailwind CSS + Framer Motion
- **后端**: Cloudflare Workers + D1 + R2 + KV
- **AI引擎**: Claude 3.5 Sonnet API
- **数据源**: Binance API
- **通知**: Telegram Bot API

## 文档

- [产品需求文档 (PRD)](./prd.md) - 核心架构和模块设计
- [实施细节补充](./prd-supplement.md) - 完整的数据库Schema、API端点和开发计划
 - [产品需求文档 (PRD)](./prd.md) - 主 PRD（总览）
 - [认证与账号设置 PRD](./prd-auth.md) - Google 登录与账号偏好
 - [策略排行榜 PRD](./prd-leaderboard.md) - 排行榜与排序/筛选设计
 - [测试规范 PRD](./prd-testing.md) - 测试用例与 CI 要求
 - [实施细节补充](./prd-supplement.md) - 详细实现与数据库 Schema

## 快速开始

### 前置要求

- Node.js 18+
- Cloudflare账号
- Claude API密钥
- Telegram Bot Token

### 开发步骤

详见 [prd-supplement.md](./prd-supplement.md) 第10章节的分步实施计划。

预计开发时间：**3-4周（MVP）**

## 项目结构（规划）

```
ai-strategy-trader/
├── docs/                    # 文档
│   ├── prd.md              # 产品需求文档
│   └── prd-supplement.md   # 实施细节补充
├── workers/                # Cloudflare Workers
│   ├── parse-strategy/     # 策略解析Worker
│   ├── backtest/           # 回测引擎Worker
│   └── live-monitor/       # 实时监控Cron Worker
├── frontend/               # Next.js前端
│   ├── app/                # App Router
│   ├── components/         # React组件
│   └── lib/                # 工具函数
└── data/                   # 数据脚本
    └── fetch-klines.js     # K线数据获取脚本
```

## 开发路线图

- [x] 完成PRD文档编写
- [ ] Phase 1: 基础设施搭建 (1-2天)
- [ ] Phase 2: 策略解析模块 (2-3天)
- [ ] Phase 3: 回测引擎模块 (3-5天)
- [ ] Phase 4: 前端界面开发 (4-6天)
- [ ] Phase 5: 实时监控模块 (2-3天)
- [ ] Phase 6: 高级功能与优化 (3-4天)
- [ ] Phase 7: 测试与部署 (2-3天)

## 性能目标

| 指标 | 目标值 |
|------|--------|
| 策略解析响应时间 | <5秒 |
| 回测执行时间（1000根K线） | <100ms |
| API成功率 | >99.9% |
| 前端首屏加载时间 | <2秒 |

## 主要模块说明

### 模块 A: 自然语言策略解析
用户输入自然语言描述（如"当20日均线上穿50日均线时买入"），系统调用Claude API解析为标准化的JSON格式。

### 模块 B: 边缘回测引擎  
在Cloudflare Workers上运行，从R2读取历史K线数据，计算技术指标，模拟交易，返回详细的回测报告（包括资金曲线、交易记录、蒙特卡洛模拟结果）。

### 模块 C: 可视化看板
Next.js构建的前端界面，包括AI对话创建策略、回测结果展示（K线图+信号标记、资金曲线、统计卡片）、策略监控面板。

### 模块 D: 实时监控  
Cloudflare Cron每分钟运行，检查活跃策略是否触发交易信号，通过Telegram Bot推送实时通知。

## 差异化功能

- **AI策略诊断**: 回测后自动生成专业分析报告
- **社交分享**: 一键生成精美的策略分享海报
- **参数优化器**: 自动寻找最优参数组合
- **策略对比**: 并排对比多个策略的表现

## 贡献

欢迎提交Issue和Pull Request！

## 许可证

MIT License

---

**⚠️ 免责声明**: 本平台提供的回测结果仅供参考，不构成投资建议。历史表现不代表未来收益，用户需自行承担交易风险。