feat: 迁移渠道画像累计指标和玩家付费分层

2026-11-03 23:50:05 +08:00
parent 0de822f121
commit f5b7ce21b9
38 changed files with 1424 additions and 37 deletions
@@ -9,6 +9,6 @@
  "zeroGameCountClickable": true,
  "missingMetricsVisible": true,
  "sourceDatabaseCreatePayload": true,
-  "portraitPending": true,
+  "portraitPending": false,
  "pageErrors": []
 }
@@ -0,0 +1,35 @@
+{
+  "scope": "当前 sw7 登录会话，只读检查；完整累计、分层、日期与权限在隔离 TCP HTTP 中验证。",
+  "checks": [
+    {
+      "path": "/sw/promote/list?pageNum=1&pageSize=1",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "available": false
+    },
+    {
+      "path": "/sw/promote/portrait?sourceDb=lx&promoteId=1&period=total",
+      "http": 200,
+      "code": 7,
+      "msg": "渠道数据尚未接入",
+      "passed": true
+    },
+    {
+      "path": "/sw/promote/portrait?sourceDb=lx&promoteId=0",
+      "http": 200,
+      "code": 7,
+      "msg": "渠道查询参数不正确",
+      "passed": true
+    },
+    {
+      "path": "/sw/promote/portrait?sourceDb=invalid&promoteId=1",
+      "http": 200,
+      "code": 7,
+      "msg": "所属平台不正确",
+      "passed": true
+    }
+  ],
+  "passed": true
+}
@@ -0,0 +1,13 @@
+{
+  "method": "真实 Chrome，画像、游戏与预警数据为受控响应，不改业务数据",
+  "passed": true,
+  "activeMetric": true,
+  "totalNoComparison": true,
+  "canonicalLast7": true,
+  "fourPayTiers": true,
+  "gameDrawer": true,
+  "platformAndChannelAlertFilter": true,
+  "crossPlatformSameID": true,
+  "unavailableIsNotZero": true,
+  "pageErrors": []
+}
@@ -0,0 +1,32 @@
+# 渠道画像迁移核对
+
+已实现 `GET /sw/promote/portrait` 及渠道列表画像入口，来源为旧 `PromotePortraitServiceImpl`、`ChannelProfileDrawer.vue`、日汇总/身份键和支付 Mapper。完整业务库数据仍待最终复制验收。
+
+## 数据范围与基本资料
+
+- 先按当前商务本人/下级的正常绑定校验渠道可见性，平台与渠道 ID 组合定位；超管不限。
+- 统计树与原渠道画像 helper 一致：关闭下级只看自身；二级看自身及直属三级；一级看自身及同平台 top/parent 对应的渠道。
+- 基本信息包含昵称、账号、负责人、级别、审批状态、注册类型、注册/登录时间、归属商务、上级渠道与已通过推广游戏数。一级渠道不显示父级；其他渠道的父级账号从同平台记录重新读取。
+- 画像状态取 status，与列表锁定状态不同：0 待审核、1 正常、-2 驳回、-3 商务新增。第四张指标卡是活跃人数，不能套用商务画像的人均充值。
+
+## 时间与累计
+
+- 支持 today、yesterday、last7、last30、total；累计起点取当前人数去重模式的最早日汇总，缺省上海当天。
+- 累计模式无对照期，compareValue/changeRate/changeDiff/compareLabel 均为空；其他周期保持原对比规则。
+- 游戏分布和付费分层始终按累计身份范围，与顶部指标周期独立。
+- 今日/昨日趋势读取原始主账号和成功支付；其余按日汇总。金额固定模式 0，人数遵守全局去重偏好。
+
+## 付费分层
+
+- 参与者是累计注册身份键集合，重复键只计一次；无键时保留原注册人数回退规则。
+- 分层金额来自统计渠道树内的所有历史成功支付，没有支付时间过滤。因此历史或未来时间戳的支付仍可能影响已注册身份的分层，不擅自改成顶部日期范围。
+- 模式 1 按付款用户的原始 idcard 汇总，再按旧 trim/末尾 X 规则归一并合并；不擅自加主账号过滤或把子账号付款并到父账号。模式 0 按原始付款 user_id 汇总，并使用平台前缀与注册身份对应。
+- 大R ≥10000，中R ≥1000 且 <10000，小R >0 且 <1000，其余免费。先按旧金额规则保留两位再归档，比例独立保留一位，不强制凑成 100%。未出现在注册集合中的付款人不增加分层人数。
+
+## 修复的旧页面参数错误
+
+- 旧“近7天/近30天”发送 7d/30d，而旧后台只识别 last7/last30，导致回退今日；新页面发送后台正式参数。
+- 旧关联预警误将渠道 ID 传入 businessId；新页面使用 targetPromoteId 与 platformCodes，并继续由预警接口执行查看者数据范围隔离。
+- 小R/免费区间文案按实际后端 >0 / ≤0 调整，避免把小于一元的付费玩家误解为免费。
+
+验证覆盖领域规则、真实仓储查询、隔离数据库 TCP HTTP、浏览器完整交互及当前 sw7 只读接口。详见 `channel-portrait-http-2026-11-03.json` 与 `channel-portrait-page-2026-11-03.json`；全量 Go 测试与前端构建通过。
@@ -1,6 +1,6 @@
 # 渠道列表与新增渠道：源码核对记录

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

 ## 页面

@@ -52,4 +52,4 @@

 游戏分布依赖 `PromotePortraitServiceImpl.buildGameDistribution`、`SwReportDayQueryServiceImpl` 和日汇总/身份键 Mapper。当前实现只列根渠道已通过的游戏，用同渠道统计树读取日汇总：人数对 metric=1 的 identity_key 去重，dedup_mode 随偏好；金额固定 dedup_mode=0。累计起点从当前人数模式的最早日汇总取得，缺失则使用上海当天，即使模式 0 有更早数据也不改写该起点。截止上海当天，排除未来日期。先将金额保留两位再按金额降序、游戏 ID 升序排列。

-完整画像、报表汇总任务和预警生成任务仍属于后续范围。列表没有用无效画像按钮或占位响应冒充画像已迁移。
+完整渠道画像已接入，规则及验证见 `channel-portrait-source-notes.md`。报表汇总任务、预警生成任务和最终实库验收仍属于后续范围。
@@ -24,7 +24,7 @@
 | 1 | 商务用户字段、层级与角色、账号资料和审核、偏好、登录及找回密码 | 进行中 |
 | 2 | 平台绑定、商务/渠道可见范围、外部平台与 OA 数据源、商务列表及抽屉 | 进行中；绑定、旗下渠道、商务/SDK 画像、OA 激活只读接口已接入；外部数据源及审核实库联调待完成 |
 | 3 | 预警规则、记录与状态机、操作日志、附件、消息、任务注册与调度 | 进行中；规则、记录和工作流已接入；任务待迁移，消息盒子已确认属于未改动框架代码 |
-| 4 | 渠道列表及新增、渠道激活、推广游戏等业务接口与页面 | 进行中；渠道列表/新增、激活、游戏分布已接入，渠道画像待迁移 |
+| 4 | 渠道列表及新增、渠道激活、推广游戏等业务接口与页面 | 功能已接入；包含渠道画像，完整业务数据和源平台联调仍待最终验收 |
 | 5 | 日汇总构建、充值/注册明细、渠道/游戏/区服报表、排行、画像与仪表盘 | 待实现 |
 | 6 | 静态接口核对、后端测试、前端构建和页面验证 | 随阶段推进，最终全量复核 |
 | 7 | 用户确认源数据库，复制至隔离库，执行迁移，启动并逐接口核对数据 | 未开始，必须等待用户确认 |
@@ -47,7 +47,7 @@
 - 已落地商务用户七个扩展字段的存取及增量补列；登录和既有会话同时检查商务审核状态。
 - 已落地全局偏好 GET/PUT、当前用户隔离、缺省开启、显式关闭及幂等写入；Kra 顶栏增加统计口径入口。
 - 已落地商务列表、查询资料、新增子商务、部分编辑和审核状态，以及 Kra 风格 `BusinessList` 页面。层级及角色由服务端按原角色 ID 映射分配；账号、角色、偏好在同一事务创建。列表按平台与商务组合键统计直属一级渠道和已通过绑定。
- 商务与 SDK 商务画像已接入；渠道画像、其余报表及任务继续迁移。后端导出等接口另按源码核对，不能据此给旧页面增加不存在的按钮；最终仍需完整数据源验收。
+- 商务、SDK 商务和渠道画像已接入；其余报表及任务继续迁移。后端导出等接口另按源码核对，不能据此给旧页面增加不存在的按钮；最终仍需完整数据源验收。
 - 已接入绑定列表、指定商务已通过绑定详情、提交绑定及解绑四个接口，页面恢复仅三级可见的“绑定列表”页签及只读详情抽屉。绑定流程保持三级限制、平台验密、OA 待审核及驳回重提规则；新增键锁表 `sys_business_binding_locks`，串行处理同一平台商务的并发绑定。
 - 已恢复旧登录页的图片、文案、布局及记住账号功能，系统名称统一为“遨游龙翔游戏平台”。找回密码四个匿名接口位于 `/sw/auth/forgot-password/`，保留账号/手机号检查、60 秒发码限制、两分钟验证码、十分钟凭证、6–15 位密码及失败五次吊销等规则。
 - 找回密码采用同库事务保存验证码摘要和一次性凭证，并原子执行改密/消费凭证；新增 `sys_business_password_codes`、`sys_business_password_resets`。更新密码版本使旧 JWT 失效。短信复用 Kra 集成配置，`SW_PASSWORD_RESET_SMS_PROVIDER` 默认 `tencent`，也支持 `aliyun`；模板和通道凭据在对应集成配置中维护。
@@ -85,3 +85,5 @@
 - 画像日指标与日趋势读取汇总/身份键表，模式 0 人数带平台前缀、模式 1 跨平台身份证去重，金额固定模式 0。付费率分母为活跃人数，人均充值分母为注册人数；上期活跃为零时付费率对照和百分点差为 null。今日/昨日趋势读原始主账号与成功支付、补齐 24 小时；MySQL 保留原 HOUR(FROM_UNIXTIME) 会话时区语义。注册 TOP 5 在渠道树内 COUNT DISTINCT；人数上限在排序截取前应用。
 - 画像批次通过领域/存储/双库实际 TCP HTTP 测试、全量 Go 检查和前端 ESLint/构建；验证月末/闰月对比、四舍五入与负零、去重切换、金额稳定、原始小时口径、父级状态、跨商务拒绝及缺表。`portrait-http-2026-11-03.json` 为真实会话检查：无绑定返回零指标及完整趋势，有绑定缺表保留基本资料并明确未知。`portrait-page-2026-11-03.json` 核对三个入口、周期切换、交互图表、两个 ID 范畴和缺数据提示。
 - 当前没有执行最终旧数据库复制与迁移验收。
+- 渠道画像 `/sw/promote/portrait` 与列表入口已接入，包含基本资料、累计/当期指标、趋势、四档付费分层、关联预警及推广游戏抽屉。复用画像统计并增加经过校验的单渠道树范围、无对照期分支；渠道第四项保持活跃玩家。分层成员取累计注册身份，金额按历史成功支付及原始付款账号/身份证口径，保持无日期过滤，不能误复用指标周期过滤。
+- 修复旧渠道页面两处参数错配：近7/30天改发 last7/last30，关联预警改发 targetPromoteId 而不是 businessId。领域、存储和隔离 TCP HTTP 覆盖分层边界、子账号与跨平台、模式切换、累计无环比、原始小时趋势和缺数据；浏览器验证入口、正确参数、四档分层及游戏抽屉。全量 Go、ESLint/构建通过；当前真实会话请求记录于 `channel-portrait-http-2026-11-03.json`，仍未复制实际旧业务库。
@@ -31,7 +31,7 @@
 - `business-page-parity-2026-11-03.json`：真实 Chrome 渲染、受控身份/业务数据，检查四个等级的页签和按钮，以及三种审核状态的行操作；无页面运行时错误。
 - `http-business-bindings-2026-11-03.json`：真实运行实例及已有 sw7 测试数据的 HTTP 验证。
 - 旗下渠道已通过仓储与实际 HTTP 回归，覆盖已通过绑定、直属一级、跨平台同号和稳定分页；sw7 缺渠道数据时明确返回 `available=false`。
- 商务/SDK 商务画像已通过接口及浏览器验证；渠道画像仍待迁移，没有使用占位响应冒充完成。
+- 商务、SDK 商务和渠道画像已通过接口及浏览器验证；真实业务库数值仍待最终验收。

 ## 商务与游戏商务画像

@@ -48,7 +48,7 @@
 | 画像“旗下渠道”继续打开直属渠道抽屉 | 已对照父组件处理函数；传入 SW 用户 ID，SDK 场景附带平台和平台商务 ID |
 | 缺业务数据与没有业务数据 | 分别显示未接入与真实零，避免未知指标显示为零 |

-验证：`portrait-http-2026-11-03.json`、`portrait-page-2026-11-03.json` 及隔离双库 TCP HTTP 测试。完整平台资料与真实业务数值仍待最终实库联调；渠道画像是下一项独立工作。
+验证：`portrait-http-2026-11-03.json`、`portrait-page-2026-11-03.json` 及隔离双库 TCP HTTP 测试。完整平台资料与真实业务数值仍待最终实库联调。

 ## 其他页面

@@ -120,7 +120,7 @@
 | 平台、商务账号、渠道关键词、层级、类型、锁定状态筛选 | 已实现；修正旧“账号/负责人姓名”占位文案，按实际后端只查询账号 |
 | 列表类型个人/公会；新增类型个人/企业 | 按两处实际模板分别保留 |
 | 渠道信息、归属商务、上级/负责人、推广游戏、玩家、累计充值、锁定状态 | 已实现；缺失指标明确显示未接入 |
-| 没有编辑入口，行操作为画像 | 未增加编辑；画像随完整画像用例继续迁移，目前没有冒充可用的占位入口 |
+| 没有编辑入口，行操作为画像 | 已对齐，渠道画像入口及完整抽屉已接入 |
 | 添加渠道按按钮权限，不额外限制三级 | 已实现并用一级浏览器身份核对，上级可选择下级正常绑定 |
 | 切换平台清空游戏商务并重新加载、按平台商务 ID 去重 | 已实现，防止旧请求覆盖新平台选项 |
 | 添加成功后关闭抽屉、刷新第一页，允许同步延迟 | 已实现，保持源平台创建及同步延迟提示 |
@@ -128,4 +128,20 @@
 | 游戏分布显示累计玩家数、充值金额 | 已实现，实际取日汇总/身份键数据，独立于列表原始累计指标 |
 | 全局偏好变化刷新页面 | 复用 Kra 全局 reload，后端每次请求读取当前偏好 |

-验证：`channel-http-2026-11-03.json`、`channel-page-2026-11-03.json`，以及实际 TCP HTTP + 隔离主库/平台库。整菜单仍因画像待迁移而保持未完成。
+验证：`channel-http-2026-11-03.json`、`channel-page-2026-11-03.json`，以及实际 TCP HTTP + 隔离主库/平台库。画像新增验证见下表，完整真实数据仍待最终验收。
+
+## 渠道画像
+
+来源及计算规则见 `channel-portrait-source-notes.md`。
+
+| 旧页面行为 | 新页面状态 |
+| --- | --- |
+| 基本资料、上级渠道、注册与最后登录时间、推广游戏数 | 已实现，一级不显示上级，其余读取同平台当前上级账号 |
+| 今日、昨日、近7天、近30天、累计 | 已实现；修正旧 7d/30d 参数错配，发送 last7/last30 |
+| 注册玩家、充值金额、付费率、活跃玩家 | 已实现；累计模式无环比值 |
+| 两个趋势图与四档付费分层 | 已实现，复用 Kra 主题图表和进度条，分层按累计身份与历史成功支付 |
+| 推广游戏数点击打开游戏分布 | 已实现，携带同一平台和渠道 ID，始终累计口径 |
+| 关联预警分页 | 已实现；修复旧页面误传 businessId，改为平台＋targetPromoteId |
+| 缺业务表 | 保留能读取的基本资料，明确提示未接入，不生成假零分层 |
+
+验证：`channel-portrait-http-2026-11-03.json`、`channel-portrait-page-2026-11-03.json`、隔离数据真实 TCP HTTP 和完整 Go/前端构建检查。