kknongchang_2506/app/Module/Transfer/Dtos/TransferFeeDto.php

<?php

namespace App\Module\Transfer\Dtos;

use UCore\Dto\BaseDto;

/**
 * 划转手续费计算结果数据传输对象
 * 
 * 用于表示手续费计算的结果，包含手续费率、手续费金额、实际到账金额等信息
 */
class TransferFeeDto extends BaseDto
{
    /**
     * 构造函数
     * 
     * @param float $feeRate 手续费率（小数形式，如 0.01 表示 1%）
     * @param string $feeAmount 手续费金额（字符串格式，保持精度）
     * @param string $actualAmount 实际到账金额（字符串格式，保持精度）
     * @param string $originalAmount 原始金额（字符串格式，保持精度）
     * @param bool $hasError 是否有错误
     * @param string|null $errorMessage 错误信息
     * @param array $additionalInfo 额外信息
     */
    public function __construct(
        public readonly float $feeRate,
        public readonly string $feeAmount,
        public readonly string $actualAmount,
        public readonly string $originalAmount,
        public readonly bool $hasError = false,
        public readonly ?string $errorMessage = null,
        public readonly array $additionalInfo = []
    ) {}

    /**
     * 创建成功的手续费计算结果
     * 
     * @param string $originalAmount 原始金额
     * @param float $feeRate 手续费率
     * @param string $feeAmount 手续费金额
     * @param string $actualAmount 实际到账金额
     * @param array $additionalInfo 额外信息
     * @return self
     */
    public static function success(
        string $originalAmount,
        float $feeRate,
        string $feeAmount,
        string $actualAmount,
        array $additionalInfo = []
    ): self {
        return new self(
            feeRate: $feeRate,
            feeAmount: $feeAmount,
            actualAmount: $actualAmount,
            originalAmount: $originalAmount,
            hasError: false,
            errorMessage: null,
            additionalInfo: $additionalInfo
        );
    }

    /**
     * 创建错误的手续费计算结果
     * 
     * @param string $originalAmount 原始金额
     * @param string $errorMessage 错误信息
     * @param array $additionalInfo 额外信息
     * @return self
     */
    public static function error(
        string $originalAmount,
        string $errorMessage,
        array $additionalInfo = []
    ): self {
        return new self(
            feeRate: 0.0000,
            feeAmount: '0.0000',
            actualAmount: $originalAmount,
            originalAmount: $originalAmount,
            hasError: true,
            errorMessage: $errorMessage,
            additionalInfo: $additionalInfo
        );
    }

    /**
     * 从数组创建DTO（兼容旧的数组格式）
     *
     * @param array $data 数组数据
     * @param string $originalAmount 原始金额
     * @return self
     */
    public static function fromLegacyArray(array $data, string $originalAmount = ''): self
    {
        // 检查是否有错误
        if (isset($data['error'])) {
            return self::error(
                originalAmount: $originalAmount,
                errorMessage: $data['error'],
                additionalInfo: array_diff_key($data, array_flip(['error']))
            );
        }

        return self::success(
            originalAmount: $originalAmount,
            feeRate: (float) ($data['fee_rate'] ?? 0.0000),
            feeAmount: (string) ($data['fee_amount'] ?? '0.0000'),
            actualAmount: (string) ($data['actual_amount'] ?? $originalAmount),
            additionalInfo: array_diff_key($data, array_flip(['fee_rate', 'fee_amount', 'actual_amount']))
        );
    }

    /**
     * 转换为数组（保持向后兼容）
     * 
     * @return array
     */
    public function toArray(): array
    {
        $result = [
            'fee_rate' => $this->feeRate,
            'fee_amount' => $this->feeAmount,
            'actual_amount' => $this->actualAmount,
            'original_amount' => $this->originalAmount,
            'has_error' => $this->hasError,
        ];

        // 如果有错误，添加错误信息
        if ($this->hasError && $this->errorMessage) {
            $result['error'] = $this->errorMessage;
        }

        // 添加额外信息
        if (!empty($this->additionalInfo)) {
            $result = array_merge($result, $this->additionalInfo);
        }

        return $result;
    }

    /**
     * 转换为兼容旧格式的数组
     * 
     * @return array
     */
    public function toLegacyArray(): array
    {
        if ($this->hasError) {
            return [
                'error' => $this->errorMessage,
                'fee_rate' => $this->feeRate,
                'fee_amount' => $this->feeAmount,
                'actual_amount' => $this->actualAmount,
            ];
        }

        return [
            'fee_rate' => $this->feeRate,
            'fee_amount' => $this->feeAmount,
            'actual_amount' => $this->actualAmount,
        ];
    }

    /**
     * 获取手续费率百分比格式
     * 
     * @param int $decimals 小数位数
     * @return string
     */
    public function getFeeRatePercent(int $decimals = 2): string
    {
        return number_format($this->feeRate * 100, $decimals) . '%';
    }

    /**
     * 判断是否有手续费
     * 
     * @return bool
     */
    public function hasFee(): bool
    {
        return bccomp($this->feeAmount, '0', 10) > 0;
    }

    /**
     * 判断是否计算成功
     * 
     * @return bool
     */
    public function isSuccess(): bool
    {
        return !$this->hasError;
    }

    /**
     * 获取格式化的手续费信息
     * 
     * @return string
     */
    public function getFormattedFeeInfo(): string
    {
        if ($this->hasError) {
            return "计算失败: {$this->errorMessage}";
        }

        if (!$this->hasFee()) {
            return "无手续费";
        }

        return "手续费: {$this->feeAmount} ({$this->getFeeRatePercent()})";
    }
}