# 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. 后续建议

后续可以继续迭代：

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