kknongchang_2506/app/Module/Ulogic/AdminControllers/Helper/ShowHelperTrait.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\Show;

/**
 * 详情页辅助特性
 *
 * 提供用户逻辑模块后台控制器的详情页构建功能的具体实现
 */
trait ShowHelperTrait
{
    /**
     * 显示用户ID
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldUserId(string $field = 'user_id', string $label = '用户ID'): Show\Field
    {
        return $this->show->field($field, $label);
    }

    /**
     * 显示管理员ID
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldAdminId(string $field = 'admin_id', string $label = '管理员ID'): Show\Field
    {
        return $this->show->field($field, $label);
    }

    /**
     * 显示惩罚类型
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldPunishType(string $field = 'type', string $label = '惩罚类型'): Show\Field
    {
        return $this->show->field($field, $label)->as(function ($value) {
            return $value instanceof PUNISH_TYPE ? $value->name : $value;
        });
    }

    /**
     * 显示惩罚等级
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldPunishLevel(string $field = 'level', string $label = '惩罚等级'): Show\Field
    {
        return $this->show->field($field, $label);
    }

    /**
     * 显示描述
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldDesc(string $field = 'desc', string $label = '描述'): Show\Field
    {
        return $this->show->field($field, $label);
    }

    /**
     * 显示消息标题
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldMessageTitle(string $field = 'title', string $label = '消息标题'): Show\Field
    {
        return $this->show->field($field, $label);
    }

    /**
     * 显示消息内容
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldMessageContent(string $field = 'content', string $label = '消息内容'): Show\Field
    {
        return $this->show->field($field, $label);
    }

    /**
     * 显示消息类型
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldMessageType(string $field = 'type', string $label = '消息类型'): Show\Field
    {
        return $this->show->field($field, $label)->as(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 Show\Field
     */
    public function fieldMessageStatus(string $field = 'status', string $label = '消息状态'): Show\Field
    {
        return $this->show->field($field, $label)->as(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;
        });
    }

    /**
     * 显示发送者类型
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldSenderType(string $field = 'sender_type', string $label = '发送者类型'): Show\Field
    {
        return $this->show->field($field, $label)->as(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 Show\Field
     */
    public function fieldSenderId(string $field = 'sender_id', string $label = '发送者ID'): Show\Field
    {
        return $this->show->field($field, $label);
    }

    /**
     * 显示接收者ID
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldReceiverId(string $field = 'receiver_id', string $label = '接收者ID'): Show\Field
    {
        return $this->show->field($field, $label);
    }

    /**
     * 显示是否允许回复
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldAllowReply(string $field = 'allow_reply', string $label = '允许回复'): Show\Field
    {
        return $this->show->field($field, $label)->as(function ($value) {
            return $value ? '是' : '否';
        });
    }

    /**
     * 显示创建时间
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldCreatedAt(string $field = 'created_at', string $label = '创建时间'): Show\Field
    {
        return $this->show->field($field, $label);
    }

    /**
     * 显示更新时间
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldUpdatedAt(string $field = 'updated_at', string $label = '更新时间'): Show\Field
    {
        return $this->show->field($field, $label);
    }

    /**
     * 显示删除时间
     *
     * @param string $field 字段名
     * @param string $label 标签名
     * @return Show\Field
     */
    public function fieldDeletedAt(string $field = 'deleted_at', string $label = '删除时间'): Show\Field
    {
        return $this->show->field($field, $label);
    }
}