feat: 迁移商务工作台指标和仪表盘榜单

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

@@ -96,3 +96,6 @@
 - 统计批次通过全量 Go、隔离数据库真实 TCP HTTP、领域/仓储测试、ESLint/生产构建；真实 sw7 请求和 Chrome 检查见 `analytics-http-2026-11-04.json`、`analytics-page-2026-11-04.json`。分页不改变汇总，缺表明确未接入；非法日期/倒置周期明确报错。没有添加旧统计页面不存在的导出按钮。详细口径与优化见 `analytics-source-notes.md`。
 - 区服列表与区服选项接口、Kra 区服分析页面已接入。统计按平台＋游戏＋区服编号分组，人数区服内去重、金额固定模式 0；页尾汇总全部筛选行。游戏必选，选项按当前游戏名，报表按历史游戏名，区服编号保留前导零。
 - 区服批次通过全量 Go、隔离数据库真实 TCP HTTP、前端 ESLint/构建和真实 sw7 只读接口请求，结果见 `server-analysis-http-2026-11-04.json`。覆盖跨平台同号、全量汇总、零行处理、偏好切换、资料补全及缺表；按用户新要求未执行页面交互检查。最终旧库验收仍未开始。
+- 工作台四个接口及 Kra 仪表盘业务区域已接入：六项指标、注册/充值 TOP10、未登录 TOP10、最低充值 TOP10 和已有预警的最新五条轮播。保留 Kra 欢迎区域、快捷入口与公告，平台和周期按旧页面设置；请求失败清空旧结果并提示，不能显示其他平台的缓存值。
+- 工作台保留本月对上月同日（截断月末）、模式 0 跨平台 ID 隔离、渠道树注册去重、金额固定模式 0、活跃渠道按自身注册/正充值计数、最低榜含零一级渠道，以及未登录回退创建时间和 99999 哨兵值。详见 `workbench-source-notes.md`。
+- 工作台批次全量 Go、隔离 TCP HTTP、领域/仓储测试、前端 ESLint/构建通过；真实 sw7 请求记录见 `workbench-http-2026-11-04.json`。缺业务表时六卡返回 null、榜单明确报未接入。未执行页面交互检查或最终旧库复制。
@@ -186,3 +186,9 @@
 按旧 `ServerAnalysis.vue` 源码迁移平台多选、游戏多选、区服单选、近 30 天默认日期、首个游戏自动查询、列排序/分页及全量汇总；沿用 Kra 控件，没有新增导出入口。切换平台清空游戏/区服，切换游戏清空区服，过期异步请求不覆盖新选项。统计字段保持所属平台、区服编号/名称、开服日期、新增注册、活跃玩家、充值金额、付费玩家和 ARPU。

 接口通过真实 sw7 请求及隔离数据库 TCP HTTP 验证，前端 ESLint/生产构建通过。按用户 2026-11-04 新要求，此后只检查接口，不再检查页面交互。详见 `server-analysis-source-notes.md`。
+
+## 工作台 / Kra 仪表盘
+
+直接核对旧 `views/index.vue`，在原 Kra 仪表盘中加入六项商务指标、平台多选、注册/充值两组横向榜图、未登录/最低充值两组榜表，以及最新五条待处理预警的四秒轮播和查看全部入口。注册/最高充值默认今日，最低充值默认近 30 天；每个榜单单独切换周期。保留 Kra 欢迎、快捷入口和公告，使用 Kra 卡片、颜色与 Element Plus 控件。没有移植旧页面的自定义图表样式。
+
+四个工作台接口和已有预警接口负责真实业务数据；接口缺表或错误明确提示，不将空选择、未接入和真实零混淆。按用户要求仅做接口实测、数据断言和构建，未做页面交互检查。
@@ -0,0 +1,84 @@
+{
+  "scope": "真实 sw7 会话；当前缺业务表，只读验证输入与未接入提示。正向六卡、榜单与权限通过隔离 TCP HTTP 测试。",
+  "checks": [
+    {
+      "path": "/sw/workbench/summary?",
+      "http": 200,
+      "code": 7,
+      "msg": "请选择所属平台后查看数据",
+      "passed": true
+    },
+    {
+      "path": "/sw/workbench/summary?sourceDbList=lx,hw,yq",
+      "http": 200,
+      "code": 0,
+      "msg": "成功",
+      "passed": true,
+      "available": false
+    },
+    {
+      "path": "/sw/workbench/registerTop?",
+      "http": 200,
+      "code": 7,
+      "msg": "请选择所属平台后查看数据",
+      "passed": true
+    },
+    {
+      "path": "/sw/workbench/registerTop?sourceDbList=lx,hw,yq",
+      "http": 200,
+      "code": 7,
+      "msg": "工作台所需业务数据尚未接入",
+      "passed": true
+    },
+    {
+      "path": "/sw/workbench/registerTop?sourceDbList=lx&period=invalid",
+      "http": 200,
+      "code": 7,
+      "msg": "时间维度无效，应为 today/yesterday/last7/last30",
+      "passed": true
+    },
+    {
+      "path": "/sw/workbench/payRank?",
+      "http": 200,
+      "code": 7,
+      "msg": "请选择所属平台后查看数据",
+      "passed": true
+    },
+    {
+      "path": "/sw/workbench/payRank?sourceDbList=lx,hw,yq",
+      "http": 200,
+      "code": 7,
+      "msg": "工作台所需业务数据尚未接入",
+      "passed": true
+    },
+    {
+      "path": "/sw/workbench/payRank?sourceDbList=lx&period=invalid",
+      "http": 200,
+      "code": 7,
+      "msg": "时间维度无效，应为 today/yesterday/last7/last30",
+      "passed": true
+    },
+    {
+      "path": "/sw/workbench/payRank?sourceDbList=lx,hw,yq&order=asc&period=last30",
+      "http": 200,
+      "code": 7,
+      "msg": "工作台所需业务数据尚未接入",
+      "passed": true
+    },
+    {
+      "path": "/sw/workbench/unloginTop?",
+      "http": 200,
+      "code": 7,
+      "msg": "请选择所属平台后查看数据",
+      "passed": true
+    },
+    {
+      "path": "/sw/workbench/unloginTop?sourceDbList=lx,hw,yq",
+      "http": 200,
+      "code": 7,
+      "msg": "工作台所需业务数据尚未接入",
+      "passed": true
+    }
+  ],
+  "passed": true
+}
@@ -0,0 +1,26 @@
+# 工作台与仪表盘业务数据
+
+核对旧 main `WorkbenchServiceImpl`、`ChannelTreeMetricsSupport`、日汇总 Mapper，以及 dev/dev1.0 的 `views/index.vue`，迁移 `/sw/workbench/summary`、`registerTop`、`payRank`、`unloginTop`。
+
+## 六项指标
+
+- `sourceDbList` 至少选择一个平台；商务范围为本人及下级正常绑定，超管不限；是否包含下级渠道与身份证去重读取当前偏好。
+- 今日注册、活跃人数对比昨日，今日充值对比昨日，本月充值对比上月 1 日至同日（上月无该日期时取月末）。金额固定模式 0，人数模式 0 在全平台汇总时加平台前缀，模式 1 跨平台去重。
+- 活跃渠道数按每个渠道自身当日注册人数大于 0 或汇总充值金额大于 0 计算，不合并一级；同一渠道同时命中只计一次。新增渠道数按可见实体的创建时间统计，包含下级开关同时影响两项。
+- 本期/上期值先保留两位，再算一位小数环比；上期为零时 changeRate=null。changeDiff 保留字段但为 null，与旧服务实际输出一致。
+
+## 四组榜单
+
+- 注册榜 TOP10：包含下级时使用旧 `countByChannelRoot` 的 INNER JOIN＋CASE，在渠道树内去重；不会将缺少实体的官方/历史孤立记录纳入注册榜。此处与渠道统计页的 LEFT JOIN 根口径不同。
+- 充值最高/最低榜按金额固定模式 0，再归并到根渠道。最高榜只保留正值，最低榜额外包含可见一级渠道的零充值实体；负值沿用旧最低榜行为，不擅自清零。官方/缺账号名称按旧规则回退。
+- 注册/最高充值默认今日，最低充值默认近 30 天，支持 today/yesterday/last7/last30；包括今天。最高/最低共用 payRank，通过 order 区分。
+- 未登录榜仅取可见一级实体，先用最后登录时间，无有效登录时用创建时间，两者都无效为 99999；未来日期为 0，按上海自然日计算。
+- 数值排序使用精确有理数；同值按 ID，跨平台同号追加平台稳定排序。充值显示两位小数，未登录天数为整数字符串；所有榜单排名连续 1 至 10。
+
+## 实现与验证
+
+- 仪表盘直接调用四个接口，并复用已有预警列表查询 status=1/pageSize=5，实现原最新五条轮播。Kra 快捷入口和公告保留。
+- 聚合、资料查询批量执行，未对每个渠道发起独立 SQL。注册榜不依赖金额表，未登录榜不依赖报表，缺少必要表返回明确不可用。
+- 六卡扩展 available=false 并返回 null 值；榜单保留数组成功协议，缺表返回业务错误，避免把未知榜单当作真实空榜。
+- 全量 Go、隔离数据库真实 TCP HTTP、前端 ESLint/构建通过；测试覆盖月末对照、零分母、大金额、TOP10、身份去重、下级偏好、负金额/零渠道、未登录回退和跨商务拒绝。实际 sw7 只读结果见 `workbench-http-2026-11-04.json`。
+- 按用户要求不检查页面交互。当前没有复制旧业务库，最终同源验收尚未开始。