【升级】v3.5.0后端更新，更新日志见推文

2026-03-22 02:37:16 +08:00 · 2025-05-13 01:33:37 +08:00
parent 550a118068
commit 9dd127479a
422 changed files with 13368 additions and 2033 deletions
--- a/snowy-plugin-api/snowy-plugin-auth-api/pom.xml
+++ b/snowy-plugin-api/snowy-plugin-auth-api/pom.xml
@@ -27,4 +27,4 @@
            <artifactId>sa-token-core</artifactId>
        </dependency>
    </dependencies>
-</project>
+</project>
--- a/snowy-plugin-api/snowy-plugin-auth-api/src/main/java/vip/xiaonuo/auth/api/SaBaseLoginUserApi.java
+++ b/snowy-plugin-api/snowy-plugin-auth-api/src/main/java/vip/xiaonuo/auth/api/SaBaseLoginUserApi.java
@@ -66,6 +66,14 @@ public interface SaBaseLoginUserApi {
     **/
    SaBaseLoginUser getUserByPhone(String phone);

+    /**
+     * 根据邮箱获取B端用户信息，查不到则返回null
+     *
+     * @author xuyuxiang
+     * @date 2022/3/10 16:14
+     **/
+    SaBaseLoginUser getUserByEmail(String email);
+
    /**
     * 根据手机号获取C端用户信息，查不到则返回null
     *
@@ -74,6 +82,14 @@ public interface SaBaseLoginUserApi {
     **/
    SaBaseClientLoginUser getClientUserByPhone(String phone);

+    /**
+     * 根据邮箱获取C端用户信息，查不到则返回null
+     *
+     * @author xuyuxiang
+     * @date 2022/3/10 16:14
+     **/
+    SaBaseClientLoginUser getClientUserByEmail(String email);
+
    /**
     * 根据用户id获取用户集合
     *
@@ -121,4 +137,44 @@ public interface SaBaseLoginUserApi {
     * @date 2022/4/27 22:57
     */
    void updateUserLoginInfo(String userId, String device);
+
+    /**
+     * 使用手机号创建B端用户
+     *
+     * @author xuyuxiang
+     * @date 2022/3/10 16:14
+     **/
+    SaBaseLoginUser createUserWithPhone(String phone);
+
+    /**
+     * 使用手机号创建C端用户
+     *
+     * @author xuyuxiang
+     * @date 2022/3/10 16:14
+     **/
+    SaBaseClientLoginUser createClientUserWithPhone(String phone);
+
+    /**
+     * 使用邮箱创建B端用户
+     *
+     * @author xuyuxiang
+     * @date 2022/3/10 16:14
+     **/
+    SaBaseLoginUser createUserWithEmail(String email);
+
+    /**
+     * 使用邮箱创建C端用户
+     *
+     * @author xuyuxiang
+     * @date 2022/3/10 16:14
+     **/
+    SaBaseClientLoginUser createClientUserWithEmail(String email);
+
+    /**
+     * 执行注册
+     *
+     * @author xuyuxiang
+     * @date 2022/3/10 16:14
+     **/
+    void doRegister(String account, String password);
 }
--- a/snowy-plugin-api/snowy-plugin-dev-api/pom.xml
+++ b/snowy-plugin-api/snowy-plugin-dev-api/pom.xml
@@ -63,28 +63,22 @@
            <artifactId>tencentcloud-sdk-java-ses</artifactId>
        </dependency>

-        <!--阿里云短信sdk-->
-        <dependency>
-            <groupId>com.aliyun</groupId>
-            <artifactId>dysmsapi20170525</artifactId>
-        </dependency>
-
-        <!--腾讯云短信sdk-->
-        <dependency>
-            <groupId>com.tencentcloudapi</groupId>
-            <artifactId>tencentcloud-sdk-java-sms</artifactId>
-        </dependency>
-
        <!-- sms4j短信sdk -->
        <dependency>
            <groupId>org.dromara.sms4j</groupId>
            <artifactId>sms4j-javase-plugin</artifactId>
        </dependency>

+        <!-- sms4j消息推送sdk -->
+        <dependency>
+            <groupId>org.dromara.sms4j</groupId>
+            <artifactId>sms4j-oa-core</artifactId>
+        </dependency>
+
        <!--系统硬件信息-->
        <dependency>
            <groupId>com.github.oshi</groupId>
            <artifactId>oshi-core</artifactId>
        </dependency>
    </dependencies>
-</project>
+</project>
--- a/snowy-plugin-api/snowy-plugin-dev-api/src/main/java/vip/xiaonuo/dev/api/DevEmailApi.java
+++ b/snowy-plugin-api/snowy-plugin-dev-api/src/main/java/vip/xiaonuo/dev/api/DevEmailApi.java
@@ -27,6 +27,28 @@ import java.util.Map;
 **/
 public interface DevEmailApi {

+    /**
+     * 动态发送TXT邮件（使用系统配置的默认邮件引擎）
+     *
+     * @param tos 收件人邮箱，逗号拼接
+     * @param subject 邮件主题
+     * @param content 邮件内容
+     * @author xuyuxiang
+     * @date 2022/2/7 22:29
+     */
+    void sendDynamicTxtEmail(String tos, String subject, String content);
+
+    /**
+     * 动态发送HTML邮件（使用系统配置的默认邮件引擎）
+     *
+     * @param tos 收件人邮箱，逗号拼接
+     * @param subject 邮件主题
+     * @param content 邮件内容
+     * @author xuyuxiang
+     * @date 2022/2/7 22:29
+     */
+    void sendDynamicHtmlEmail(String tos, String subject, String content);
+
    /* =========本地邮件========= */

    /**
--- a/snowy-plugin-api/snowy-plugin-dev-api/src/main/java/vip/xiaonuo/dev/api/DevFileApi.java
+++ b/snowy-plugin-api/snowy-plugin-dev-api/src/main/java/vip/xiaonuo/dev/api/DevFileApi.java
@@ -31,6 +31,14 @@ public interface DevFileApi {
     **/
    String uploadDynamicReturnId(MultipartFile file);

+    /**
+     * 动态上传文件返回url（使用系统配置的默认文件引擎）
+     *
+     * @author xuyuxiang
+     * @date 2021/10/13 14:01
+     **/
+    String uploadDynamicReturnUrl(MultipartFile file);
+
    /* =========本地文件========= */

    /**
@@ -119,6 +127,7 @@ public interface DevFileApi {
     */
    JSONObject getFileInfoById(String id);

+
    /**
     * 根据文件id物理删除文件
     *
--- a/snowy-plugin-api/snowy-plugin-dev-api/src/main/java/vip/xiaonuo/dev/api/DevPushApi.java
+++ b/snowy-plugin-api/snowy-plugin-dev-api/src/main/java/vip/xiaonuo/dev/api/DevPushApi.java
@@ -0,0 +1,109 @@
+/*
+ * Copyright [2022] [https://www.xiaonuo.vip]
+ *
+ * Snowy采用APACHE LICENSE 2.0开源协议，您在使用过程中，需要注意以下几点：
+ *
+ * 1.请不要删除和修改根目录下的LICENSE文件。
+ * 2.请不要删除和修改Snowy源码头部的版权声明。
+ * 3.本项目代码可免费商业使用，商业使用请保留源码和相关描述文件的项目出处，作者声明等。
+ * 4.分发源码时候，请注明软件出处 https://www.xiaonuo.vip
+ * 5.不可二次分发开源参与同类竞品，如有想法可联系团队xiaonuobase@qq.com商议合作。
+ * 6.若您的项目无法满足以上几点，需要更多功能代码，获取Snowy商业授权许可，请在官网购买授权，地址为 https://www.xiaonuo.vip
+ */
+package vip.xiaonuo.dev.api;
+
+/**
+ * 邮件API接口
+ *
+ * @author xuyuxiang
+ * @date 2022/6/22 15:21
+ **/
+public interface DevPushApi {
+
+    /**
+     * 动态推送消息（使用系统配置的默认消息推送引擎）
+     *
+     * @param content 内容
+     * @param noticeAll 是否通知所有人
+     * @author xuyuxiang
+     * @date 2022/2/23 14:24
+     */
+    void pushDynamicText(String content, boolean noticeAll);
+
+    /**
+     * 推送消息——飞书TXT
+     *
+     * @param content 内容
+     * @param noticeAll 是否通知所有人
+     * @author xuyuxiang
+     * @date 2022/2/23 14:24
+     */
+    void pushFeiShuText(String content, boolean noticeAll);
+
+    /**
+     * 推送消息——钉钉TXT
+     *
+     * @param content 内容
+     * @param noticeAll 是否通知所有人
+     * @param phones 通知的用户手机号，英文逗号分割
+     * @author xuyuxiang
+     * @date 2022/2/23 14:24
+     */
+    void pushDingTalkText(String content, boolean noticeAll, String phones);
+
+    /**
+     * 推送消息——钉钉MARKDOWN
+     *
+     * @param title 标题
+     * @param content 内容
+     * @param noticeAll 是否通知所有人
+     * @author xuyuxiang
+     * @date 2022/2/23 14:24
+     */
+    void pushDingTalkMarkdown(String title, String content, boolean noticeAll);
+
+    /**
+     * 推送消息——钉钉LINK
+     *
+     * @param title 标题
+     * @param content 内容
+     * @param picUrl 封面图片地址
+     * @param messageUrl 消息链接地址
+     * @author xuyuxiang
+     * @date 2022/2/23 14:24
+     */
+    void pushDingTalkLink(String title, String content, String picUrl,String messageUrl);
+
+    /**
+     * 推送消息——企业微信TXT
+     *
+     * @param content 内容
+     * @param noticeAll 是否通知所有人
+     * @param phones 通知的用户手机号，英文逗号分割
+     * @author xuyuxiang
+     * @date 2022/2/23 14:24
+     */
+    void pushWorkWechatText(String content, boolean noticeAll, String phones);
+
+    /**
+     * 推送消息——企业微信MARKDOWN
+     *
+     * @param title 标题
+     * @param content 内容
+     * @author xuyuxiang
+     * @date 2022/2/23 14:24
+     */
+    void pushWorkWechatMarkdown(String title, String content);
+
+    /**
+     * 推送消息——企业微信NEWS
+     *
+     * @param title 标题
+     * @param content 内容
+     * @param picUrl 封面图片地址
+     * @param messageUrl 消息链接地址
+     * @author xuyuxiang
+     * @date 2022/2/23 14:24
+     */
+    void pushWorkWechatNews(String title, String content, String picUrl,String messageUrl);
+}
--- a/snowy-plugin-api/snowy-plugin-dev-api/src/main/java/vip/xiaonuo/dev/api/DevSmsApi.java
+++ b/snowy-plugin-api/snowy-plugin-dev-api/src/main/java/vip/xiaonuo/dev/api/DevSmsApi.java
@@ -12,6 +12,8 @@
 */
 package vip.xiaonuo.dev.api;

+import cn.hutool.json.JSONObject;
+
 /**
 * 短信API
 *
@@ -20,6 +22,17 @@ package vip.xiaonuo.dev.api;
 **/
 public interface DevSmsApi {

+    /**
+     * 动态发送短信（使用系统配置的默认短信引擎）
+     *
+     * @param phoneNumbers 手机号
+     * @param templateCodeOrId 模板id或编码
+     * @param paramMap 发送参数
+     * @author xuyuxiang
+     * @date 2022/2/7 22:29
+     */
+    void sendDynamicSms(String phoneNumbers, String templateCodeOrId, JSONObject paramMap);
+
    /* =========阿里云短信========= */

    /**
@@ -27,7 +40,7 @@ public interface DevSmsApi {
     *
     * @param phoneNumbers 手机号码，支持对多个手机号码发送短信，手机号码之间以半角逗号（,）分隔。
     *                     上限为1000个手机号码。批量调用相对于单条调用及时性稍有延迟。
-     * @param signName 短信服务控制台配置且审核通过的短信签名，为空则使用默认签名
+     * @param signName 短信服务控制台配置且审核通过的短信签名
     * @param templateCode 短信服务控制台配置且审核通过的模板编码
     * @param templateParam 短信模板变量对应的实际值，JSON格式。支持传入多个参数，示例：{"name":"张三","number":"15038****76"}
     * @author xuyuxiang
@@ -40,17 +53,15 @@ public interface DevSmsApi {
    /**
     * 发送短信
     *
-     * @param sdkAppId 短信 SdkAppId，在 短信控制台 添加应用后生成的实际 SdkAppId，示例如1400006666。
-     *                 可前往 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 查看
     * @param phoneNumbers 手机号码，支持对多个手机号码发送短信，手机号码之间以半角逗号（,）分隔。
     *                     上限为1000个手机号码。批量调用相对于单条调用及时性稍有延迟。
-     * @param signName 短信服务控制台配置且审核通过的短信签名，为空则使用默认签名
+     * @param signName 短信服务控制台配置且审核通过的短信签名
     * @param templateCode 短信服务控制台配置且审核通过的模板编码
     * @param templateParam 短信模板变量对应的顺序。支持传入多个参数，逗号拼接，示例："张三,15038****76,进行中"}
     * @author xuyuxiang
     * @date 2022/2/24 13:42
     **/
-    void sendSmsTencent(String sdkAppId, String phoneNumbers, String signName, String templateCode, String templateParam);
+    void sendSmsTencent(String phoneNumbers, String signName, String templateCode, String templateParam);

    /* =========小诺短信========= */

@@ -58,10 +69,11 @@ public interface DevSmsApi {
     * 发送短信
     *
     * @param phoneNumbers 手机号码，支持对多个手机号码发送短信，手机号码之间以半角逗号（,）分隔。
-     * @param signName 短信签名，为空则使用默认签名
-     * @param message 短信内容
-     * @author xuyuxiang
-     * @date 2022/2/24 13:42
+     *                     上限为1000个手机号码。批量调用相对于单条调用及时性稍有延迟。
+     * @param signName 短信服务控制台配置且审核通过的短信签名
+     * @param message 短信内容，发送时编写好的整条短信内容，不带签名【】
+     * @author yubaoshan
+     * @date 2024/5/20 12:00
     **/
    void sendSmsXiaonuo(String phoneNumbers, String signName, String message);
 }
--- a/snowy-plugin-api/snowy-plugin-dev-api/src/main/java/vip/xiaonuo/dev/api/DevWeakPasswordApi.java
+++ b/snowy-plugin-api/snowy-plugin-dev-api/src/main/java/vip/xiaonuo/dev/api/DevWeakPasswordApi.java
@@ -0,0 +1,32 @@
+/*
+ * Copyright [2022] [https://www.xiaonuo.vip]
+ *
+ * Snowy采用APACHE LICENSE 2.0开源协议，您在使用过程中，需要注意以下几点：
+ *
+ * 1.请不要删除和修改根目录下的LICENSE文件。
+ * 2.请不要删除和修改Snowy源码头部的版权声明。
+ * 3.本项目代码可免费商业使用，商业使用请保留源码和相关描述文件的项目出处，作者声明等。
+ * 4.分发源码时候，请注明软件出处 https://www.xiaonuo.vip
+ * 5.不可二次分发开源参与同类竞品，如有想法可联系团队xiaonuobase@qq.com商议合作。
+ * 6.若您的项目无法满足以上几点，需要更多功能代码，获取Snowy商业授权许可，请在官网购买授权，地址为 https://www.xiaonuo.vip
+ */
+package vip.xiaonuo.dev.api;
+
+import java.util.List;
+
+/**
+ * 弱密码库APi接口
+ *
+ * @author xuyuxiang
+ * @date 2022/6/17 10:37
+ **/
+public interface DevWeakPasswordApi {
+
+    /**
+     * 获取弱密码库列表
+     *
+     * @author xuyuxiang
+     * @date 2022/6/17 11:11
+     **/
+    List<String> weakPasswordList();
+}
--- a/snowy-plugin-api/snowy-plugin-mobile-api/src/main/java/vip/xiaonuo/mobile/api/MobileApi.java
+++ b/snowy-plugin-api/snowy-plugin-mobile-api/src/main/java/vip/xiaonuo/mobile/api/MobileApi.java
@@ -0,0 +1,22 @@
+/*
+ * Copyright [2022] [https://www.xiaonuo.vip]
+ *
+ * Snowy采用APACHE LICENSE 2.0开源协议，您在使用过程中，需要注意以下几点：
+ *
+ * 1.请不要删除和修改根目录下的LICENSE文件。
+ * 2.请不要删除和修改Snowy源码头部的版权声明。
+ * 3.本项目代码可免费商业使用，商业使用请保留源码和相关描述文件的项目出处，作者声明等。
+ * 4.分发源码时候，请注明软件出处 https://www.xiaonuo.vip
+ * 5.不可二次分发开源参与同类竞品，如有想法可联系团队xiaonuobase@qq.com商议合作。
+ * 6.若您的项目无法满足以上几点，需要更多功能代码，获取Snowy商业授权许可，请在官网购买授权，地址为 https://www.xiaonuo.vip
+ */
+package vip.xiaonuo.mobile.api;
+
+/**
+ * 移动端综合API
+ *
+ * @author xuyuxiang
+ * @date 2022/9/26 14:24
+ **/
+public interface MobileApi {
+}
--- a/snowy-plugin-api/snowy-plugin-mobile-api/src/main/java/vip/xiaonuo/mobile/api/MobileButtonApi.java
+++ b/snowy-plugin-api/snowy-plugin-mobile-api/src/main/java/vip/xiaonuo/mobile/api/MobileButtonApi.java
@@ -28,5 +28,5 @@ public interface MobileButtonApi {
     * @author 每天一点
     * @date 2023/2/5 13:26
     **/
-    List<String> listByIds(List<String> idList);
+    List<String> listButtonCodeListByIdList(List<String> idList);
 }
--- a/snowy-plugin-api/snowy-plugin-mobile-api/src/main/java/vip/xiaonuo/mobile/api/MobileMenuApi.java
+++ b/snowy-plugin-api/snowy-plugin-mobile-api/src/main/java/vip/xiaonuo/mobile/api/MobileMenuApi.java
@@ -33,6 +33,14 @@ public interface MobileMenuApi {
     **/
    List<JSONObject> mobileMenuTreeSelector();

+    /**
+     * 获取移动端菜单授权树
+     *
+     * @author xuyuxiang
+     * @date 2023/1/31 10:10
+     **/
+    List<JSONObject> mobileMenuTreeSelector(List<JSONObject> originDataList);
+
    /**
     * 获取移动端登录菜单树
     *
--- a/snowy-plugin-api/snowy-plugin-sys-api/src/main/java/vip/xiaonuo/sys/api/SysApi.java
+++ b/snowy-plugin-api/snowy-plugin-sys-api/src/main/java/vip/xiaonuo/sys/api/SysApi.java
@@ -0,0 +1,30 @@
+/*
+ * Copyright [2022] [https://www.xiaonuo.vip]
+ *
+ * Snowy采用APACHE LICENSE 2.0开源协议，您在使用过程中，需要注意以下几点：
+ *
+ * 1.请不要删除和修改根目录下的LICENSE文件。
+ * 2.请不要删除和修改Snowy源码头部的版权声明。
+ * 3.本项目代码可免费商业使用，商业使用请保留源码和相关描述文件的项目出处，作者声明等。
+ * 4.分发源码时候，请注明软件出处 https://www.xiaonuo.vip
+ * 5.不可二次分发开源参与同类竞品，如有想法可联系团队xiaonuobase@qq.com商议合作。
+ * 6.若您的项目无法满足以上几点，需要更多功能代码，获取Snowy商业授权许可，请在官网购买授权，地址为 https://www.xiaonuo.vip
+ */
+package vip.xiaonuo.sys.api;
+
+/**
+ * 系统模块综合API
+ *
+ * @author xuyuxiang
+ * @date 2022/9/26 14:24
+ **/
+public interface SysApi {
+
+    /**
+     * 获取系统默认密码
+     *
+     * @author xuyuxiang
+     * @date 2022/9/26 14:25
+     **/
+    String getDefaultPassword();
+}
--- a/snowy-plugin-api/snowy-plugin-sys-api/src/main/java/vip/xiaonuo/sys/api/SysModuleApi.java
+++ b/snowy-plugin-api/snowy-plugin-sys-api/src/main/java/vip/xiaonuo/sys/api/SysModuleApi.java
@@ -13,6 +13,7 @@
 package vip.xiaonuo.sys.api;

 import cn.hutool.json.JSONObject;
+
 import java.util.List;

 /**
--- a/snowy-plugin-api/snowy-plugin-sys-api/src/main/java/vip/xiaonuo/sys/api/SysPositionApi.java
+++ b/snowy-plugin-api/snowy-plugin-sys-api/src/main/java/vip/xiaonuo/sys/api/SysPositionApi.java
@@ -37,5 +37,5 @@ public interface SysPositionApi {
     * @author xuyuxiang
     * @date 2022/7/22 14:47
     **/
-    Page<JSONObject> positionSelector(String orgId, String searchKey);
+    Page<JSONObject> positionSelector(String orgId, String searchKey, Integer current, Integer size);
 }
--- a/snowy-plugin-api/snowy-plugin-sys-api/src/main/java/vip/xiaonuo/sys/api/SysRoleApi.java
+++ b/snowy-plugin-api/snowy-plugin-sys-api/src/main/java/vip/xiaonuo/sys/api/SysRoleApi.java
@@ -48,4 +48,20 @@ public interface SysRoleApi {
     * @date 2022/11/1 15:58
     **/
    void grantForGenMenuAndButton(String menuId);
+
+    /**
+     * 获取资源授权树
+     *
+     * @author xuyuxiang
+     * @date 2022/4/24 20:08
+     */
+    List<JSONObject> resourceTreeSelector();
+
+    /**
+     * 获取权限授权树
+     *
+     * @author xuyuxiang
+     * @date 2022/4/24 20:08
+     */
+    List<String> permissionTreeSelector();
 }