# 页面名：board-coach（助教看板）

> PRD 参考：P8 `docs/prd/specs/P8-miniapp-fe-boards.md`；`apps/miniprogram/doc/prd.md` 第九节 9.3
> 已实现：否

## 页面说明
按排序×技能×时间三重筛选查看助教排名列表。不同排序维度下卡片结构和突出数据不同。

## 状态变量
| 变量名 | 类型 | 初始值 | 说明 |
|--------|------|--------|------|
| selectedSort | string | "定档业绩最高" | 排序筛选 |
| selectedSkill | string | "不限" | 技能筛选 |
| selectedTime | string | "本月" | 时间筛选 |
| sortDropdownVisible | boolean | false | 排序筛选下拉展开 |
| skillDropdownVisible | boolean | false | 技能筛选下拉展开 |
| timeDropdownVisible | boolean | false | 时间筛选下拉展开 |
| coaches | array | [] | 助教列表 |
| loading | boolean | true | 数据加载中 |
| error | boolean | false | 加载失败 |

## 用户操作 → 响应
| 操作 | 触发条件 | 响应行为 | 目标状态 |
|------|----------|----------|----------|
| 页面加载 | 进入页面 | GET /api/board/coaches | loading→false |
| 点击排序筛选 | 无 | 展开排序下拉，关闭其他 | sortDropdownVisible=true |
| 选择排序 | 下拉展开 | 切换对应 dim-container 显隐，重新请求数据 | selectedSort 更新 |
| 点击技能筛选 | 无 | 展开技能下拉，关闭其他 | skillDropdownVisible=true |
| 选择技能 | 下拉展开 | 重新请求数据 | selectedSkill 更新 |
| 点击时间筛选 | 无 | 展开时间下拉，关闭其他 | timeDropdownVisible=true |
| 选择时间 | 下拉展开 | 重新请求数据 | selectedTime 更新 |
| 点击助教卡片 | 无 | navigateTo coach-detail | — |
| 切换看板 Tab | 顶部 Tab 栏 | navigateTo board-finance / board-customer | — |
| 滚动页面 | 持续 | 下滑隐藏筛选栏，上滑显示 | — |
| 点击"重试" | error=true | 重新请求数据 | loading=true |

## 筛选器选项（忠于原型 HTML）

### 排序筛选（6 个）
1. 定档业绩最高
2. 定档业绩最低
3. 工资最高
4. 工资最低
5. 客源储值最高
6. 任务完成最多

### 技能筛选
不限 / 🎱 / 斯 / 🀄 / 🎤

### 时间筛选
本月 / 本季度 / 上月 / 前3个月（不含本月）/ 上季度 / 最近6个月（不含本月，不支持客源储值最高）

## 排序切换 → 卡片结构映射（忠于原型 HTML）

切换排序时，通过 `selectSort(value)` 函数切换对应的 `dim-container` 显隐。每种排序的卡片右侧突出数据不同：

| 排序 | container id | 卡片右侧突出数据 |
|------|-------------|-----------------|
| 定档业绩最高/最低 | `dim-perf` | 定档 Xh + 折前 Xh + 距升档 Xh（或 ✅ 已达标） |
| 工资最高/最低 | `dim-salary` | 预估标签 + ¥金额（大字）+ 定档/折前 |
| 客源储值最高 | `dim-sv` | 储值 ¥金额（大字）+ 客户 X人 + 消耗 ¥X |

> 高客源储值定义（PRD 补充）：RS > 2 的客户的会员卡储值合计（RS = 关系强度指数，> 2 表示有一定服务关系的客户）
| 任务完成最多 | `dim-task` | 召回 X（蓝色大字）+ 回访 X |

### 所有卡片共有元素
- 助教头像圆形 + 姓名
- 等级标签（星级/高级/中级/初级）— 不同等级不同颜色
- 技能标签（🎱/斯/🀄/🎤）
- 底部 TOP3 客户 emoji 列表

## 等级标签颜色
| 等级 | 颜色 |
|------|------|
| 星级 | 金色/amber |
| 高级 | 蓝色/primary |
| 中级 | 绿色/success |
| 初级 | 灰色/gray |

## 筛选栏滚动行为
- 下滑时筛选栏隐藏，上滑时重新显示
- 由 `initFilterBarScrollBehavior()` 实现

## 页面状态枚举
| 状态名 | 视觉表现 | 触发条件 |
|--------|----------|----------|
| 加载中 | 区域文案"加载中..." | loading=true |
| 正常态 | 助教列表 | 有数据 |
| 空数据态 | "暂无数据" | coaches 为空 |
| 错误态 | "加载失败，请点击重试" + 重试按钮 | error=true |

## 后端 API 依赖
| API | 方法 | 说明 |
|-----|------|------|
| `GET /api/board/coaches` | GET | 助教看板（排序×技能×时间三重筛选） |

## 页面导航
- 来源：board-finance / board-customer（看板 Tab 切换）
- 去向：coach-detail / chat

## 全局组件
- 底部 TabBar（看板 active）
- AI 悬浮按钮（右下角）
- 看板顶部 Tab 栏（财务 / 客户 / 助教 active）