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

<?php

namespace App\Module\Fund\Dto;

use App\Module\Fund\Enums\FUND_TYPE;

/**
 * 转账结果数据传输对象
 *
 * 用于在服务层返回转账结果信息，避免直接暴露模型对象
 */
class TransferResultDto
{
    /**
     * @var int 转账ID
     */
    public int $id;

    /**
     * @var int 发送用户ID
     */
    public int $fromUserId;

    /**
     * @var int 接收用户ID
     */
    public int $toUserId;

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

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

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

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

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

    /**
     * @var string|null 发送用户名称（可选）
     */
    public ?string $fromUserName = null;

    /**
     * @var string|null 接收用户名称（可选）
     */
    public ?string $toUserName = null;

    /**
     * 从模型创建DTO
     *
     * @param mixed $model 转账模型
     * @param array $fundNames 资金类型名称映射（可选）
     * @param array $userNames 用户名称映射（可选）
     * @return self
     */
    public static function fromModel($model, array $fundNames = [], array $userNames = []): self
    {
        $dto = new self();
        $dto->id = $model->id;
        $dto->fromUserId = $model->from_user_id;
        $dto->toUserId = $model->to_user_id;
        $dto->fundId = $model->fund_id;

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

        $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];
        }

        // 如果提供了用户名称映射，则设置用户名称
        if (!empty($userNames)) {
            if (isset($userNames[$model->from_user_id])) {
                $dto->fromUserName = $userNames[$model->from_user_id];
            }
            
            if (isset($userNames[$model->to_user_id])) {
                $dto->toUserName = $userNames[$model->to_user_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,
            'from_user_id' => $this->fromUserId,
            'to_user_id' => $this->toUserId,
            'fund_id' => $this->fundId instanceof FUND_TYPE ? $this->fundId->value : $this->fundId,
            'amount' => $this->amount,
            'remark' => $this->remark,
            'create_time' => $this->createTime,
        ];

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

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

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

        return $result;
    }
}