设备注册 短信跟邮箱验证

ruoyi-api/src/main/java/org/dromara/system/api/AppUserApiService.java

@@ -58,7 +58,7 @@ public interface AppUserApiService {
      *
      * @param phoneNumber 手机号
      * @param rawPassword 明文密码
-     * @param nickName    昵称（为空时默认取手机号）
+     * @param nickName    昵称（为空时默认生成 {@code user_ + 当前时间戳}）
      * @return 新建用户主键
      */
     Long registerByPhone(String phoneNumber, String rawPassword, String nickName);
@@ -82,6 +82,15 @@ public interface AppUserApiService {
      */
     boolean existsByEmail(String email);
 
+    /**
+     * 更新 APP 用户邮箱；仅更新邮箱字段，昵称保持不变。
+     *
+     * @param userId   用户主键
+     * @param newEmail 新邮箱地址（已归一化）
+     * @return true 修改成功
+     */
+    boolean updateEmail(Long userId, String newEmail);
+
     /**
      * 以邮箱注册一个 APP 用户（邮箱注册入口）。
      * <p>
@@ -94,7 +103,7 @@ public interface AppUserApiService {
      *
      * @param email       邮箱地址（已归一化）
      * @param rawPassword 明文密码
-     * @param nickName    昵称（为空时默认取邮箱）
+     * @param nickName    昵称（为空时默认生成 {@code user_ + 当前时间戳}）
      * @return 新建用户主键
      */
     Long registerByEmail(String email, String rawPassword, String nickName);
@@ -109,7 +118,7 @@ public interface AppUserApiService {
     boolean resetPassword(Long userId, String rawPassword);
 
     /**
-     * 换绑手机号。
+     * 换绑手机号；仅更新手机号字段，昵称保持不变。
      *
      * @param userId         用户主键
      * @param newPhoneNumber 新手机号