# 规则详情页与疑点描述模板 PRD ## 1. 文档信息 - 文档名称：规则详情页与疑点描述模板 PRD - 所属模块：全知平台 / 风控模块 / 风险规则 / 风险疑点 - 文档类型：功能优化 PRD --- ## 2. 背景与问题 当前规则分为两类： - AI规则 - 普通规则 在疑点列表中： - AI规则已有“疑点描述”字段，由 AI 生成，用于说明为什么该数据被识别为疑点 - 普通规则没有统一的“疑点描述”字段，只展示原始业务字段，用户需要自行判断问题 这导致普通规则疑点的理解成本较高，不利于用户快速判断这条数据究竟存在什么问题。 --- ## 3. 优化目标 本次优化目标如下： - 统一页面上的“疑点描述”能力 - AI规则继续沿用 AI 生成疑点描述 - 普通规则通过“疑点描述模板 + 变量填充”生成疑点描述 - 在规则详情页中增加第三个 Tab：`疑点描述` - 在疑点列表中统一展示 `疑点描述` 字段 --- ## 4. 本次范围 ### 4.1 本次要做 - 在普通规则详情页新增第三个 Tab：`疑点描述` - 支持变量插入 - 支持模板校验 - 支持验证状态展示 - 在主疑点明细页中新增统一字段 `疑点描述` - 历史普通规则疑点支持脚本回填 ### 4.2 本次不做 - 模板版本管理 - 模板变更历史 - 模板审批流程 - 疑点描述搜索/筛选 - 导出联动 - 所有疑点列表页一次性全覆盖 --- ## 5. 页面范围 本次功能改进作用于以下页面： - `规则详情.html` - `疑点派发-疑点详情.html` - `疑点处置-疑点详情.html` --- ## 6. 功能方案 ## 6.1 统一字段名 页面上统一展示字段名： - **疑点描述** ### 规则口径 - AI规则：继续使用 AI 生成的疑点描述 - 普通规则：使用疑点描述模板生成描述 --- ## 6.2 模板配置入口 模板配置入口放在： - `我的规则` - `已入库` - 进入普通规则详情页后，在 `规则详情.html` 的第三个 Tab `疑点描述` 中配置 本次不在以下位置配置： - 公共规则库 - 未入库规则 - 风险场景配置页 --- ## 6.3 AI规则与普通规则的差异 ### AI规则 - 不显示 `疑点描述` Tab - 疑点描述仍由 AI 生成 ### 普通规则 - 显示 `疑点描述` Tab - 使用模板 + 变量填充生成疑点描述 --- ## 6.4 模板语法 占位符语法统一使用： - `${fieldName}` 示例： - `报销单 ${billNo} 的伙食补助人数为 ${subsidyPeopleCount} 人，超过标准人数 ${standardPeopleCount} 人。` --- ## 6.5 变量分类 变量分类和取值体系参考消息模板管理页面中的变量设计，分为两类： ### A. 规则/场景相关变量 例如： - `${ruleName}` - `${sceneName}` - `${businessDomainName}` - `${riskLevel}` ### B. 疑点字段相关变量 来源于当前规则的疑点字段集合，例如： - `${billNo}` - `${contractAmount}` - `${subsidyPeopleCount}` - `${standardPeopleCount}` 变量展示方式参考 `消息模板管理.html` 中“编辑消息模板”弹窗的变量区： - 规则/场景相关变量直接展示 - 疑点字段相关变量通过“选择疑点字段”按钮 + 下拉搜索方式展示 --- ## 6.6 模板校验 第一阶段即支持模板校验。 ### 校验目标 校验模板中所有 `${fieldName}` 是否都能在当前规则上下文中找到合法变量。 ### 校验结果 - 验证通过：状态更新为 `已验证` - 验证失败：提示不合法变量列表 验证状态展示和提示方式参考 `消息模板管理.html`： - 保留 `验证状态` - 保留 `立即验证` - 保留引导提示文案 - 失败提示采用同类样式表现 - 验证通过后不再额外显示“验证通过，所有变量均可匹配”文案 ### 状态变化 - 模板一旦修改，验证状态自动重置为 `未验证` --- ## 6.7 保存策略 模板支持保存，但遵循以下规则： - 可以保存未验证模板 - 保存后仍保留当前验证状态 - 如果模板内容修改后未重新验证，则状态应显示为 `未验证` --- ## 6.8 权限与编辑时机 ### 仅管理员可编辑 第一阶段中： - 管理员：可编辑、可验证、可保存 - 非管理员：只读可见，不可编辑 ### 规则上线后才允许编辑 原因： - 规则未上线时，疑点字段尚未最终确定 因此： - 已上线普通规则：允许管理员编辑 - 未上线普通规则：模板区显示但禁用，并提示原因 提示文案建议： - `规则未上线，疑点字段尚未确定，暂不支持编辑疑点描述模板。` --- ## 7. 数据生成口径 ## 7.1 新疑点生成 当普通规则命中疑点时： 1. 读取规则的疑点描述模板 2. 替换模板中的变量 3. 生成最终疑点描述 4. 将疑点描述写入疑点记录并落库 AI规则保持原有逻辑不变。 --- ## 7.2 历史数据回填 历史普通规则疑点由开发脚本回填。 ### 回填优先级 1. 有模板 → 按模板生成并回填 2. 无模板 → 使用兜底文案回填 ### 兜底文案建议 - `命中规则：${ruleName}` --- ## 8. 页面展示方案 ## 8.1 展示页面 第一阶段先覆盖两个主疑点明细页： - `疑点派发-疑点详情.html` - `疑点处置-疑点详情.html` ## 8.2 展示字段位置 建议位置： - 疑点编号后 - 原始业务字段前 ## 8.3 展示方式 - 默认展示 1～2 行 - 超长省略 - 支持悬停查看全文 --- ## 9. 验收标准 ### 9.1 规则详情页 - 普通规则详情页出现第三个 Tab：`疑点描述` - AI规则不显示该 Tab - 未上线普通规则显示但禁用 - 非管理员只读查看 - 支持变量插入、立即验证、保存 ### 9.2 疑点列表页 - `疑点派发-疑点详情.html` 中出现 `疑点描述` 字段 - `疑点处置-疑点详情.html` 中出现 `疑点描述` 字段 - 普通规则疑点显示模板生成内容 - AI规则疑点显示 AI 生成内容（口径保留） ### 9.3 数据口径 - 新疑点生成时生成并落库 - 历史普通规则疑点可通过脚本回填 - 无模板时允许使用兜底文案 --- ## 10. 一句话总结 本次改进将普通规则纳入统一的“疑点描述”体系，通过在规则详情页配置模板并在疑点生成时落库，使用户能够像查看 AI 规则一样，一眼理解普通规则疑点的具体问题。