smart
67837df8d0
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
4.0 KiB
4.0 KiB
模块 6：研发效能看板指标开发
看板不是图表堆叠。核心是指标口径、数据来源和权限范围。
工单总数
待处理数量
已关闭数量
平均关闭周期
优先级分布
状态趋势
看板指标字典
| 指标 | 含义 | 计算口径 | 数据来源 | 展示 |
|---|---|---|---|---|
| 工单总数 | 当前工单总量 | 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 | 折线图 |
看板统计接口契约
GET /workOrder/dashboard/summary
返回：totalCount、pendingCount、closedCount、avgCloseHours
GET /workOrder/dashboard/status
返回：状态分布
GET /workOrder/dashboard/priority
返回：优先级分布
GET /workOrder/dashboard/trend
返回：每日新增、每日关闭
每个接口必须说明筛选条件、数据范围、统计口径和看板权限。
看板页面验收
| 验收项 | 预期 |
|---|---|
| 看板权限 | 无 work:order:dashboard 权限不可访问 |
| Summary 指标 | 口径符合指标字典 |
| 状态分布 | 与列表筛选统计一致 |
| 趋势图 | 新增/关闭按日期展示 |
| 空数据 | 显示空态，不报 NaN 或 undefined |
可直接复制到 rules：看板指标
## 看板指标必须手工抽样校验
- 级别：硬约束
- 适用场景：统计卡片、趋势图、分布图、排行、效能指标。
- 必须：每个关键指标有含义、公式、过滤条件、时间字段、数据范围，并用样例数据手工校验。
- 禁止：只验证接口返回 200 或页面有图表。
- 来源证据：指标字典、接口契约、样例数据、数据库查询或列表数据。
- 验收方式：至少一组样例数据的手工计算结果与接口返回一致。
看板交付时要同时交付指标字典、接口契约和一组手工核对样例。