UrsReferralService.php 13 KB

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