# 规则详情页与疑点描述模板 - 页面改动说明 ## 1. 文档目的 本文档用于记录本次“规则详情页与疑点描述模板”功能在原型 Demo 中涉及的页面范围、具体改动点与交互变化，便于后续继续讨论和复用。 --- ## 2. 本次改动概述 本次优化把普通规则纳入统一的 `疑点描述` 展示能力中，主要体现为： - 在普通规则详情页新增第三个 Tab：`疑点描述` - 在主疑点明细页新增统一字段 `疑点描述` - AI规则保留原有描述逻辑，普通规则通过模板生成描述 --- ## 3. 涉及页面范围 本次实际改动的页面文件如下： - `规则详情.html` - `疑点派发-疑点详情.html` - `疑点处置-疑点详情.html` 本次新增的说明文档如下： - `规则详情页与疑点描述模板-PRD.md` - `规则详情页与疑点描述模板-页面改动说明.md` --- ## 4. 各页面改动说明 ## 4.1 规则详情.html ### 改动类型 - 规则 mock 数据增强 - 详情页 Tab 结构增强 - 模板编辑与校验逻辑新增 ### 具体改动 #### 4.1.1 增加普通 / AI 规则区分 为规则 mock 数据明确区分： - 普通规则 - AI规则 并补充： - 上线时间 - 模板配置数据 - 疑点字段变量集合 #### 4.1.2 新增第三个 Tab：`疑点描述` 在规则详情页中新增第三个 Tab： - 疑点描述 该 Tab 内包含： - 顶部标题 `疑点描述模板` - 说明文案 - 模板输入框（不再重复显示第二个“疑点描述模板”小标题） - 规则/场景相关变量 - 疑点字段相关变量 - 验证状态 - `立即验证` - `保存` - 变量展示方式参考 `消息模板管理.html` - 变量展示方式参考 `消息模板管理.html` - 验证状态提示参考 `消息模板管理.html` - 验证通过后不再额外显示“验证通过，所有变量均可匹配”文案 #### 4.1.3 权限与状态控制 按规则类型、上线状态、用户角色控制显示效果： - 普通规则 + 已上线 + 管理员：可编辑 - 普通规则 + 已上线 + 非管理员：只读 - 普通规则 + 未上线：显示但禁用 - AI规则：不显示该 Tab #### 4.1.4 新增模板校验逻辑 支持： - 识别 `${fieldName}` 占位符 - 校验变量是否合法 - 显示 `已验证` / `未验证` 状态 - 模板修改后自动重置为未验证 #### 4.1.5 支持本地保存 原型中通过浏览器本地存储保存普通规则模板内容和验证状态，用于模拟配置结果。 --- ## 4.2 疑点派发-疑点详情.html ### 改动类型 - 表格结构增强 - 展示字段增强 ### 具体改动 #### 4.2.1 新增“疑点描述”列 在疑点列表中新增统一字段： - `疑点描述` 位置： - 疑点编号后 - 原始业务字段前 #### 4.2.2 补充普通规则描述示例数据 为当前原型中的普通规则疑点记录补充了示例描述文案，用于展示模板生成后的效果。 #### 4.2.3 调整搜索口径 由于新增了疑点描述列，页面中原有的“业务字段”搜索逻辑同步调整，避免把新列误当作原始业务字段范围的一部分。 --- ## 4.3 疑点处置-疑点详情.html ### 改动类型 - 表格结构增强 - 展示字段增强 ### 具体改动 #### 4.3.1 新增“疑点描述”列 和派发页一致，在疑点编号后新增： - `疑点描述` #### 4.3.2 补充普通规则描述示例数据 为当前原型中的普通规则疑点记录补充了示例描述文案。 #### 4.3.3 调整搜索口径 同步调整“业务字段”搜索逻辑，避免把疑点描述列混入原始业务字段搜索范围。 --- ## 5. 交互变化总结 ## 5.1 原流程 - AI规则疑点能够直接看到描述 - 普通规则疑点只能先看原始字段，再自行判断问题 - 普通规则详情页没有独立的疑点描述配置区 ## 5.2 新流程 - 管理员在普通规则详情页的 `疑点描述` Tab 中配置模板 - 系统对模板进行变量校验 - 普通规则命中后生成疑点描述 - 疑点列表中统一展示 `疑点描述` --- ## 6. 数据与权限口径说明 ### 6.1 模板语法 统一使用： - `${fieldName}` ### 6.2 变量分类 沿用消息模板管理页面的分类思路： - 规则/场景相关变量 - 疑点字段相关变量 ### 6.3 权限口径 - 管理员：可编辑、可验证、可保存 - 非管理员：只读可见 ### 6.4 上线前限制 - 未上线普通规则显示模板区，但不可编辑 ### 6.5 历史数据口径 - 历史普通规则疑点支持脚本回填 - 无模板时允许使用兜底文案 --- ## 7. 验收检查点 ### 7.1 规则详情页 - 普通规则详情页中出现第三个 Tab：`疑点描述` - AI规则不显示该 Tab - 非管理员只读查看 - 未上线规则显示但禁用 - 模板校验可用 ### 7.2 疑点列表页 - 派发页出现 `疑点描述` 列 - 处置页出现 `疑点描述` 列 - 示例数据能清晰表达普通规则命中的原因 ### 7.3 数据口径 - 新疑点生成时可生成描述并落库 - 历史普通规则疑点允许脚本回填 --- ## 8. 一句话总结 本次页面改动把普通规则也纳入统一的“疑点描述”展示体系，通过规则详情页配置模板、主疑点明细页展示描述，让用户能够更快理解普通规则命中的具体问题。