kra-new/docs/sw6-to-kra/ledger-source-notes.md

注册与充值明细迁移核对

已接入注册/充值列表、对应 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。未修改真实业务数据，最终旧库复制和数据比对尚未开始。