kknongchang_2506/app/Module/Fund/Dto/FundAdminDto.php

<?php

namespace App\Module\Fund\Dto;

use App\Module\Fund\Enums\FUND_TYPE;
use App\Module\Fund\Models\FundAdminModel;

/**
 * 管理员资金操作数据传输对象
 *
 * 用于在服务层返回管理员资金操作信息，避免直接暴露模型对象
 */
class FundAdminDto
{
    /**
     * @var int 操作ID
     */
    public int $id;

    /**
     * @var int 用户ID
     */
    public int $userId;

    /**
     * @var int|FUND_TYPE 资金类型ID
     */
    public $fundId;

    /**
     * @var float 总金额（小数形式）
     */
    public float $totalFee;

    /**
     * @var int 状态
     */
    public int $status;

    /**
     * @var int 管理员ID
     */
    public int $adminId;

    /**
     * @var string 备注
     */
    public string $remark;

    /**
     * @var int 创建时间
     */
    public int $createTime;

    /**
     * @var string|null 资金类型名称（可选）
     */
    public ?string $fundName = null;

    /**
     * 从模型创建DTO
     *
     * @param FundAdminModel $model 管理员操作模型
     * @param array $fundNames 资金类型名称映射（可选）
     * @return self
     */
    public static function fromModel(FundAdminModel $model, array $fundNames = []): self
    {
        $dto = new self();
        $dto->id = $model->id;
        $dto->userId = $model->user_id;
        $dto->fundId = $model->fund_id;

        // 直接使用数据库中的小数值
        $dto->totalFee = (float)$model->total_fee;

        $dto->status = $model->status;
        $dto->adminId = $model->admin_id;
        $dto->remark = $model->remark;
        $dto->createTime = $model->create_time;

        // 如果提供了资金类型名称映射，则设置资金类型名称
        if (!empty($fundNames) && isset($fundNames[$model->fund_id instanceof FUND_TYPE ? $model->fund_id->value : $model->fund_id])) {
            $dto->fundName = $fundNames[$model->fund_id instanceof FUND_TYPE ? $model->fund_id->value : $model->fund_id];
        }

        return $dto;
    }

    /**
     * 获取资金类型ID的整数值
     *
     * @return int
     */
    public function getFundId(): int
    {
        if ($this->fundId instanceof FUND_TYPE) {
            return $this->fundId->value;
        }
        return (int)$this->fundId;
    }

    /**
     * 转换为数组
     *
     * @return array
     */
    public function toArray(): array
    {
        $result = [
            'id' => $this->id,
            'user_id' => $this->userId,
            'fund_id' => $this->fundId instanceof FUND_TYPE ? $this->fundId->value : $this->fundId,
            'total_fee' => $this->totalFee,
            'status' => $this->status,
            'admin_id' => $this->adminId,
            'remark' => $this->remark,
            'create_time' => $this->createTime,
        ];

        if ($this->fundName !== null) {
            $result['fund_name'] = $this->fundName;
        }

        return $result;
    }
}