Initial commit

2026-03-01 01:43:46 +08:00
commit c6125c117b
3840 changed files with 415340 additions and 0 deletions
@@ -0,0 +1,107 @@
+# 2.1 跨客户订购迁移流程自动化（涉及子系统与CPID字段解耦）
+
+## 需求评审
+
+NRWLXT-30203
+
+**功能说明：** 针对不同 cpid 的冲突域名，预热刷新及 URL 封禁， 我们把 A 转为 A^，底层回调给我们的也按照 A^回调，展示给客户的结果按照 A 展示。
+
+**需求来源：** 集团-高旭、韩齐雅
+
+**需求背景：**
+
+政企侧 2025 年订购迁移需求呈现出密集、不定期态势，主要为从【总部政企】迁移至【省公司政企】需求。
+
+政企侧要求订购迁移时，保障业务服务不中断、计费数据不受影响（一般需要某月 1 号 00:00 分新订购生效计费，前一日 23:59 分旧订购中止）。
+
+由于订购迁移主要为【订购ID】和【CPID】变更，当前各系统和平面与 CPID 字段耦合严重，导致订购迁移工作组织消耗大量人力。
+
+当前不同场景订购迁移各系统需配合的工作，主要涉及：IBS、CRS、集中配管、自研平面、中兴平面、华为平面，以及客户侧配合变更 AKSK 等。
+
+**具体描述：**
+
+1、预热刷新：针对冲突域名，不同 CPID 时，客户下发预热刷新任务时（接口、页面），需将URL中的原始域名修改为加后缀的冲突域名给下游系统。查询任务时，将待后缀的冲突域名转换回原始域名给客户展示。
+
+2、[CDN运营平台接口规范-客户版-20250519](https://www.kdocs.cn/office/w/cnS6vYEirmwO?sub_file_id=AEITSOBCADQHU&attachment_store_type=upload_ks3&disablePlugins&readonly) 涉及 4 内容管理接口、8.1 解封禁接口、8.2 URL 封禁/解封任务查询接口。
+
+3、相同 cpid 下的不做任何逻辑处理，子账号做同步处理。
+
+4、场景说明
+
+（1）A：冲突a  展示原始a
+
+（2）A：冲突a+冲突2a   展示冲突a+冲突2a
+
+（3）A：冲突a+冲突b  展示原始a +原始b
+
+（4）A：原始a+冲突b   展示原始a +原始b
+
+（5）A：原始a+冲突a    展示原始a+冲突a
+
+## 需求备注
+
+老接口：com.cmcc.cdn.api.service.impl.ContentApiServiceImpl#submitContentTasksFromApi
+
+正哥写的新接口：
+
+com.cmcc.cdn.api.service.impl.ContentApiServiceImpl#submitContentTasksFromApiNew
+
+## 需求开发
+
+```
+    /**
+     * 根据企业ID集合查询活跃域名信息
+     * 返回包含企业ID和域名的投影对象列表
+     */
+    @Query("select s.tenantId as tenantId, s.domain as domain from SelfServiceDomainConfigPO s "
+           + "where s.tenantId in :tenantIds and s.deleted = false and s.state in :states")
+    List<TenantDomainProjection> findActiveDomainsByTenantIds(@Param("tenantIds") Collection<String> tenantIds,
+                                                              @Param("states") Collection<DomainTicketStateEnum> states);
+```
+
+1、 客户同时拥有冲突域名和真实域名，当在缓存失效内，删除了真实域名，这时候处理冲突域名的时候会存在获取异常。
+
+2、 4.5 支持域名和 URL 维度查询。历史没有校验直接给配管。现在因为要做冲突域名转换。如果没有查到域名信息和 rul 中的 hsot 信息，我们要进行异常抛出吗？
+
+URL 解封禁途径：
+
+```
+deny_allow_task 库表存储
+
+
+更新（网宿URL封禁/解禁回调入口）：/v1/url/ban/callback
+新增（URL封禁/解禁，网速封禁）：/api/normal/url/ban
+
+新增
+/action?commandType=urlbanorunban
+/api/toutiao/url/ban
+/api/url/ban（8.1）
+
+
+更新：/actionpm?commandType=pipeDomainCallBack
+/v1/pipe/config/callback
+```
+
+# 用例评审
+
+# 冒烟自测
+
+## API 接口
+
+**URL预热**
+
+```
+https://apppkg-p02-bg-drcn.hihonorcdn.com/diff/com.zhongyuedu.zhongyuzhongyi_183_19_186_0_e6f007_3d1930_1761718044875.diff
+```
+
+**内容刷新**
+
+```
+https://contentplatform-drcn.hihonorcdn.com.wskam.com/AdPlatformDelivery/landingPagePkgName/com.jzxy.heisu.json
+```
+
+**目录刷新**
+
+```
+https://s-file-1.ykt.cbern.com.cn/
+```