# stockQtt

**Repository Path**: mingwuda/stock-qtt

## Basic Information

- **Project Name**: stockQtt
- **Description**: No description available
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-15
- **Last Updated**: 2026-03-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Stock Quant - 股市量化投资工具

[comment]: <> (General project overview)

Stock Quant 是一个基于 Java Spring Boot 和 Vue.js 构建的股市量化投资工具，支持美股、A股和港股的行情数据获取、交易执行、策略回测以及智能交易功能。

[comment]: <> (Main features)

## 功能特性

### 行情数据
- 实时行情数据获取（支持美股、A股、港股）
- K线数据查询（分钟线、日线、周线、月线）
- 自动同步市场数据

### 交易执行
- 支持 Alpaca 券商 API 集成
- 买卖下单操作
- 持仓管理
- 账户余额查询

### 策略引擎
- 多种内置策略：均线交叉、止损、RSI策略
- 策略创建、修改、删除
- 定时执行策略

### 智能交易
- 新闻爬取与分析
- 基于 LLM（通义千问）的智能决策
- 自动交易执行

### 盈亏分析
- 日/周/月盈亏统计
- 总盈亏计算
- 图表数据展示

### 日志记录
- 交易日志记录
- 日志查询与筛选

[comment]: <> (Technology stack)

## 技术栈

### 后端
- Java 17
- Spring Boot
- MyBatis-Plus
- MySQL
- Alpaca Trading API
- 通义千问 LLM API

### 前端
- Vue 3
- Vite
- Nginx

### 部署
- Docker
- Docker Compose

[comment]: <> (Project structure)

## 项目结构

```
stock-qtt/
├── backend/                 # Spring Boot 后端
│   ├── src/main/java/
│   │   └── com/stockquant/
│   │       ├── config/      # 配置类
│   │       ├── controller/  # 控制器
│   │       ├── entity/      # 实体类
│   │       ├── mapper/      # 数据访问层
│   │       └── service/     # 业务服务
│   └── src/main/resources/
│       └── application.yml  # 配置文件
├── frontend/               # Vue 前端
│   ├── src/
│   │   ├── api/            # API 接口
│   │   ├── router/         # 路由配置
│   │   └── views/          # 页面组件
│   └── nginx.conf
├── mysql/                  # MySQL 初始化脚本
├── docker-compose.yml      # Docker Compose 配置
└── SPEC.md                 # 技术规范文档
```

[comment]: <> (Quick start)

## 快速开始

### 环境要求

- JDK 17+
- Node.js 18+
- MySQL 8.0+
- Docker & Docker Compose

### 配置文件

在 `backend/src/main/resources/application.yml` 中配置：

```yaml
stock:
  alpaca:
    base-url: https://paper-api.alpaca.markets
    api-key: your-api-key
    secret-key: your-secret-key
    paper: true
  scheduler:
    enabled: true
    market-data-cron: "0 * * * * ?"
    strategy-cron: "0 0 9 * * ?"
    profit-cron: "0 0 0 * * ?"

qwen:
  api:
    key: your-qwen-api-key
    url: https://dashscope.aliyuncs.com/api/v1/services/aigc/text-generation/generation
```

### Docker 部署

```bash
# 启动所有服务
docker-compose up -d
```

服务启动后访问：
- 前端：http://localhost:80
- 后端：http://localhost:8080

### 本地开发

**后端：**
```bash
cd backend
mvn clean package
java -jar target/stock-quant-backend-1.0.0.jar
```

**前端：**
```bash
cd frontend
npm install
npm run dev
```

[comment]: <> (API interface)

## API 接口

### 行情接口
- `GET /api/market/quotes` - 获取实时行情
- `GET /api/market/klines` - 获取K线数据

### 交易接口
- `POST /api/trade/buy` - 买入
- `POST /api/trade/sell` - 卖出
- `GET /api/trade/positions` - 获取持仓
- `GET /api/trade/balance` - 获取账户余额

### 策略接口
- `GET /api/strategy/list` - 获取策略列表
- `POST /api/strategy/create` - 创建策略
- `PUT /api/strategy/update` - 更新策略
- `DELETE /api/strategy/delete` - 删除策略
- `POST /api/strategy/execute` - 执行策略

### 分析接口
- `GET /api/analysis/daily` - 日盈亏
- `GET /api/analysis/weekly` - 周盈亏
- `GET /api/analysis/monthly` - 月盈亏
- `GET /api/analysis/chart` - 图表数据
- `GET /api/analysis/total-profit` - 总盈亏

### 智能交易接口
- `GET /api/intelligent-trading/account-summary` - 账户概要
- `GET /api/intelligent-trading/latest-decisions` - 最新决策
- `GET /api/intelligent-trading/news` - 最新新闻

### 日志接口
- `GET /api/logs` - 获取交易日志

[comment]: <> (License)

## License

MIT License