wanghep/lhbfx
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
9e0ad439997da33b3f8c2b28dc03d084731448d7
lhbfx/docs/需求文档.md

5.0 KiB
Raw Blame History

lhbfx 需求文档

1. 项目目标

lhbfx 用于盘后跟踪顶级游资席位行为，帮助用户快速判断：

  • 今天目标游资买了什么、卖了什么
  • 哪些股票值得加入后续关注池
  • 哪些关注股已经出现卖出或慢流出风险
  • 某只股票在目标游资维度上的完整参与轨迹

系统定位是“盘后分析与预警辅助”，不是自动交易系统。

2. 当前功能范围

2.1 首页总控台

首页当前聚焦两个核心区域：

  • 关注池与操作流水
  • 待加入关注

首页支持：

  • 按日期范围筛选
  • 按游资筛选
  • 按方向筛选
  • 关注股票加入/移出数据库关注池
  • 已关注股票展示对应操作流水
  • 待关注候选展示重点净额、价格与板块信息

2.2 关注池

关注池规则：

  • 用户点击“关注”后，股票进入数据库关注池
  • 用户点击“取消关注”后，对应数据库记录删除
  • 首页左侧仅展示当前关注池中的股票
  • 关注池流水按“股票 + 日期 + 游资 + 席位”合并展示

2.3 待加入关注

候选区规则：

  • 候选来自当前筛选条件下、尚未进入关注池的操作记录
  • 候选卡片固定高度展示
  • 重点突出净额
  • 展示股票代码、日期、游资、板块标签、股价、涨跌幅、总市值
  • 买卖结构使用不同颜色表达

2.4 个股详情

个股详情页支持：

  • 基础资料展示
  • 日 K 线图
  • MA5 图例
  • 买卖点标注
  • 游资参与概览
  • 预警信息展示

2.5 游资详情

游资详情页支持：

  • 游资档案
  • 风格标签
  • 股票列表全宽展示
  • 时间、名称、净额连续增大筛选
  • 按时间、净额、动作数排序
  • 行业、上市板块、总市值、净额和预警标签展示

2.6 预警中心

当前预警中心支持：

  • 卖出预警
  • 慢流出观察
  • 按股票、游资查看风险条目

3. 用户核心流程

3.1 盘后筛选

用户进入首页后：

  1. 先看关注池中今天是否有新增动作
  2. 再看待加入关注中的候选
  3. 对感兴趣的股票加入关注池
  4. 对已有关注股继续跟踪或取消关注

3.2 候选转关注

  1. 在右侧候选区看到符合预期的股票
  2. 点击“关注”
  3. 股票立即进入左侧关注池
  4. 后续首页统计和流水只围绕关注池展开

3.3 风险排查

  1. 在首页左侧看到关注股的最新流水
  2. 若出现卖出或净流出，进入个股详情进一步确认
  3. 在预警中心查看系统风险提示

4. 数据需求

系统需要至少具备以下数据：

  • 龙虎榜概览数据
  • 龙虎榜席位明细
  • 股票基础资料
  • 股票日线行情
  • 预警事件
  • 用户关注池数据

5. 接口需求

当前已使用接口：

  • GET /api/summary
  • GET /api/pipeline/status
  • GET /api/traders
  • GET /api/traders/{trader_id}
  • GET /api/stocks/{stock_code}
  • GET /api/actions
  • GET /api/watchlist
  • POST /api/watchlist
  • DELETE /api/watchlist/{stock_code}
  • GET /api/warnings

其中：

  • /api/actions 为首页主要数据源
  • /api/watchlist 为关注池持久化入口

6. 当前确认的展示规则

6.1 左侧关注池流水

  • 同股票、同日期、同游资、同席位合并展示
  • 同一席位若同时出现在买入榜和卖出榜，合并后展示为一条
  • 净额重新按买卖合计计算

6.2 右侧待加入关注

  • 卡片固定高度
  • 去掉流通市值
  • 文案与数字缩小，保证同屏显示更多条目
  • 净额优先显示

7. 非功能要求

  • 盘后页面打开速度要快
  • 关键页面在 1440px 及以上宽度下保持清晰稳定
  • 文档、配置与代码要支持团队继续接手迭代

8. 新增定时报送需求

新增一项每日自动化需求：

  • 每个交易日下午 17:00 自动更新最新龙虎榜与相关统计数据
  • 更新完成后自动统计“关注池情况”和“今日待加入关注列表”
  • 自动发送邮件给指定收件人
  • 邮件需同时包含正文摘要和 PDF 附件

8.1 定时更新要求

  • 默认执行时间为每天下午 17:00
  • 若当天为非交易日或数据源尚未更新，需要在邮件正文中明确说明
  • 若更新失败，需要输出失败原因并进入告警状态

8.2 邮件正文要求

邮件正文至少包含以下内容：

  • 数据统计日期
  • 关注池股票数量
  • 关注池中今日有动作的股票列表
  • 今日待加入关注列表
  • 关键风险提示或卖出预警摘要

8.3 PDF 附件要求

PDF 附件建议作为“盘后日报”输出，至少包含：

  • 当日数据概览
  • 关注池汇总
  • 关注池操作流水摘要
  • 今日待加入关注候选列表
  • 重点风险与预警说明

8.4 邮件收件要求

  • 支持配置一个或多个收件人
  • 邮件主题中应包含日期，例如：lhbfx 盘后日报 - 2026-04-17
  • 邮件发送成功与失败都需要记录日志

9. 后续建议

后续可以继续迭代：

  • 统一修正当前部分历史数据的中文乱码问题
  • 对首页增加截图回归检查
  • 为关键页面补充 Playwright 可视化回归测试