smart
67837df8d0
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
124 lines
4.0 KiB
Markdown
124 lines
4.0 KiB
Markdown
# 模块 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>
|
|
|
|
<!--
|
|
看板页面不是能打开就算完成。
|
|
验收要看权限、口径、空态和数字是否能解释。
|
|
-->
|
|
|
|
---
|
|
|
|
# 可直接复制到 rules：看板指标
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
```md
|
|
## 看板指标必须手工抽样校验
|
|
- 级别：硬约束
|
|
- 适用场景：统计卡片、趋势图、分布图、排行、效能指标。
|
|
- 必须：每个关键指标有含义、公式、过滤条件、时间字段、数据范围，并用样例数据手工校验。
|
|
- 禁止：只验证接口返回 200 或页面有图表。
|
|
- 来源证据：指标字典、接口契约、样例数据、数据库查询或列表数据。
|
|
- 验收方式：至少一组样例数据的手工计算结果与接口返回一致。
|
|
```
|
|
|
|
</div>
|
|
|
|
<div class="mt-4 p-3 rounded-xl bg-amber-500/10 border border-amber-500/30 text-sm">
|
|
看板交付时要同时交付指标字典、接口契约和一组手工核对样例。
|
|
</div>
|
|
|
|
<!--
|
|
这页把看板从“图表开发”拉回“指标开发”。
|
|
企业看板最怕数字说不清来源，尤其是平均关闭周期、待处理数量、趋势图这类指标。
|
|
所以规则要求公式、过滤条件、时间字段、数据范围和样例核对都必须齐全。
|
|
-->
|