chore: initialize lhbfx project and documentation

docs/需求文档.md

@@ -0,0 +1,161 @@
+# 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 可视化回归测试