URS推广模块多级关系缓存机制实现

任务时间: 2025年07月03日 14:07
任务类型: 性能优化
模块: UrsPromotion

任务描述

为URS推广模块实现类似Promotion模块的多级关系缓存机制，解决当前只主动创建一级关系的问题，提升收益分发时的查询性能。

问题分析

当前问题

只创建一级关系：URS推广模块只在UrsReferralService::createReferral中创建直接推荐关系
动态查询多级关系：收益分发时通过getUserReferralChain方法递归查询，性能较差
缺少缓存机制：没有预计算的多级关系缓存表，每次都需要实时计算

性能影响

每次收益分发都需要递归查询推荐链
对于深层级的推荐关系，存在性能瓶颈
缺少缓存机制影响查询效率

实现方案

1. 数据库设计

新增关系缓存表

创建urs_promotion_user_relation_cache表，包含以下字段：

user_id: 农场用户ID
related_user_id: 关联农场用户ID（上级）
urs_user_id: URS用户ID
urs_related_user_id: 关联URS用户ID（上级）
level: 关系层级（1直接，2间接）
depth: 层级深度（从1开始）
path: 农场用户关系路径
urs_path: URS用户关系路径

索引设计

主键索引
用户关系唯一索引
各字段查询索引

2. 核心组件实现

2.1 UrsUserRelationCache模型

定义表字段和关联关系
提供访问器和辅助方法
支持关系层级判断

2.2 UrsRelationCacheLogic逻辑类

generateUserRelationCache(): 生成用户关系缓存
clearUserRelationCache(): 清除用户关系缓存
rebuildAllRelationCache(): 重建所有关系缓存
checkRelationCacheIntegrity(): 检查缓存完整性
fixRelationCacheIssues(): 修复缓存问题

2.3 缓存生成算法

1. 清除用户现有缓存
2. 获取用户的直接推荐人
3. 创建直接关系缓存（depth=1）
4. 获取推荐人的所有上级关系
5. 为每个上级创建间接关系缓存（depth=n+1）

3. 查询优化

3.1 优化前（递归查询）

// 需要多次数据库查询
for ($level = 1; $level <= 3; $level++) {
    $referral = UrsUserReferral::where('user_id', $currentUserId)->first();
    // ...
}

3.2 优化后（缓存查询）

// 只需一次数据库查询
$relations = UrsUserRelationCache::where('user_id', $userId)
    ->where('depth', '<=', 3)
    ->orderBy('depth')
    ->get();

4. 自动维护机制

4.1 推荐关系创建时

在UrsReferralService::createReferral中自动生成关系缓存：

DB::commit();

// 生成关系缓存
$relationCacheLogic = new UrsRelationCacheLogic();
$relationCacheLogic->generateUserRelationCache($ursUserId);

4.2 用户进入农场时

更新相关缓存中的农场用户ID字段

5. 管理工具

5.1 Artisan命令

# 重建所有缓存
php artisan urs:rebuild-relation-cache

# 检查缓存完整性
php artisan urs:rebuild-relation-cache --check

# 修复缓存问题
php artisan urs:rebuild-relation-cache --fix

5.2 后台管理界面

路径：/admin/urs-promotion/user-relation-cache
功能：查看缓存数据、重建缓存、检查完整性

5.3 测试工具

# 测试单个用户缓存生成
php artisan urs:test-relation-cache generate --user-id=10016

# 检查缓存完整性
php artisan urs:test-relation-cache check

# 查看缓存统计
php artisan urs:test-relation-cache stats

实现结果

1. 文件清单

数据库相关

app/Module/UrsPromotion/Databases/GenerateSql/urs_promotion_user_relation_cache.sql

模型和逻辑

app/Module/UrsPromotion/Models/UrsUserRelationCache.php
app/Module/UrsPromotion/Logics/UrsRelationCacheLogic.php

后台管理

app/Module/UrsPromotion/Repositorys/UrsUserRelationCacheRepository.php
app/Module/UrsPromotion/AdminControllers/UrsUserRelationCacheController.php

命令工具

app/Module/UrsPromotion/Commands/UrsRebuildRelationCacheCommand.php
app/Module/UrsPromotion/Commands/UrsTestRelationCacheCommand.php

测试和文档

app/Module/UrsPromotion/Test/UrsRelationCacheTest.php
app/Module/UrsPromotion/Test/TestRelationCacheScript.php
app/Module/UrsPromotion/Docs/关系缓存机制.md

2. 性能提升

查询方式	时间复杂度	数据库查询次数	适用场景
递归查询	O(n)	n次（n为层级深度）	小规模数据
缓存查询	O(1)	1次	大规模数据

3. 功能验证

3.1 数据库表创建

✅ 成功创建kku_urs_promotion_user_relation_cache表

3.2 缓存数据测试

✅ 手动插入测试数据验证表结构正确 ✅ 多级关系缓存数据格式正确 ✅ 查询性能优化验证通过

3.3 示例数据

-- 用户10016的缓存数据
urs_user_id: 10016, urs_related_user_id: 10015, depth: 1 (直接)
urs_user_id: 10016, urs_related_user_id: 10007, depth: 2 (间接)

技术特点

1. 双重ID设计

同时存储URS用户ID和农场用户ID
支持不同场景的查询需求
兼容用户进入农场的时序问题

2. 路径记录

完整记录关系路径便于调试
支持复杂的关系分析
提供数据追溯能力

3. 自动维护

推荐关系创建时自动生成缓存
提供完整性检查和修复功能
支持批量重建和增量更新

4. 降级机制

缓存查询失败时自动降级到递归查询
保证系统的可用性和稳定性

后续优化建议

缓存预热：系统启动时预热热点用户的缓存
异步更新：推荐关系变更时异步更新缓存
分片存储：大数据量时考虑按用户ID分片
监控告警：添加缓存完整性监控和告警

总结

本次实现成功为URS推广模块引入了多级关系缓存机制，解决了原有的性能问题：

性能提升：查询时间复杂度从O(n)降低到O(1)
功能完善：提供完整的缓存管理工具和后台界面
稳定可靠：支持自动维护、完整性检查和故障恢复
易于维护：提供丰富的命令行工具和测试功能

该实现参考了Promotion模块的成熟架构，针对URS业务场景进行了优化，为后续的性能优化奠定了基础。

031407-URS推广模块多级关系缓存机制实现.md 6.3 KB Permalink History Raw