stock-monitor/docs/guides/NEW_FEATURES_GUIDE.md
ycg 569c1c8813 重构股票监控系统:数据库架构升级与功能完善
- 重构数据访问层:引入DAO模式,支持MySQL/SQLite双数据库
- 新增数据库架构:完整的股票数据、AI分析、自选股管理表结构
- 升级AI分析服务:集成豆包大模型,支持多维度分析
- 优化API路由:分离市场数据API,提供更清晰的接口设计
- 完善项目文档:添加数据库迁移指南、新功能指南等
- 清理冗余文件:删除旧的缓存文件和无用配置
- 新增调度器:支持定时任务和数据自动更新
- 改进前端模板:简化的股票展示页面

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-01 15:44:25 +08:00

5.7 KiB
Raw Blame History

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

🎉 新功能概览

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

已实现的功能

  1. 📊 全市场股票数据

    • 获取所有A股股票的基础信息
    • 支持按行业、概念板块分类浏览
    • 实时股票搜索和筛选
  2. 📈 K线数据管理

    • 日K、周K、月K线数据存储
    • 支持历史K线数据查询
    • K线图表可视化展示
  3. 🤖 自动化定时任务

    • 每日自动更新股票列表
    • 自动更新K线数据
    • 市场统计数据计算
    • 数据清理和维护
  4. 🖥️ 前端用户界面

    • 股票市场浏览页面
    • 实时市场概览
    • 股票详情和K线图表
    • 行业和概念筛选

🚀 快速开始

1. 应用数据库结构

python apply_extended_schema.py

此脚本会创建新的数据库表结构,支持全市场股票数据。

2. 启动系统

python run.py

系统启动后,定时任务会自动开始运行。

3. 访问新功能

📋 主要功能说明

股票市场页面 (/stocks)

市场概览

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

股票浏览

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

股票详情

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

API接口

股票数据接口

# 获取所有股票列表(支持分页和筛选)
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

市场统计接口

# 获取市场概览
GET /api/market/overview

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

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

定时任务接口

# 手动执行任务
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配额充足
    • 查看任务执行日志

日志查看

# 查看任务执行状态
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线图表
  • 🏭 按行业概念分类筛选
  • 🔥 追踪市场热点股票
  • 享受全自动数据更新

祝您投资顺利!🚀