kknongchang_2506/app/Module/UrsPromotion/Models/UrsUserTalent.php

<?php

namespace App\Module\UrsPromotion\Models;

use UCore\ModelCore;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use App\Module\User\Models\User;
use App\Module\UrsPromotion\Enums\UrsTalentLevel;

/**
 * URS用户达人等级模型
 * field start 
 * @property  int  $id  主键ID
 * @property  int  $user_id  用户ID
 * @property  int  $talent_level  URS达人等级:0无,1初级,2中级,3高级,4资深,5顶级
 * @property  int  $direct_count  直推人数
 * @property  int  $indirect_count  间推人数
 * @property  int  $third_count  三推人数
 * @property  int  $promotion_count  团队总人数
 * @property  \Carbon\Carbon  $last_level_update_time  最后等级更新时间
 * @property  \Carbon\Carbon  $created_at  创建时间
 * @property  \Carbon\Carbon  $updated_at  更新时间
 * field end
 * 
 * @property-read User $user 用户
 */
class UrsUserTalent extends ModelCore
{
    /**
     * 数据库表名
     */
    protected $table = 'urs_promotion_user_talents';

    
    /**
     * 可批量赋值的属性
     */
    protected $fillable = [
        'user_id',
        'talent_level',
        'direct_count',
        'indirect_count',
        'third_count',
        'promotion_count',
        'last_level_update_time',
    ];

    /**
     * 属性类型转换
     */
    protected $casts = [
        'user_id' => 'integer',
        'talent_level' => 'integer',
        'direct_count' => 'integer',
        'indirect_count' => 'integer',
        'third_count' => 'integer',
        'promotion_count' => 'integer',
        'last_level_update_time' => 'datetime',
        'created_at' => 'datetime',
        'updated_at' => 'datetime',
    ];

    /**
     * 获取用户映射关系
     */
    public function userMapping(): BelongsTo
    {
        return $this->belongsTo(UrsUserMapping::class, 'user_id', 'user_id');
    }

    /**
     * 获取达人等级枚举
     */
    public function getTalentLevelEnum(): UrsTalentLevel
    {
        return UrsTalentLevel::fromInt($this->talent_level) ?? UrsTalentLevel::NONE;
    }

    /**
     * 获取达人等级名称
     */
    public function getTalentLevelName(): string
    {
        return $this->getTalentLevelEnum()->getName();
    }

    /**
     * 检查是否为达人
     */
    public function isTalent(): bool
    {
        return $this->getTalentLevelEnum()->isTalent();
    }

    /**
     * 更新团队统计数据
     *
     * @param int $directCount 直推人数
     * @param int $indirectCount 间推人数
     * @param int $thirdCount 三推人数
     * @param int $promotionCount 团队总人数（20代统计）
     */
    public function updateTeamStats(int $directCount, int $indirectCount, int $thirdCount, int $promotionCount): void
    {
        $this->direct_count = $directCount;
        $this->indirect_count = $indirectCount;
        $this->third_count = $thirdCount;
        $this->promotion_count = $promotionCount;
    }

    /**
     * 升级达人等级
     */
    public function upgradeTalentLevel(int $newLevel): void
    {
        if ($newLevel > $this->talent_level) {
            $this->talent_level = $newLevel;
            $this->last_level_update_time = now();
        }
    }

    /**
     * 获取团队总人数（20代统计）
     */
    public function getTotalTeamCount(): int
    {
        return $this->promotion_count;
    }

    /**
     * 获取前三代团队总人数
     */
    public function getThreeGenTeamCount(): int
    {
        return $this->direct_count + $this->indirect_count + $this->third_count;
    }
}