feat: 添加个性标签管理功能

2025-10-12 23:02:34 +00:00
parent 49701fcd09
commit 6d97bf1e88
9 changed files with 1088 additions and 7 deletions
@@ -34,6 +34,8 @@ use App\Models\WebSocketDialogUser;
 use App\Models\UserTaskBrowse;
 use App\Models\UserFavorite;
 use App\Models\UserRecentItem;
+use App\Models\UserTag;
+use App\Models\UserTagRecognition;
 use Illuminate\Support\Facades\DB;
 use App\Models\UserEmailVerification;
 use App\Module\AgoraIO\AgoraTokenGenerator;
@@ -355,6 +357,9 @@ class UsersController extends AbstractController
        $data['nickname_original'] = $user->getRawOriginal('nickname');
        $data['department_name'] = $user->getDepartmentName();
        $data['department_owner'] = UserDepartment::where('parent_id',0)->where('owner_userid', $user->userid)->exists(); // 适用默认部门下第1级负责人才能添加部门OKR
+        $tagMeta = UserTag::listWithMeta($user->userid, $user);
+        $data['personal_tags'] = $tagMeta['top'];
+        $data['personal_tags_total'] = $tagMeta['total'];
        return Base::retSuccess('success', $data);
    }

@@ -773,8 +778,12 @@ class UsersController extends AbstractController
    public function basic()
    {
        $sharekey = Request::header('sharekey');
-        if (empty($sharekey) || !Meeting::getShareInfo($sharekey)) {
-            User::auth();
+        $shareInfo = $sharekey ? Meeting::getShareInfo($sharekey) : null;
+        $viewer = null;
+        if (empty($shareInfo)) {
+            $viewer = User::auth();
+        } elseif (Doo::userId() > 0) {
+            $viewer = User::whereUserid(Doo::userId())->first();
        }
        //
        $userid = Request::input('userid');
@@ -792,6 +801,9 @@ class UsersController extends AbstractController
                $basic = UserDelete::userid2basic($id);
            }
            if ($basic) {
+                $tagMeta = UserTag::listWithMeta($basic->userid, $viewer);
+                $basic->personal_tags = $tagMeta['top'];
+                $basic->personal_tags_total = $tagMeta['total'];
                //
                $retArray[] = $basic;
            }
@@ -1456,6 +1468,233 @@ class UsersController extends AbstractController
        return Base::retSuccess('success', $data);
    }

+    protected function buildUserTagResponse(?User $viewer, int $targetUserId, string $message = 'success')
+    {
+        return Base::retSuccess($message, UserTag::listWithMeta($targetUserId, $viewer));
+    }
+
+    /**
+     * @api {get} api/users/tags/lists          10.1. 获取个性标签列表
+     *
+     * @apiDescription 需要token身份
+     * @apiVersion 1.0.0
+     * @apiGroup users
+     * @apiName tags__lists
+     *
+     * @apiParam {Number} [userid]          会员ID（不传默认为当前用户）
+     *
+     * @apiSuccess {Number} ret     返回状态码（1正确、0错误）
+     * @apiSuccess {String} msg     返回信息（错误描述）
+     * @apiSuccess {Object} data    返回数据
+     * @apiSuccessExample {json} data:
+    {
+        "list": [
+            {
+                "id": 1,
+                "name": "认真负责",
+                "recognition_total": 3,
+                "recognized": true,
+                "can_edit": true,
+                "can_delete": true
+            }
+        ],
+        "top": [ ],
+        "total": 1
+    }
+     */
+    public function tags__lists()
+    {
+        $viewer = User::auth();
+        $userid = intval(Request::input('userid')) ?: $viewer->userid;
+        $target = User::whereUserid($userid)->first();
+        if (empty($target)) {
+            return Base::retError('会员不存在');
+        }
+        return $this->buildUserTagResponse($viewer, $target->userid);
+    }
+
+    /**
+     * @api {post} api/users/tags/add          10.2. 新增个性标签
+     *
+     * @apiDescription 需要token身份
+     * @apiVersion 1.0.0
+     * @apiGroup users
+     * @apiName tags__add
+     *
+     * @apiParam {Number} [userid]          会员ID（不传默认为当前用户）
+     * @apiParam {String} name              标签名称（1-20个字符）
+     *
+     * @apiSuccess {Number} ret     返回状态码（1正确、0错误）
+     * @apiSuccess {String} msg     返回信息（错误描述）
+     * @apiSuccess {Object} data    返回数据，同“获取个性标签列表”
+     */
+    public function tags__add()
+    {
+        $viewer = User::auth();
+        $userid = intval(Request::input('userid')) ?: $viewer->userid;
+        $target = User::whereUserid($userid)->first();
+        if (empty($target)) {
+            return Base::retError('会员不存在');
+        }
+
+        $name = trim((string) Request::input('name'));
+        if ($name === '') {
+            return Base::retError('请输入个性标签');
+        }
+        if (mb_strlen($name) > 20) {
+            return Base::retError('标签名称最多只能设置20个字');
+        }
+        if (UserTag::where('user_id', $userid)->where('name', $name)->exists()) {
+            return Base::retError('标签已存在');
+        }
+        if (UserTag::where('user_id', $userid)->count() >= 100) {
+            return Base::retError('每位会员最多添加100个标签');
+        }
+
+        $tag = UserTag::create([
+            'user_id' => $userid,
+            'name' => $name,
+            'created_by' => $viewer->userid,
+            'updated_by' => $viewer->userid,
+        ]);
+        $tag->save();
+
+        return $this->buildUserTagResponse($viewer, $userid, '添加成功');
+    }
+
+    /**
+     * @api {post} api/users/tags/update          10.3. 修改个性标签
+     *
+     * @apiDescription 需要token身份
+     * @apiVersion 1.0.0
+     * @apiGroup users
+     * @apiName tags__update
+     *
+     * @apiParam {Number} tag_id           标签ID
+     * @apiParam {String} name             标签名称（1-20个字符）
+     *
+     * @apiSuccess {Number} ret     返回状态码（1正确、0错误）
+     * @apiSuccess {String} msg     返回信息（错误描述）
+     * @apiSuccess {Object} data    返回数据，同“获取个性标签列表”
+     */
+    public function tags__update()
+    {
+        $viewer = User::auth();
+        $tagId = intval(Request::input('tag_id'));
+        $name = trim((string) Request::input('name'));
+        if ($tagId <= 0) {
+            return Base::retError('参数错误');
+        }
+        if ($name === '') {
+            return Base::retError('请输入个性标签');
+        }
+        if (mb_strlen($name) > 20) {
+            return Base::retError('标签名称最多只能设置20个字');
+        }
+        $tag = UserTag::find($tagId);
+        if (empty($tag)) {
+            return Base::retError('标签不存在');
+        }
+        if (!$tag->canManage($viewer)) {
+            return Base::retError('无权操作该标签');
+        }
+        if ($name !== $tag->name && UserTag::where('user_id', $tag->user_id)->where('name', $name)->where('id', '!=', $tag->id)->exists()) {
+            return Base::retError('标签已存在');
+        }
+
+        if ($name !== $tag->name) {
+            $tag->updateInstance([
+                'name' => $name,
+                'updated_by' => $viewer->userid,
+            ]);
+        } else {
+            $tag->updateInstance([
+                'updated_by' => $viewer->userid,
+            ]);
+        }
+        $tag->save();
+
+        return $this->buildUserTagResponse($viewer, $tag->user_id, '保存成功');
+    }
+
+    /**
+     * @api {post} api/users/tags/delete          10.4. 删除个性标签
+     *
+     * @apiDescription 需要token身份
+     * @apiVersion 1.0.0
+     * @apiGroup users
+     * @apiName tags__delete
+     *
+     * @apiParam {Number} tag_id           标签ID
+     *
+     * @apiSuccess {Number} ret     返回状态码（1正确、0错误）
+     * @apiSuccess {String} msg     返回信息（错误描述）
+     * @apiSuccess {Object} data    返回数据，同“获取个性标签列表”
+     */
+    public function tags__delete()
+    {
+        $viewer = User::auth();
+        $tagId = intval(Request::input('tag_id'));
+        if ($tagId <= 0) {
+            return Base::retError('参数错误');
+        }
+        $tag = UserTag::find($tagId);
+        if (empty($tag)) {
+            return Base::retError('标签不存在');
+        }
+        if (!$tag->canManage($viewer)) {
+            return Base::retError('无权操作该标签');
+        }
+
+        $userId = $tag->user_id;
+        $tag->delete();
+
+        return $this->buildUserTagResponse($viewer, $userId, '删除成功');
+    }
+
+    /**
+     * @api {post} api/users/tags/recognize          10.5. 认可个性标签
+     *
+     * @apiDescription 需要token身份
+     * @apiVersion 1.0.0
+     * @apiGroup users
+     * @apiName tags__recognize
+     *
+     * @apiParam {Number} tag_id           标签ID
+     *
+     * @apiSuccess {Number} ret     返回状态码（1正确、0错误）
+     * @apiSuccess {String} msg     返回信息（错误描述）
+     * @apiSuccess {Object} data    返回数据，同“获取个性标签列表”
+     */
+    public function tags__recognize()
+    {
+        $viewer = User::auth();
+        $tagId = intval(Request::input('tag_id'));
+        if ($tagId <= 0) {
+            return Base::retError('参数错误');
+        }
+        $tag = UserTag::find($tagId);
+        if (empty($tag)) {
+            return Base::retError('标签不存在');
+        }
+
+        $recognition = UserTagRecognition::where('tag_id', $tagId)
+            ->where('user_id', $viewer->userid)
+            ->first();
+        if ($recognition) {
+            $recognition->delete();
+            $message = '已取消认可';
+        } else {
+            UserTagRecognition::create([
+                'tag_id' => $tagId,
+                'user_id' => $viewer->userid,
+            ]);
+            $message = '认可成功';
+        }
+
+        return $this->buildUserTagResponse($viewer, $tag->user_id, $message);
+    }
+
    /**
     * @api {get} api/users/meeting/link          20. 【会议】获取分享链接
     *