2026-04-17 21:20:26 +08:00
|
|
|
# lhbfx 需求文档
|
|
|
|
|
|
|
|
|
|
## 1. 项目目标
|
|
|
|
|
|
|
|
|
|
`lhbfx` 用于盘后跟踪顶级游资席位行为，帮助用户快速判断：
|
|
|
|
|
|
|
|
|
|
- 今天目标游资买了什么、卖了什么
|
|
|
|
|
- 哪些股票值得加入后续关注池
|
|
|
|
|
- 哪些关注股已经出现卖出或慢流出风险
|
|
|
|
|
- 某只股票在目标游资维度上的完整参与轨迹
|
|
|
|
|
|
|
|
|
|
系统定位是“盘后分析与预警辅助”，不是自动交易系统。
|
|
|
|
|
|
|
|
|
|
## 2. 当前功能范围
|
|
|
|
|
|
|
|
|
|
### 2.1 首页总控台
|
|
|
|
|
|
|
|
|
|
首页当前聚焦两个核心区域：
|
|
|
|
|
|
|
|
|
|
- 关注池与操作流水
|
|
|
|
|
- 待加入关注
|
|
|
|
|
|
|
|
|
|
首页支持：
|
|
|
|
|
|
|
|
|
|
- 按日期范围筛选
|
|
|
|
|
- 按游资筛选
|
|
|
|
|
- 按方向筛选
|
|
|
|
|
- 关注股票加入/移出数据库关注池
|
|
|
|
|
- 已关注股票展示对应操作流水
|
|
|
|
|
- 待关注候选展示重点净额、价格与板块信息
|
|
|
|
|
|
|
|
|
|
### 2.2 关注池
|
|
|
|
|
|
|
|
|
|
关注池规则：
|
|
|
|
|
|
|
|
|
|
- 用户点击“关注”后，股票进入数据库关注池
|
|
|
|
|
- 用户点击“取消关注”后，对应数据库记录删除
|
|
|
|
|
- 首页左侧仅展示当前关注池中的股票
|
|
|
|
|
- 关注池流水按“股票 + 日期 + 游资 + 席位”合并展示
|
|
|
|
|
|
|
|
|
|
### 2.3 待加入关注
|
|
|
|
|
|
|
|
|
|
候选区规则：
|
|
|
|
|
|
|
|
|
|
- 候选来自当前筛选条件下、尚未进入关注池的操作记录
|
|
|
|
|
- 候选卡片固定高度展示
|
|
|
|
|
- 重点突出净额
|
|
|
|
|
- 展示股票代码、日期、游资、板块标签、股价、涨跌幅、总市值
|
|
|
|
|
- 买卖结构使用不同颜色表达
|
|
|
|
|
|
|
|
|
|
### 2.4 个股详情
|
|
|
|
|
|
|
|
|
|
个股详情页支持：
|
|
|
|
|
|
|
|
|
|
- 基础资料展示
|
|
|
|
|
- 日 K 线图
|
|
|
|
|
- MA5 图例
|
|
|
|
|
- 买卖点标注
|
|
|
|
|
- 游资参与概览
|
|
|
|
|
- 预警信息展示
|
|
|
|
|
|
|
|
|
|
### 2.5 游资详情
|
|
|
|
|
|
|
|
|
|
游资详情页支持：
|
|
|
|
|
|
|
|
|
|
- 游资档案
|
|
|
|
|
- 风格标签
|
2026-04-18 13:06:11 +08:00
|
|
|
- 股票列表全宽展示
|
|
|
|
|
- 时间、名称、净额连续增大筛选
|
|
|
|
|
- 按时间、净额、动作数排序
|
|
|
|
|
- 行业、上市板块、总市值、净额和预警标签展示
|
2026-04-17 21:20:26 +08:00
|
|
|
|
|
|
|
|
### 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 及以上宽度下保持清晰稳定
|
|
|
|
|
- 文档、配置与代码要支持团队继续接手迭代
|
|
|
|
|
|
2026-04-18 14:46:24 +08:00
|
|
|
## 8. 新增定时报送需求
|
|
|
|
|
|
|
|
|
|
新增一项每日自动化需求：
|
|
|
|
|
|
|
|
|
|
- 每个交易日下午 17:00 自动更新最新龙虎榜与相关统计数据
|
|
|
|
|
- 更新完成后自动统计“关注池情况”和“今日待加入关注列表”
|
|
|
|
|
- 自动发送邮件给指定收件人
|
|
|
|
|
- 邮件需同时包含正文摘要和 PDF 附件
|
|
|
|
|
|
|
|
|
|
### 8.1 定时更新要求
|
|
|
|
|
|
|
|
|
|
- 默认执行时间为每天下午 `17:00`
|
|
|
|
|
- 若当天为非交易日或数据源尚未更新，需要在邮件正文中明确说明
|
|
|
|
|
- 若更新失败，需要输出失败原因并进入告警状态
|
|
|
|
|
|
|
|
|
|
### 8.2 邮件正文要求
|
|
|
|
|
|
|
|
|
|
邮件正文至少包含以下内容：
|
|
|
|
|
|
|
|
|
|
- 数据统计日期
|
|
|
|
|
- 关注池股票数量
|
|
|
|
|
- 关注池中今日有动作的股票列表
|
|
|
|
|
- 今日待加入关注列表
|
|
|
|
|
- 关键风险提示或卖出预警摘要
|
|
|
|
|
|
|
|
|
|
### 8.3 PDF 附件要求
|
|
|
|
|
|
|
|
|
|
PDF 附件建议作为“盘后日报”输出，至少包含：
|
|
|
|
|
|
|
|
|
|
- 当日数据概览
|
|
|
|
|
- 关注池汇总
|
|
|
|
|
- 关注池操作流水摘要
|
|
|
|
|
- 今日待加入关注候选列表
|
|
|
|
|
- 重点风险与预警说明
|
|
|
|
|
|
|
|
|
|
### 8.4 邮件收件要求
|
|
|
|
|
|
|
|
|
|
- 支持配置一个或多个收件人
|
|
|
|
|
- 邮件主题中应包含日期，例如：`lhbfx 盘后日报 - 2026-04-17`
|
|
|
|
|
- 邮件发送成功与失败都需要记录日志
|
|
|
|
|
|
|
|
|
|
## 9. 后续建议
|
2026-04-17 21:20:26 +08:00
|
|
|
|
|
|
|
|
后续可以继续迭代：
|
|
|
|
|
|
|
|
|
|
- 统一修正当前部分历史数据的中文乱码问题
|
|
|
|
|
- 对首页增加截图回归检查
|
|
|
|
|
- 为关键页面补充 Playwright 可视化回归测试
|
