feat: 迁移注册充值明细和筛选导出

2026-11-04 00:32:49 +08:00
parent f5b7ce21b9
commit 6703a66f0d
34 changed files with 1964 additions and 9 deletions
@@ -25,7 +25,7 @@
 | 2 | 平台绑定、商务/渠道可见范围、外部平台与 OA 数据源、商务列表及抽屉 | 进行中；绑定、旗下渠道、商务/SDK 画像、OA 激活只读接口已接入；外部数据源及审核实库联调待完成 |
 | 3 | 预警规则、记录与状态机、操作日志、附件、消息、任务注册与调度 | 进行中；规则、记录和工作流已接入；任务待迁移，消息盒子已确认属于未改动框架代码 |
 | 4 | 渠道列表及新增、渠道激活、推广游戏等业务接口与页面 | 功能已接入；包含渠道画像，完整业务数据和源平台联调仍待最终验收 |
-| 5 | 日汇总构建、充值/注册明细、渠道/游戏/区服报表、排行、画像与仪表盘 | 待实现 |
+| 5 | 日汇总构建、充值/注册明细、渠道/游戏/区服报表、排行、画像与仪表盘 | 进行中；画像、注册/充值明细及导出已接入，其余统计与任务待迁移 |
 | 6 | 静态接口核对、后端测试、前端构建和页面验证 | 随阶段推进，最终全量复核 |
 | 7 | 用户确认源数据库，复制至隔离库，执行迁移，启动并逐接口核对数据 | 未开始，必须等待用户确认 |

@@ -87,3 +87,6 @@
 - 当前没有执行最终旧数据库复制与迁移验收。
 - 渠道画像 `/sw/promote/portrait` 与列表入口已接入，包含基本资料、累计/当期指标、趋势、四档付费分层、关联预警及推广游戏抽屉。复用画像统计并增加经过校验的单渠道树范围、无对照期分支；渠道第四项保持活跃玩家。分层成员取累计注册身份，金额按历史成功支付及原始付款账号/身份证口径，保持无日期过滤，不能误复用指标周期过滤。
 - 修复旧渠道页面两处参数错配：近7/30天改发 last7/last30，关联预警改发 targetPromoteId 而不是 businessId。领域、存储和隔离 TCP HTTP 覆盖分层边界、子账号与跨平台、模式切换、累计无环比、原始小时趋势和缺数据；浏览器验证入口、正确参数、四档分层及游戏抽屉。全量 Go、ESLint/构建通过；当前真实会话请求记录于 `channel-portrait-http-2026-11-03.json`，仍未复制实际旧业务库。
+- 注册/充值明细、两个 XLSX 导出及游戏下拉共五个接口已接入。注册保留 puid=0、同平台玩家全部历史成功充值；充值合计只算成功单，不随列表状态改变。渠道精确匹配、商务文字筛选、官方/未知渠道和跨平台同号均按旧口径处理。
+- 修复注册游戏关联跨平台、超过200个渠道后放宽筛选的问题，批量补充当前页资料。导出超过10000条提前拒绝，保留数字/文本类型及原字段顺序。页面使用 Kra 表格、筛选、日期控件与下载，保留近30天默认显示和大额行高亮；注册导出权限与接口一致。
+- 明细批次通过全量 Go、前端 ESLint/构建、隔离 TCP HTTP、工作簿内容校验和浏览器筛选/下载。真实 sw7 请求及空查询工作簿验证记录见 `ledger-http-2026-11-04.json`、`ledger-page-2026-11-04.json`，没有导出或修改真实业务行；详细边界见 `ledger-source-notes.md`。
@@ -0,0 +1,86 @@
+{
+  "scope": "真实 sw7 会话，只读查询；导出使用确定为空的商务筛选，仅校验表头工作簿，不导出真实业务行。",
+  "checks": [
+    {
+      "method": "GET",
+      "path": "/sw/register/list?sourceDb=lx,hw,yq",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "total": 0,
+      "available": false
+    },
+    {
+      "method": "GET",
+      "path": "/sw/register/list?busierAccount=__kra_empty_export_probe_20261104__",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "total": 0,
+      "available": true
+    },
+    {
+      "method": "POST",
+      "path": "/sw/register/export",
+      "http": 200,
+      "xlsx": true,
+      "worksheet_rows": 1,
+      "passed": true
+    },
+    {
+      "method": "POST",
+      "path": "/sw/register/export",
+      "http": 200,
+      "code": 7,
+      "msg": "明细数据尚未接入，无法导出",
+      "passed": true
+    },
+    {
+      "method": "GET",
+      "path": "/sw/spend/list?sourceDb=lx,hw,yq",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "total": 0,
+      "available": false
+    },
+    {
+      "method": "GET",
+      "path": "/sw/spend/list?busierAccount=__kra_empty_export_probe_20261104__",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "total": 0,
+      "available": true
+    },
+    {
+      "method": "POST",
+      "path": "/sw/spend/export",
+      "http": 200,
+      "xlsx": true,
+      "worksheet_rows": 1,
+      "passed": true
+    },
+    {
+      "method": "POST",
+      "path": "/sw/spend/export",
+      "http": 200,
+      "code": 7,
+      "msg": "明细数据尚未接入，无法导出",
+      "passed": true
+    },
+    {
+      "method": "GET",
+      "path": "/sw/register/list?beginRegisterTime=bad&endRegisterTime=2026-11-04",
+      "http": 200,
+      "code": 7,
+      "msg": "明细查询参数不正确",
+      "passed": true
+    }
+  ],
+  "passed": true
+}
@@ -0,0 +1,27 @@
+{
+  "method": "真实 Chrome，列表数据受控；导出使用真实服务的空筛选生成 XLSX，不读取业务数据。",
+  "reports": [
+    {
+      "kind": "register",
+      "passed": true,
+      "defaultThirtyDays": true,
+      "gameNameSelection": true,
+      "exactAmountOrSuccessSummary": true,
+      "xlsxDownload": true,
+      "exportKeepsFilters": true,
+      "failedQueryClearsOldData": true,
+      "pageErrors": []
+    },
+    {
+      "kind": "spend",
+      "passed": true,
+      "defaultThirtyDays": true,
+      "gameNameSelection": true,
+      "exactAmountOrSuccessSummary": true,
+      "xlsxDownload": true,
+      "exportKeepsFilters": true,
+      "failedQueryClearsOldData": true,
+      "pageErrors": []
+    }
+  ]
+}
@@ -0,0 +1,36 @@
+# 注册与充值明细迁移核对
+
+已接入注册/充值列表、对应 XLSX 导出，以及页面依赖的游戏下拉接口。来源为旧 `RegisterServiceImpl`、`SpendServiceImpl`、`BusinessBindScopeServiceImpl`、`ReportQueryScopes` 和实际明细 Vue 页面。
+
+## 查询口径
+
+- 注册列表严格 `puid=0`，不包含 NULL，也不受身份证去重开关影响。注册时间使用 Unix 秒；未传完整日期时默认截至昨日的七天，页面主动传入的默认范围则是含今日的近30天。
+- 注册累计充值按同平台＋玩家 ID 汇总全部历史成功支付，不受本次注册日期和渠道过滤影响，也不归并子账号。
+- 充值列表按选定状态过滤；成功支付合计强制 pay_status=1，忽略选定状态，保留其余过滤。因此筛选失败订单时合计仍可非零。
+- 充值保留历史游戏名和渠道账号，注册保留首登游戏名快照。渠道资料缺失时依次保留历史账号、显示官方渠道（ID=0）或未知渠道及 ID。
+- 游戏选项来自平台游戏表，列表按游戏名称传参；注册游戏筛选通过同平台游戏 ID 关联，充值直接筛订单的游戏名快照。
+
+## 可见范围
+
+- 普通商务只用本人和下级正常绑定；三级只用本人。指定商务账号按平台账号或 SW 登录名的文字子串收窄。
+- 渠道账号为区分大小写的精确匹配。包含下级时，先解析命中渠道所属一级树，再与原可见渠道范围取交集；不包含下级时只保留一级。
+- 超管未按商务/渠道收窄且包含下级时，可以看到官方和已无当前渠道资料的历史数据；其他情况必须命中真实可见渠道。
+- 所有平台实体关联均带 source_db，不将同号玩家、渠道或游戏混为同一条。
+
+## 修复与优化
+
+- 修复旧注册游戏 EXISTS 内未限定外层 source_db 导致跨平台串号。
+- 保留旧累计充值排序已修复的外层用户关联，并按数值注册时间排序。
+- 移除“命中超过200个渠道后退回全平台”的筛选失效行为；用相关 EXISTS 表达渠道树，不需要把大量 ID 拼进请求。
+- 只读取当前页/导出范围所需的渠道与绑定资料，累计充值按玩家组合键分批查询。
+- 注册导出按钮使用正确的注册导出权限，不再误用充值导出权限；充值 ID 列不显示后台不支持的排序箭头。
+
+## 导出与页面
+
+- 超过10000条在读取完整结果和生成工作簿前拒绝；缺业务表不导出假空数据，确定无匹配绑定可导出只有表头的工作簿。
+- 保留原 VO 导出字段顺序，包括没有中文 ExcelProperty 的辅助字段；时间保留 Unix 秒，状态/方式保留原代码。
+- 数值直接写入数值 XML，不先转 float64；账号、订单号等强制文本，保留前导零并避免当作公式。
+- 页面按旧模板提供筛选、游戏远程下拉、日期快捷项、排序、分页、导出；充值金额≥5000的行高亮。查询失败会清除旧行和旧合计。
+- 游戏下拉的默认/批量 limit 行为沿用旧接口；区服分析的 servers/list 尚待后续实现，不能因 games 可用而标记整个区服页面完成。
+
+验证：领域/存储测试，实际 TCP HTTP 与 XLSX 内容校验，真实 sw7 的只读查询及确定空查询导出，Chrome 筛选/下载回归。见 `ledger-http-2026-11-04.json`、`ledger-page-2026-11-04.json`。未修改真实业务数据，最终旧库复制和数据比对尚未开始。
@@ -52,7 +52,24 @@

 ## 其他页面

-渠道统计、充值明细、注册明细、游戏数据、区服分析和排行榜，均需在各自实现前逐项提取旧模板的筛选项、列、按钮、抽屉、权限和跳转。数据库菜单清单或后端接口清单只能用于交叉核对，不能替代页面核对。
+渠道统计、游戏数据、区服分析和排行榜，均需在各自实现前逐项提取旧模板的筛选项、列、按钮、抽屉、权限和跳转。数据库菜单清单或后端接口清单只能用于交叉核对，不能替代页面核对。
+
+## 注册与充值明细
+
+来源：旧 `RegistrationDetails.vue`、`RechargeDetails.vue`，查询及导出边界见 `ledger-source-notes.md`。
+
+| 旧页面行为 | 新页面状态 |
+| --- | --- |
+| 平台、商务账号、玩家ID、精确渠道账号、游戏名称与日期筛选 | 已实现；游戏选项按平台查询并按名称选择 |
+| 页面默认含今日近30天，后台不传日期默认截至昨日7天 | 分别保留；日期快捷为今日/昨日/本周/本月 |
+| 注册列没有独立 ID 与角色名称，包含累计充值 | 已对齐；累计充值按同平台玩家全部历史成功支付 |
+| 充值包含订单、区服、角色、方式、状态及成功支付合计 | 已实现；合计不跟随失败/处理中状态筛选改变口径 |
+| 时间、金额服务端排序 | 已实现；不提供后台不支持的充值 ID 排序 |
+| 充值≥5000的行高亮 | 已保留 |
+| 导出当前筛选数据，最多10000条 | 已实现 XLSX；注册按钮改用正确的注册导出权限 |
+| 缺业务数据或查询失败 | 明确提示，清除旧行与旧合计，不导出假空业务数据 |
+
+验证：`ledger-http-2026-11-04.json`、`ledger-page-2026-11-04.json`，实际 TCP HTTP、工作簿内容检查及全量 Go/前端构建。真实服务导出验证仅使用确定无匹配数据的筛选。

 ## 预警规则