UrsReferralService.php 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470
  1. <?php
  2. namespace App\Module\UrsPromotion\Services;
  3. use App\Module\UrsPromotion\Enums\UrsPromotionRelationLevel;
  4. use App\Module\UrsPromotion\Models\UrsUserMapping;
  5. use App\Module\UrsPromotion\Models\UrsUserReferral;
  6. use App\Module\UrsPromotion\Models\UrsUserTalent;
  7. use Illuminate\Support\Facades\DB;
  8. use Illuminate\Support\Facades\Log;
  9. /**
  10. * URS推荐关系服务
  11. *
  12. * 管理URS用户之间的推荐关系
  13. */
  14. class UrsReferralService
  15. {
  16. /**
  17. * 获取用户的推荐人
  18. *
  19. * @param int $ursUserId URS用户ID
  20. * @return int|null 推荐人URS用户ID,如果没有推荐人返回null
  21. */
  22. public static function getReferrer(int $ursUserId): int
  23. {
  24. $referral = UrsUserReferral::where('urs_user_id', $ursUserId)
  25. ->where('status', UrsUserReferral::STATUS_VALID)
  26. ->first();
  27. return $referral ? $referral->urs_referrer_id : 0;
  28. }
  29. /**
  30. * 获取用户的直推下级列表
  31. *
  32. * @param int $ursUserId URS用户ID
  33. * @return array 直推下级URS用户ID数组
  34. */
  35. public static function getDirectReferrals(int $ursUserId): array
  36. {
  37. return UrsUserReferral::where('urs_referrer_id', $ursUserId)
  38. ->where('status', UrsUserReferral::STATUS_VALID)
  39. ->where('user_id','>',0)
  40. ->pluck('urs_user_id')
  41. ->toArray();
  42. }
  43. /**
  44. * 获取用户的推荐关系链(向上查找)
  45. *
  46. * @param int $ursUserId URS用户ID
  47. * @param int $maxLevels 最大层级数
  48. * @return array 推荐关系链,按层级排序 [level => urs_user_id]
  49. */
  50. public static function getReferralChain(int $ursUserId, int $maxLevels = 10): array
  51. {
  52. $chain = [];
  53. $currentUserId = $ursUserId;
  54. for ($level = 1; $level <= $maxLevels; $level++) {
  55. $referrerId = self::getReferrer($currentUserId);
  56. if (!$referrerId) {
  57. break; // 没有上级了
  58. }
  59. $chain[$level] = $referrerId;
  60. $currentUserId = $referrerId;
  61. }
  62. return $chain;
  63. }
  64. /**
  65. * 获取上级 链ID
  66. * @param int $userId
  67. * @param int $maxLevels
  68. * @return array
  69. */
  70. public static function getReferralChain2(int $userId, int $maxLevels = 10): array
  71. {
  72. $chain = [];
  73. $relations = \App\Module\UrsPromotion\Models\UrsUserRelationCache::where('user_id', $userId)
  74. ->where('depth', '<=', $maxLevels)
  75. ->orderBy('depth')
  76. ->pluck('related_user_id','depth')->toArray()
  77. ;
  78. return $relations;
  79. }
  80. /**
  81. * 获取用户的团队成员(向下查找)
  82. *
  83. * @param int $ursUserId URS用户ID
  84. * @param int $maxLevels 最大层级数(默认20代,支持达人等级统计)
  85. * @return array 团队成员,按层级分组 [level => [urs_user_ids]]
  86. */
  87. public static function getTeamMembers(int $ursUserId, ?int $maxLevels = null): array
  88. {
  89. // 如果没有指定层级数,使用配置的团队统计深度
  90. if ($maxLevels === null) {
  91. $maxLevels = UrsPromotionRelationLevel::getTeamStatsDepth();
  92. }
  93. // 优先使用关系缓存表进行查询,性能更好
  94. return self::getTeamMembersFromCache($ursUserId, $maxLevels);
  95. }
  96. /**
  97. * 获取团队成员数量
  98. * @param int $ursUserId
  99. * @param int|null $maxLevels
  100. * @return array
  101. */
  102. public static function getTeamMNumber(int $ursUserId, ?int $maxLevels = null): array
  103. {
  104. // 如果没有指定层级数,使用配置的团队统计深度
  105. if ($maxLevels === null) {
  106. $maxLevels = UrsPromotionRelationLevel::getTeamStatsDepth();
  107. }
  108. // 优先使用关系缓存表进行查询,性能更好
  109. return self::getTeamMNumberFromCache($ursUserId, $maxLevels);
  110. }
  111. /**
  112. * 从关系缓存表获取团队成员(高性能版本)
  113. *
  114. * @param int $ursUserId URS用户ID
  115. * @param int $maxLevels 最大层级数
  116. * @return array 团队成员,按层级分组 [level => [urs_user_ids]]
  117. */
  118. private static function getTeamMembersFromCache(int $ursUserId, int $maxLevels): array
  119. {
  120. // 使用关系缓存表查询所有下级关系
  121. $relations = \App\Module\UrsPromotion\Models\UrsUserRelationCache::where('urs_related_user_id', $ursUserId)
  122. ->where('depth', '<=', $maxLevels)
  123. ->orderBy('depth')
  124. ->get(['urs_user_id', 'depth']);
  125. $team = [];
  126. foreach ($relations as $relation) {
  127. $level = $relation->depth;
  128. if (!isset($team[$level])) {
  129. $team[$level] = [];
  130. }
  131. $team[$level][] = $relation->urs_user_id;
  132. }
  133. return $team;
  134. }
  135. /**
  136. * 获取团队成员人数/层级
  137. * @param int $ursUserId
  138. * @param int $maxLevels
  139. * @return array [代数=>人数]
  140. */
  141. private static function getTeamMNumberFromCache(int $ursUserId, int $maxLevels): array
  142. {
  143. // 使用关系缓存表查询所有下级关系
  144. $relations = \App\Module\UrsPromotion\Models\UrsUserRelationCache::where('urs_related_user_id', $ursUserId)
  145. ->where('depth', '<=', $maxLevels)
  146. ->where('user_id','>',0)
  147. ->orderBy('depth')
  148. ->groupBy('depth')
  149. ->pluck(
  150. DB::raw('count(*) as total'),
  151. 'depth'
  152. );
  153. $team = [];
  154. $totle = 0;
  155. foreach ($relations as $level=>$number) {
  156. $team[$level] = $number;
  157. $totle += $number;
  158. }
  159. $team['total'] = $totle;
  160. // dd($relations);
  161. return $team;
  162. }
  163. /**
  164. * 获取用户的团队成员(递归查询版本,作为备用方案)
  165. *
  166. * @param int $ursUserId URS用户ID
  167. * @param int $maxLevels 最大层级数
  168. * @return array 团队成员,按层级分组 [level => [urs_user_ids]]
  169. */
  170. private static function getTeamMembersRecursive(int $ursUserId, int $maxLevels): array
  171. {
  172. $team = [];
  173. $currentLevelUsers = [$ursUserId];
  174. for ($level = 1; $level <= $maxLevels; $level++) {
  175. $nextLevelUsers = [];
  176. foreach ($currentLevelUsers as $userId) {
  177. $directReferrals = self::getDirectReferrals($userId);
  178. $nextLevelUsers = array_merge($nextLevelUsers, $directReferrals);
  179. }
  180. if (empty($nextLevelUsers)) {
  181. break; // 没有下级了
  182. }
  183. $team[$level] = $nextLevelUsers;
  184. $currentLevelUsers = $nextLevelUsers;
  185. }
  186. return $team;
  187. }
  188. /**
  189. * 获取活跃用户数量
  190. *
  191. * @param int $userId 农场用户ID
  192. * @param int $level 等级
  193. * @return int 活跃用户数量(映射关系有效且用户活跃)
  194. */
  195. public static function getTeamANumber($userId,$level = 3): int
  196. {
  197. // 通过关系缓存表获取三代内所有的URS用户ID
  198. $ursUserIds = \App\Module\UrsPromotion\Models\UrsUserRelationCache::where('related_user_id', $userId)
  199. ->where('depth', '<=', $level) // 只统计前3级
  200. ->pluck('urs_user_id')
  201. ->toArray();
  202. if (empty($ursUserIds)) {
  203. return 0;
  204. }
  205. // 到映射表查询活跃的人数(is_active=1为活跃)
  206. $validCount = \App\Module\UrsPromotion\Models\UrsUserMapping::whereIn('urs_user_id', $ursUserIds)
  207. ->where('status', 1) // 映射关系必须有效
  208. ->where('is_active', 1) // 用户必须活跃
  209. ->count();
  210. return $validCount;
  211. }
  212. /**
  213. * 更新推荐人的团队统计
  214. *
  215. * @param int $ursReferrerId URS推荐人ID
  216. */
  217. private static function updateReferrerStats(int $ursReferrerId): void
  218. {
  219. $user_id = UrsUserMapping::getFarmUserIdByUrsUserId($ursReferrerId);
  220. // 获取团队成员统计(使用配置的团队统计深度)
  221. $teamMembers = self::getTeamMembers($ursReferrerId);
  222. $directCount = count($teamMembers[1] ?? []);
  223. $indirectCount = count($teamMembers[2] ?? []);
  224. $thirdCount = count($teamMembers[3] ?? []);
  225. // 计算20代总人数
  226. $totalCount = 0;
  227. foreach ($teamMembers as $members) {
  228. $totalCount += count($members);
  229. }
  230. // 获取或创建用户达人记录
  231. $talent = UrsUserTalent::firstOrCreate(
  232. ['user_id' => $user_id],
  233. [
  234. 'talent_level' => 0,
  235. 'direct_count' => 0,
  236. 'indirect_count' => 0,
  237. 'third_count' => 0,
  238. 'promotion_count' => 0,
  239. ]
  240. );
  241. // 使用模型方法更新团队统计,确保逻辑一致性
  242. $talent->updateTeamStats($directCount, $indirectCount, $thirdCount, $totalCount);
  243. $talent->save();
  244. }
  245. /**
  246. * 批量更新团队统计
  247. *
  248. * @param array $ursUserIds URS用户ID数组
  249. */
  250. public static function batchUpdateTeamStats(array $ursUserIds): void
  251. {
  252. foreach ($ursUserIds as $ursUserId) {
  253. self::updateReferrerStats($ursUserId);
  254. }
  255. }
  256. /**
  257. * 获取推荐关系统计
  258. *
  259. * @param int $ursUserId URS用户ID
  260. * @return array
  261. */
  262. public static function getReferralStats(int $ursUserId): array
  263. {
  264. $teamMembers = self::getTeamMembers($ursUserId,3);
  265. $referralChain = self::getReferralChain($ursUserId);
  266. dump($teamMembers);
  267. return [
  268. 'urs_user_id' => $ursUserId,
  269. 'referrer_id' => self::getReferrer($ursUserId),
  270. 'referrer_level' => count($referralChain),
  271. 'direct_count' => count($teamMembers[1] ?? []),
  272. 'indirect_count' => count($teamMembers[2] ?? []),
  273. 'third_count' => count($teamMembers[3] ?? []),
  274. 'total_team_count' => array_sum(array_map('count', $teamMembers)),
  275. 'team_members' => $teamMembers,
  276. 'referral_chain' => $referralChain,
  277. ];
  278. }
  279. /**
  280. * 验证推荐关系的有效性
  281. *
  282. * @param int $ursUserId URS用户ID
  283. * @return bool
  284. */
  285. public static function validateReferral(int $ursUserId): bool
  286. {
  287. $referral = UrsUserReferral::where('urs_user_id', $ursUserId)->first();
  288. return $referral && $referral->isValid();
  289. }
  290. /**
  291. * 禁用推荐关系
  292. *
  293. * @param int $ursUserId URS用户ID
  294. * @return bool
  295. */
  296. public static function disableReferral(int $ursUserId): bool
  297. {
  298. try {
  299. $referral = UrsUserReferral::where('urs_user_id', $ursUserId)->first();
  300. if (!$referral) {
  301. return false;
  302. }
  303. $referral->setInvalid();
  304. $referral->save();
  305. // 更新推荐人的团队统计
  306. self::updateReferrerStats($referral->urs_referrer_id);
  307. Log::info('URS推荐关系已禁用', [
  308. 'urs_user_id' => $ursUserId,
  309. 'referral_id' => $referral->id
  310. ]);
  311. return true;
  312. } catch (\Exception $e) {
  313. Log::error('URS推荐关系禁用失败', [
  314. 'urs_user_id' => $ursUserId,
  315. 'error' => $e->getMessage()
  316. ]);
  317. return false;
  318. }
  319. }
  320. /**
  321. * 批量更新推荐关系表中的农场用户ID
  322. *
  323. * 当用户进入农场后,批量更新推荐关系表中的农场用户ID字段
  324. *
  325. * @return array 更新结果
  326. */
  327. public static function batchUpdateFarmUserIds(): array
  328. {
  329. try {
  330. Log::info('开始批量更新推荐关系表中的农场用户ID');
  331. // 使用SQL批量更新,提高性能
  332. $updateSql = "
  333. UPDATE `kku_urs_promotion_user_referrals` r
  334. LEFT JOIN `kku_urs_promotion_user_mappings` um ON r.urs_user_id = um.urs_user_id AND um.status = 1
  335. LEFT JOIN `kku_urs_promotion_user_mappings` rm ON r.urs_referrer_id = rm.urs_user_id AND rm.status = 1
  336. SET
  337. r.user_id = COALESCE(um.user_id, 0),
  338. r.referrer_id = COALESCE(rm.user_id, 0)
  339. WHERE r.status = 1
  340. ";
  341. $affectedRows = DB::update($updateSql);
  342. Log::info('批量更新推荐关系表中的农场用户ID完成', [
  343. 'affected_rows' => $affectedRows
  344. ]);
  345. return [
  346. 'success' => true,
  347. 'affected_rows' => $affectedRows,
  348. 'message' => "成功更新 {$affectedRows} 条推荐关系记录"
  349. ];
  350. } catch (\Exception $e) {
  351. Log::error('批量更新推荐关系表中的农场用户ID失败', [
  352. 'error' => $e->getMessage()
  353. ]);
  354. return [
  355. 'success' => false,
  356. 'affected_rows' => 0,
  357. 'message' => '批量更新失败: ' . $e->getMessage()
  358. ];
  359. }
  360. }
  361. /**
  362. * 更新单个推荐关系的农场用户ID
  363. *
  364. * 当特定用户进入农场时,更新其相关的推荐关系记录
  365. *
  366. * @param int $ursUserId URS用户ID
  367. * @param int $farmUserId 农场用户ID
  368. * @return bool
  369. */
  370. public static function updateFarmUserIdForUser(int $ursUserId, int $farmUserId): bool
  371. {
  372. try {
  373. DB::beginTransaction();
  374. // 更新该用户作为被推荐人的记录
  375. UrsUserReferral::where('urs_user_id', $ursUserId)
  376. ->where('status', UrsUserReferral::STATUS_VALID)
  377. ->update(['user_id' => $farmUserId]);
  378. // 更新该用户作为推荐人的记录
  379. UrsUserReferral::where('urs_referrer_id', $ursUserId)
  380. ->where('status', UrsUserReferral::STATUS_VALID)
  381. ->update(['referrer_id' => $farmUserId]);
  382. DB::commit();
  383. Log::info('更新用户推荐关系农场用户ID成功', [
  384. 'urs_user_id' => $ursUserId,
  385. 'farm_user_id' => $farmUserId
  386. ]);
  387. return true;
  388. } catch (\Exception $e) {
  389. DB::rollBack();
  390. Log::error('更新用户推荐关系农场用户ID失败', [
  391. 'urs_user_id' => $ursUserId,
  392. 'farm_user_id' => $farmUserId,
  393. 'error' => $e->getMessage()
  394. ]);
  395. return false;
  396. }
  397. }
  398. }