<?php

namespace App\Module\Promotion\Events;

use App\Module\Promotion\Models\PromotionReferralChange;
use App\Module\Promotion\Models\PromotionUserReferral;
use Illuminate\Broadcasting\InteractsWithSockets;
use Illuminate\Foundation\Events\Dispatchable;
use Illuminate\Queue\SerializesModels;

/**
 * 推荐关系更新事件
 *
 * 当用户的推荐关系被更新时触发此事件。
 * 监听此事件可以执行如下操作：
 * 1. 更新用户的团队统计数据
 * 2. 更新用户的达人等级
 * 3. 更新用户的关系缓存
 */
class ReferralUpdatedEvent
{
    use Dispatchable, InteractsWithSockets, SerializesModels;

    /**
     * 推荐关系模型
     *
     * @var PromotionUserReferral
     */
    public $referral;

    /**
     * 推荐关系修改记录
     *
     * @var PromotionReferralChange
     */
    public $change;

    /**
     * 创建一个新的事件实例
     *
     * @param PromotionUserReferral $referral 推荐关系模型
     * @param PromotionReferralChange $change 推荐关系修改记录
     * @return void
     */
    public function __construct(PromotionUserReferral $referral, PromotionReferralChange $change)
    {
        $this->referral = $referral;
        $this->change = $change;
    }
}