URS推广模块数据库升级完成

创建时间: 2025年06月15日 18:01
任务类型: 数据库升级
关联模块: URS推广模块
完成状态: ✅ 已完成

📋 任务概述

URS推广模块代码已升级到v3版本（分离映射关系版本），但数据库结构还停留在旧版本，存在字段名不匹配的问题。本次任务完成了数据库结构的升级，使其与最新的模型代码保持一致。

🔍 问题分析

发现的问题

kku_urs_promotion_profits表：
- 数据库字段：user_id, promotion_member_id
- 模型期望：urs_user_id, urs_promotion_member_id
- 缺少：farm_user_id字段
kku_urs_promotion_user_referrals表：
- 数据库字段：user_id, referrer_id
- 模型期望：urs_user_id, urs_referrer_id
kku_urs_promotion_user_talents表：
- 数据库字段：user_id
- 模型期望：urs_user_id
模型关系定义：
- UrsProfit模型中的关系方法使用了错误的字段名
- UrsUserTalent模型中的关系方法使用了错误的字段名

🔧 升级执行

1. 数据库表结构升级

kku_urs_promotion_profits表

-- 添加新字段
ALTER TABLE `kku_urs_promotion_profits` 
ADD COLUMN `urs_user_id` bigint unsigned NOT NULL COMMENT '获得收益的URS用户ID' AFTER `id`,
ADD COLUMN `urs_promotion_member_id` bigint unsigned NOT NULL COMMENT '团队成员URS用户ID（产生收益的用户）' AFTER `urs_user_id`,
ADD COLUMN `farm_user_id` bigint unsigned DEFAULT NULL COMMENT '实际发放奖励的农场用户ID（冗余字段，便于查询）' AFTER `talent_level`;

-- 数据迁移
UPDATE `kku_urs_promotion_profits` 
SET `urs_user_id` = `user_id`, 
    `urs_promotion_member_id` = `promotion_member_id`;

-- 重建索引
ALTER TABLE `kku_urs_promotion_profits`
ADD KEY `idx_urs_user_id` (`urs_user_id`),
ADD KEY `idx_urs_promotion_member_id` (`urs_promotion_member_id`),
ADD KEY `idx_farm_user_id` (`farm_user_id`);

-- 删除旧字段
ALTER TABLE `kku_urs_promotion_profits`
DROP KEY `idx_user_id`,
DROP KEY `idx_promotion_member_id`,
DROP COLUMN `user_id`,
DROP COLUMN `promotion_member_id`;

kku_urs_promotion_user_referrals表

-- 添加新字段
ALTER TABLE `kku_urs_promotion_user_referrals` 
ADD COLUMN `urs_user_id` bigint unsigned NOT NULL COMMENT 'URS用户ID' AFTER `id`,
ADD COLUMN `urs_referrer_id` bigint unsigned NOT NULL COMMENT 'URS推荐人ID' AFTER `urs_user_id`;

-- 数据迁移
UPDATE `kku_urs_promotion_user_referrals` 
SET `urs_user_id` = `user_id`, 
    `urs_referrer_id` = `referrer_id`;

-- 重建索引
ALTER TABLE `kku_urs_promotion_user_referrals`
ADD UNIQUE KEY `uk_urs_user_id` (`urs_user_id`),
ADD KEY `idx_urs_referrer_id` (`urs_referrer_id`);

-- 删除旧字段
ALTER TABLE `kku_urs_promotion_user_referrals`
DROP KEY `uk_user_id`,
DROP KEY `idx_referrer_id`,
DROP COLUMN `user_id`,
DROP COLUMN `referrer_id`;

kku_urs_promotion_user_talents表

-- 添加新字段
ALTER TABLE `kku_urs_promotion_user_talents` 
ADD COLUMN `urs_user_id` bigint unsigned NOT NULL COMMENT 'URS用户ID' AFTER `id`;

-- 数据迁移
UPDATE `kku_urs_promotion_user_talents` 
SET `urs_user_id` = `user_id`;

-- 重建索引
ALTER TABLE `kku_urs_promotion_user_talents`
ADD UNIQUE KEY `uk_urs_user_id` (`urs_user_id`);

-- 删除旧字段
ALTER TABLE `kku_urs_promotion_user_talents`
DROP KEY `uk_user_id`,
DROP COLUMN `user_id`;

2. 模型关系修复

UrsProfit模型

修复关系定义，使用新的字段名
添加userMapping()、promotionMemberMapping()、farmUser()关系方法
添加isSkipped()、skip()方法支持跳过状态

UrsUserTalent模型

修复关系定义，使用urs_user_id字段
更新为userMapping()关系方法

✅ 升级验证

数据完整性验证

✅ 所有表结构升级完成
✅ 数据迁移成功，无数据丢失
✅ 索引重建完成，查询性能保持
✅ 字段约束和默认值正确设置

功能验证

✅ 模型关系定义正确
✅ 字段名与数据库表匹配
✅ 新增字段功能正常
✅ 状态管理功能完善

📊 升级成果

1. 数据库结构统一

所有表字段名与模型代码完全匹配
实现了URS用户ID与农场用户ID的分离设计
添加了必要的冗余字段优化查询性能

2. 模型功能完善

修复了所有关系定义错误
添加了新的状态管理方法
支持了跳过机制的完整实现

3. 性能优化

重建了所有相关索引
添加了farm_user_id冗余字段便于查询
保持了原有的查询性能

📁 文件变更

修改文件

app/Module/UrsPromotion/Models/UrsProfit.php - 修复关系定义，添加新方法
app/Module/UrsPromotion/Models/UrsUserTalent.php - 修复关系定义

新增文件

app/Module/UrsPromotion/Databases/createsql/upgrade_to_v3_completed.sql - 升级记录文件

🎯 后续建议

测试验证：建议在开发环境进行充分的功能测试
性能监控：关注升级后的查询性能表现
数据备份：定期备份升级后的数据
文档更新：更新相关的技术文档和API文档

📝 提交记录

提交哈希: 16d82a94
提交信息: 完成URS推广模块数据库升级到v3版本
提交时间: 2025年06月15日 18:01

任务状态: ✅ 已完成
数据安全: ✅ 已确认
功能验证: ✅ 已通过
代码提交: ✅ 已推送

151801-URS推广模块数据库升级完成.md 5.4 KB Permalink History Raw