# 风险场景协作人功能 - 页面改动说明

## 文档信息

| 属性 | 值 |
|------|---|
| 关联PRD | 风险场景协作人功能-PRD.md |
| 所属模块 | 全知平台 / 风控模块 |
| 涉及页面 | 6个 |

---

## 1. 风险场景详情和编辑页面

**文件路径**：`fengkong/风险场景详情和编辑页面.html`

### 1.1 改动概述

在场景基础信息区域新增"协作人"字段，支持创建人添加和移除协作人。支持只读模式（协作人通过「我协作的」Tab 访问时）。

### 1.2 具体改动

#### 新增字段

在"场景说明"字段后面新增"协作人"字段，以独立区块展示：

```
┌─────────────────────────────────────────────────────────────┐
│                        基础信息                              │
├─────────────────────────────────────────────────────────────┤
│  场景名称：差旅费报销单审核                                   │
│  场景ID：CJ-20260130-001                                     │
│  业务域：领域1                   运行状态：启用               │
│  数据范围：示例单位A、示例单位B                               │
│  场景说明：该场景用于审核差旅费报销单的合规性...              │
│  创建人：张三（不可编辑）                                     │
├─────────────────────────────────────────────────────────────┤
│ ┌─ 协作人（独立区块，浅灰背景）───────────────────────────┐ │
│ │  协作人：[李四 ×] [王五 ×] [赵六 ×]    [编辑协作人]     │ │
│ │                                                         │ │
│ │  ℹ️ 协作人可查看场景疑点、派发疑点、执行疑点甄别，并可   │ │
│ │  审核自己派发的疑点。移除协作人时，需确保该协作人无已派  │ │
│ │  发未关闭的疑点（需处置类型）。                          │ │
│ └─────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
```

#### 字段说明

| 项目 | 说明 |
|------|------|
| 字段名称 | 协作人 |
| 控件类型 | 人员标签展示 + 编辑按钮 |
| 是否必填 | 否 |
| 字段位置 | 创建人字段下方 |

#### 交互说明

**创建人视角**：
- 显示协作人姓名标签，每个标签带【×】移除按钮
- 显示【编辑】按钮，点击弹出人员选择器
- 可添加多人，可移除已添加的协作人

**协作人视角**：
- 只显示协作人姓名标签
- 不显示【×】移除按钮
- 不显示【编辑】按钮

**普通用户视角**：
- 不显示该字段（或显示为空）

#### 权限控制

| 按钮 | 创建人 | 协作人 | 普通用户 |
|------|--------|--------|----------|
| 编辑协作人 | 显示 | 隐藏 | 隐藏 |
| 移除协作人（×） | 显示 | 隐藏 | 隐藏 |

#### 权限说明提示

协作人区块底部显示灰色提示文字：
```
ℹ️ 协作人可查看场景疑点、派发疑点、执行疑点甄别，并可审核自己派发的疑点。移除协作人时，需确保该协作人无已派发未关闭的疑点（需处置类型）。
```

#### 移除协作人阻止提示

当创建人尝试移除有未关闭疑点的协作人时，弹窗提示（不自动关闭，需手动点击「关闭」）：
```
无法移除
该协作人尚有 N 条已派发未关闭的疑点（需处置类型），
移除后将影响疑点处置流程，
请等待该协作人相关疑点全部关闭后再操作。
```

### 1.4 只读模式

当协作人通过「我协作的」Tab 点击「查看场景」进入详情页时，页面以只读模式展示（URL 参数 `?mode=readonly`）。

**只读模式下隐藏的元素**：
- 场景名称、业务域、运行状态、场景说明 → 改为纯文本展示
- 数据范围多选 → 禁用
- 编辑协作人按钮、移除按钮（×）→ 隐藏
- 添加规则、删除规则、编辑配置按钮 → 隐藏
- 保存按钮 → 隐藏
- 页面标题 → 改为「风险场景详情（只读）」

**保留可操作的元素**：
- 查看场景疑点按钮
- 左侧导航菜单
- 面包屑导航

### 1.3 新增弹窗：人员选择器

点击【编辑】按钮后弹出组织人员选择器：

```
┌─────────────────────────────────────────────────────────────┐
│                      选择协作人                              │
├─────────────────────────────────────────────────────────────┤
│  搜索：[请输入姓名或工号]                                    │
│                                                             │
│  组织架构树                                                  │
│  ├── 风控部                                                 │
│  │   ├── 李四（已选）                                       │
│  │   └── 王五                                               │
│  ├── 财务部                                                 │
│  │   └── 赵六（已选）                                       │
│  └── 审计部                                                 │
│      └── 钱七                                               │
│                                                             │
│  已选人员：[李四 ×] [赵六 ×]                                 │
│                                                             │
│              [ 取消 ]           [ 确认 ]                     │
└─────────────────────────────────────────────────────────────┘
```

#### 校验规则

| 校验项 | 规则 |
|--------|------|
| 重复添加 | 已是协作人的人员不可重复添加 |
| 添加自己 | 创建人不可将自己添加为协作人 |
| 人员上限 | 暂不设上限 |
| 移除前检查 | 有未关闭的【需处置】疑点时不允许移除 |

#### 移除协作人流程

```
创建人点击协作人标签的【×】
        │
        ↓
系统检测该协作人是否有未关闭的【需处置】疑点
        │
    ┌───┴───┐
    │       │
    ↓       ↓
  有       无
    │       │
    ↓       ↓
 阻止移除   二次确认："确认移除该协作人？"
 弹窗提示        │
 "该协作人        ↓
  有N条未     确认移除
  关闭的疑点，       │
  无法移除"         ↓
               协作人列表更新
               协作人从"我协作的"列表消失
```

---

## 2. 风险场景列表页

**文件路径**：`fengkong/风险场景列表.html`

### 2.1 改动概述

新增"我创建的"和"我协作的"标签页，用户可切换查看不同类型的场景。

### 2.2 具体改动

#### 新增标签页

在页面标题下方、筛选栏上方新增标签页：

```
┌─────────────────────────────────────────────────────────────┐
│  风险场景列表                              [+ 新增风险场景]  │
├─────────────────────────────────────────────────────────────┤
│  [我创建的]  [我协作的]                ← 新增标签页          │
├─────────────────────────────────────────────────────────────┤
│  筛选栏...                                                  │
└─────────────────────────────────────────────────────────────┘
```

#### 标签页说明

| 标签页 | 说明 | 默认状态 |
|--------|------|---------|
| 我创建的 | 展示当前用户创建的场景 | 默认选中 |
| 我协作的 | 展示当前用户作为协作人的场景 | - |

#### 列表字段调整

| 字段 | 是否显示 | 说明 |
|------|---------|------|
| 序号 | 显示 | - |
| 场景ID | 显示 | - |
| 场景名称 | 显示 | - |
| 业务域 | 显示 | - |
| 关联规则数 | 显示 | - |
| 运行状态 | 显示 | - |
| 创建人 | 显示 | 原有字段 |
| 创建单位 | 显示 | - |
| 创建时间 | 显示 | - |
| 操作 | 显示 | - |

#### 操作权限

| 操作 | 我创建的 | 我协作的 |
|------|---------|---------|
| 编辑/查看场景 | 显示「编辑」→ 跳转详情页可编辑 | 显示「查看场景」→ 跳转详情页只读模式 |
| 禁用/启用 | 显示 | 隐藏 |
| 删除 | 显示 | 隐藏 |
| 查看疑点 | 显示 | 显示 |

#### 只读模式跳转

「我协作的」Tab 下点击「查看场景」时，跳转 URL 携带 `?mode=readonly` 参数：
```
./风险场景详情和编辑页面.html?sceneId=xxx&sceneName=xxx&mode=readonly
```

---

## 3. 疑点派发-场景疑点页

**文件路径**：`fengkong/疑点派发-场景疑点.html`

### 3.1 改动概述

场景列表展示用户有权限的所有场景（创建的+协作的），新增"创建人"字段标识场景归属。

### 3.2 具体改动

#### 场景卡片调整

在场景卡片中新增"创建人"字段：

```
┌─────────────────────────────────────────────────────────────┐
│  差旅费报销单审核                                            │
├─────────────────────────────────────────────────────────────┤
│  场景ID：CJ-20260130-001                                     │
│  业务域：领域1    创建人：张三    ← 新增字段                 │
│  关联规则数：5    数据范围：示例单位A、示例单位B              │
└─────────────────────────────────────────────────────────────┘
```

#### 场景列表逻辑

| 项目 | 说明 |
|------|------|
| 数据范围 | 展示用户有权限的所有场景（创建的+协作的） |
| 不区分标签 | 不需要"我创建的"/"我协作的"标签页 |
| 归属标识 | 通过"创建人"字段区分场景归属 |

---

## 4. 疑点派发-疑点详情页

**文件路径**：`fengkong/疑点派发-疑点详情.html`

### 4.1 改动概述

协作人可执行疑点派发操作，派发时记录派发人信息。

### 4.2 具体改动

#### 权限扩展

| 操作 | 创建人 | 协作人 |
|------|--------|--------|
| 查看疑点 | 可以 | 可以 |
| 派发疑点 | 可以 | 可以 |
| 甄别疑点 | 可以 | 可以 |

#### 权限提示条

在筛选栏下方、表格上方新增一行提示条，提示协作人也有派发权限：

```html
┌─────────────────────────────────────────────────────────────┐
│ ℹ️ 创建人和协作人均可派发疑点，派发后处置人将收到通知        │
└─────────────────────────────────────────────────────────────┘
```

样式：`alert-info`，蓝色背景，字号 13px。

#### 派发操作记录

派发时系统自动记录：

| 字段 | 说明 |
|------|------|
| 派发人ID | 当前操作人ID |
| 派发人姓名 | 当前操作人姓名 |
| 派发时间 | 派发操作时间 |

---

## 5. 疑点处置-疑点详情页

**文件路径**：`fengkong/疑点处置-疑点详情.html`

### 5.1 改动概述

协作人可审核自己派发的疑点，创建人可审核所有疑点。

### 5.2 具体改动

#### 页面定位说明

此页面主要使用者是**处置人**，核心操作是「处置反馈」。审核入口在：
- 风险监控入口的待办列表
- 疑点派发-疑点详情页的「处置情况」列

#### 审核权限

| 疑点派发人 | 可审核人 |
|-----------|---------|
| 创建人 | 创建人 |
| 协作人A | 协作人A、创建人 |
| 协作人B | 协作人B、创建人 |

#### 审核操作

| 操作 | 说明 |
|------|------|
| 通过 | 疑点状态更新为已通过 |
| 驳回 | 退回派发人重新处理 |

#### UI 改动说明

原页面曾有审核权限提示 badge，经评估后已移除——此页面核心是处置反馈，审核信息为辅助内容，不宜过度突出。

---

## 6. 已排除疑点汇总页

**文件路径**：`fengkong/已排除疑点汇总.html`

### 6.1 改动概述

协作人可查看和管理当前场景下的已排除疑点。

### 6.2 具体改动

#### 权限说明

| 操作 | 创建人 | 协作人 |
|------|--------|--------|
| 查看已排除疑点 | 可以（所有场景） | 可以（当前场景） |
| 确认为误报 | 可以 | 可以 |
| 确认为有效 | 可以 | 可以 |

#### 数据范围

| 角色 | 数据范围 |
|------|---------|
| 创建人 | 当前用户创建的所有场景的已排除疑点 |
| 协作人 | 当前用户作为协作人的场景的已排除疑点 |

---

## 7. 待办/已办页面

**文件路径**：`fengkong/index.html`（首页待办区域）

### 7.1 改动概述

协作人派发的待审核疑点，同时出现在协作人和创建人的待办列表。

### 7.2 具体改动

#### 待办展示逻辑

```
协作人A派发疑点
      │
      ↓
待审核待办 → 同时出现在：协作人A待办、创建人待办
      │
      ├── 协作人A审核 → 创建人待办同步消失
      │
      └── 创建人审核 → 协作人A待办同步消失
```

#### 待办列表字段

| 字段 | 说明 |
|------|------|
| 任务类型 | 疑点审核 |
| 任务标题 | 场景名称 + 规则名称 |
| 派发人 | 显示实际派发人（可能是创建人或协作人） |
| 派发时间 | 派发操作时间 |
| 操作 | 审核（跳转到审核页面） |

---

## 8. 新建风险场景页面

**文件路径**：`fengkong/新建风险场景页面.html`

### 8.1 改动概述

在新建场景表单中新增"协作人"字段，支持创建场景时即设置协作人。

### 8.2 具体改动

#### 新增字段

在"场景说明"字段后面新增"协作人"字段，以独立区块展示：

```
┌─────────────────────────────────────────────────────────────┐
│                        基础信息                              │
├─────────────────────────────────────────────────────────────┤
│  场景名称：[输入框]              场景ID：[自动生成]          │
│  业务域：[下拉选择]              运行状态：[启用/禁用]       │
│  数据范围：[多选下拉]                                       │
│  场景说明：[文本域]                                          │
├─────────────────────────────────────────────────────────────┤
│ ┌─ 协作人（独立区块，浅灰背景）───────────────────────────┐ │
│ │  协作人：[暂未设置协作人]    [编辑协作人]                │ │
│ │                                                         │ │
│ │  ℹ️ 协作人可查看场景疑点、派发疑点、执行疑点甄别，并可   │ │
│ │  审核自己派发的疑点。移除协作人时，需确保该协作人无已派  │ │
│ │  发未关闭的疑点（需处置类型）。                          │ │
│ └─────────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────────┘
```

#### 交互说明

- 点击【编辑】弹出树形组织人员选择器（与详情页相同）
- 支持多选人员
- 协作人字段下方显示权限说明提示
- 协作人为选填字段，不影响场景保存

---

## 9. 边界条件与异常处理

### 9.1 协作人被移除

| 场景 | 处理方式 |
|------|---------|
| 协作人有待审核的疑点 | 创建人继承审核权（创建人本就有审核所有疑点的权限） |
| 协作人有已驳回待重新处理的疑点 | 第一阶段：阻止移除（有未关闭的【需处置】疑点）；第二阶段：转移给指定人 |
| 协作人有已派发待处置的疑点 | 处置人仍可正常处置，不受影响 |
| 移除后「我协作的」Tab 可见性 | 该场景从被移除协作人的「我协作的」列表中消失 |
| 疑点操作记录 | `DISPATCH_USER`、`DISPATCH_USER_NAME` 保留原始记录，不修改 |
| 区块链存证 | 派发人信息保持不变，保证操作轨迹可追溯 |

### 9.2 场景状态变更

| 场景 | 处理方式 |
|------|---------|
| 场景被禁用 | 不再产生新疑点；已有的疑点继续正常处理（派发、处置、审核不受影响） |
| 场景被删除 | 协作人无法再查看该场景；所有相关待办事项清空 |

### 9.3 并发审核

| 场景 | 处理方式 |
|------|---------|
| 创建人和协作人同时审核同一疑点 | 先提交者成功，后提交者收到提示"该疑点已被审核"；待办列表实时同步消失 |

### 9.4 协作人账号异常

| 场景 | 处理方式 |
|------|---------|
| 协作人离职/账号被禁用 | 本期不做系统自动处理。由创建人自行发现后，手动移除该协作人并按需添加新协作人 |

---

## 10. 页面改动汇总

| 页面 | 改动类型 | 改动内容 |
|------|---------|---------|
| 新建风险场景页面 | 修改 | 新增协作人字段、树形人员选择器、权限提示 |
| 风险场景详情和编辑页面 | 修改 | 新增协作人字段、树形选择器、权限控制、只读模式、移除前疑点检查 |
| 风险场景列表页 | 修改 | 新增"我创建的"/"我协作的"标签页、「查看场景」只读跳转 |
| 疑点派发-场景疑点页 | 修改 | 场景卡片新增"创建人"字段 |
| 疑点派发-疑点详情页 | 修改 | 协作人可派发、记录派发人信息、权限提示条 |
| 疑点处置-疑点详情页 | 修改 | 协作人可审核自己派发的疑点 |
| 已排除疑点汇总页 | 修改 | 协作人可查看和管理已排除疑点 |
| 待办/已办页面 | 修改 | 待办同步展示逻辑 |

---

## 11. 样式规范

### 11.1 协作人标签样式

```css
/* 协作人标签 */
.collaborator-tag {
    background-color: #e3f2fd;
    color: #1976d2;
    padding: 4px 12px;
    border-radius: 16px;
    font-size: 13px;
    display: inline-flex;
    align-items: center;
    gap: 6px;
    margin-right: 8px;
    margin-bottom: 8px;
}

/* 移除按钮 */
.collaborator-tag .remove-btn {
    cursor: pointer;
    font-size: 12px;
    color: #909399;
}

.collaborator-tag .remove-btn:hover {
    color: #f56c6c;
}
```

### 11.2 标签页样式

```css
/* 标签页 */
.tab-nav {
    display: flex;
    border-bottom: 2px solid #e4e7ed;
    margin-bottom: 20px;
}

.tab-item {
    padding: 12px 24px;
    cursor: pointer;
    font-size: 14px;
    color: #606266;
    border-bottom: 2px solid transparent;
    margin-bottom: -2px;
}

.tab-item.active {
    color: #409eff;
    border-bottom-color: #409eff;
    font-weight: 500;
}
```

---

## 12. 注意事项

1. **权限判断**：前端需根据当前用户与场景的关系判断权限，控制按钮显示/隐藏
2. **数据同步**：待办列表需实现实时同步，一人审核后其他人待办自动消失
3. **人员选择器**：复用现有组织人员选择器组件
4. **操作日志**：协作人的所有操作需记录操作日志