44 lines
4.7 KiB
Markdown
44 lines
4.7 KiB
Markdown
# 商务与 SDK 商务画像源码核对
|
|
|
|
两种画像接口、三个页面入口及报表读取已实现。接口、平台数据源及账号状态验证统一见 `validation.md`。
|
|
|
|
## 范围与入口
|
|
|
|
- `GET /sw/business/:userId/portrait`：普通商务画像。旧 `BusinessPortraitQueryBo` 取 `sourceDbList`，必须选择平台；不是渠道接口的 `sourceDb` 参数。通过目标商务本人及下级的正常绑定解析渠道范围。
|
|
- `GET /sw/business/bindPlatform/portrait`：指定 `sourceDb` 与 `platformBusierId` 的正常绑定，校验当前登录人的可见范围。基本资料读取对应平台 `tab_promote_business`，不能用 SW 用户资料冒充。
|
|
- 两种画像共用旧 `BusinessProfileDrawer.vue`。商务列表“画像”、绑定正常行“画像”、只读 SDK 绑定详情的平台入口都需要接上；此前移除的“编辑”不能恢复。
|
|
- SDK 基本信息中 `userId` 实际是平台商务 ID。关联预警及旗下渠道的查询仍应使用打开抽屉时的 SW 用户 ID 和绑定参数，不能误用这个平台 ID。
|
|
|
|
## 基本信息
|
|
|
|
- 普通商务：账号、姓名、级别、父商务账号/姓名、创建时间、审核状态；渠道数只数所选范围内一级渠道，本月新增判断渠道创建 Unix 秒位于上海本月首日（含）至明天零点（不含）。
|
|
- SDK 商务：账号、姓名、级别、创建 Unix 秒。二级的父商务是 `commerce1`，三级是 `commerce2`，一级没有父级；父记录不存在时不填父资料。
|
|
- SDK 状态与 SW 不同：SDK 的 1 为正常、0 为待审核、其余为停用；不能把 SDK 字符串 `"0"` 套用成 SW 正常。
|
|
- 普通商务画像的渠道数包含目标商务的下级绑定；旧“旗下渠道”抽屉接口仍是直属口径，需要保留并记录两者差异。
|
|
|
|
## 时间、卡片与趋势
|
|
|
|
来源：`BusinessPortraitServiceImpl`、`BusinessPortraitSupport`。
|
|
|
|
- 画像服务支持 today、yesterday、last7、last30、thismonth，大小写归一，空/未知回退 today。公共 helper 另外支持 total，但普通商务画像服务不接受 total；渠道画像才使用累计模式。
|
|
- today 对比昨日；yesterday 对比前日；last7/last30 包含今天并对比前一完整同长周期；thismonth 对比上月首日至相同日号，上月不足该日时截到月末。
|
|
- 注册玩家来自日汇总身份键的 REGISTER=1；付费率为 PAY=3 人数 / ACTIVE=2 人数 ×100，保留 1 位；人均充值为金额 / 注册人数，保留 2 位。
|
|
- 当前活跃为零时付费率为 0.0；对照期活跃为零时 compareValue 为 null，百分点差也为 null。
|
|
- 注册、金额、ARPU 的相对变化率为 `(current-previous)*100/previous`，保留 1 位；对照为零/null 时 changeRate 为 null。付费率用 changeDiff 百分点差。
|
|
- today/yesterday 的趋势读取原始主账号注册与成功支付，补齐 24 个小时；小时注册趋势不做身份证去重。MySQL 与原 Mapper 一致使用 `HOUR(FROM_UNIXTIME(...))`，原服务与新服务的数据库会话时区在最终实库验收时核对；SQLite 测试按传入上海日边界计算小时。
|
|
- 其他周期趋势来自日汇总/身份键，按天补零。金额查询固定 dedup_mode=0；人数随当前登录人的偏好。
|
|
- 跨平台不去重人数需要给身份键加 source_db 前缀；身份证去重模式按身份键跨平台去重。具体 SQL 在 `TabSwReportDayKeyMapper.xml` 的 summary / summaryByDate 中。
|
|
|
|
## 排行和关联预警
|
|
|
|
- 注册 TOP 5 经 `ChannelTreeMetricsSupport.countRegisterByDisplayChannel` 汇总：含下级时按源平台和一级渠道树 COUNT DISTINCT；一级取自身 ID，其他渠道 top_promote_id>0 时取 top，否则取自身 ID。不能把子渠道人数简单求和。人数先按旧 int 上限归一，再排序和截取 TOP 5。
|
|
- 充值 TOP 5 先按渠道取金额，再按 `resolveRootPromoteId` 归根；同平台分组，过滤 <=0，只取前五。按值降序、渠道 ID 升序，返回 rank、平台、渠道 ID/账号、value（保留两位）。
|
|
- 关联预警不在画像 DTO 中，由前端独立请求 `/sw/alertRecord/list`，参数为 `platformCodes`、SW `businessId`、分页。
|
|
- 旧 SDK 画像的预警仍按 SW 商务及平台筛选，没有单独按 platformBusierId 收窄；需按实际模板核对，不从基本资料 ID 推断范围。
|
|
|
|
## 验证与实现要求
|
|
|
|
沿用 DTO → service → biz → data，金额用精确计算，页面采用 Kra 图表/表格风格。不要在 stats 缺表时伪造零；没有任何绑定是已知空范围，可返回真实零和零趋势，有绑定但渠道/汇总未接入时保留可读取基本信息并明确未知指标。
|
|
|
|
当前验证状态统一见 [验收与性能记录](validation.md)，不再维护阶段性运行报告。
|