# 模块 6：研发效能看板指标开发

<div class="mt-6 text-sm">

看板不是图表堆叠。核心是指标口径、数据来源和权限范围。

</div>

<div class="grid grid-cols-3 gap-4 mt-8 text-sm">
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30 text-center">工单总数</div>
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30 text-center">待处理数量</div>
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30 text-center">已关闭数量</div>
<div class="p-3 rounded-xl bg-purple-500/10 border border-purple-500/30 text-center">平均关闭周期</div>
<div class="p-3 rounded-xl bg-red-500/10 border border-red-500/30 text-center">优先级分布</div>
<div class="p-3 rounded-xl bg-gray-500/10 border border-gray-500/30 text-center">状态趋势</div>
</div>

<!--
看板的重点不是图表好看。
工单总数怎么算，待处理包含哪些状态，关闭周期从哪里到哪里，都要先讲清楚。
-->

---

# 看板指标字典

<div class="mt-5 text-xs">

| 指标 | 含义 | 计算口径 | 数据来源 | 展示 |
|---|---|---|---|---|
| 工单总数 | 当前工单总量 | count(*) | work_order | 数字卡片 |
| 待处理数量 | created + processing | 按状态统计 | work_order.status | 数字卡片 |
| 已关闭数量 | closed 数量 | 按状态统计 | work_order.status | 数字卡片 |
| 平均关闭周期 | 创建到关闭平均耗时 | avg(close_time - create_time) | work_order | 数字卡片 |
| 优先级分布 | 各优先级数量 | group by priority | work_order.priority | 饼图 |
| 状态趋势 | 每日新增/关闭 | 按日期聚合 | work_order | 折线图 |

</div>

<!--
指标字典是看板开发的第一产物。
如果指标口径不清，看板数字就不能用于管理判断。
-->

---

# 看板统计接口契约

<div class="mt-5 text-sm">

```md
GET /workOrder/dashboard/summary
返回：totalCount、pendingCount、closedCount、avgCloseHours

GET /workOrder/dashboard/status
返回：状态分布

GET /workOrder/dashboard/priority
返回：优先级分布

GET /workOrder/dashboard/trend
返回：每日新增、每日关闭
```

</div>

<div class="mt-4 p-3 rounded-xl bg-blue-500/10 border border-blue-500/30 text-sm">
每个接口必须说明筛选条件、数据范围、统计口径和看板权限。
</div>

<!--
看板不要只做前端假数据。
至少要设计后端统计接口契约，并说明管理员、负责人、普通用户的数据范围。
-->

---

# 看板页面验收

<div class="mt-5 text-sm">

| 验收项 | 预期 |
|---|---|
| 看板权限 | 无 `work:order:dashboard` 权限不可访问 |
| Summary 指标 | 口径符合指标字典 |
| 状态分布 | 与列表筛选统计一致 |
| 趋势图 | 新增/关闭按日期展示 |
| 空数据 | 显示空态，不报 NaN 或 undefined |

</div>

<!--
看板页面不是能打开就算完成。
验收要看权限、口径、空态和数字是否能解释。
-->