stock-monitor/docs/guides/NEW_FEATURES_GUIDE.md

# 股票监控系统新功能使用指南

## 🎉 新功能概览

我们已经成功为股票监控系统添加了以下全市场股票功能：

### ✅ 已实现的功能

1. **📊 全市场股票数据**
   - 获取所有A股股票的基础信息
   - 支持按行业、概念板块分类浏览
   - 实时股票搜索和筛选

2. **📈 K线数据管理**
   - 日K、周K、月K线数据存储
   - 支持历史K线数据查询
   - K线图表可视化展示

3. **🤖 自动化定时任务**
   - 每日自动更新股票列表
   - 自动更新K线数据
   - 市场统计数据计算
   - 数据清理和维护

4. **🖥️ 前端用户界面**
   - 股票市场浏览页面
   - 实时市场概览
   - 股票详情和K线图表
   - 行业和概念筛选

## 🚀 快速开始

### 1. 应用数据库结构
```bash
python apply_extended_schema.py
```
此脚本会创建新的数据库表结构，支持全市场股票数据。

### 2. 启动系统
```bash
python run.py
```
系统启动后，定时任务会自动开始运行。

### 3. 访问新功能
- **股票市场页面**: http://localhost:8000/stocks
- **原有监控页面**: http://localhost:8000/
- **指数行情页面**: http://localhost:8000/market

## 📋 主要功能说明

### 股票市场页面 (/stocks)

#### 市场概览
- 显示全市场涨跌统计
- 总成交量和成交额
- 实时刷新市场数据

#### 股票浏览
- **搜索功能**: 支持股票代码和名称搜索
- **行业筛选**: 按行业分类浏览股票
- **概念筛选**: 按概念板块浏览股票
- **热门排行**: 成交量、成交额、涨幅排行榜
- **分页显示**: 高效显示大量股票数据

#### 股票详情
- 点击股票查看详细信息
- K线图表展示（60天历史数据）
- 基本面指标和估值数据
- 一键添加到监控列表

### API接口

#### 股票数据接口
```bash
# 获取所有股票列表（支持分页和筛选）
GET /api/market/stocks?page=1&size=50&industry=I09&search=银行

# 获取股票详细信息
GET /api/market/stocks/000001

# 获取K线数据
GET /api/market/stocks/000001/kline?kline_type=daily&days=30

# 获取行业列表
GET /api/market/industries

# 获取概念板块列表
GET /api/market/sectors
```

#### 市场统计接口
```bash
# 获取市场概览
GET /api/market/overview

# 获取热门股票排行榜
GET /api/market/hot-stocks?rank_type=volume&limit=20

# 同步市场数据
POST /api/market/sync
```

#### 定时任务接口
```bash
# 手动执行任务
POST /api/market/tasks/update_stock_list
POST /api/market/tasks/update_daily_kline

# 获取任务执行状态
GET /api/market/tasks/status?days=7
```

## 🔄 定时任务说明

系统内置了以下自动任务：

### 每日任务
- **09:00** - 更新股票列表（每周一）
- **09:30** - 更新当日K线数据
- **16:00** - 计算市场统计数据
- **20:00** - 更新监控列表数据

### 每周任务
- **周日02:00** - 清理旧数据（保留6个月）

### 数据更新策略
- 股票列表：每周一更新一次
- K线数据：每个交易日更新
- 市场统计：每个交易日计算
- 数据清理：每周日凌晨执行

## 📊 数据库表结构

### 新增表结构

1. **industries** - 行业分类表
2. **sectors** - 概念板块表
3. **kline_data** - K线数据表
4. **stock_sector_relations** - 股票-板块关联表
5. **market_statistics** - 市场统计表
6. **data_update_tasks** - 任务执行记录表
7. **hot_stocks** - 热门股票统计表

### 扩展表结构

- **stocks** 表增加了行业、板块、市场类型等字段

## 🎨 前端技术栈

- **Vue.js 3** - 前端框架
- **Bootstrap 5** - UI组件库
- **ECharts** - 图表库
- **Axios** - HTTP客户端

## 🛠️ 使用技巧

### 1. 数据同步
首次使用时，点击"同步数据"按钮获取最新的股票数据。

### 2. 股票筛选
- 使用搜索框快速定位特定股票
- 通过行业和概念筛选发现投资机会
- 查看热门排行榜了解市场热点

### 3. K线图表
- 点击股票查看详细的K线图表
- 支持日K、周K、月K不同周期
- 结合成交量分析价格走势

### 4. 监控管理
- 在股票详情页面一键添加到监控列表
- 原有监控功能完全保持兼容
- AI分析功能支持新添加的股票

## 📈 系统性能

### 优化策略
- 数据库索引优化查询性能
- 分页加载减少内存占用
- 缓存机制减少API调用
- 异步任务处理提升响应速度

### 容量规划
- 支持5000+股票实时数据
- 历史K线数据按需清理
- 任务执行状态监控和日志

## 🔧 故障排除

### 常见问题

1. **股票列表为空**
   - 检查是否已执行数据同步
   - 确认数据库连接正常
   - 查看任务执行状态

2. **K线图表不显示**
   - 确认股票代码正确
   - 检查网络连接
   - 查看浏览器控制台错误信息

3. **数据更新不及时**
   - 检查定时任务是否正常运行
   - 确认Tushare API配额充足
   - 查看任务执行日志

### 日志查看
```bash
# 查看任务执行状态
curl http://localhost:8000/api/market/tasks/status

# 手动触发数据同步
curl -X POST http://localhost:8000/api/market/sync
```

## 🎯 下一步优化方向

1. **技术分析指标**: 添加更多技术分析指标
2. **实时推送**: WebSocket实时数据推送
3. **数据导出**: 支持Excel、CSV格式导出
4. **用户个性化**: 自定义筛选条件和提醒
5. **移动端适配**: 响应式设计优化

---

## 🎊 总结

新功能完全兼容原有系统，在保持监控列表功能的同时，大大扩展了系统的数据覆盖面和分析能力。现在您可以：

- 🔍 **浏览全市场5000+股票**
- 📊 **查看实时K线图表**
- 🏭 **按行业概念分类筛选**
- 🔥 **追踪市场热点股票**
- ⏰ **享受全自动数据更新**

祝您投资顺利！🚀