kra-new/docs/sw6-to-kra/channel-portrait-source-notes.md

渠道画像迁移核对

已实现 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 测试与前端构建通过。