悬浮按钮与任务管理

1. 悬浮按钮（FAB）

1.1 功能概述

悬浮按钮（AI 悬浮按钮）是各智能体在信贷系统作业页面上的统一入口，常驻页面右侧。系统根据管理员功能配置、用户逐功能显示偏好、当前末级功能、页面业务上下文以及任务状态，动态展示小查、小审、小核、小问。

• 两层入口语义：折叠态彩色圆形主按钮是"查看已有结果或发起新任务"的复合入口；悬停展开后的自动、手工、运行中和完成徽标均为含义确定的单项入口。
• 圆形主按钮仅对任务类功能执行可排序的点击触发规则；小问直接打开对话。
• 小查的"自动发起/手工发起"均由审查人员发起，作为补充入口；主场景为授信申请提交后由授信作业中心调用统一发起接口自动创建（信贷模式）。放款/出账审核不适用"智能审核"发起操作，其任务由信贷系统提交业务后自动创建，悬浮按钮仅展示运行中和完成结果入口。
• 任务类功能展开后展示运行中数量、已完成未读数量、自动操作和可用的手工操作；不展示部分完成数量或绿点（小核任务不使用部分完成状态）。
• 智能体渲染顺序固定（任务类在前、问答类置底）。

1.2 操作权限

悬浮按钮不承载数据维护权限，所有任务的发起与查看均复用信贷系统的单点登录身份与功能权限。

1.3 显示规则（优先级从高到低）

1. 管理员禁用 → 不展示；
2. 用户"整体隐藏" → 隐藏整个悬浮按钮（保留右侧窄触发条用于恢复）；
3. 用户"始终隐藏" → 隐藏该功能（逐功能隐藏只影响入口，不停止后台轮询和通知）；
4. 用户"始终启用" → 强制展示（不绕过自动任务上下文校验）；
5. “自动显示”：管理员始终显示、存在运行中/已完成未读任务、或当前末级功能命中绑定且上下文满足，任一成立即展示。

1.4 圆形主按钮点击触发规则（可配置顺序，只执行第一条命中）

规则要点：

• “提交自动任务"是复合分支；取消确认后本次点击结束，不执行后续规则。
• 展开后的"自动"按钮只执行自动任务，所有分支均不得切换为手工；“手工"按钮只打开手工入口。
• 配置读取时对规则顺序做规范化：忽略未知项和重复项，按默认顺序补齐缺失规则。
• 展开后的单项按钮不受点击规则顺序影响；“运行中/完成"徽标仅在数量 >0 时显示，点击进入相应筛选后的运行列表。

1.5 风险提醒（仅小查、小核）

• 功能已启用风险提醒且存在未读的已完成任务时，圆点右上角显示风险等级角标（高/中/低/疑，经 FAB_RISK_LEVEL 字典加载），圆点与完成徽标颜色随最高风险等级变化；高风险时圆点字符在"功能字"与"风险字"间交替闪烁。
• 放款/出账审核任务的风险等级按"材料+制度统一考虑"合并：取材料智能审核风险与制度风险分析中的更高者；仅制度发现高风险时该笔业务同样按高风险驱动；均无风险时不驱动。
• 风险提醒只增强视觉提示，不改变点击规则；用户"始终隐藏"仍具最高优先级；管理员可按功能启停并自定义各级颜色（6 位 HEX，统一转大写）。

1.6 界面与关键规则

界面 1：悬浮按钮（折叠/展开）

• 折叠态：每个智能体显示单字标识（查/审/核/问）；运行中任务→脉冲动效；已完成未读→右上角红点。
• 展开态：显示"别名 + 功能说明”，右侧操作区——小查：运行中、完成、自动发起、手工发起；小审：运行中、完成、自动查找、手工查找；小核：运行中、完成（非放款审核场景可按配置展示"智能审核”，放款审核场景不展示发起按钮，无手工入口）；小问：仅"打开对话”。
• 自动按钮不满足当前业务页面或上下文时显示禁用样式，点击给出明确提示。
• 后端接口：配置接口（功能定义 + 末级绑定规则）、汇总接口（按智能体聚合运行中数/已完成未读数/失败数 + 最高未读风险等级，带版本号或变更时间）、自动提交接口（校验页面上下文、权限和唯一性；放款审核禁止经此发起）、已读标记接口、用户偏好接口。

界面 2：AI 助手设置对话框（鼠标悬停约 1 秒浮现设置齿轮）

• 整体隐藏悬浮按钮（开关，默认关；开启后仅保留约 6×48 像素半透明触发条）；
• 各功能显示方式（仅列管理员已启用功能，单选：自动显示/始终启用/始终隐藏，默认自动显示）；
• 纵向位置距底部滑块（最小 24px，默认 88px，上限随视口动态计算，区间内夹取）；
• 底部：恢复默认 / 取消 / 保存（乐观更新，失败回滚并仅控制台告警）。偏好按当前登录用户维度保存在服务端，合并优先级：用户值 > 管理员默认值 > 前端兜底常量；历史"显示全部已启用功能"偏好不迁移、不参与判断。

界面 3：任务完成提醒弹窗——轮询感知已完成未读增量后弹出系统通知"智能分析：有 N 个任务已完成"（成功类型，4 秒自动关闭），同步刷新角标并经事件总线广播。

界面 4：小查手工发起弹窗——标题"小查 · 手工发起"（860px，遮罩不可关闭）：查询条件区（客户号/客户名称/业务流水号，模糊匹配，至少输入一项）；调查报告单选列表（报告编号、客户号、客户名称、业务流水号、报告标题、业务功能、报告日期）；子模块选择区（禁用模块灰色显示"建设中"）。“开始检查"校验：必选一条调查报告 + 至少一个子模块；成功后仅提示"已经发起”，不自动跳转。

界面 5：小审检索配置弹窗——标题"类似案例对比 - 检索配置"（1200px），亦为类案对比列表页"新增"所复用：

• 检索方式（字典 CC_SEARCH_MODE）联动三区显示：精确条件筛选加语义检索 / 语义检索 / 仅精确条件检索；隐藏区域不参与必填校验、已填内容保留。
• 基础信息：类别、检索方式、是否数据抽取、是否项目贷款（CC_LOAN_TYPE，必选默认非项目贷款，项目/非项目不允许混用）、是否比对分析（选"是"时显示对比业务——经业务查找弹窗回填业务流水号、业务名称、客户名称、客户号；个人业务另显示产品种类）。
• 精确条件区：类型（可清空单选，与基础区联动）、企业性质、企业规模、经营年限范围、所属行业三级级联（大类→中类→小类按编码前缀过滤并清空）、贷款用途、产品（命中任意一个即匹配；“授信"匹配无产品业务）、主担保类型、所属分行、审批通过时间范围。
• 近似关键词区：关键词（逗号分隔）+ 最大数量（1–50）。
• 差异化必填校验 + 年限/日期区间合法性校验；通过后提示"检索请求已受理"并广播任务创建事件。

界面 6：小问对话面板——参看知识库部分。现状为简化浮层对话面板（单会话、会话仅内存、刷新后清空、不支持深链定位会话），完整版将参考 A 项目重构后回填。

2. 悬浮按钮配置

面向系统管理员，管理功能启停、末级功能绑定、上下文要求、管理员始终显示、圆形主按钮点击规则顺序及轮询参数；对所有用户统一生效（个人显示偏好在"AI 助手设置"维护）。

页面六区域：功能管理（别名/说明/类型/槽位 1-6/启用开关）、末级功能绑定（管理员始终显示、上下文要求[无/客户号/批复编号/业务流水号]、绑定末级功能多选；开启始终显示时绑定选择禁用并清空）、角色功能路由（小核任务按角色路由到业务功能页面的映射及进入方式[仅查看/正常]；业务材料上传/审查默认"仅查看”；无匹配路由跳转通用运行详情；目标路由与进入方式均为服务端配置项，程序不写死）、点击触发配置（5 条规则拖拽排序）、风险提醒配置（小查/小核启停 + 高/中/低/疑四级颜色，全功能统一，实时预览）、轮询与行为（轮询间隔 3–120 秒默认 10；空闲间隔 30–300 秒默认 60；标签页隐藏暂停轮询默认开）。

小查的末级功能绑定即为小查功能覆盖范围的唯一事实源；风险分析配置不再维护子模块级功能绑定，小查触发后在其覆盖范围内统一运行所有启用子模块。

3. 智能体运行列表

展示当前用户可见的各智能体分析任务记录；悬浮按钮"已完成"区域点击后跳转至本列表并按来源智能体预过滤。

• 主流程：进入运行列表（支持按功能、模式、状态、结果、风险等级、已读、评价状态筛选与分页）→ 点击任务标题/“查看”→（未读先调标记已读接口并刷新角标）→ 运行详情 → 返回列表（保留筛选与分页位置）。
• 详情页路由：审查报告 → 报告详情页；小审 → 类似案例对比详情页；其他 → 通用运行详情页。
• 运行详情页：顶部任务基础信息（只读，双列）；分析结果区按功能差异化渲染（小查渲染结构化风险检查结果组件；其他功能暂为占位）；结果评价区（小查按可评价子模块分项，其他按整任务单面板；评分 0–100、等级自动命中、反馈原因多选、补充说明 ≤200 字符、截图；已有评价回显）。
• 数据权限：按当前登录用户与业务权限过滤；自动/手动任务按提交人关联，信贷任务按业务经办、审查或授权范围关联。

4. 运行管理配置

面向系统管理员，集中管理各任务类型运行策略（与悬浮按钮配置互补：后者管"显示什么、何时显示"，本配置管"怎么执行、能否重复、何时超时"）。

列表操作：新增/编辑（弹窗 560px，确定带加载态防重）/删除；保存时后端校验名称唯一、枚举合法与数值区间。

5. 本章关联文档

• 任务状态与覆盖规则详见：02 业务架构与端到端流程 第 3 节
• 下一章：04 风险检查（小查）