aquaculture/app/Admin/Transforms/OrderShipStatusTransform.php

<?php

namespace App\Admin\Transforms; // 定义命名空间

use App\Enums\OrderShipStatusEnum; // 引入订单发货状态枚举类
use App\Enums\OrderStatusEnum; // 引入订单状态枚举类（未使用）
use App\Enums\OrderTypeEnum; // 引入订单类型枚举类（未使用）
use App\Models\Order; // 引入订单模型（未使用）

/**
 * 订单发货状态转换类
 *
 * 该类用于将订单发货状态的枚举值转换为可读的字符串形式。
 */
class OrderShipStatusTransform implements Transform
{
    /**
     * 将发货状态转换为对应的可读字符串
     *
     * @param mixed $status 发货状态的枚举值
     * @return string 返回对应的发货状态名称
     */
    public static function trans($status)
    {
        // 根据发货状态的枚举值进行判断并设置对应的字符串
        switch ($status) {
            case OrderShipStatusEnum::PENDING:
                $text = '未发货'; // 订单尚未发货
                break;
            case OrderShipStatusEnum::DELIVERED:
                $text = '待收货'; // 订单已发货，等待用户收货
                break;
            case OrderShipStatusEnum::RECEIVED:
                $text = '已收货'; // 用户已确认收货
                break;
            default:
                $text = '未知状态'; // 未知的发货状态
                break;
        }

        return $text; // 返回转换后的发货状态名称
    }
}