# 2.1 工单管理 - 工单搜索详情优化

## 需求评审

## 需求备注

1. 功能说明部分描述不符合。（已优化。）
2. 详情的拼接规则是什么？（已优化。）
3. 前端是否需要处理？（无需处理前台默认 20 单字节字符，看前台代码确认的。）
4. 工单范围：订购迁移工单、直播域名配置记录工单。（产品缩减后的处理范围。）

### 文档优化

功能说明 部分：可以去掉 直播字眼。

具体描述 部分：

第一点，可以补充说明下，多域名之间用 英文逗号（,）隔开。

1）订购迁移工单 格式：原订购 ID: 域名

例如：PRODUCTID1718174093:DevReq1718173913A.komect.com

2）直播域名配置记录工单 格式：域名操作类型（域名停用、域名启用、域名删除、域名修改、）: 域名

例如：域名停用:DevReq1720485193A.komect.com

关于 直播域名配置记录工单 无法触发自动删除流程。

## 需求开发

### 订购迁移工单

因订购迁移工单工单会有大批域名，数据库字段（details）目前是 varchar(8000) 限制。所以代码中的 details 字段进行了 7900 的截取。

1. 考虑字符编码带来的存储空间差异；
2. 预留处理和编码转换的安全空间。

### 直播域名配置记录工单

直播域名配置记录工单的触发场景：

1. 直播控制台 -> 域名管理列表 -> 停用、启用、删除；（没问题）
2. 直播控制台 -> 域名管理列表 -> 配置按钮 -> 修改配置；（没问题）
3. 业务单相关定时任务自动停用和自动删除；
    1. 点播：停用无运营单，删除没问题；
    2. 直播：停用没问题，无法触发自动删除流程（直播的停用 self_service_domain_config 中没有 domain_disable_time）
4. 预约注销直播删除。（没问题）

# 2.2 工单管理 - 集团业务管理员驳回修改重提后附件展示重复优化

## 需求评审

## 需求备注

1. 工单详情展示新提交的需求附件和信安附件、底层删除旧信安附件。
2. 具体描述：
1、 针对【域名配置需求工单】集团业务管理员驳回，客户经理修改重提后附件展示重复。当客户经理重新提交后，集团业务管理员工单详情展示新提交的需求附件和信安附件。
2、被集团业务管理员退回后，客户经理点击修改时显示上次上传的文件附件，并解析出相关域名信息（单个和多个域名显示逻辑一致）。
2、客户经理可删除历史上传的信安附件文件及其他附件。
3、新信安附件上传后，工单流转更新为最新的信安附件，底层删除旧信安附件。

## 需求开发

### 域名配置需求工单 - 上传信安附件接口

```
/workorder/requestDomain/upload
```

#### 接口携带参数

```
name: 信安导入模板.xls
enterprise: g18wgpcx-bdyfrmx8fvls1wk4
product: 视音频点播加速
type: domain_request
file: (binary)
```

#### 接口响应参数

```json
{
    "id": "unssywtot8iapfk6f6kf6bgzj",
    "info": [
        {
            "cpDomain": "",
            "domain": "20240701095811.komect.com",
            "domainType": "0",
            "icp": "京ICP备0500_komect.com_12号",
            "loopDomain": [
                {
                    "mainFlag": true,
                    "type": "domain",
                    "value": "so1urce.test.com:80"
                }
            ],
            "speedList": [
                {
                    "cpDomain": "",
                    "domain": "20240701095811.komect.com",
                    "icpNumber": "京ICP备0500_komect.com_12号"
                }
            ]
        }
    ],
    "name": "信安导入模板.xls"
}
```

#### 参数说明

```
id：生成的md5值
name：原始文件名
info：附件内容
cpDomain：企业真实域名
domain：域名
icp：备案号
loopDomain：回源信息
domainType：默认0
speedList：域名信息
```

多次上传库中均保存，前端传最后一个文件 md5 值。

#### 附件入库相关

file_info：filename 原始文件名称、md5、user_id（自动持久化）

### 附件删除按钮接口

```
/workorder/custom/deleteFile
```

#### 接口携带参数

```
id：unssywtot8iapfk6f6kf6bgzj
```

### 上传其他附件接口

```
/workorder/custom/upload
```

#### 接口响应参数

```json
{
	"name":"测试备用附件.docx",
	"id":"mmfgjt72rflso2xb5zqnbjd0d"
}
```

### 提供附件解析新接口

```json
GET http://localhost:8080/workorder/parseByMd5?md5=


{
    "info": [
        {
            "cpDomain": "",
            "domain": "20240715141708.komect.com",
            "domainType": "0",
            "icp": "京ICP备0500_komect.com_12号",
            "loopDomain": [
                {
                    "mainFlag": true,
                    "type": "domain",
                    "value": "so1urce1.test.com:80"
                },
                {
                    "mainFlag": false,
                    "type": "domain",
                    "value": "back1.test.com:80"
                }
            ],
            "speedList": [
                {
                    "cpDomain": "",
                    "domain": "20240715141708.komect.com",
                    "icpNumber": "京ICP备0500_komect.com_12号"
                }
            ]
        }
    ]
}
```

### 列表修改按钮 - 接口及响应

```json
/workorder/modify/detail

{
	"approve":{
		"accountId":"政企分公司|政企客户经理|政企汤汤",
		"buttons":[
			"ok",
			"back",
			"kill"
		],
		"createInfo":"政企汤汤 | 18867102345",
		"createTime":"2024-07-02T17:09:25",
		"userid":831
	},
	"code":"001-20240702001",
	"corp":"ECName1714374835",
	"createTime":"2024-07-02 17:09:25",
	"creatorInfo":"政企汤汤 | 18867102345",
	"dealer":"政企客户经理",
	"enterpriseCpId":"8351490236157",
	"files":[
		{
			"id":"76jsh7pvl6flg0zalhyceqoen",
			"name":"测试备用附件.docx"
		},
		{
			"id":"mhwexnchqtvn2xqqx6r3nfwqz",
			"name":"信安导入模板.xls"
		},
		{
			"id":"z05tt3zlh1vyu07yhdgdkwoir",
			"name":"性格测试.png"
		}
	],
	"history":[
		{
			"finished":true,
			"mobile":"18867102345",
			"modify":false,
			"province":"政企分公司",
			"role":"政企分公司|政企汤汤:提交",
			"time":"2024-07-02 17:09",
			"userAccount":"18867102345cmcc",
			"userName":"政企汤汤"
		},
		{
			"finished":true,
			"icpNeedUpdate":false,
			"modify":false,
			"role":"信安信息:上传成功"
		},
		{
			"finished":true,
			"mobile":"18867121321",
			"modify":false,
			"msg":"",
			"province":"集团",
			"result":"back",
			"role":"集团|集团客户经理管理员",
			"time":"2024-07-02 17:13",
			"userAccount":"jt-cma",
			"userName":"集团客户经理管理员"
		},
		{
			"finished":false,
			"modify":false,
			"role":"当前办理: 政企分公司|政企汤汤|18867102345"
		},
		{
			"finished":false,
			"modify":false,
			"role":"集团客户经理管理员审批"
		},
		{
			"finished":false,
			"modify":false,
			"role":"BPM运维工程师审批"
		}
	],
	"httpSelection":{
		
	},
	"informationFiles":[
		{
			"fileId":"mhwexnchqtvn2xqqx6r3nfwqz",
			"name":"信安导入模板.xls"
		}
	],
	"orderSource":1,
	"requirement":"add",
	"self":{
		"httpSelection":{
			
		},
		"provinceCodeList":[
			"551",
			"100",
			"591",
			"931",
			"200",
			"771",
			"851",
			"898",
			"311",
			"371",
			"451",
			"270",
			"731",
			"431",
			"250",
			"791",
			"240",
			"471",
			"951",
			"971",
			"531",
			"351",
			"290",
			"210",
			"280",
			"220",
			"891",
			"991",
			"871",
			"571",
			"230"
		],
		"domainInfo":[
			{
				"adaptPlain":[
					{
						"approve":0,
						"editable":false,
						"loopDomain":[
							{
								"mainFlag":true,
								"type":"domain",
								"value":"so1urce.test.com:80"
							}
						],
						"plane":""
					}
				],
				"domain":"20240702170545.komect.com 已删除",
				"icp":"京ICP备0500_komect.com_12号",
				"provinceCodeList":[
					"all"
				]
			},
			{
				"adaptPlain":[
					{
						"approve":0,
						"editable":false,
						"loopDomain":[
							{
								"mainFlag":true,
								"type":"domain",
								"value":"so1urce.test.com:80"
							}
						],
						"plane":""
					}
				],
				"domain":"20240702170549.komect.com 已删除",
				"icp":"京ICP备0500_komect.com_12号",
				"provinceCodeList":[
					"all"
				]
			}
		],
		"domainType":"0",
		"enterprise":"ECName1714374835",
		"description":"",
		"isBatch":true,
		"type":"configure",
		"speedList":[
			{
				"cpDomain":"",
				"domain":"20240702170545.komect.com",
				"icpNumber":"京ICP备0500_komect.com_12号",
				"loopDomain":[],
				"loopType":"DOMAIN",
				"mainLoopDomain":"so1urce.test.com:80"
			},
			{
				"cpDomain":"",
				"domain":"20240702170549.komect.com",
				"icpNumber":"京ICP备0500_komect.com_12号",
				"loopDomain":[],
				"loopType":"DOMAIN",
				"mainLoopDomain":"so1urce.test.com:80"
			}
		],
		"provinceIdList":[
			1,
			2,
			3,
			4,
			5,
			6,
			7,
			8,
			9,
			10,
			11,
			12,
			13,
			14,
			15,
			16,
			17,
			18,
			19,
			20,
			21,
			22,
			23,
			24,
			25,
			26,
			27,
			28,
			29,
			30,
			31
		],
		"loopDomain":[],
		"province":"安徽 北京 福建 甘肃 广东 广西 贵州 海南 河北 河南 黑龙江 湖北 湖南 吉林 江苏 江西 辽宁 内蒙古 宁夏 青海 山东 山西 陕西 上海 四川 天津 西藏 新疆 云南 浙江 重庆 ",
		"probationTime":"",
		"product":"PAGE_UP",
		"charge":false,
		"productId":"PRODUCTID1714375610",
		"cpid":"kimpg6gh-oxul9g7qpp06hhcw",
		"chargeTime":"",
		"workOrderFileList":{
			"batchExcelFiles":[
				{
					"fileId":"76jsh7pvl6flg0zalhyceqoen",
					"name":"测试备用附件.docx"
				}
			],
			"batchFiles":[
				{
					"fileId":"mhwexnchqtvn2xqqx6r3nfwqz",
					"name":"信安导入模板.xls"
				}
			],
			"informationFiles":[
				{
					"fileId":"mhwexnchqtvn2xqqx6r3nfwqz",
					"name":"信安导入模板.xls"
				}
			]
		},
		"operateType":"新增域名",
		"canConfig":false,
		"planeData":[
			"自研（杭研）",
			"华为平面"
		]
	},
	"source":"ESOP",
	"speedDomain":"20240702170545.komect.com",
	"state":"CmaCheck",
	"type":"domain_request"
}
```

### 最终处理取消批量和单个，与前端定义交互字段

```json
    "workOrderFileList": {
        "requirementAttachment": [
            {
                "fileId": "bj8vcjfajlm6egzapqikfexrb",
                "name": "测试备用附件.docx"
            },
            {
                "fileId": "2jyoubwaf4wn4grft2tgrmxnc",
                "name": "vim键盘位置.png"
            }
        ],
        "securityInfoAttachment": {
            "fileId": "pnd2zjrrvcvrgbh7mhplsimph",
            "name": "信安导入模板.xls"
        }
    }
```

# 3.1 企业管理新增运营经理删除功能

## 需求评审

## 需求备注

1. 需求背景中：当前企业管理功能页中不支持新增操作，新增是在 ESOP 工单流转过程中分配不同运营经理绑定的。
2. 具体描述中：增加说明限制此操作目前仅限 ESOP 企业操作。

各省业务管理员仅能删除本省内的运营经理数据。

## 需求开发

### esop 变更运营经理接口

```
/selfService/enterprise/bindToUsers

{
  "enterId": 728, 企业ID
  "userId": [
    "865", 要变更的人员ID
    "921"
  ],
  "alterId": "865" 要变更的人员ID
}
```

### cache+ 绑定接口

```
/selfService/enterprise/bindToUser
```

### 删除并更换企业运营经理接口说明

`POST /selfService/enterprise/replaceEnterpriseManager`

请求参数以 JSON 格式通过请求体 (`@RequestBody`) 传递。

| 参数名          | 类型   | 是否必填 | 描述             |
| ------------ | ---- | ---- | -------------- |
| deleteUserId | Long | 是    | 要删除的运营经理的用户 ID  |
| bindUserId   | Long | 是    | 要绑定的新运营经理的用户 ID |
| enterpriseId | Long | 是    | 企业 ID           |

请求示例

```json
{
  "deleteUserId": 123,
  "bindUserId": 456,
  "enterpriseId": 789
}
```

### 直播控制触发运营单无法变更问题

![](../../../../attachment/images-paste/image-20240711121358676.png)

### 自测

1、IBS 测试环境：https://test.p.cdn.10086.cn/

2、集团国际 CDN 有限公司存在两个两个试用单，运营经理分别是集团运营经理 001 集团运营经理 003

ECName1720664357

xj 集团运营经理 B：07111019_14

3、集团国际 CDN 有限公司存在一个试用变更单（未新增域名），集团运营经理 001 待审批

企业：ECName1720592898

运营经理：xj 集团运营经理 B

试用单：07101427_57（完结）

试用单：07101450_03（在途）

删除前：完结的已办可查，工单查询可查

在途的代办可查，工单查询可查

运营经理：集团运营汤汤

试用单：07101446_34（完结）

转派前：完结的已办不可查，工单查询可查

在途的代办不可查，工单查询可查

删除后：07101450_03（在途）到新运营经理

首次开通也发到新运营经理

非首次开通发到新运营经理

**售前支撑工单**

此类型工单无法支持变更运营经理，目前售前支撑工单由业务员分配运营经理，可以分配任意运营经理。

工单与企业无强关联关系。

一个企业、两个试用单

![](../../../../attachment/images-paste/image-20240716100224705.png)

# 5.1 国际 CDN&咪咕直播配置能力接入（石正/田卓）

## 需求评审

## 需求备注

因版本排期问题，正哥帮忙全力处理了需求。

## 需求开发

# 测试评审

## 集团运营经理通过直播域名搜索直播域名配置记录工单

1. 前提：需要新生成的记录才可以模糊搜索。

## 集团业务管理员删除运营经理 - 存在待办试用变更单

1. 第一步 点击按钮异常
2. 第二部 不存在删除按钮

# 冒烟自测

## 集团运营经理通过直播域名搜索直播域名配置记录工单

前提：

1、IBS 测试环境：https://test.p.cdn.10086.cn/

2、系统存在 A 企业直播域名 www.test.com，已生效

ECName1720604734

DevReq1720604734A.komect.com

## 集团客户经理管理员退回多个域名修改附件后提交

1、IBS 测试环境：https://test.p.cdn.10086.cn/

2、IBS 系统存在 esop 企业 A，已开通网页加速产品

第一步验证点：角色名称 集团客户经理管理员

![](../../../../attachment/images-paste/image-20240710180936445.png)

## 新增 Esop 定制域名默认开启流式数据

1.Esop 企业：testA，已开通网页加速，订购关系：123456，对应客户经理：浙江省客户经理 002，对应运营经理: 浙江省运营经理 002

步骤 1：新建工单

![](../../../../attachment/images-paste/image-20240711144307205.png)

## 非域名运营经理停用点播域名

1、IBS 测试环境：https://test.p.cdn.10086.cn

2、esop 企业 A 存在运营经理：集团运营经理 001 集团运营经理 002

![](../../../../attachment/images-uuid/31eedefcb6f74f2ba3497fe0e64ff9ce.jpg)

企业下已生效域名 test.com 运营经理为集团运营经理 001