feat(slidev): update 3 4

2026-07-03 00:26:47 +08:00
parent 2fd8fc1f66
commit 6baa4cd10e
47 changed files with 1185 additions and 382 deletions
@@ -1,16 +1,19 @@
-# 工单 RBAC 权限矩阵
+# <模块名称> RBAC 权限矩阵

-| 功能点 | 管理员 | 工单负责人 | 研发处理人 | 测试验证人 | 只读观察者 | 权限字符建议 | 备注 |
-| --- | --- | --- | --- | --- | --- | --- | --- |
-| 查看列表 | 允许 | 条件允许 | 条件允许 | 条件允许 | 条件允许 | work:order:list | 按数据范围 |
-| 查看详情 | 允许 | 条件允许 | 条件允许 | 条件允许 | 条件允许 | work:order:query | 仅可见范围 |
-| 新建工单 | 允许 | 允许 | 允许 | 允许 | 拒绝 | work:order:add |  |
-| 编辑工单 | 允许 | 条件允许 | 条件允许 | 拒绝 | 拒绝 | work:order:edit | 状态限制 |
-| 指派负责人 | 允许 | 条件允许 | 拒绝 | 拒绝 | 拒绝 | work:order:assign |  |
-| 状态流转 | 允许 | 条件允许 | 条件允许 | 条件允许 | 拒绝 | work:order:transition | 按状态 |
-| 关闭工单 | 允许 | 条件允许 | 拒绝 | 条件允许 | 拒绝 | work:order:close | 测试验证后 |
-| 删除工单 | 允许 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | work:order:delete | 高危操作 |
-| 查看审计日志 | 允许 | 条件允许 | 条件允许 | 条件允许 | 拒绝 | work:order:audit |  |
-| 查看看板 | 允许 | 允许 | 条件允许 | 条件允许 | 条件允许 | work:order:dashboard | 按数据范围 |
-| 导出数据 | 允许 | 条件允许 | 拒绝 | 拒绝 | 拒绝 | work:order:export |  |
+## 使用说明

+将列名中的 `<角色A>`、`<角色B>`、`<角色C>` 替换为目标项目真实角色。权限字符只能写成建议，除非源码、菜单配置或后端注解已经证明。
+
+| 功能点 | <管理员角色> | <业务负责人角色> | <处理人角色> | <审核人角色> | <只读角色> | 权限字符建议 | 数据范围 | 来源证据 | 备注 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| 查看列表 | 允许 | 条件允许 | 条件允许 | 条件允许 | 条件允许 | `<module>:<entity>:list` | 按授权范围 |  |  |
+| 查看详情 | 允许 | 条件允许 | 条件允许 | 条件允许 | 条件允许 | `<module>:<entity>:query` | 仅可见数据 |  |  |
+| 新建记录 | 允许 | 允许 | 条件允许 | 条件允许 | 拒绝 | `<module>:<entity>:add` | 通常无数据范围 |  |  |
+| 编辑记录 | 允许 | 条件允许 | 条件允许 | 拒绝 | 拒绝 | `<module>:<entity>:edit` | 创建人/负责人/授权范围 |  | 需结合状态 |
+| 分配/转交 | 允许 | 条件允许 | 拒绝 | 拒绝 | 拒绝 | `<module>:<entity>:assign` | 管理范围 |  | 高风险操作 |
+| 状态流转 | 允许 | 条件允许 | 条件允许 | 条件允许 | 拒绝 | `<module>:<entity>:transition` | 当前数据范围 |  | 需结合状态表 |
+| 关闭/归档 | 允许 | 条件允许 | 拒绝 | 条件允许 | 拒绝 | `<module>:<entity>:close` | 当前数据范围 |  | 终态动作 |
+| 删除记录 | 条件允许 | 拒绝 | 拒绝 | 拒绝 | 拒绝 | `<module>:<entity>:delete` | 管理范围 |  | 高危操作 |
+| 查看审计日志 | 允许 | 条件允许 | 条件允许 | 条件允许 | 拒绝 | `<module>:<entity>:audit` | 当前数据范围 |  |  |
+| 查看统计看板 | 允许 | 条件允许 | 条件允许 | 条件允许 | 条件允许 | `<module>:<entity>:dashboard` | 按角色过滤 |  |  |
+| 导出数据 | 条件允许 | 条件允许 | 拒绝 | 拒绝 | 拒绝 | `<module>:<entity>:export` | 管理范围或授权范围 |  | 需脱敏 |
@@ -1,18 +1,20 @@
 # RBAC 权限矩阵生成 Prompt

 ```text
-请基于 JeecgBoot 工单模块设计 RBAC 权限矩阵。
+请基于目标业务模块设计 RBAC 权限矩阵。

 输入材料：
- 工单模块需求：<粘贴需求>
- 角色列表：管理员、工单负责人、研发处理人、测试验证人、只读观察者
- 功能点：查看列表、查看详情、新建、编辑、指派、状态流转、关闭、删除、查看审计、查看看板、导出
- 项目依据：<粘贴权限、路由、菜单相关路径>
+- 模块名称：<填写>
+- 业务对象：<填写，例如订单、客户、申请、任务>
+- 需求说明或用户故事：<粘贴>
+- 角色列表：<粘贴目标项目真实角色>
+- 功能点：<粘贴页面、按钮、接口、数据动作>
+- 项目依据：<粘贴权限、路由、菜单、接口、后端校验相关路径>

 输出要求：
-1. 先列事实依据：JeecgBoot 权限、菜单、动态路由相关路径。
+1. 先列事实依据：权限、菜单、动态路由、接口、后端校验相关路径。
 2. 输出 RBAC 权限矩阵：角色 x 功能点，允许、拒绝、条件允许。
-3. 输出权限字符建议，必须标注为建议。
+3. 输出权限字符建议，并标注哪些是事实、哪些是建议。
 4. 输出页面级、按钮级、接口级、数据范围四层控制。
 5. 输出不确定点：哪些权限必须业务方确认。
 6. 输出验收方式：如何证明权限确实生效。
@@ -21,5 +23,5 @@
 - 不要直接改代码。
 - 不要把前端按钮隐藏当作安全边界。
 - 所有结论必须区分事实、推断、建议。
+- 不要把示例模块、示例角色或示例权限字符当成目标项目事实。
 ```
-
@@ -1,18 +1,19 @@
-# 工单审计日志 SOP
+# <模块名称> 审计日志 SOP

 ## 记录原则

-所有会改变工单关键业务状态、负责人、可见性或结论的动作都必须记录审计日志。
+所有会改变目标业务对象关键状态、负责人/处理人、可见性、金额、结论或对外结果的动作都必须记录审计日志。

 ## 审计字段

 | 字段 | 含义 | 示例 |
 | --- | --- | --- |
-| ticket_id | 工单 ID | WO-001 |
+| target_type | 业务对象类型 | order / customer / request |
+| target_id | 业务对象 ID | 100001 |
 | actor_id | 操作人 ID | 1001 |
 | actor_name | 操作人名称 | zhangsan |
-| action | 操作类型 | ASSIGN |
-| field_name | 变更字段 | assignee |
+| action | 操作类型 | ASSIGN / APPROVE / CLOSE |
+| field_name | 变更字段 | status / owner_id / amount |
 | old_value | 旧值 | lisi |
 | new_value | 新值 | wangwu |
 | source | 来源 | web |
@@ -23,12 +24,13 @@

 | 动作 | 写入时机 | oldValue | newValue | 验收 |
 | --- | --- | --- | --- | --- |
-| 创建工单 | 创建成功后 | 空 | 工单摘要 | 审计列表可见 |
+| 创建记录 | 创建成功后 | 空 | 业务摘要 | 审计列表可见 |
 | 编辑字段 | 保存成功后 | 修改前字段 | 修改后字段 | 字段前后值正确 |
-| 指派负责人 | 指派成功后 | 原负责人 | 新负责人 | 审计记录负责人变化 |
+| 分配/转交 | 分配成功后 | 原处理人 | 新处理人 | 审计记录处理人变化 |
 | 状态流转 | 状态变更成功后 | 原状态 | 新状态 | 审计记录状态变化 |
-| 评论新增 | 评论保存后 | 空 | 评论摘要 | 审计记录评论动作 |
-| 关闭工单 | 关闭成功后 | 原状态 | 已关闭 | 审计记录关闭时间 |
+| 结论/审核 | 结论保存成功后 | 原结论 | 新结论 | 审计记录结论变化 |
+| 评论/备注新增 | 保存成功后 | 空 | 摘要或脱敏内容 | 审计记录评论动作 |
+| 关闭/归档 | 操作成功后 | 原状态 | 目标终态 | 审计记录关闭或归档时间 |

 ## 验收方式

@@ -37,4 +39,3 @@
 3. 敏感字段已脱敏。
 4. 操作失败不写成功审计。
 5. 多步写入失败时审计和业务数据保持一致。
-
@@ -2,12 +2,11 @@

 | 检查项 | 通过标准 | 结果 |
 | --- | --- | --- |
-| 创建记录 | 创建工单后能查询审计记录 |  |
+| 创建记录 | 创建业务记录后能查询审计记录 |  |
 | 字段变更 | 编辑关键字段记录 oldValue/newValue |  |
-| 指派记录 | 指派负责人记录原负责人和新负责人 |  |
+| 分配记录 | 分配或转交记录原处理人和新处理人 |  |
 | 状态记录 | 状态流转记录原状态和新状态 |  |
 | 操作人 | actor_id 和 actor_name 可追溯 |  |
 | 来源 | source 或 request_id 可追溯 |  |
 | 脱敏 | 敏感字段不明文进入审计 |  |
 | 失败处理 | 操作失败不写成功审计 |  |
-
@@ -3,11 +3,10 @@
 | 异常态 | 必须验证 | 结果 |
 | --- | --- | --- |
 | 空列表 | 页面显示空状态，不报错 |  |
-| 详情不存在 | 提示工单不存在，页面不崩溃 |  |
+| 详情不存在 | 提示记录不存在，页面不崩溃 |  |
 | 权限不足 | 前端提示或隐藏，后端拒绝 |  |
 | 非法状态 | 返回非法流转，状态不变 |  |
 | 重复提交 | 只成功一次，只写一条有效审计 |  |
 | 参数缺失 | 返回参数错误，业务数据不变 |  |
 | 并发修改 | 拒绝覆盖或提示刷新 |  |
 | 看板无数据 | 图表显示空态，不显示假数据 |  |
-
@@ -1,13 +1,13 @@
-# 工单异常态清单
-
-| 场景 | 触发条件 | 前端表现 | 后端响应 | 验收 |
-| --- | --- | --- | --- | --- |
-| 权限不足 | 无权限操作 | 按钮不可见或提示无权限 | 403 或业务拒绝 | 不完成操作 |
-| 工单不存在 | 传入错误 ID | 显示不存在 | 404 或业务错误 | 页面不崩溃 |
-| 非法状态流转 | closed -> processing | 提示非法流转 | 状态不变 | 数据状态不变 |
-| 重复提交 | 连续点击提交 | 按钮 loading/禁用 | 只处理一次 | 只生成一条有效审计 |
-| 参数缺失 | 驳回缺少原因 | 表单校验提示 | 参数错误 | 不改变状态 |
-| 并发修改 | 数据版本过期 | 提示刷新 | 拒绝覆盖 | 旧数据不覆盖新数据 |
-| 看板无数据 | 无匹配记录 | 空状态 | 返回空集合 | 页面不报错 |
-| 审计日志为空 | 无审计记录 | 空状态 | 返回空集合 | 页面不报错 |
+# <模块名称> 异常态清单

+| 场景 | 触发条件 | 前端表现 | 后端响应 | 验收 | 来源证据 |
+| --- | --- | --- | --- | --- | --- |
+| 权限不足 | 无权限操作敏感功能 | 按钮不可见或提示无权限 | 403 或业务拒绝 | 不完成操作 |  |
+| 记录不存在 | 传入错误 ID | 显示不存在 | 404 或业务错误 | 页面不崩溃 |  |
+| 非法状态流转 | `<状态A> -> <状态C>` 不在状态表 | 提示非法流转 | 状态不变 | 数据状态不变 |  |
+| 重复提交 | 连续点击提交或重复请求 | 按钮 loading/禁用 | 只处理一次 | 只生成一条有效审计 |  |
+| 参数缺失 | 必填原因、金额、范围或结论缺失 | 表单校验提示 | 参数错误 | 不改变业务数据 |  |
+| 并发修改 | 数据版本过期 | 提示刷新 | 拒绝覆盖或合并冲突 | 旧数据不覆盖新数据 |  |
+| 统计无数据 | 无匹配记录 | 空状态 | 返回 0 或空集合 | 页面不显示假数据 |  |
+| 审计日志为空 | 无审计记录 | 空状态 | 返回空集合 | 页面不报错 |  |
+| 下游服务失败 | 外部接口超时或失败 | 错误提示且可重试 | 失败响应可追踪 | 不写成功审计 |  |
@@ -1,24 +1,31 @@
 # 异常态补齐 Prompt

 ```text
-请基于 JeecgBoot 工单模块，列出状态流转、指派、删除、查询详情、审计日志、看板相关的异常态和防御性逻辑。
+请基于目标业务模块，列出状态流转、分配/转交、删除/作废、查询详情、审计日志、统计看板相关的异常态和防御性逻辑。
+
+输入材料：
+- 模块名称：<填写>
+- 业务对象：<填写>
+- 角色与权限：<粘贴>
+- 状态流转表：<粘贴>
+- 接口契约或页面说明：<粘贴>

 输出表格：
 场景 | 触发条件 | 前端表现 | 后端响应 | 用户提示 | 测试点 | 验收

 必须覆盖：
 - 权限不足
- 工单不存在
+- 记录不存在
 - 非法状态流转
 - 重复提交
 - 参数缺失
 - 并发修改
- 看板无数据
+- 统计无数据
 - 审计日志为空
+- 下游服务失败

 约束：
 - 先列异常态，不要直接改代码。
 - 给出每个异常态的验收步骤。
 - 标注事实、推断、建议和不确定点。
 ```
-
@@ -2,11 +2,10 @@

 | 检查项 | 通过标准 | 结果 |
 | --- | --- | --- |
-| 菜单权限 | 工单菜单只对授权角色可见 |  |
-| 按钮权限 | 新增、编辑、删除、指派、状态按钮按权限显示 |  |
+| 菜单权限 | 目标模块菜单只对授权角色可见 |  |
+| 按钮权限 | 新增、编辑、删除、分配、状态按钮按权限显示 |  |
 | 接口权限 | 无权限账号直接请求敏感接口失败 |  |
-| 数据权限 | 普通用户只能看到授权范围内工单 |  |
+| 数据权限 | 普通用户只能看到授权范围内数据 |  |
 | 权限字符 | 前端按钮、菜单配置、后端接口命名一致 |  |
 | 审计 | 权限敏感操作成功后有审计记录 |  |
-| 反例验证 | 无权限账号不能绕过前端执行删除/指派 |  |
-
+| 反例验证 | 无权限账号不能绕过前端执行删除/分配 |  |
@@ -1,12 +1,11 @@
-# 工单权限控制方案
+# <模块名称> 权限控制方案

 | 操作 | 前端入口 | 权限字符 | 后端接口 | 后端校验 | 数据权限 | 验收 |
 | --- | --- | --- | --- | --- | --- | --- |
-| 新增工单 | 新增按钮 | work:order:add | /workOrder/add | 权限注解 | 无 | 无权限账号看不到按钮且直接请求失败 |
-| 编辑工单 | 编辑按钮 | work:order:edit | /workOrder/edit | 权限注解 + 状态校验 | 负责人/创建人范围 | 越权账号返回 403 或业务拒绝 |
-| 指派负责人 | 指派按钮 | work:order:assign | /workOrder/assign | 权限注解 | 管理员/负责人范围 | 普通研发无法指派他人 |
-| 状态流转 | 状态按钮 | work:order:transition | /workOrder/transition | 权限注解 + 状态机校验 | 相关工单范围 | 非法流转失败 |
-| 删除工单 | 删除按钮 | work:order:delete | /workOrder/delete | 权限注解 | 管理员范围 | 非管理员返回 403 |
-| 查看审计 | 审计页签 | work:order:audit | /workOrder/audit/list | 权限注解 | 相关工单范围 | 无权限不可见且接口拒绝 |
-| 看板 | 看板菜单 | work:order:dashboard | /workOrder/dashboard | 权限注解 | 数据范围过滤 | 不同角色数据范围不同 |
-
+| 新增记录 | 新增按钮 | `<module>:<entity>:add` | `<POST /api/entity>` | 权限注解或统一鉴权 | 通常无数据范围 | 无权限账号看不到按钮且直接请求失败 |
+| 编辑记录 | 编辑按钮 | `<module>:<entity>:edit` | `<PUT /api/entity/{id}>` | 权限校验 + 状态校验 | 创建人/负责人/授权范围 | 越权账号返回 403 或业务拒绝 |
+| 分配/转交 | 分配按钮 | `<module>:<entity>:assign` | `<POST /api/entity/{id}/assign>` | 权限校验 | 管理范围或当前授权范围 | 未授权角色无法分配给他人 |
+| 状态流转 | 状态按钮 | `<module>:<entity>:transition` | `<POST /api/entity/{id}/transition>` | 权限校验 + 状态机校验 | 当前授权范围 | 非法流转失败且状态不变 |
+| 删除/作废 | 删除或作废按钮 | `<module>:<entity>:delete` | `<DELETE /api/entity/{id}>` | 权限校验 + 风险校验 | 管理范围 | 非授权角色返回 403 或业务拒绝 |
+| 查看审计 | 审计页签 | `<module>:<entity>:audit` | `<GET /api/entity/{id}/audit>` | 权限校验 | 当前授权范围 | 无权限不可见且接口拒绝 |
+| 统计看板 | 看板菜单 | `<module>:<entity>:dashboard` | `<GET /api/entity/dashboard>` | 权限校验 | 数据范围过滤 | 不同角色返回授权范围内统计 |
@@ -1,9 +1,11 @@
 # 权限控制方案生成 Prompt

 ```text
-请基于工单模块 RBAC 权限矩阵，生成 JeecgBoot 权限控制方案。
+请基于目标业务模块 RBAC 权限矩阵，生成权限控制方案。

 输入材料：
+- 模块名称：<填写>
+- 业务对象：<填写>
 - RBAC 权限矩阵：<粘贴>
 - 接口契约表：<粘贴>
 - 当前项目权限相关路径：<粘贴>
@@ -20,5 +22,5 @@
 - 不要直接改代码。
 - 后端接口权限必须单独说明。
 - 每个敏感操作必须有验收方式。
+- 权限字符、接口路径和角色名称必须来自输入材料；没有依据时标注为建议。
 ```
-
@@ -6,7 +6,6 @@
 | 合法流转 | 状态流转表中的合法路径可执行 |  |
 | 非法流转 | 非法路径被拒绝且状态不变 |  |
 | 角色限制 | 不同角色只能执行被授权动作 |  |
-| 前置条件 | 驳回原因、关闭条件、负责人等校验完整 |  |
+| 前置条件 | 驳回原因、关闭条件、处理人、审批意见等校验完整 |  |
 | 审计日志 | 每次成功流转写审计 |  |
 | 重复提交 | 重复点击不会产生重复有效流转 |  |
-
@@ -1,22 +1,21 @@
-# 工单状态流转表
+# <模块名称> 状态流转表

-| 当前状态 | 动作 | 目标状态 | 允许角色 | 前置条件 | 后置动作 | 验收 |
-| --- | --- | --- | --- | --- | --- | --- |
-| 新建 | 指派 | 新建 | 管理员/负责人 | 工单未关闭 | 写审计日志 | 指派人变化且状态不变 |
-| 新建 | 开始处理 | 处理中 | 研发处理人/负责人 | 已指派处理人 | 写审计日志 | 状态变为处理中 |
-| 处理中 | 提交验证 | 待验证 | 研发处理人/负责人 | 处理说明不为空 | 写审计日志 | 状态变为待验证 |
-| 待验证 | 验证通过 | 已关闭 | 测试验证人/负责人 | 验证结果通过 | 写审计日志和关闭时间 | 状态变为已关闭 |
-| 待验证 | 验证驳回 | 已驳回 | 测试验证人/负责人 | 驳回原因不为空 | 写审计日志 | 状态变为已驳回 |
-| 已驳回 | 重新处理 | 处理中 | 研发处理人/负责人 | 驳回原因已读 | 写审计日志 | 状态变为处理中 |
-| 已关闭 | 重新打开 | 新建 | 管理员 | 重开原因不为空 | 写审计日志 | 状态变为新建 |
+| 当前状态 | 动作 | 目标状态 | 允许角色 | 前置条件 | 后置动作 | 验收 | 来源证据 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| 草稿/新建 | 提交 | 待处理/待审核 | 创建人/提交人 | 必填字段完整 | 写审计日志 | 状态变为目标状态 |  |
+| 待处理/待审核 | 分配/领取 | 处理中 | 管理员/负责人/处理人 | 处理人存在且有权限 | 写审计日志 | 处理人变化且状态正确 |  |
+| 处理中 | 提交结果 | 待确认/待复核 | 处理人/负责人 | 处理说明或结果不为空 | 写审计日志 | 状态变为待确认 |  |
+| 待确认/待复核 | 通过 | 已完成/已关闭 | 审核人/负责人 | 审核结论通过 | 写审计日志和完成时间 | 状态进入终态 |  |
+| 待确认/待复核 | 驳回 | 已驳回/待修改 | 审核人/负责人 | 驳回原因不为空 | 写审计日志 | 状态变为驳回态 |  |
+| 已驳回/待修改 | 重新提交 | 待处理/待审核 | 创建人/处理人 | 修改说明不为空 | 写审计日志 | 回到处理链路 |  |
+| 已完成/已关闭 | 重新打开 | 草稿/新建/处理中 | 管理员/负责人 | 重开原因不为空 | 写审计日志 | 状态按规则回退 |  |

 ## 非法流转清单

 | 当前状态 | 尝试动作 | 问题 | 系统响应 | 验收 |
 | --- | --- | --- | --- | --- |
-| 已关闭 | 开始处理 | 关闭后不能直接处理 | 返回非法流转 | 状态不变 |
-| 新建 | 验证通过 | 未处理不能验证 | 返回非法流转 | 状态不变 |
-| 待验证 | 提交验证 | 重复提交验证 | 返回非法流转 | 只保留原状态 |
-| 处理中 | 验证通过 | 未进入待验证 | 返回非法流转 | 状态不变 |
-| 已驳回 | 关闭 | 驳回后不能直接关闭 | 返回非法流转 | 状态不变 |
-
+| 已完成/已关闭 | 直接处理 | 终态不能直接进入处理中 | 返回非法流转 | 状态不变 |
+| 草稿/新建 | 直接通过 | 未提交或未处理不能通过 | 返回非法流转 | 状态不变 |
+| 待确认/待复核 | 重复提交结果 | 重复动作不应再次生效 | 返回非法流转或幂等结果 | 只保留原状态 |
+| 处理中 | 直接通过 | 未进入确认/复核节点 | 返回非法流转 | 状态不变 |
+| 已驳回/待修改 | 直接关闭 | 驳回后不能绕过修改或确认 | 返回非法流转 | 状态不变 |
@@ -1,23 +1,22 @@
 # 状态流转设计 Prompt

 ```text
-请为 JeecgBoot 工单模块设计状态流转规则。
+请为目标业务模块设计状态流转规则。

-状态候选：
- 新建
+输入材料：
+- 模块名称：<填写>
+- 业务对象：<填写>
+- 角色列表：<粘贴>
+- 当前需求或已有状态枚举：<粘贴>
+- 关键动作：<粘贴>
+
+可参考但必须按项目替换的状态类型：
+- 草稿/新建
+- 待处理/待审核
 - 处理中
- 待验证
- 已关闭
- 已驳回
-
-动作候选：
- 指派
- 开始处理
- 提交验证
- 验证通过
- 验证驳回
- 关闭
- 重新打开
+- 待确认/待复核
+- 已完成/已关闭
+- 已驳回/待修改

 输出要求：
 1. 状态流转表：当前状态、动作、目标状态、允许角色、前置条件、后置动作、验收。
@@ -28,7 +27,7 @@

 约束：
 - 先出状态表，不要直接写 if else。
- 已关闭、越权、缺少说明、重复提交必须覆盖。
+- 终态、越权、缺少说明、重复提交必须覆盖。
 - 每条规则必须有验收方式。
+- 没有需求依据的状态或动作必须标注为建议或待确认。
 ```
-
@@ -1,13 +1,12 @@
-# 工单看板指标字典
+# <模块名称> 看板指标字典

 | 指标 | 含义 | 口径 | 数据来源 | 展示方式 | 权限 | 验收 |
 | --- | --- | --- | --- | --- | --- | --- |
-| 工单总数 | 当前筛选范围内工单数量 | count(ticket_id) | 工单表 | 指标卡 | 看板权限 | 与列表同条件数量一致 |
-| 未关闭工单数 | 状态不是已关闭的数量 | status != closed | 工单表 | 指标卡 | 看板权限 | 过滤状态验证 |
-| 平均关闭周期 | 从创建到关闭平均耗时 | avg(close_time - create_time) | 工单表 | 指标卡/趋势 | 看板权限 | 抽样计算一致 |
-| 按优先级分布 | 高中低优先级数量 | group by priority | 工单表/字典 | 饼图/柱状图 | 看板权限 | 分组总和等于总数 |
-| 按类型分布 | 缺陷/需求/支持数量 | group by type | 工单表/字典 | 柱状图 | 看板权限 | 分组总和等于总数 |
-| 缺陷趋势 | 按日期统计缺陷工单 | type=bug group by date | 工单表 | 折线图 | 看板权限 | 日期范围正确 |
-| 逾期工单数 | 超过 SLA 未关闭数量 | due_time < now and status != closed | 工单表 | 指标卡 | 看板权限 | SLA 口径明确 |
-| 人员处理负载 | 按负责人统计未关闭数量 | group by assignee | 工单表 | 排行榜 | 管理员/负责人 | 数据范围正确 |
-
+| 记录总数 | 当前筛选范围内业务记录数量 | count(target_id) | 主业务表 | 指标卡 | 看板权限 | 与列表同条件数量一致 |
+| 未完成数量 | 状态不在终态集合内的数量 | status not in `<terminal_statuses>` | 主业务表 | 指标卡 | 看板权限 | 过滤状态验证 |
+| 平均完成周期 | 从开始时间到完成时间的平均耗时 | avg(completed_at - started_at) | 主业务表 | 指标卡/趋势 | 看板权限 | 抽样计算一致 |
+| 按状态分布 | 各状态记录数量 | group by status | 主业务表/状态字典 | 饼图/柱状图 | 看板权限 | 分组总和等于总数 |
+| 按类型分布 | 各业务类型数量 | group by type | 主业务表/字典 | 柱状图 | 看板权限 | 分组总和等于总数 |
+| 趋势指标 | 按日期统计新增、完成或失败数量 | group by date_field | 主业务表 | 折线图 | 看板权限 | 日期范围正确 |
+| 逾期数量 | 超过 SLA 且未完成的数量 | due_at < now and status not in `<terminal_statuses>` | 主业务表 | 指标卡 | 看板权限 | SLA 口径明确 |
+| 人员处理负载 | 按负责人/处理人统计未完成数量 | group by owner_id / assignee_id | 主业务表 | 排行榜 | 管理员/负责人 | 数据范围正确 |
@@ -1,16 +1,23 @@
 # 看板指标设计 Prompt

 ```text
-请为 JeecgBoot 工单模块设计研发效能看板指标。
+请为目标业务模块设计业务看板指标。

-指标方向：
- 工单总数
- 未关闭工单数
- 平均关闭周期
- 按优先级分布
+输入材料：
+- 模块名称：<填写>
+- 业务对象：<填写>
+- 角色与数据范围：<粘贴>
+- 状态枚举与时间字段：<粘贴>
+- 列表筛选条件：<粘贴>
+
+指标方向可参考：
+- 记录总数
+- 未完成数量
+- 平均完成周期
+- 按状态分布
 - 按类型分布
- 缺陷趋势
- 逾期工单数
+- 趋势指标
+- 逾期数量
 - 人员处理负载

 输出要求：
@@ -24,5 +31,5 @@
 - 每个指标必须可计算。
 - 不要只写页面 UI。
 - 指标口径不清必须写入不确定点。
+- 不要把示例指标名直接当成目标项目事实。
 ```
-
@@ -1,9 +1,11 @@
 # 看板接口验收 Prompt

 ```text
-请为 JeecgBoot 工单看板统计接口生成验收记录。
+请为目标业务模块看板统计接口生成验收记录。

 输入材料：
+- 模块名称：<填写>
+- 业务对象：<填写>
 - 看板指标字典：<粘贴>
 - 看板接口契约：<粘贴>
 - 权限矩阵：<粘贴>
@@ -23,5 +25,5 @@
 约束：
 - 不要只说“接口正常”。
 - 每个指标至少有一个验收动作。
+- 每个验收动作都要说明账号/角色、请求参数、预期、实际和证据。
 ```
-
@@ -2,11 +2,10 @@

 | 验收项 | 请求条件 | 通过标准 | 结果 |
 | --- | --- | --- | --- |
-| 默认查询 | 管理员默认条件 | 返回完整指标 |  |
+| 默认查询 | 管理员或授权角色默认条件 | 返回完整指标 |  |
 | 时间过滤 | 指定 start/end | 只统计时间范围内数据 |  |
-| 类型过滤 | 指定工单类型 | 只统计对应类型 |  |
+| 类型过滤 | 指定业务类型 | 只统计对应类型 |  |
 | 空数据 | 无匹配条件 | 返回 0 或空集合 |  |
 | 无权限 | 未授权账号 | 返回 403 或业务拒绝 |  |
 | 数据范围 | 普通角色 | 只返回授权范围 |  |
 | 指标一致性 | 固定样例数据 | 与手工计算一致 |  |
-
@@ -1,11 +1,10 @@
-# 工单看板接口验收记录
+# <模块名称> 看板接口验收记录

 | 验收项 | 账号/条件 | 请求参数 | 预期 | 实际 | 证据 | 结论 |
 | --- | --- | --- | --- | --- | --- | --- |
-| 工单总数 | 管理员 | 默认筛选 | 返回总数 |  |  |  |
-| 空数据 | 管理员 + 无匹配条件 | 不存在的日期范围 | 返回空集合或 0 |  |  |  |
-| 无权限 | 只读外角色 | 默认筛选 | 返回 403 或业务拒绝 |  |  |  |
-| 时间过滤 | 管理员 | start/end | 只统计范围内数据 |  |  |  |
-| 数据范围 | 普通研发 | 默认筛选 | 只返回本人相关数据 |  |  |  |
-| 指标口径 | 管理员 | 固定样例数据 | 与手工计算一致 |  |  |  |
-
+| 记录总数 | 管理员或授权角色 | 默认筛选 | 返回总数 |  |  |  |
+| 空数据 | 授权角色 + 无匹配条件 | 不存在的日期范围或筛选条件 | 返回空集合或 0 |  |  |  |
+| 无权限 | 未授权角色 | 默认筛选 | 返回 403 或业务拒绝 |  |  |  |
+| 时间过滤 | 授权角色 | start/end | 只统计范围内数据 |  |  |  |
+| 数据范围 | 普通业务角色 | 默认筛选 | 只返回本人或授权范围内数据 |  |  |  |
+| 指标口径 | 授权角色 | 固定样例数据 | 与手工计算一致 |  |  |  |