Files
TARE-Learn/slidev/pages/day4/m6-dashboard-metrics.md
T
2026-07-02 10:04:32 +08:00

2.9 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