GridHelperTrait.php 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311
  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 columnUserContact(string $label = '联系方式'): Column
  48. {
  49. return $this->grid->column('id', $label)->display(function ($userId) {
  50. return '<span class="text-muted">联系方式</span>';
  51. });
  52. }
  53. /**
  54. * 添加时间信息组合列
  55. *
  56. * 复用价值:高 - 将创建时间和更新时间组合显示,提高信息密度
  57. *
  58. * @param string $createdAtField 创建时间字段名
  59. * @param string $updatedAtField 更新时间字段名
  60. * @param string $label 标签名
  61. * @return Column
  62. */
  63. public function columnTimes(string $createdAtField = 'created_at', string $updatedAtField = 'updated_at', string $label = '时间信息'): Column
  64. {
  65. return $this->grid->column($createdAtField, $label)->display(function ($createdAt) use ($updatedAtField) {
  66. $updatedAt = $this->{$updatedAtField} ?? '';
  67. $createdAtHtml = "<div>创建: {$createdAt}</div>";
  68. $updatedAtHtml = $updatedAt ? "<div>更新: {$updatedAt}</div>" : '';
  69. return $createdAtHtml . $updatedAtHtml;
  70. });
  71. }
  72. /**
  73. * 添加用户资金账户信息列
  74. *
  75. * 复用价值:高 - 显示用户的资金账户信息
  76. *
  77. * @param string $idField 用户ID字段名
  78. * @param string $label 标签名
  79. * @return Column
  80. */
  81. public function columnUserFunds(string $idField = 'id', string $label = '资金账户'): Column
  82. {
  83. return $this->grid->column($idField, $label)->display(function ($userId) {
  84. return '<span class="text-muted">资金账户</span>';
  85. });
  86. }
  87. /**
  88. * 添加用户物品信息列
  89. *
  90. * 复用价值:高 - 显示用户的物品信息
  91. *
  92. * @param string $idField 用户ID字段名
  93. * @param string $label 标签名
  94. * @return Column
  95. */
  96. public function columnUserItems(string $idField = 'id', string $label = '物品背包'): Column
  97. {
  98. return $this->grid->column($idField, $label)->display(function ($userId) {
  99. return '<span class="text-muted">物品背包</span>';
  100. });
  101. }
  102. /**
  103. * 添加用户土地信息列
  104. *
  105. * 复用价值:高 - 显示用户的土地信息
  106. *
  107. * @param string $idField 用户ID字段名
  108. * @param string $label 标签名
  109. * @return Column
  110. */
  111. public function columnUserLands(string $idField = 'id', string $label = '土地信息'): Column
  112. {
  113. return $this->grid->column($idField, $label)->display(function ($userId) {
  114. return '<span class="text-muted">土地信息</span>';
  115. });
  116. }
  117. /**
  118. * 添加用户神像buff信息列
  119. *
  120. * 复用价值:高 - 显示用户的神像buff信息
  121. *
  122. * @param string $idField 用户ID字段名
  123. * @param string $label 标签名
  124. * @return Column
  125. */
  126. public function columnUserBuffs(string $idField = 'id', string $label = '神像加持'): Column
  127. {
  128. return $this->grid->column($idField, $label)->display(function ($userId) {
  129. return '<span class="text-muted">神像加持</span>';
  130. });
  131. }
  132. /**
  133. * 添加用户种植作物信息列
  134. *
  135. * 复用价值:高 - 显示用户的种植作物信息
  136. *
  137. * @param string $idField 用户ID字段名
  138. * @param string $label 标签名
  139. * @return Column
  140. */
  141. public function columnUserCrops(string $idField = 'id', string $label = '种植作物'): Column
  142. {
  143. return $this->grid->column($idField, $label)->display(function ($userId) {
  144. // 获取用户的作物
  145. $crops = \App\Module\Farm\Models\FarmCrop::with(['seed', 'land'])
  146. ->where('user_id', $userId)
  147. ->get();
  148. if ($crops->isEmpty()) {
  149. return '<span class="text-muted">无种植作物</span>';
  150. }
  151. // 获取作物生长阶段统计
  152. $stageCounts = $crops->groupBy('growth_stage')->map->count();
  153. $stageMap = [
  154. \App\Module\Farm\Enums\GROWTH_STAGE::SEED->value => '种子期',
  155. \App\Module\Farm\Enums\GROWTH_STAGE::SPROUT->value => '发芽期',
  156. \App\Module\Farm\Enums\GROWTH_STAGE::GROWTH->value => '生长期',
  157. \App\Module\Farm\Enums\GROWTH_STAGE::MATURE->value => '成熟期',
  158. \App\Module\Farm\Enums\GROWTH_STAGE::WITHERED->value => '枯萎期'
  159. ];
  160. $html = '<div style="max-height: 150px; overflow-y: auto;">';
  161. $html .= "<div>总数: {$crops->count()} 株</div>";
  162. foreach ($stageCounts as $stage => $count) {
  163. $stageName = $stageMap[$stage] ?? "未知阶段({$stage})";
  164. $badgeClass = match($stage) {
  165. \App\Module\Farm\Enums\GROWTH_STAGE::SEED->value => 'secondary',
  166. \App\Module\Farm\Enums\GROWTH_STAGE::SPROUT->value => 'info',
  167. \App\Module\Farm\Enums\GROWTH_STAGE::GROWTH->value => 'primary',
  168. \App\Module\Farm\Enums\GROWTH_STAGE::MATURE->value => 'success',
  169. \App\Module\Farm\Enums\GROWTH_STAGE::WITHERED->value => 'danger',
  170. default => 'dark'
  171. };
  172. $html .= "<div><span class='badge badge-{$badgeClass}'>{$stageName}</span>: {$count} 株</div>";
  173. }
  174. $html .= '</div>';
  175. $html .= "<div><a href='" . admin_url("farm-crops?user_id={$userId}") . "' class='text-primary'>查看详情</a></div>";
  176. return $html;
  177. });
  178. }
  179. /**
  180. * 添加奖励类型列
  181. *
  182. * @param string $field 字段名
  183. * @param string $label 标签名
  184. * @return Column
  185. */
  186. public function columnRewardType(string $field = 'reward_type', string $label = '奖励类型'): Column
  187. {
  188. return $this->grid->column($field, $label)->display(function ($value) {
  189. return REWARD_TYPE::getName($value);
  190. })->label([
  191. REWARD_TYPE::ITEM->value => 'primary',
  192. REWARD_TYPE::CURRENCY->value => 'success',
  193. REWARD_TYPE::PET_EXP->value => 'info',
  194. REWARD_TYPE::PET_ENERGY->value => 'warning',
  195. REWARD_TYPE::OTHER->value => 'default',
  196. ]);
  197. }
  198. /**
  199. * 添加奖励来源类型列
  200. *
  201. * @param string $field 字段名
  202. * @param string $label 标签名
  203. * @return Column
  204. */
  205. public function columnRewardSourceType(string $field = 'source_type', string $label = '奖励来源'): Column
  206. {
  207. return $this->grid->column($field, $label)->display(function ($value) {
  208. return REWARD_SOURCE_TYPE::getName($value);
  209. })->label([
  210. REWARD_SOURCE_TYPE::TASK->value => 'primary',
  211. REWARD_SOURCE_TYPE::ACTIVITY->value => 'success',
  212. REWARD_SOURCE_TYPE::SIGN_IN->value => 'info',
  213. REWARD_SOURCE_TYPE::ACHIEVEMENT->value => 'warning',
  214. REWARD_SOURCE_TYPE::LEVEL->value => 'danger',
  215. REWARD_SOURCE_TYPE::CHEST->value => 'dark',
  216. REWARD_SOURCE_TYPE::SYSTEM->value => 'default',
  217. ]);
  218. }
  219. /**
  220. * 添加奖励组列
  221. *
  222. * @param string $field 字段名
  223. * @param string $label 标签名
  224. * @return Column
  225. */
  226. public function columnRewardGroup(string $field = 'group_id', string $label = '奖励组'): Column
  227. {
  228. return $this->grid->column($field, $label)->display(function ($value) {
  229. $group = GameRewardGroup::find($value);
  230. return $group ? "{$group->name} ({$group->code})" : "未知 ({$value})";
  231. });
  232. }
  233. /**
  234. * 添加奖励项列
  235. *
  236. * @param string $field 字段名
  237. * @param string $label 标签名
  238. * @return Column
  239. */
  240. public function columnRewardItems(string $field = 'reward_items', string $label = '奖励项'): Column
  241. {
  242. return $this->grid->column($field, $label)->display(function ($value) {
  243. $items = json_decode($value, true);
  244. if (empty($items)) {
  245. return '无奖励项';
  246. }
  247. $count = count($items);
  248. return "<span class=\"badge badge-primary\">{$count}个奖励项</span>";
  249. });
  250. }
  251. /**
  252. * 添加是否随机发放列
  253. *
  254. * @param string $field 字段名
  255. * @param string $label 标签名
  256. * @return Column
  257. */
  258. public function columnIsRandom(string $field = 'is_random', string $label = '随机发放'): Column
  259. {
  260. return $this->grid->column($field, $label)->switch();
  261. }
  262. /**
  263. * 添加是否必中列
  264. *
  265. * @param string $field 字段名
  266. * @param string $label 标签名
  267. * @return Column
  268. */
  269. public function columnIsGuaranteed(string $field = 'is_guaranteed', string $label = '必中'): Column
  270. {
  271. return $this->grid->column($field, $label)->switch();
  272. }
  273. /**
  274. * 添加权重列
  275. *
  276. * @param string $field 字段名
  277. * @param string $label 标签名
  278. * @return Column
  279. */
  280. public function columnWeight(string $field = 'weight', string $label = '权重'): Column
  281. {
  282. return $this->grid->column($field, $label)->sortable();
  283. }
  284. }