修改URS达人等级逻辑：扩展团队统计到20代

- 修改UrsReferralService::getTeamMembers()默认参数从3代改为20代
- 修改UrsActiveUserService::getActiveTeamMembers()使用20代统计
- 重构UrsTalentLogic::calculateTeamStats()支持20代递归统计
- 在UrsPromotionRelationLevel枚举中添加getTeamStatsDepth()常量方法
- 更新updateReferrerStats()方法计算20代总人数
- 所有团队统计现在支持20代深度，提升达人等级计算准确性

AiWork/now.md

@@ -1,6 +1,37 @@
-# 修复农场灾害生成空指针异常 + 调查URS WebHook问题
+# URS达人等级逻辑修改 - 扩展团队统计到20代
 
-## 任务1：修复农场灾害生成空指针异常
+## 任务概述
+修改URS推广模块的达人等级逻辑，将团队总人数和活跃团队总人数的统计范围从3代扩展到20代。
+
+## 当前时间
+2025年07月03日 14:37:38 CST
+
+## 工作列表（标记状态，一句话描述工作）
+- [x] 修改UrsReferralService::getTeamMembers()方法
+- [x] 修改UrsActiveUserService::getActiveTeamMembers()方法
+- [x] 重构UrsTalentLogic::calculateTeamStats()方法
+- [x] 添加20代统计的配置常量
+- [x] 测试验证修改结果
+
+## 工作详情（列表工作详细描述，保留5项工作的，旧的的删除）
+
+## 任务1：URS达人等级逻辑修改 - 扩展团队统计到20代
+
+### 当前实现分析
+- 团队总人数：统计3代（直推、间推、三推）
+- 活跃团队总人数：基于3代团队进行活跃用户筛选
+- 相关方法都硬编码了3代的限制
+
+### 需要修改的文件
+1. `app/Module/UrsPromotion/Services/UrsReferralService.php`
+2. `app/Module/UrsPromotion/Services/UrsActiveUserService.php`
+3. `app/Module/UrsPromotion/Logics/UrsTalentLogic.php`
+4. 相关枚举或配置文件
+
+### 修改策略
+- 将硬编码的3代改为20代
+- 保持向后兼容性
+- 确保性能不受太大影响
 
 ### 错误详情
 - 错误位置：`app/Module/Farm/Logics/DisasterLogic.php` 第386行

app/Module/UrsPromotion/Enums/UrsPromotionRelationLevel.php

@@ -68,6 +68,14 @@ enum UrsPromotionRelationLevel: int
         return 20;
     }
 
+    /**
+     * 获取团队统计深度（达人等级计算使用）
+     */
+    public static function getTeamStatsDepth(): int
+    {
+        return 20;
+    }
+
     /**
      * 根据深度获取层级类型
      */

app/Module/UrsPromotion/Logics/UrsTalentLogic.php

@@ -5,9 +5,7 @@ namespace App\Module\UrsPromotion\Logics;
 use App\Module\UrsPromotion\Models\UrsUserReferral;
 use App\Module\UrsPromotion\Models\UrsUserTalent;
 use App\Module\UrsPromotion\Models\UrsTalentConfig;
-use App\Module\UrsPromotion\Enums\UrsTalentLevel;
 use App\Module\UrsPromotion\Enums\UrsPromotionRelationLevel;
-use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Log;
 
 /**
@@ -82,8 +80,8 @@ class UrsTalentLogic
     }
     
     /**
-     * 计算用户的团队统计数据
-     * 
+     * 计算用户的团队统计数据（支持20代统计）
+     *
      * @param int $userId 用户ID
      * @return array
      */
@@ -95,44 +93,87 @@ class UrsTalentLogic
             'third_count' => 0,
             'promotion_count' => 0,
         ];
-        
+
         // 获取直推用户
         $directUsers = UrsUserReferral::where('referrer_id', $userId)
             ->where('status', UrsUserReferral::STATUS_VALID)
             ->pluck('user_id')
             ->toArray();
-            
+
         $stats['direct_count'] = count($directUsers);
-        
+
         if (empty($directUsers)) {
             return $stats;
         }
-        
+
         // 获取间推用户（直推用户的直推）
         $indirectUsers = UrsUserReferral::whereIn('referrer_id', $directUsers)
             ->where('status', UrsUserReferral::STATUS_VALID)
             ->pluck('user_id')
             ->toArray();
-            
+
         $stats['indirect_count'] = count($indirectUsers);
-        
+
         if (empty($indirectUsers)) {
             $stats['promotion_count'] = $stats['direct_count'];
             return $stats;
         }
-        
+
         // 获取三推用户（间推用户的直推）
         $thirdUsers = UrsUserReferral::whereIn('referrer_id', $indirectUsers)
             ->where('status', UrsUserReferral::STATUS_VALID)
             ->pluck('user_id')
             ->toArray();
-            
+
         $stats['third_count'] = count($thirdUsers);
-        $stats['promotion_count'] = $stats['direct_count'] + $stats['indirect_count'] + $stats['third_count'];
-        
+
+        // 计算20代总人数（使用递归方式统计所有层级）
+        $allTeamUsers = $this->getAllTeamMembers($userId, UrsPromotionRelationLevel::getTeamStatsDepth());
+        $stats['promotion_count'] = count($allTeamUsers);
+
         return $stats;
     }
-    
+
+    /**
+     * 递归获取所有团队成员（支持多层级）
+     *
+     * @param int $userId 用户ID
+     * @param int $maxLevels 最大层级数
+     * @return array 所有团队成员的用户ID数组
+     */
+    private function getAllTeamMembers(int $userId, ?int $maxLevels = null): array
+    {
+        // 如果没有指定层级数，使用配置的团队统计深度
+        if ($maxLevels === null) {
+            $maxLevels = UrsPromotionRelationLevel::getTeamStatsDepth();
+        }
+
+        $allMembers = [];
+        $currentLevelUsers = [$userId];
+
+        for ($level = 1; $level <= $maxLevels; $level++) {
+            $nextLevelUsers = [];
+
+            foreach ($currentLevelUsers as $currentUserId) {
+                $directReferrals = UrsUserReferral::where('referrer_id', $currentUserId)
+                    ->where('status', UrsUserReferral::STATUS_VALID)
+                    ->pluck('user_id')
+                    ->toArray();
+
+                $nextLevelUsers = array_merge($nextLevelUsers, $directReferrals);
+            }
+
+            if (empty($nextLevelUsers)) {
+                break; // 没有下级了
+            }
+
+            $allMembers = array_merge($allMembers, $nextLevelUsers);
+            $currentLevelUsers = $nextLevelUsers;
+        }
+
+        return array_unique($allMembers);
+    }
+
     /**
      * 根据团队数据计算达人等级
      * 

app/Module/UrsPromotion/Services/UrsActiveUserService.php

@@ -195,8 +195,8 @@ class UrsActiveUserService
      */
     public static function getActiveTeamMembers(int $ursUserId): array
     {
-        // 获取用户的推荐关系
-        $teamMembers = UrsReferralService::getTeamMembers($ursUserId, 3); // 获取三代团队
+        // 获取用户的推荐关系（使用配置的团队统计深度，支持达人等级统计）
+        $teamMembers = UrsReferralService::getTeamMembers($ursUserId);
 
         if (empty($teamMembers)) {
             return [

app/Module/UrsPromotion/Services/UrsReferralService.php

@@ -3,6 +3,7 @@
 namespace App\Module\UrsPromotion\Services;
 
 use App\Module\UrsPromotion\Dtos\UrsUserReferralDto;
+use App\Module\UrsPromotion\Enums\UrsPromotionRelationLevel;
 use App\Module\UrsPromotion\Logics\UrsRelationCacheLogic;
 use App\Module\UrsPromotion\Models\UrsUserMapping;
 use App\Module\UrsPromotion\Models\UrsUserReferral;
@@ -148,11 +149,16 @@ class UrsReferralService
      * 获取用户的团队成员（向下查找）
      *
      * @param int $ursUserId URS用户ID
-     * @param int $maxLevels 最大层级数
+     * @param int $maxLevels 最大层级数（默认20代，支持达人等级统计）
      * @return array 团队成员，按层级分组 [level => [urs_user_ids]]
      */
-    public static function getTeamMembers(int $ursUserId, int $maxLevels = 3): array
+    public static function getTeamMembers(int $ursUserId, ?int $maxLevels = null): array
     {
+        // 如果没有指定层级数，使用配置的团队统计深度
+        if ($maxLevels === null) {
+            $maxLevels = UrsPromotionRelationLevel::getTeamStatsDepth();
+        }
+
         $team = [];
         $currentLevelUsers = [$ursUserId];
 
@@ -198,12 +204,18 @@ class UrsReferralService
     {
         $user_id = UrsUserMapping::getFarmUserIdByUrsUserId($ursReferrerId);
 
+        // 获取团队成员统计（使用配置的团队统计深度）
         $teamMembers = self::getTeamMembers($ursReferrerId);
 
         $directCount = count($teamMembers[1] ?? []);
         $indirectCount = count($teamMembers[2] ?? []);
         $thirdCount = count($teamMembers[3] ?? []);
-        $totalCount = $directCount + $indirectCount + $thirdCount;
+
+        // 计算20代总人数
+        $totalCount = 0;
+        foreach ($teamMembers as $members) {
+            $totalCount += count($members);
+        }
 
         UrsUserTalent::updateOrCreate(
             ['user_id' => $user_id],
@@ -211,7 +223,7 @@ class UrsReferralService
                 'direct_count' => $directCount,
                 'indirect_count' => $indirectCount,
                 'third_count' => $thirdCount,
-                'promotion_count' => $totalCount,
+                'promotion_count' => $totalCount, // 现在包含20代总人数
             ]
         );
     }

tests/Unit/UrsPromotion/UrsTeamStatsTest.php

@@ -0,0 +1,92 @@
+<?php
+
+namespace Tests\Unit\UrsPromotion;
+
+use Tests\TestCase;
+use App\Module\UrsPromotion\Services\UrsReferralService;
+use App\Module\UrsPromotion\Services\UrsActiveUserService;
+use App\Module\UrsPromotion\Enums\UrsPromotionRelationLevel;
+
+/**
+ * URS团队统计测试
+ * 
+ * 测试20代团队统计功能是否正常工作
+ */
+class UrsTeamStatsTest extends TestCase
+{
+    /**
+     * 测试团队统计深度配置
+     */
+    public function testTeamStatsDepthConfiguration()
+    {
+        // 测试配置常量是否正确
+        $this->assertEquals(20, UrsPromotionRelationLevel::getTeamStatsDepth());
+        $this->assertEquals(20, UrsPromotionRelationLevel::getMaxLevel());
+    }
+
+    /**
+     * 测试getTeamMembers方法的默认参数
+     */
+    public function testGetTeamMembersDefaultParameters()
+    {
+        // 创建一个测试用户ID（这里使用一个不存在的ID进行测试）
+        $testUserId = 999999;
+        
+        // 测试默认参数是否使用20代
+        $teamMembers = UrsReferralService::getTeamMembers($testUserId);
+        
+        // 由于是测试环境，可能没有实际数据，但方法应该能正常执行
+        $this->assertIsArray($teamMembers);
+    }
+
+    /**
+     * 测试活跃团队成员统计
+     */
+    public function testGetActiveTeamMembers()
+    {
+        // 创建一个测试用户ID
+        $testUserId = 999999;
+        
+        // 测试活跃团队成员统计
+        $activeStats = UrsActiveUserService::getActiveTeamMembers($testUserId);
+        
+        // 验证返回结构
+        $this->assertIsArray($activeStats);
+        $this->assertArrayHasKey('active_direct_count', $activeStats);
+        $this->assertArrayHasKey('active_total_count', $activeStats);
+        $this->assertArrayHasKey('active_members', $activeStats);
+    }
+
+    /**
+     * 测试层级名称生成
+     */
+    public function testLevelNameGeneration()
+    {
+        // 测试直推
+        $this->assertEquals('直推', UrsPromotionRelationLevel::getLevelNameByDepth(1));
+        
+        // 测试间推
+        $this->assertEquals('2级间推', UrsPromotionRelationLevel::getLevelNameByDepth(2));
+        $this->assertEquals('5级间推', UrsPromotionRelationLevel::getLevelNameByDepth(5));
+        $this->assertEquals('20级间推', UrsPromotionRelationLevel::getLevelNameByDepth(20));
+        
+        // 测试超级间推
+        $this->assertEquals('超级间推', UrsPromotionRelationLevel::getLevelNameByDepth(21));
+    }
+
+    /**
+     * 测试层级有效性检查
+     */
+    public function testLevelValidation()
+    {
+        // 测试有效层级
+        $this->assertTrue(UrsPromotionRelationLevel::isValidLevel(1));
+        $this->assertTrue(UrsPromotionRelationLevel::isValidLevel(10));
+        $this->assertTrue(UrsPromotionRelationLevel::isValidLevel(20));
+        
+        // 测试无效层级
+        $this->assertFalse(UrsPromotionRelationLevel::isValidLevel(0));
+        $this->assertFalse(UrsPromotionRelationLevel::isValidLevel(21));
+        $this->assertFalse(UrsPromotionRelationLevel::isValidLevel(-1));
+    }
+}