feat: 迁移渠道列表新增和游戏累计分布

2026-11-03 21:32:51 +08:00
parent 5e58c6bcf3
commit 075d94a51e
39 changed files with 2216 additions and 12 deletions
@@ -0,0 +1,87 @@
+{
+  "scope": "当前 sw7 实际登录会话；只读查询和无效创建。完整查询、偏好、游戏分布及源库创建已在隔离数据库通过 TCP HTTP 验证。",
+  "checks": [
+    {
+      "method": "GET",
+      "path": "/sw/promote/list?pageNum=1&pageSize=10",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "total": 0,
+      "available": false
+    },
+    {
+      "method": "GET",
+      "path": "/sw/promote/list?sourceDb=lx,hw&lockStatus=-1&promoteLevel=1",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "total": 0,
+      "available": false
+    },
+    {
+      "method": "GET",
+      "path": "/sw/promote/list?busierAccount=does-not-exist",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "total": 0,
+      "available": true
+    },
+    {
+      "method": "GET",
+      "path": "/sw/promote/bindOptions?sourceDb=lx",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "rows": 17
+    },
+    {
+      "method": "GET",
+      "path": "/sw/promote/bindOptions?sourceDb=hw",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "rows": 20
+    },
+    {
+      "method": "GET",
+      "path": "/sw/promote/bindOptions?sourceDb=yq",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "rows": 20
+    },
+    {
+      "method": "GET",
+      "path": "/sw/promote/game-distribution?sourceDb=lx&promoteId=0",
+      "http": 200,
+      "code": 7,
+      "msg": "渠道查询参数不正确",
+      "passed": true
+    },
+    {
+      "method": "GET",
+      "path": "/sw/promote/game-distribution?sourceDb=lx&promoteId=1",
+      "http": 200,
+      "code": 7,
+      "msg": "渠道数据尚未接入",
+      "passed": true
+    },
+    {
+      "method": "POST",
+      "path": "/sw/promote",
+      "http": 200,
+      "code": 7,
+      "msg": "请选择有效的游戏商务绑定",
+      "passed": true
+    }
+  ],
+  "passed": true
+}
@@ -0,0 +1,14 @@
+{
+  "method": "真实 Chrome 渲染；受控页面数据、身份及平台创建响应，不创建真实平台渠道",
+  "passed": true,
+  "level": 1,
+  "noEditEntry": true,
+  "createAllowedForUpperBusiness": true,
+  "platformSwitchClearsBinding": true,
+  "crossPlatformSameID": true,
+  "zeroGameCountClickable": true,
+  "missingMetricsVisible": true,
+  "sourceDatabaseCreatePayload": true,
+  "portraitPending": true,
+  "pageErrors": []
+}
@@ -1,6 +1,6 @@
 # 渠道列表与新增渠道：源码核对记录

-以下是下一批实现的契约，不代表已经完成。源码基线与 `implementation.md` 一致。
+以下是实现核对契约，源码基线与 `implementation.md` 一致。列表、新增、绑定选项及游戏分布已接入并验证；完整画像及报表构建任务仍未完成。

 ## 页面

@@ -48,6 +48,8 @@
 5. 游戏商务必须存在，原子追加新渠道 ID 到 `tab_promote_business.promote_ids`，避免并发覆盖；任一步失败整体回滚。
 6. 返回新 ID 与 `sourceDb`，原成功文案提示“添加成功，数据同步到列表可能有延迟”。不直接制造主库同步副本，不在真实平台库创建测试渠道。

-## 尚需读取的依赖
+## 游戏分布的已核对依赖

-游戏分布还依赖 `PromotePortraitServiceImpl.buildGameDistribution` 及其累计报表范围。实现前继续核对该方法及报表查询，不可按列表的直接注册/支付聚合臆造游戏分布。完整画像、报表汇总任务和预警生成任务仍属于后续范围。
+游戏分布依赖 `PromotePortraitServiceImpl.buildGameDistribution`、`SwReportDayQueryServiceImpl` 和日汇总/身份键 Mapper。当前实现只列根渠道已通过的游戏，用同渠道统计树读取日汇总：人数对 metric=1 的 identity_key 去重，dedup_mode 随偏好；金额固定 dedup_mode=0。累计起点从当前人数模式的最早日汇总取得，缺失则使用上海当天，即使模式 0 有更早数据也不改写该起点。截止上海当天，排除未来日期。先将金额保留两位再按金额降序、游戏 ID 升序排列。
+
+完整画像、报表汇总任务和预警生成任务仍属于后续范围。列表没有用无效画像按钮或占位响应冒充画像已迁移。
@@ -24,7 +24,7 @@
 | 1 | 商务用户字段、层级与角色、账号资料和审核、偏好、登录及找回密码 | 进行中 |
 | 2 | 平台绑定、商务/渠道可见范围、外部平台与 OA 数据源、商务列表及抽屉 | 进行中；绑定、旗下渠道、OA 激活只读接口已接入；画像与外部审核联调待完成 |
 | 3 | 预警规则、记录与状态机、操作日志、附件、消息、任务注册与调度 | 进行中；规则、记录和工作流已接入；任务待迁移，消息盒子已确认属于未改动框架代码 |
-| 4 | 渠道列表及新增、渠道激活、推广游戏等业务接口与页面 | 进行中；渠道激活已接入，渠道列表/新增及推广游戏待迁移 |
+| 4 | 渠道列表及新增、渠道激活、推广游戏等业务接口与页面 | 进行中；渠道列表/新增、激活、游戏分布已接入，渠道画像待迁移 |
 | 5 | 日汇总构建、充值/注册明细、渠道/游戏/区服报表、排行、画像与仪表盘 | 待实现 |
 | 6 | 静态接口核对、后端测试、前端构建和页面验证 | 随阶段推进，最终全量复核 |
 | 7 | 用户确认源数据库，复制至隔离库，执行迁移，启动并逐接口核对数据 | 未开始，必须等待用户确认 |
@@ -73,4 +73,9 @@
 - 激活流水从主库 `tab_spend` 按游戏汇总，成功支付、同平台、绑定开始（含）到达标/解绑截止（含）；渠道树包含本级、直属子级及 `top_promote_id` 匹配项，不依赖全局下级/身份证偏好。达标时间优先于解绑时间，进行中没有结束上限。使用 EXISTS 避免重复渠道行导致金额翻倍，金额及大 ID 以字符串返回，计算和页面格式化避免浮点精度丢失。
 - 激活批次通过全量 `go test ./...`、ESLint 和生产构建，以及主库/OA 两个隔离数据库的实际 TCP HTTP 测试。`activation-http-2026-11-03.json` 记录当前真实会话请求（OA 未接入，明确 available=false）；`activation-page-2026-11-03.json` 核对旧页面列、五种状态入口、筛选重置、达标截止与大金额。待审核可以打开流水入口但显示原接口“审核通过后可查看”，已驳回不显示入口；明细读取失败不展示伪造零流水。
 - 已对框架基线至 main 的 Git 差异核实：`SysMessageController` 与 `SysMessageServiceImpl` 未变更，旧导航栏消息入口也被注释，因此不新增商务消息 UI。SW 主库写入待审绑定后由外部 OA 审核，并没有需要照搬的 SW 内部 OA 同步任务；最终联调仍须核对 OA 连接目标及商务用户 ID 映射，不能把隔离替身测试当成外部审核验收。
+- 渠道列表、可用绑定、新增渠道、推广游戏分布四个接口及对应 Kra 页面已接入。列表读取本人及全部下级的正常绑定，超管默认不限；指定商务用户只取该用户本人的绑定。商务账号关键词同时匹配平台账号和 SW 登录名，保留 Java 文字子串语义，不把 `%` 变成通配符。渠道状态筛选使用锁定状态字段。
+- 渠道列表游戏数仅统计当前渠道已通过申请的去重游戏；玩家数和成功充值额按原渠道树及全局偏好汇总。身份证去重跨整棵统计树进行，空证件不计入，末尾 X/x 归一。指标按平台/渠道组合批量查询；缺失指标单独返回 null，已有指标继续显示。真实 TCP HTTP 回归发现并修复 `idcard` 列映射错误，增加存储字段与实际返回人数断言。
+- 游戏分布只列当前渠道已通过的推广游戏，读取 `tab_sw_report_day` / `tab_sw_report_day_key`，人数按当前去重模式去重，金额固定模式 0。累计起点保留旧实现从当前人数口径的最早日汇总取得、缺省当天的规则，截止上海当天；不能与列表原始注册/充值口径混用。金额先保留两位再排序，同金额按游戏 ID。
+- 新增渠道由 biz 决定一级、待审核 `-3`、默认注册类型和七天结算周期；data 在对应源平台库同事务写渠道、结算记录、商务渠道关系。密码复用旧 cmf 格式和 `SW_SDK_AUTH_CODE`。MySQL 创建使用固定连接持有账号命名锁直到事务提交，商务关系在行锁内追加；命名锁的真实并发验证留待最终隔离平台库联调。没有创建真实平台测试渠道，也没有伪造主库同步副本。
+- 渠道批次通过全量 Go 检查、前端 ESLint/生产构建、独立主库和源平台 SQLite 的 TCP HTTP 验证。`channel-http-2026-11-03.json` 记录实际 sw7 会话请求，当前主库渠道数据未接入，lx/hw/yq 正常绑定选项分别为 17/20/20 条。`channel-page-2026-11-03.json` 核对一级商务新增入口、平台切换清空绑定、跨平台同号、零游戏数入口、缺失指标提示及新增提交参数。画像入口继续随画像用例迁移，当前不将整个渠道菜单标为完成。
 - 当前没有执行最终旧数据库复制与迁移验收。
@@ -35,7 +35,7 @@

 ## 其他页面

-渠道列表、渠道统计、充值明细、注册明细、游戏数据、区服分析和排行榜，均需在各自实现前逐项提取旧模板的筛选项、列、按钮、抽屉、权限和跳转。数据库菜单清单或后端接口清单只能用于交叉核对，不能替代页面核对。
+渠道统计、充值明细、注册明细、游戏数据、区服分析和排行榜，均需在各自实现前逐项提取旧模板的筛选项、列、按钮、抽屉、权限和跳转。数据库菜单清单或后端接口清单只能用于交叉核对，不能替代页面核对。

 ## 预警规则

@@ -93,3 +93,22 @@
 | OA 未接入 | 明确显示未接入；不回退到主库同名表 |

 验证：`activation-http-2026-11-03.json`、`activation-page-2026-11-03.json`，以及独立主库/OA 两个 SQLite 数据库的真实 TCP HTTP 测试。未修改实际 OA 数据。
+
+## 渠道列表、新增与推广游戏
+
+来源及统计规则详见 `channel-source-notes.md`。页面保持旧 `ChannelList.vue`、`AddChannelDrawer.vue`、`ChannelGameDrawer.vue` 的实际功能。
+
+| 旧页面行为 | 新页面状态 |
+| --- | --- |
+| 平台、商务账号、渠道关键词、层级、类型、锁定状态筛选 | 已实现；修正旧“账号/负责人姓名”占位文案，按实际后端只查询账号 |
+| 列表类型个人/公会；新增类型个人/企业 | 按两处实际模板分别保留 |
+| 渠道信息、归属商务、上级/负责人、推广游戏、玩家、累计充值、锁定状态 | 已实现；缺失指标明确显示未接入 |
+| 没有编辑入口，行操作为画像 | 未增加编辑；画像随完整画像用例继续迁移，目前没有冒充可用的占位入口 |
+| 添加渠道按按钮权限，不额外限制三级 | 已实现并用一级浏览器身份核对，上级可选择下级正常绑定 |
+| 切换平台清空游戏商务并重新加载、按平台商务 ID 去重 | 已实现，防止旧请求覆盖新平台选项 |
+| 添加成功后关闭抽屉、刷新第一页，允许同步延迟 | 已实现，保持源平台创建及同步延迟提示 |
+| 游戏数量零也可打开抽屉；必须携带平台和渠道 ID | 已实现并用跨平台同号与零游戏行验证 |
+| 游戏分布显示累计玩家数、充值金额 | 已实现，实际取日汇总/身份键数据，独立于列表原始累计指标 |
+| 全局偏好变化刷新页面 | 复用 Kra 全局 reload，后端每次请求读取当前偏好 |
+
+验证：`channel-http-2026-11-03.json`、`channel-page-2026-11-03.json`，以及实际 TCP HTTP + 隔离主库/平台库。整菜单仍因画像待迁移而保持未完成。