GridHelperTrait.php 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406
  1. <?php
  2. namespace App\Module\Game\AdminControllers\Helper;
  3. use App\Module\Game\Enums\REWARD_SOURCE_TYPE;
  4. use App\Module\Game\Enums\REWARD_TYPE;
  5. use App\Module\Game\Models\GameRewardGroup;
  6. use App\Module\User\Enums\STATUS2;
  7. use Dcat\Admin\Grid;
  8. use Dcat\Admin\Grid\Column;
  9. /**
  10. * 游戏用户列表页辅助特性
  11. *
  12. * 提供游戏用户模块后台控制器的列表页构建功能的具体实现
  13. * 包含用户基础信息和游戏相关信息的显示方法
  14. */
  15. trait GridHelperTrait
  16. {
  17. /**
  18. * 添加用户信息组合列
  19. *
  20. * 复用价值:高 - 将用户ID、用户名和头像组合显示,提高信息密度
  21. *
  22. * @param string $idField 用户ID字段名
  23. * @param string $usernameField 用户名字段名
  24. * @param string $label 标签名
  25. * @return Column
  26. */
  27. public function columnUserInfo(string $idField = 'id', string $usernameField = 'username', string $label = '用户信息'): Column
  28. {
  29. return $this->grid->column($idField, $label)->display(function ($userId) use ($usernameField) {
  30. $username = $this->{$usernameField} ?? '';
  31. return <<<HTML
  32. <div>
  33. <div>ID: {$userId}</div>
  34. <div>用户名: {$username}</div>
  35. </div>
  36. HTML;
  37. });
  38. }
  39. /**
  40. * 添加用户活动时间组合列
  41. *
  42. * 复用价值:高 - 将最后登录时间和最后活动时间组合显示,提高信息密度
  43. *
  44. * @param string $label 标签名
  45. * @return Column
  46. */
  47. public function columnUserActivityTimes(string $label = '活动时间'): Column
  48. {
  49. return $this->grid->column('info.last_login_time', $label)->display(function ($lastLoginTime) {
  50. $lastActivityTime = $this->info->last_activity_time ?? '';
  51. $loginTimeHtml = $lastLoginTime ? "<div>最后登录: {$lastLoginTime}</div>" : "<div>最后登录: 未登录</div>";
  52. $activityTimeHtml = $lastActivityTime ? "<div>最后活动: {$lastActivityTime}</div>" : "<div>最后活动: 无活动</div>";
  53. return $loginTimeHtml . $activityTimeHtml;
  54. })->sortable();
  55. }
  56. /**
  57. * 添加最后登录时间列
  58. *
  59. * 复用价值:中 - 单独显示最后登录时间
  60. *
  61. * @param string $label 标签名
  62. * @return Column
  63. */
  64. public function columnLastLoginTime(string $label = '最后登录时间'): Column
  65. {
  66. return $this->grid->column('info.last_login_time', $label)->display(function ($value) {
  67. return $value ?: '未登录';
  68. })->sortable();
  69. }
  70. /**
  71. * 添加最后活动时间列
  72. *
  73. * 复用价值:中 - 单独显示最后活动时间
  74. *
  75. * @param string $label 标签名
  76. * @return Column
  77. */
  78. public function columnLastActivityTime(string $label = '最后活动时间'): Column
  79. {
  80. return $this->grid->column('info.last_activity_time', $label)->display(function ($value) {
  81. return $value ?: '无活动';
  82. })->sortable();
  83. }
  84. /**
  85. * 添加用户联系信息组合列
  86. *
  87. * 复用价值:高 - 将用户手机号、邮箱和微信号组合显示,提高信息密度
  88. *
  89. * @param string $label 标签名
  90. * @return Column
  91. */
  92. public function columnUserContact(string $label = '联系方式'): Column
  93. {
  94. return $this->grid->column('id', $label)->display(function ($userId) {
  95. return '<span class="text-muted">联系方式</span>';
  96. });
  97. }
  98. /**
  99. * 添加时间信息组合列 - 使用统一的时间格式化
  100. *
  101. * 复用价值:高 - 将创建时间和更新时间组合显示,提高信息密度
  102. *
  103. * @param string $createdAtField 创建时间字段名
  104. * @param string $updatedAtField 更新时间字段名
  105. * @param string $label 标签名
  106. * @return Column
  107. */
  108. public function columnTimes($createdAtField = 'created_at', $updatedAtField = 'updated_at', $label = '时间信息'): Column
  109. {
  110. return $this->grid->column($createdAtField, $label)->display(function ($createdAt) use ($updatedAtField) {
  111. $updatedAt = $this->{$updatedAtField} ?? '';
  112. // 使用静态方法进行时间格式化
  113. $createdAtFormatted = self::formatDateTimeStatic($createdAt);
  114. $createdAtHtml = "<div><small class='text-muted'>创建:</small> {$createdAtFormatted}</div>";
  115. $updatedAtHtml = '';
  116. if ($updatedAt) {
  117. $updatedAtFormatted = self::formatDateTimeStatic($updatedAt);
  118. $updatedAtHtml = "<div><small class='text-muted'>更新:</small> {$updatedAtFormatted}</div>";
  119. }
  120. return $createdAtHtml . $updatedAtHtml;
  121. })->sortable();
  122. }
  123. /**
  124. * 格式化时间的静态方法
  125. *
  126. * @param mixed $value 时间值
  127. * @return string 格式化后的时间字符串
  128. */
  129. private static function formatDateTimeStatic($value)
  130. {
  131. // 检查空值(但不包括0,因为0是有效的时间戳)
  132. if (is_null($value) || $value === '') {
  133. return '-';
  134. }
  135. // 如果是时间戳,转换为日期时间字符串
  136. if (is_numeric($value)) {
  137. return date('Y-m-d H:i:s', $value);
  138. }
  139. // 如果是Carbon实例或DateTime对象
  140. if ($value instanceof \Carbon\Carbon || $value instanceof \DateTime) {
  141. return $value->format('Y-m-d H:i:s');
  142. }
  143. // 如果是字符串,尝试转换为标准格式
  144. if (is_string($value)) {
  145. try {
  146. $date = new \DateTime($value);
  147. return $date->format('Y-m-d H:i:s');
  148. } catch (\Exception $e) {
  149. return $value; // 如果转换失败,返回原值
  150. }
  151. }
  152. return $value;
  153. }
  154. /**
  155. * 添加用户资金账户信息列
  156. *
  157. * 复用价值:高 - 显示用户的资金账户信息
  158. *
  159. * @param string $idField 用户ID字段名
  160. * @param string $label 标签名
  161. * @return Column
  162. */
  163. public function columnUserFunds(string $idField = 'id', string $label = '资金账户'): Column
  164. {
  165. return $this->grid->column($idField, $label)->display(function ($userId) {
  166. return '<span class="text-muted">资金账户</span>';
  167. });
  168. }
  169. /**
  170. * 添加用户物品信息列
  171. *
  172. * 复用价值:高 - 显示用户的物品信息
  173. *
  174. * @param string $idField 用户ID字段名
  175. * @param string $label 标签名
  176. * @return Column
  177. */
  178. public function columnUserItems(string $idField = 'id', string $label = '物品背包'): Column
  179. {
  180. return $this->grid->column($idField, $label)->display(function ($userId) {
  181. return '<span class="text-muted">物品背包</span>';
  182. });
  183. }
  184. /**
  185. * 添加用户土地信息列
  186. *
  187. * 复用价值:高 - 显示用户的土地信息
  188. *
  189. * @param string $idField 用户ID字段名
  190. * @param string $label 标签名
  191. * @return Column
  192. */
  193. public function columnUserLands(string $idField = 'id', string $label = '土地信息'): Column
  194. {
  195. return $this->grid->column($idField, $label)->display(function ($userId) {
  196. return '<span class="text-muted">土地信息</span>';
  197. });
  198. }
  199. /**
  200. * 添加用户神像buff信息列
  201. *
  202. * 复用价值:高 - 显示用户的神像buff信息
  203. *
  204. * @param string $idField 用户ID字段名
  205. * @param string $label 标签名
  206. * @return Column
  207. */
  208. public function columnUserBuffs(string $idField = 'id', string $label = '神像加持'): Column
  209. {
  210. return $this->grid->column($idField, $label)->display(function ($userId) {
  211. return '<span class="text-muted">神像加持</span>';
  212. });
  213. }
  214. /**
  215. * 添加用户种植作物信息列
  216. *
  217. * 复用价值:高 - 显示用户的种植作物信息
  218. *
  219. * @param string $idField 用户ID字段名
  220. * @param string $label 标签名
  221. * @return Column
  222. */
  223. public function columnUserCrops(string $idField = 'id', string $label = '种植作物'): Column
  224. {
  225. return $this->grid->column($idField, $label)->display(function ($userId) {
  226. // 获取用户的作物
  227. $crops = \App\Module\Farm\Models\FarmCrop::with(['seed', 'land'])
  228. ->where('user_id', $userId)
  229. ->get();
  230. if ($crops->isEmpty()) {
  231. return '<span class="text-muted">无种植作物</span>';
  232. }
  233. // 获取作物生长阶段统计
  234. $stageCounts = $crops->groupBy('growth_stage')->map->count();
  235. $stageMap = [
  236. \App\Module\Farm\Enums\GROWTH_STAGE::SEED->value => '种子期',
  237. \App\Module\Farm\Enums\GROWTH_STAGE::SPROUT->value => '发芽期',
  238. \App\Module\Farm\Enums\GROWTH_STAGE::GROWTH->value => '生长期',
  239. \App\Module\Farm\Enums\GROWTH_STAGE::FRUIT->value => '果实期',
  240. \App\Module\Farm\Enums\GROWTH_STAGE::MATURE->value => '成熟期',
  241. \App\Module\Farm\Enums\GROWTH_STAGE::WITHERED->value => '枯萎期'
  242. ];
  243. $html = '<div style="max-height: 150px; overflow-y: auto;">';
  244. $html .= "<div>总数: {$crops->count()} 株</div>";
  245. foreach ($stageCounts as $stage => $count) {
  246. $stageName = $stageMap[$stage] ?? "未知阶段({$stage})";
  247. $badgeClass = match($stage) {
  248. \App\Module\Farm\Enums\GROWTH_STAGE::SEED->value => 'secondary',
  249. \App\Module\Farm\Enums\GROWTH_STAGE::SPROUT->value => 'info',
  250. \App\Module\Farm\Enums\GROWTH_STAGE::GROWTH->value => 'primary',
  251. \App\Module\Farm\Enums\GROWTH_STAGE::FRUIT->value => 'warning',
  252. \App\Module\Farm\Enums\GROWTH_STAGE::MATURE->value => 'success',
  253. \App\Module\Farm\Enums\GROWTH_STAGE::WITHERED->value => 'danger',
  254. default => 'dark'
  255. };
  256. $html .= "<div><span class='badge badge-{$badgeClass}'>{$stageName}</span>: {$count} 株</div>";
  257. }
  258. $html .= '</div>';
  259. $html .= "<div><a href='" . admin_url("farm-crops?user_id={$userId}") . "' class='text-primary'>查看详情</a></div>";
  260. return $html;
  261. });
  262. }
  263. /**
  264. * 添加奖励类型列
  265. *
  266. * @param string $field 字段名
  267. * @param string $label 标签名
  268. * @return Column
  269. */
  270. public function columnRewardType(string $field = 'reward_type', string $label = '奖励类型'): Column
  271. {
  272. return $this->grid->column($field, $label)->display(function ($value) {
  273. return REWARD_TYPE::getName($value);
  274. })->label([
  275. REWARD_TYPE::ITEM->value => 'primary',
  276. REWARD_TYPE::CURRENCY->value => 'success',
  277. REWARD_TYPE::PET_EXP->value => 'info',
  278. REWARD_TYPE::PET_ENERGY->value => 'warning',
  279. REWARD_TYPE::OTHER->value => 'default',
  280. ]);
  281. }
  282. /**
  283. * 添加奖励来源类型列
  284. *
  285. * @param string $field 字段名
  286. * @param string $label 标签名
  287. * @return Column
  288. */
  289. public function columnRewardSourceType(string $field = 'source_type', string $label = '奖励来源'): Column
  290. {
  291. return $this->grid->column($field, $label)->display(function ($value) {
  292. return REWARD_SOURCE_TYPE::getName($value);
  293. })->label([
  294. REWARD_SOURCE_TYPE::TASK->value => 'primary',
  295. REWARD_SOURCE_TYPE::ACTIVITY->value => 'success',
  296. REWARD_SOURCE_TYPE::SIGN_IN->value => 'info',
  297. REWARD_SOURCE_TYPE::ACHIEVEMENT->value => 'warning',
  298. REWARD_SOURCE_TYPE::LEVEL->value => 'danger',
  299. REWARD_SOURCE_TYPE::CHEST->value => 'dark',
  300. REWARD_SOURCE_TYPE::SYSTEM->value => 'default',
  301. ]);
  302. }
  303. /**
  304. * 添加奖励组列
  305. *
  306. * @param string $field 字段名
  307. * @param string $label 标签名
  308. * @return Column
  309. */
  310. public function columnRewardGroup(string $field = 'group_id', string $label = '奖励组'): Column
  311. {
  312. return $this->grid->column($field, $label)->display(function ($value) {
  313. $group = GameRewardGroup::find($value);
  314. return $group ? "{$group->name} ({$group->code})" : "未知 ({$value})";
  315. });
  316. }
  317. /**
  318. * 添加奖励项列
  319. *
  320. * @param string $field 字段名
  321. * @param string $label 标签名
  322. * @return Column
  323. */
  324. public function columnRewardItems(string $field = 'reward_items', string $label = '奖励项'): Column
  325. {
  326. return $this->grid->column($field, $label)->display(function ($value) {
  327. $items = json_decode($value, true);
  328. if (empty($items)) {
  329. return '无奖励项';
  330. }
  331. $count = count($items);
  332. return "<span class=\"badge badge-primary\">{$count}个奖励项</span>";
  333. });
  334. }
  335. /**
  336. * 添加是否随机发放列
  337. *
  338. * @param string $field 字段名
  339. * @param string $label 标签名
  340. * @return Column
  341. */
  342. public function columnIsRandom(string $field = 'is_random', string $label = '随机发放'): Column
  343. {
  344. return $this->grid->column($field, $label)->switch();
  345. }
  346. /**
  347. * 添加是否必中列
  348. *
  349. * @param string $field 字段名
  350. * @param string $label 标签名
  351. * @return Column
  352. */
  353. public function columnIsGuaranteed(string $field = 'is_guaranteed', string $label = '必中'): Column
  354. {
  355. return $this->grid->column($field, $label)->switch();
  356. }
  357. /**
  358. * 添加权重列
  359. *
  360. * @param string $field 字段名
  361. * @param string $label 标签名
  362. * @return Column
  363. */
  364. public function columnWeight(string $field = 'weight', string $label = '权重'): Column
  365. {
  366. return $this->grid->column($field, $label)->sortable();
  367. }
  368. }