kknongchang_2506/app/Module/Transfer/Events/FeeCalculatedEvent.php

<?php

namespace App\Module\Transfer\Events;

use App\Module\Transfer\Models\TransferApp;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;

/**
 * 手续费计算完成事件
 *
 * 在手续费计算完成后触发，用于记录日志、统计等
 */
class FeeCalculatedEvent
{
    use Dispatchable, SerializesModels;

    /**
     * 划转应用
     */
    public TransferApp $app;

    /**
     * 原始金额
     */
    public string $amount;

    /**
     * 手续费类型：'in' 或 'out'
     */
    public string $type;

    /**
     * 最终的手续费率
     */
    public float $feeRate;

    /**
     * 最终的手续费金额
     */
    public string $feeAmount;

    /**
     * 最终的实际到账金额
     */
    public string $actualAmount;

    /**
     * 是否被修改过
     */
    public bool $isModified;

    /**
     * 修改原因
     */
    public ?string $modificationReason;

    /**
     * 修改者标识
     */
    public ?string $modifiedBy;

    /**
     * 额外的上下文数据
     */
    public array $context;

    /**
     * 创建事件实例
     *
     * @param TransferApp $app 划转应用
     * @param string $amount 原始金额
     * @param string $type 手续费类型
     * @param float $feeRate 手续费率
     * @param string $feeAmount 手续费金额
     * @param string $actualAmount 实际到账金额
     * @param bool $isModified 是否被修改过
     * @param string|null $modificationReason 修改原因
     * @param string|null $modifiedBy 修改者标识
     * @param array $context 额外的上下文数据
     */
    public function __construct(
        TransferApp $app,
        string $amount,
        string $type,
        float $feeRate,
        string $feeAmount,
        string $actualAmount,
        bool $isModified = false,
        ?string $modificationReason = null,
        ?string $modifiedBy = null,
        array $context = []
    ) {
        $this->app = $app;
        $this->amount = $amount;
        $this->type = $type;
        $this->feeRate = $feeRate;
        $this->feeAmount = $feeAmount;
        $this->actualAmount = $actualAmount;
        $this->isModified = $isModified;
        $this->modificationReason = $modificationReason;
        $this->modifiedBy = $modifiedBy;
        $this->context = $context;
    }

    /**
     * 从FeeCalculatingEvent创建
     *
     * @param FeeCalculatingEvent $calculatingEvent
     * @return static
     */
    public static function fromCalculatingEvent(FeeCalculatingEvent $calculatingEvent): static
    {
        return new static(
            app: $calculatingEvent->app,
            amount: $calculatingEvent->amount,
            type: $calculatingEvent->type,
            feeRate: $calculatingEvent->feeRate,
            feeAmount: $calculatingEvent->feeAmount,
            actualAmount: $calculatingEvent->actualAmount,
            isModified: $calculatingEvent->isModified,
            modificationReason: $calculatingEvent->modificationReason,
            modifiedBy: $calculatingEvent->modifiedBy,
            context: $calculatingEvent->context
        );
    }

    /**
     * 获取手续费计算结果
     *
     * @return array
     */
    public function getResult(): array
    {
        return [
            'fee_rate' => $this->feeRate,
            'fee_amount' => $this->feeAmount,
            'actual_amount' => $this->actualAmount,
            'is_modified' => $this->isModified,
            'modification_reason' => $this->modificationReason,
            'modified_by' => $this->modifiedBy,
        ];
    }

    /**
     * 获取上下文数据
     *
     * @param string $key 键名
     * @param mixed $default 默认值
     * @return mixed
     */
    public function getContext(string $key, $default = null)
    {
        return $this->context[$key] ?? $default;
    }

    /**
     * 检查是否为转入手续费
     *
     * @return bool
     */
    public function isTransferIn(): bool
    {
        return $this->type === 'in';
    }

    /**
     * 检查是否为转出手续费
     *
     * @return bool
     */
    public function isTransferOut(): bool
    {
        return $this->type === 'out';
    }




}