659 lines
15 KiB
Markdown
659 lines
15 KiB
Markdown
# 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
|
||
}
|
||
```
|
||
|
||
### 直播控制触发运营单无法变更问题
|
||
|
||

|
||
|
||
### 自测
|
||
|
||
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(在途)到新运营经理
|
||
|
||
首次开通也发到新运营经理
|
||
|
||
非首次开通发到新运营经理
|
||
|
||
**售前支撑工单**
|
||
|
||
此类型工单无法支持变更运营经理,目前售前支撑工单由业务员分配运营经理,可以分配任意运营经理。
|
||
|
||
工单与企业无强关联关系。
|
||
|
||
一个企业、两个试用单
|
||
|
||

|
||
|
||
# 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,已开通网页加速产品
|
||
|
||
第一步验证点:角色名称 集团客户经理管理员
|
||
|
||

|
||
|
||
## 新增 Esop 定制域名默认开启流式数据
|
||
|
||
1.Esop 企业:testA,已开通网页加速,订购关系:123456,对应客户经理:浙江省客户经理 002,对应运营经理: 浙江省运营经理 002
|
||
|
||
步骤 1:新建工单
|
||
|
||

|
||
|
||
## 非域名运营经理停用点播域名
|
||
|
||
1、IBS 测试环境:https://test.p.cdn.10086.cn
|
||
|
||
2、esop 企业 A 存在运营经理:集团运营经理 001 集团运营经理 002
|
||
|
||

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