feat(admin): 添加共富会员上级修改功能

- 在路由文件中新增 updateParent 接口路由
- 在控制器中实现 updateParent 方法处理上级修改逻辑
- 创建 SharedProsperityUserParentLog 模型用于记录上级变更日志
- 创建 SharedProsperityUserParentLogDao 数据访问对象
- 在仓库类中新增 updateParent 方法实现事务性更新和日志记录
- 添加参数验证和业务逻辑检查防止无效操作

app/common/dao/shared/SharedProsperityUserParentLogDao.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace app\common\dao\shared;
+
+use app\common\dao\BaseDao;
+use app\common\model\shared\SharedProsperityUserParentLog;
+
+class SharedProsperityUserParentLogDao extends BaseDao
+{
+    protected function getModel(): string
+    {
+        return SharedProsperityUserParentLog::class;
+    }
+}

app/common/model/shared/SharedProsperityUserParentLog.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace app\common\model\shared;
+
+use app\common\model\BaseModel;
+
+class SharedProsperityUserParentLog extends BaseModel
+{
+    public static function tablePk(): ?string
+    {
+        return 'id';
+    }
+
+    public static function tableName(): string
+    {
+        return 'shared_prosperity_user_parent_log';
+    }
+}

app/common/repositories/shared/SharedProsperityUserRepository.php

@@ -6,6 +6,7 @@ use app\common\dao\shared\SharedProsperityGroupUserDao;
 use app\common\dao\shared\SharedProsperityRewardRecordDao;
 use app\common\dao\shared\SharedProsperityUserDao;
 use app\common\dao\shared\SharedProsperityUserLevelLogDao;
+use app\common\dao\shared\SharedProsperityUserParentLogDao;
 use app\common\dao\user\UserDao;
 use app\common\dao\user\UserWithdrawalLimitRecordDao;
 use app\common\enum\CommonEnum;
@@ -807,6 +808,50 @@ class SharedProsperityUserRepository extends BaseRepository
 
     /**
      * @param $userId
+     * @param $parentId
+     * @param $remark
+     * @param $operator
+     * @return string|void
+     * @throws DbException
+     * @throws \think\db\exception\DataNotFoundException
+     * @throws \think\db\exception\ModelNotFoundException
+     * @author 史晨
+     * @date 2026/3/16 09:35
+     * 更新用户上级
+     */
+    public function updateParent($userId, $parentId, $remark, $operator)
+    {
+        if ($userId == $parentId) {
+            return '不能设置自己为上级';
+        }
+        $userInfo = $this->dao->getWhere(['user_id' => $userId]);
+        if ($parentId == $userInfo->parent_id) {
+            return '上级未发生变化';
+        }
+        Db::startTrans();
+        try {
+            // 变更等级
+            $this->dao->updateByUserId($userId, ['parent_id' => $parentId]);
+            // 记录日志
+            /** @var SharedProsperityUserParentLogDao $logDao */
+            $logDao = app()->make(SharedProsperityUserParentLogDao::class);
+            $logDao->create([
+                'user_id' => $userId,
+                'old_parent' => $userInfo->parent_id,
+                'new_parent' => $parentId,
+                'operator' => $operator,
+                'remark' => $remark
+            ]);
+            Db::commit();
+        } catch (\Exception $e) {
+            Db::rollback();
+            return $e->getMessage();
+        }
+    }
+
+
+    /**
+     * @param $userId
      * @param $type
      * @param $number
      * @return bool

app/controller/admin/system/sharedProsperity/SharedProsperityUser.php

@@ -61,4 +61,25 @@ class SharedProsperityUser
         }
         return app('json')->success('更新成功');
     }
+
+    /**
+     * @return mixed
+     * @author 史晨
+     * @date 2026/3/16 09:30
+     * 更新用户上级
+     */
+    public function updateParent()
+    {
+        /** @var SharedProsperityUserRepository $repository */
+        $repository = app()->make(SharedProsperityUserRepository::class);
+        $params = app('request')->params(['user_id', 'parent_id', 'remark']);
+        if (empty($params['user_id']) || empty($params['parent_id'] || empty($params['remark']))) {
+            return app('json')->fail('参数错误');
+        }
+        $res = $repository->updateParent($params['user_id'], $params['parent_id'], $params['remark'], request()->adminId());
+        if (is_string($res)) {
+            return app('json')->fail($res);
+        }
+        return app('json')->success('更新成功');
+    }
 }

route/admin.php

@@ -124,6 +124,8 @@ Route::group(config('admin.api_admin_prefix') . '/', function () {
         Route::get('sharedProsperity/user/updateLevel', 'admin.system.sharedProsperity.SharedProsperityUser/updateLevel');
         // 修改共富会员奖励
         Route::get('sharedProsperity/user/updateReward', 'admin.system.sharedProsperity.SharedProsperityUser/updateReward');
+        // 修改共富会员上级
+        Route::get('sharedProsperity/user/updateParent', 'admin.system.sharedProsperity.SharedProsperityUser/updateParent');
 
         //组合数据
         Route::group('group', function () {