kknongchang_2506/app/Module/Ulogic/AdminControllers/Helper/GridHelperTrait.php

<?php

namespace App\Module\Ulogic\AdminControllers\Helper;

use App\Module\AppMessage\Enums\APP_MESSAGE_STATUS;
use App\Module\AppMessage\Enums\APP_MESSAGE_TYPE;
use App\Module\AppMessage\Enums\APP_SENDER_TYPE;
use App\Module\Ulogic\Enum\PUNISH_TYPE;
use Dcat\Admin\Grid;
use Dcat\Admin\Grid\Column;

/**
 * 列表页辅助特性
 *
 * 提供用户逻辑模块后台控制器的列表页构建功能的具体实现
 */
trait GridHelperTrait
{
    /**
     * 添加ID列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnId(string $field = 'id', string $label = 'ID'): Column
    {
        return $this->grid->column($field, $label)->sortable();
    }






    /**
     * 添加惩罚类型列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnPunishType(string $field = 'type', string $label = '惩罚类型'): Column
    {
        return $this->grid->column($field, $label)->display(function ($value) {
            return $value instanceof PUNISH_TYPE ? $value->name : $value;
        });
    }

    /**
     * 添加惩罚等级列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnPunishLevel(string $field = 'level', string $label = '惩罚等级'): Column
    {
        return $this->grid->column($field, $label);
    }

    /**
     * 添加描述列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param int $limit 限制长度
     * @return Column
     */
    public function columnDesc(string $field = 'desc', string $label = '描述', int $limit = 30): Column
    {
        return $this->grid->column($field, $label)->limit($limit);
    }

    /**
     * 添加消息标题列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param int $limit 限制长度
     * @return Column
     */
    public function columnMessageTitle(string $field = 'title', string $label = '消息标题', int $limit = 30): Column
    {
        return $this->grid->column($field, $label)->limit($limit);
    }

    /**
     * 添加消息内容列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @param int $limit 限制长度
     * @return Column
     */
    public function columnMessageContent(string $field = 'content', string $label = '消息内容', int $limit = 50): Column
    {
        return $this->grid->column($field, $label)->limit($limit);
    }

    /**
     * 添加消息类型列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnMessageType(string $field = 'type', string $label = '消息类型'): Column
    {
        return $this->grid->column($field, $label)->display(function ($value) {
            if ($value instanceof APP_MESSAGE_TYPE) {
                return match($value) {
                    APP_MESSAGE_TYPE::SYSTEM => '系统消息',
                    APP_MESSAGE_TYPE::USER => '用户消息',
                    APP_MESSAGE_TYPE::BUSINESS => '业务消息',
                    APP_MESSAGE_TYPE::SECURITY => '安全消息',
                    default => $value->value
                };
            }
            return $value;
        });
    }

    /**
     * 添加消息状态列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnMessageStatus(string $field = 'status', string $label = '消息状态'): Column
    {
        return $this->grid->column($field, $label)->display(function ($value) {
            if ($value instanceof APP_MESSAGE_STATUS) {
                return match($value) {
                    APP_MESSAGE_STATUS::DRAFT => '草稿',
                    APP_MESSAGE_STATUS::PUBLISHED => '已发布',
                    APP_MESSAGE_STATUS::ARCHIVED => '已归档',
                    default => $value->value
                };
            }
            return $value;
        })->label([
            APP_MESSAGE_STATUS::DRAFT->value => 'default',
            APP_MESSAGE_STATUS::PUBLISHED->value => 'success',
            APP_MESSAGE_STATUS::ARCHIVED->value => 'info',
        ]);
    }

    /**
     * 添加发送者类型列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnSenderType(string $field = 'sender_type', string $label = '发送者类型'): Column
    {
        return $this->grid->column($field, $label)->display(function ($value) {
            if ($value instanceof APP_SENDER_TYPE) {
                return match($value) {
                    APP_SENDER_TYPE::SYSTEM => '系统',
                    APP_SENDER_TYPE::USER => '用户',
                    APP_SENDER_TYPE::ADMIN => '管理员',
                    default => $value->value
                };
            }
            return $value;
        });
    }

    /**
     * 添加发送者ID列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnSenderId(string $field = 'sender_id', string $label = '发送者ID'): Column
    {
        return $this->grid->column($field, $label);
    }

    /**
     * 添加接收者ID列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnReceiverId(string $field = 'receiver_id', string $label = '接收者ID'): Column
    {
        return $this->grid->column($field, $label);
    }

    /**
     * 添加是否允许回复列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnAllowReply(string $field = 'allow_reply', string $label = '允许回复'): Column
    {
        return $this->grid->column($field, $label)->bool();
    }

    /**
     * 添加创建时间列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnCreatedAt(string $field = 'created_at', string $label = '创建时间'): Column
    {
        return $this->grid->column($field, $label)->sortable();
    }

    /**
     * 添加更新时间列
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Column
     */
    public function columnUpdatedAt(string $field = 'updated_at', string $label = '更新时间'): Column
    {
        return $this->grid->column($field, $label)->sortable();
    }
}