chore: 移除剩余迁移验证脚本并说明汇总任务依赖
This commit is contained in:
Yvan
@@ -25,3 +25,38 @@
|
||||
领域与存储测试覆盖身份/账号规则、重复构建、自然日筛选和身份明细写失败后的原子回滚。真实 TCP HTTP 使用隔离数据库和 Kra 原生任务创建、手动触发、执行日志，核对两种报表实际落库且任务仍为禁用。
|
||||
|
||||
当前验证状态统一见 [验收与性能记录](validation.md)，不再维护阶段性运行报告。
|
||||
|
||||
## 任务、表与接口的对应关系
|
||||
|
||||
这些任务是 Go 内部注册的方法，与已删除的临时验证脚本无关。它们从当前主库读取已同步的原始数据，再生成统计结果；不负责将 SDK 平台数据同步进主库。当前运行服务主库为 sw9。
|
||||
|
||||
| 任务方法 | 日期范围 | 写入的统计表 |
|
||||
|---|---|---|
|
||||
| swReportDayTodayTask | 上海时区今天 | tab_sw_report_day、tab_sw_report_day_key |
|
||||
| swReportDayYesterdayTask | 上海时区昨天 | 同上 |
|
||||
| swReportDayBackfillTask | startDate 至 endDate，含两端 | 同上 |
|
||||
| swReportServerDayTodayTask | 上海时区今天 | tab_sw_report_server_day、tab_sw_report_server_day_key |
|
||||
| swReportServerDayYesterdayTask | 上海时区昨天 | 同上 |
|
||||
| swReportServerDayBackfillTask | startDate 至 endDate，含两端 | 同上 |
|
||||
|
||||
商务日报读取 `tab_user`（主账号注册及身份资料）、`tab_user_day_login`（登录）、`tab_spend`（成功充值）、`tab_game`（游戏名）。区服日报读取 `tab_user_play_info`（创角 create_time、活跃 play_time）、`tab_spend`、`tab_user`、`tab_game`。
|
||||
|
||||
`tab_sw_report_day` 按日期、平台、渠道、游戏、去重模式保存注册数、活跃人数、付费人数、新增付费人数和充值金额。`tab_sw_report_server_day` 在相同维度上增加区服，注册数代表创角玩家数，不包含新增付费人数。
|
||||
|
||||
两个 `_key` 表保存参与统计的身份键，供跨日期、渠道或游戏聚合时重新 `COUNT(DISTINCT identity_key)`。例如同一玩家连续两天活跃，查询这两天的独立活跃人数应为 1，不能直接将两个日活人数相加。`dedup_mode=0` 使用账号 ID，`dedup_mode=1` 使用规范化身份证；空身份证不计入模式 1。`metric` 为注册 1、活跃 2、付费 3，商务日报另有新增付费 4；金额查询只读模式 0，避免两种模式重复累加。
|
||||
|
||||
每次重建会在一个事务内锁定“报表类型＋日期”，读取原始数据，删除统计表及对应 key 表该 `stat_date` 的旧行，批量写入新结果。读取或写入失败、取消时回滚；每个日期单独提交，回跑中途失败不会撤销此前已完成日期。除统计表外，会使用 `sys_business_report_build_locks` 保存互斥锁键，任务执行框架将结果记入 `sys_timed_task_logs`。原始用户、充值和登录记录不会被这些任务改写。
|
||||
|
||||
| 使用方 | 接口 | 依赖 |
|
||||
|---|---|---|
|
||||
| 渠道数据统计 | GET /sw/channelData/list | 商务日报两表 |
|
||||
| 游戏数据 | GET /sw/gameData/list | 商务日报两表 |
|
||||
| 三类排行榜 | GET /sw/rank/channel、/business、/game | 商务日报两表 |
|
||||
| 仪表盘/工作台 | GET /sw/workbench/summary、/registerTop、/payRank | 商务日报两表；汇总中的新增渠道另查渠道表 |
|
||||
| 商务画像 | GET /sw/business/:userId/portrait、/sw/business/bindPlatform/portrait | 商务日报两表 |
|
||||
| 渠道画像及游戏分布 | GET /sw/promote/portrait、/sw/promote/game-distribution | 商务日报两表；付费分层还会读取原始充值 |
|
||||
| 区服分析 | GET /sw/serverAnalysis/list | 区服日报两表 |
|
||||
|
||||
普通渠道列表、注册明细、充值明细、渠道激活、工作台未登录榜，以及游戏/区服下拉选项不直接使用这四张汇总表。预警检测 `alertTriggerTask` 另行读取原始注册/充值数据，不由这些汇总任务生成预警。
|
||||
|
||||
今天任务用于当天持续刷新，昨天任务用于补算昨日完整数据，backfill 用于补历史或纠正迟到数据。2026-11-04 核实时六条计划全部停用：不自动刷新汇总，但已有历史结果仍可查询；若原始数据继续同步，依赖汇总的指标会与明细逐渐产生时间差。
|
||||
|
||||
Reference in New Issue
Block a user