cursor/plans/定格统计迁入_admin_6bbf8d93.plan.md

name, overview, todos, isProject

name	overview	todos	isProject
定格统计迁入 admin	将「首充剩余定格列表」的查询与汇总逻辑从 slot_console innerapi 迁入 slot_admin，与用户列表等后台能力一致：直连 s_common + WalletService，前端路由不变。	id content status add-models 在 slot_admin 新增 FreeCreditsPlayer/Package Model（s_common） completed id content status migrate-logic 迁入 FreeCreditsStatsLogic + Validate/DTO，fetchTotalRecharge 改用 WalletService + UserModel completed id content status wire-controller 改造 FreeCreditsStatsController，移除 ConsoleClient 透传 completed id content status cleanup-bff 删除 console innerapi 与 slot_sdk ConsoleService 中 freeCredits* 方法 in_progress id content status verify-api 对比迁前后列表/汇总与用户列表充值金额口径 pending	false

首充定格统计迁入 slot_admin（去掉 console BFF）

结论：建议做

当前链路多一跳、职责错位：

flowchart LR
  vue[slot_admin_vue] --> admin[slot_admin FreeCreditsStatsController]
  admin --> sdk[slot_sdk ConsoleClient]
  sdk --> console[slot_console innerapi]
  console --> db[(s_common free_credits_*)]
  console --> wallet[slot_wallet statistics]

FreeCreditsStatsController.php 注释已写明「仅透传 slot_console innerapi」；FreeCreditsController 也标注「仅供 slot_admin 代理调用」——本质是 admin 专用 BFF，与 C 端 FreeCreditsLogic 无关。

同仓库内后台惯例是 admin 自己查库 + 按需调钱包，例如：

• UserLogic：WalletService::statistic + getNumberFormat
• UserProfitDailyLogic：同上
• RechargeGiftPlayerLogic：直连 s_common 活动表

slot_admin 已配置 s_common 连接，具备迁回条件。

目标链路：

flowchart LR
  vue[slot_admin_vue] --> admin[slot_admin Controller]
  admin --> logic[FreeCreditsStatsLogic]
  logic --> db[(s_common)]
  logic --> wallet[WalletService statistic]

不迁：C 端定格/提现/领取仍在 slot_console FreeCreditsLogic，避免动业务写路径。

---

实施范围

1. slot_admin 新增分层（对齐 backend-layering）

层	文件	职责
Validate	app/game/validate/FreeCreditsStatsValidate.php	page/limit、筛选字段类型与枚举
DTO	app/game/dto/FreeCreditsStatsQueryDTO.php	承接已校验参数
Logic	app/game/logic/FreeCreditsStatsLogic.php	从 console 迁入（以当前 FreeCreditsStatsLogic.php 为基准，含近期前端改动：无 activity_id/status 筛选、total_deposit 按用户 currency + getNumberFormat）
Model	app/game/model/common/FreeCreditsPlayerModel.php、FreeCreditsPackageModel.php	connection = s_common，表名与 console 一致，常量 STATUS_* / TYPE_* 复制
Controller	改造 FreeCreditsStatsController.php	Validate → DTO → Logic；index 一次返回 data/total/otherData（Logic 内 statistics + list）

累计充值：在 admin Logic 内用已有 WalletService::statistic + UserModel 按用户 currency 分组（与用户列表口径一致），不再经 console 调 wallet SDK。

对外契约：保持 GET/POST /game/freeCreditsStats/index 与字段名不变 → slot_admin_vue 无需改路由。

2. 从 console / SDK 下线 admin 专用 BFF

迁移验证通过后删除或标记废弃：

• slot_console/app/innerapi/logic/FreeCreditsStatsLogic.php
• slot_console/app/innerapi/controller/FreeCreditsController.php（若仅服务 stats）
• slot_sdk ConsoleService::freeCreditsList/statistics
• admin Controller 中 ConsoleClient / buildConsoleClient

3. 不做的项

• 不把 C 端 FreeCreditsLogic 抽到 slot_lib（范围过大，与本次 admin 统计无关）
• 不为两张表单独建 Service 中转层（Logic 内私有方法即可）

---

风险与注意点

1. DB 权限：确认 slot_admin 运行账号对 s_common.free_credits_player/package 有读权限（与 console 相同库）。
2. 双份 Model：console 仍保留 C 端用的 Model；admin 侧独立 Model 类，表结构变更需两处同步常量（可接受，与现有 RechargeGift* 模式一致）。
3. 一次请求两次查询：statistics + list 仍在单次 index 内完成；若后续数据量大，再在 Logic 内优化共用 filteredPlayerIds，不必回退 BFF。
4. UserProfitDaily 的 currency：其用 GameServerModel 固定币种；本功能应继续用 每用户 UserModel.currency（与 UserLogic 一致），避免回退到固定 USD。

---

验证清单

• 列表筛选（uid/source/定格时间/第一档状态/全部完成）与汇总 7 项与迁前一致
• 某 UID「累计充值」与后台用户列表 wallet.r / total_deposit 一致
• 去掉对 consoleApiHost 的依赖后，/game/freeCreditsStats/index 仍可正常访问
• console innerapi 无其它调用方后再删 SDK 方法