feat：update 3 4

2026-07-02 10:04:32 +08:00
parent 604e7e68d7
commit 2fd8fc1f66
224 changed files with 12369 additions and 9 deletions
@@ -0,0 +1,95 @@
+# 模块 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>
+
+<!--
+看板页面不是能打开就算完成。
+验收要看权限、口径、空态和数字是否能解释。
+-->