feat(character): 添加用户人设接口及排序管理

新增 /character/addUserCharacter 端点，支持用户将人设加入个人列表并自动维护排序数组。引入 KeyboardUserCharacterAddDTO、KeyboardUserSortMapper 及相关错误码，实现事务级插入与排序更新。

src/main/java/com/yolo/keyborad/common/ErrorCode.java

@@ -32,7 +32,8 @@ public enum ErrorCode {
     USER_INFO_UPDATE_FAILED(50002, "用户信息更新失败"),
     PASSWORD_OR_MAIL_ERROR(50003,"密码或邮箱错误" ),
     SEND_MAIL_FAILED(50004,"邮件发送失败" ),
-    CONFIRM_PASSWORD_NOT_MATCH(50005,"重复密码不匹配" );
+    CONFIRM_PASSWORD_NOT_MATCH(50005,"重复密码不匹配" ),
+    USER_CHARACTER_ADD_ERROR(50006,"添加用户键盘字符失败" );
     /**
      * 状态码
      */

src/main/java/com/yolo/keyborad/config/SaTokenConfigure.java

@@ -76,7 +76,8 @@ public class SaTokenConfigure implements WebMvcConfigurer {
                 "/user/updateInfo",
                 "/user/detail",
                 "/user/register",
-                "/character/updateUserCharacterSort"
+                "/character/updateUserCharacterSort",
+                "/character/addUserCharacter"
         };
     }
     @Bean

src/main/java/com/yolo/keyborad/controller/CharacterController.java

@@ -4,6 +4,7 @@ import cn.dev33.satoken.stp.StpUtil;
 import cn.hutool.core.bean.BeanUtil;
 import com.yolo.keyborad.common.BaseResponse;
 import com.yolo.keyborad.common.ResultUtils;
+import com.yolo.keyborad.model.dto.userCharacter.KeyboardUserCharacterAddDTO;
 import com.yolo.keyborad.model.dto.userCharacter.KeyboardUserCharacterDTO;
 import com.yolo.keyborad.model.dto.userCharacter.KeyboardUserCharacterSortUpdateDTO;
 import com.yolo.keyborad.model.entity.KeyboardCharacter;
@@ -49,7 +50,7 @@ public class CharacterController {
     @Operation(summary = "人设详情", description = "人设详情接口")
     public BaseResponse<KeyboardCharacterRespVO> detail(@RequestParam("id") Long id) {
         KeyboardCharacter character = characterService.getById(id);
-        return ResultUtils.success(BeanUtil.copyProperties(character ,KeyboardCharacterRespVO.class));
+        return ResultUtils.success(BeanUtil.copyProperties(character, KeyboardCharacterRespVO.class));
     }
 
     @GetMapping("/listByTag")
@@ -67,10 +68,16 @@ public class CharacterController {
 
 
     @PostMapping("/updateUserCharacterSort")
-    @Operation(summary = "更新用户人设排序",description = "更新用户人设排序接口")
+    @Operation(summary = "更新用户人设排序", description = "更新用户人设排序接口")
     public BaseResponse<Boolean> updateUserCharacterSort(@RequestBody KeyboardUserCharacterSortUpdateDTO sortUpdateDTO) {
         characterService.updateSort(sortUpdateDTO);
         return ResultUtils.success(true);
     }
 
-}
+    @PostMapping("/addUserCharacter")
+    @Operation(summary = "添加用户人设", description = "添加用户人设接口")
+    public BaseResponse<Boolean> addUserCharacter(@RequestBody KeyboardUserCharacterAddDTO addDTO) {
+        characterService.addUserCharacter(addDTO);
+        return ResultUtils.success(true);
+    }
+}

src/main/java/com/yolo/keyborad/mapper/KeyboardUserCharacterMapper.java

@@ -18,4 +18,5 @@ public interface KeyboardUserCharacterMapper extends BaseMapper<KeyboardUserChar
 
     void updateSortByIdAndUserId(@Param("sort") Integer[] sort,@Param("userId") long userId);
 
+    List<Long> selectSortByUserId(@Param("userId") Long userId);
 }

src/main/java/com/yolo/keyborad/mapper/KeyboardUserSortMapper.java

@@ -0,0 +1,28 @@
+package com.yolo.keyborad.mapper;
+
+import org.apache.ibatis.annotations.Insert;
+import org.apache.ibatis.annotations.Param;
+import org.apache.ibatis.annotations.Select;
+import org.apache.ibatis.annotations.Update;
+
+import java.util.List;
+
+public interface KeyboardUserSortMapper {
+
+    /**
+     * 查询某个用户的人设排序（按顺序展开成列表）
+     */
+    List<Long> selectSortByUserId(@Param("userId") Long userId);
+
+    /**
+     * 更新用户排序数组
+     */
+    int updateSortByUserId(@Param("userId") Long userId,
+                           @Param("sort") Long[] sort);
+
+    /**
+     * 插入一条新的用户排序记录
+     */
+    int insertUserSort(@Param("userId") Long userId,
+                       @Param("sort") Long[] sort);
+}

src/main/java/com/yolo/keyborad/model/dto/userCharacter/KeyboardUserCharacterAddDTO.java

@@ -0,0 +1,15 @@
+package com.yolo.keyborad.model.dto.userCharacter;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.util.List;
+
+@Schema(description = "用户键盘顺序更新 DTO")
+@Data
+public class KeyboardUserCharacterAddDTO {
+
+    @Schema(description="键盘人设 id")
+    private Long characterId;
+
+}

src/main/java/com/yolo/keyborad/service/KeyboardCharacterService.java

@@ -1,5 +1,6 @@
 package com.yolo.keyborad.service;
 
+import com.yolo.keyborad.model.dto.userCharacter.KeyboardUserCharacterAddDTO;
 import com.yolo.keyborad.model.dto.userCharacter.KeyboardUserCharacterSortUpdateDTO;
 import com.yolo.keyborad.model.entity.KeyboardCharacter;
 import com.baomidou.mybatisplus.extension.service.IService;
@@ -23,4 +24,6 @@ public interface KeyboardCharacterService extends IService<KeyboardCharacter>{
     List<KeyboardUserCharacterVO> selectListByUserId();
 
     void updateSort(KeyboardUserCharacterSortUpdateDTO sortUpdateDTO);
+
+    void addUserCharacter(KeyboardUserCharacterAddDTO addDTO);
 }

src/main/java/com/yolo/keyborad/service/impl/KeyboardCharacterServiceImpl.java

@@ -1,12 +1,18 @@
 package com.yolo.keyborad.service.impl;
 
 import cn.dev33.satoken.stp.StpUtil;
+import cn.hutool.core.bean.BeanUtil;
 import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
 import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
 import com.baomidou.mybatisplus.core.toolkit.CollectionUtils;
+import com.yolo.keyborad.common.ErrorCode;
+import com.yolo.keyborad.exception.BusinessException;
 import com.yolo.keyborad.mapper.KeyboardCharacterMapper;
 import com.yolo.keyborad.mapper.KeyboardUserCharacterMapper;
+import com.yolo.keyborad.mapper.KeyboardUserSortMapper;
+import com.yolo.keyborad.model.dto.userCharacter.KeyboardUserCharacterAddDTO;
 import com.yolo.keyborad.model.dto.userCharacter.KeyboardUserCharacterSortUpdateDTO;
+import com.yolo.keyborad.model.entity.KeyboardUser;
 import com.yolo.keyborad.model.entity.KeyboardUserCharacter;
 import com.yolo.keyborad.model.vo.character.KeyboardUserCharacterVO;
 import jakarta.annotation.Resource;
@@ -32,6 +38,9 @@ public class KeyboardCharacterServiceImpl extends ServiceImpl<KeyboardCharacterM
     @Resource
     private KeyboardUserCharacterMapper keyboardUserCharacterMapper;
 
+    @Resource
+    private KeyboardUserSortMapper keyboardUserSortMapper;
+
     @Override
     public List<KeyboardCharacter> selectListWithRank() {
         return keyboardCharacterMapper.selectList(new LambdaQueryWrapper<KeyboardCharacter>()
@@ -50,7 +59,6 @@ public class KeyboardCharacterServiceImpl extends ServiceImpl<KeyboardCharacterM
     @Override
     public List<KeyboardUserCharacterVO> selectListByUserId() {
         long loginId = StpUtil.getLoginIdAsLong();
-
         return keyboardUserCharacterMapper.selectByUserId(loginId);
     }
 
@@ -64,4 +72,42 @@ public class KeyboardCharacterServiceImpl extends ServiceImpl<KeyboardCharacterM
         long loginIdAsLong = StpUtil.getLoginIdAsLong();
         keyboardUserCharacterMapper.updateSortByIdAndUserId(sortArray, loginIdAsLong);
     }
+
+    @Override
+    @Transactional
+    public void addUserCharacter(KeyboardUserCharacterAddDTO addDTO) {
+        // 1. 插入用户人设
+        KeyboardUserCharacter keyboardUserCharacter = BeanUtil.copyProperties(addDTO, KeyboardUserCharacter.class);
+        long userId = StpUtil.getLoginIdAsLong();
+        keyboardUserCharacter.setUserId(userId);
+
+        int insert = keyboardUserCharacterMapper.insert(keyboardUserCharacter);
+        if (insert != 1) {
+            log.error("用户人设添加失败, userId={}");
+            throw new BusinessException(ErrorCode.USER_CHARACTER_ADD_ERROR);
+        }
+
+        // 新插入这条记录的主键 id（MyBatis-Plus 会自动回填）
+        Long newId = keyboardUserCharacter.getId();
+
+        // 2. 查询用户当前的排序（展开数组）
+        List<Long> oldSortList = keyboardUserSortMapper.selectSortByUserId(userId);
+        // selectSortByUserId 用 unnest(user_characteu_id_sort) 实现，见下面 mapper 部分
+
+        // 3. 组装新的排序：在末尾加上新 id
+        List<Long> newSortList = new ArrayList<>();
+        if (oldSortList != null && !oldSortList.isEmpty()) {
+            newSortList.addAll(oldSortList);
+        }
+        newSortList.add(newId);
+
+        Long[] newSortArray = newSortList.toArray(new Long[0]);
+
+        // 4. 更新 keyboard_user_sort，如果没有记录就插入一条
+        int updated = keyboardUserSortMapper.updateSortByUserId(userId, newSortArray);
+        if (updated == 0) {
+            // 说明该 userId 还没有排序记录，插入一条
+            keyboardUserSortMapper.insertUserSort(userId, newSortArray);
+        }
+    }
 }

src/main/resources/mapper/KeyboardUserCharacterMapper.xml

@@ -2,39 +2,35 @@
 <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
 <mapper namespace="com.yolo.keyborad.mapper.KeyboardUserCharacterMapper">
 
-    <resultMap id="KeyboardUserCharacterVOMap"
-               type="com.yolo.keyborad.model.vo.character.KeyboardUserCharacterVO">
-
-        <id column="id" property="id"/>
-
-        <!-- keyboard_character 表的列名，根据你的实际字段调整 -->
-        <result column="character_name" property="characterName"/>
-
-        <!-- 关键：ARRAY 字段明确指定 jdbcType + typeHandler -->
-        <result column="sort"
-                jdbcType="ARRAY"
-                typeHandler="org.apache.ibatis.type.ArrayTypeHandler"/>
-        <result column="emoji" property="emoji"/>
-    </resultMap>
-
-    <update id="updateSortByIdAndUserId">
-        UPDATE keyboard_user_character
-        SET sort = #{sort,jdbcType=ARRAY}
-        where user_id = #{userId}
-        AND deleted = FALSE
-    </update>
 
 
     <select id="selectByUserId"
-            resultMap="KeyboardUserCharacterVOMap">
+            resultType="com.yolo.keyborad.model.vo.character.KeyboardUserCharacterVO">
         SELECT
         kuc.id,
+        kuc.character_id,
         kc.character_name,
-        kuc.sort,
         kuc.emoji
-        FROM keyboard_user_character AS kuc
+        FROM keyboard_user_character kuc
-        LEFT JOIN keyboard_character AS kc ON kuc.character_id = kc.id
+        JOIN keyboard_user_sort kus
+        ON kus.user_id = kuc.user_id
+        LEFT JOIN keyboard_character kc
+        ON kuc.character_id = kc.id
         WHERE kuc.user_id = #{loginId}
         AND kuc.deleted = FALSE
+        ORDER BY array_position(kus.user_characteu_id_sort, kuc.id) NULLS LAST;
+    </select>
+
+    <update id="updateSortByIdAndUserId">
+        UPDATE keyboard_user_sort
+        SET user_characteu_id_sort = #{sort,jdbcType=ARRAY}
+        where user_id = #{userId}
+    </update>
+
+
+    <select id="selectSortByUserId" resultType="java.lang.Long">
+        SELECT unnest(user_characteu_id_sort)
+        FROM keyboard_user_sort
+        WHERE user_id = #{userId}
     </select>
 </mapper>

src/main/resources/mapper/KeyboardUserSortMapper.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
+<mapper namespace="com.yolo.keyborad.mapper.KeyboardUserSortMapper">
+    <!-- 展开数组为多行：返回 List<Long> -->
+    <select id="selectSortByUserId" resultType="java.lang.Long">
+        SELECT unnest(user_characteu_id_sort)
+        FROM keyboard_user_sort
+        WHERE user_id = #{userId}
+    </select>
+
+    <update id="updateSortByUserId">
+        UPDATE keyboard_user_sort
+        SET user_characteu_id_sort = #{sort, jdbcType=ARRAY}
+        WHERE user_id = #{userId}
+    </update>
+
+    <insert id="insertUserSort">
+        INSERT INTO keyboard_user_sort (user_id, user_characteu_id_sort)
+        VALUES (#{userId}, #{sort, jdbcType=ARRAY})
+    </insert>
+
+</mapper>