UrsReferralService.php 14 KB

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