Files
notes/work/移动杭研/开发记录/7.2.0/开发笔记.md
T
2026-03-01 01:43:46 +08:00

659 lines
15 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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_infofilename 原始文件名称、md5、user_id(自动持久化)
### 附件删除按钮接口
```
/workorder/custom/deleteFile
```
#### 接口携带参数
```
idunssywtot8iapfk6f6kf6bgzj
```
### 上传其他附件接口
```
/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 集团运营经理 B07111019_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