Files
lhbfx/docs/需求文档.md

164 lines
3.8 KiB
Markdown
Raw Normal View History

# lhbfx 需求文档
## 1. 项目目标
`lhbfx` 用于盘后跟踪顶级游资席位行为,帮助用户快速判断:
- 今天目标游资买了什么、卖了什么
- 哪些股票值得加入后续关注池
- 哪些关注股已经出现卖出或慢流出风险
- 某只股票在目标游资维度上的完整参与轨迹
系统定位是“盘后分析与预警辅助”,不是自动交易系统。
## 2. 当前功能范围
### 2.1 首页总控台
首页当前聚焦两个核心区域:
- 关注池与操作流水
- 待加入关注
首页支持:
- 按日期范围筛选
- 按游资筛选
- 按方向筛选
- 关注股票加入/移出数据库关注池
- 已关注股票展示对应操作流水
- 待关注候选展示重点净额、价格与板块信息
### 2.2 关注池
关注池规则:
- 用户点击“关注”后,股票进入数据库关注池
- 用户点击“取消关注”后,对应数据库记录删除
- 首页左侧仅展示当前关注池中的股票
- 关注池流水按“股票 + 日期 + 游资 + 席位”合并展示
### 2.3 待加入关注
候选区规则:
- 候选来自当前筛选条件下、尚未进入关注池的操作记录
- 候选卡片固定高度展示
- 重点突出净额
- 展示股票代码、日期、游资、板块标签、股价、涨跌幅、总市值
- 买卖结构使用不同颜色表达
### 2.4 个股详情
个股详情页支持:
- 基础资料展示
- 日 K 线图
- MA5 图例
- 买卖点标注
- 游资参与概览
- 预警信息展示
### 2.5 游资详情
游资详情页支持:
- 游资档案
- 风格标签
2026-04-18 13:06:11 +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 及以上宽度下保持清晰稳定
- 文档、配置与代码要支持团队继续接手迭代
## 8. 后续建议
后续可以继续迭代:
- 统一修正当前部分历史数据的中文乱码问题
- 对首页增加截图回归检查
- 为关键页面补充 Playwright 可视化回归测试