后端手册完善

Author: haoxianrui

src/.vuepress/sidebar.ts

@@ -3,5 +3,6 @@ import { sidebar } from "vuepress-theme-hope";
 export default sidebar({
   "/vue3-element-admin/": "structure",
   "/youlai-boot/": "structure",
-  "/单体商城/": "structure",
+  "/vue-uniapp-template/": "structure",
+  "/youlai-mall/": "structure",
 });

src/README.md

@@ -27,29 +27,29 @@ features:
   - title: vue-uniapp-template
     details:
       <span style="font-weight:bold;color:#165DEF">移动端框架：</span>基于 Uni-App、Vue3 和 TypeScript 构建的灵活跨平台移动端模板，使用 VSCode 和 CLI 高效开发模式。
-    link: /zh/guide/feature/comment.html
+    link: /vue-uniapp-template/
   - title: youlai-nest
     details:
       <span style="font-weight:bold;color:#165DEF">Node后端框架：</span>基于 Node、Nest 和 TypeScript 构建的 RBAC 权限管理后端，前端全栈开发首选。
-    link: /zh/guide/layout/
+    link: /youlai-nest/
 
   - title: youlai-cloud
     details:
       <span style="font-weight:bold;color:#00B42A">微服务框架：</span>基于 Java、Spring Boot 3、Spring Cloud & Alibaba、SAS 构建的微服务解决方案。
-    link: /zh/guide/feature/page-info.html
+    link: /youlai-cloud/
 
   - title: youlai-mall
     details:
       <span style="font-weight:bold;color:#FF7D00">微服务商城：</span>基于 vue3-element-admin、youlai-cloud、uniapp-nutui-template 构建的微服务商城
-    link: /zh/guide/feature/page-info.html
+    link: /youlai-mall/
 
   - title: mall-admin
     details:  <span style="font-weight:bold;color:#FF7D00">商城管理前端：</span>基于 vue3-element-admin 模板框架开发的 youlai-mall 商城管理系统
-    link: /zh/guide/blog/intro.html
+    link: /mall-admin/
 
   - title: mall-app
     details: <span style="font-weight:bold;color:#FF7D00">商城移动端：</span>youlai-mall 微信小程序/H5/Android/iOS 移动应用端。
-    link: /zh/guide/interface/theme-color.html
+    link: /mall-app/
 
 copyright: false
 footer: MIT Licensed | Copyright © 2020-present 有来技术

src/vue-uniapp-template/README.md

@@ -0,0 +1,9 @@
+---
+title: 移动端框架
+icon: palette
+dir:
+  order: 1
+  collapsible: false
+  expanded: true
+  link: true
+---

src/youlai-boot/3.开发指南/1.代码生成.md

@@ -9,7 +9,11 @@ tag:
 ---
 
 :::tip
-以新增会员管理模块为例，来讲解如何生成前后端代码以及在项目中新增一个模块时自动生成菜单路由。
+本节将详细介绍两种代码生成方式：
+
+**1. IDEA 插件生成** - 专注快速生成后端 CRUD 代码
+
+**2. 项目代码生成** - 通过前端页面一键生成前后端完整模块
 :::
 
 ## IDEA 插件生成(后端代码)
@@ -19,40 +23,40 @@ tag:
 
 在 IDEA 中依次点击 **File → Settings**（快捷键 **Ctrl + Alt + S**），打开设置面板，切换到 **Plugins** 选项卡，搜索 **MybatisX** 并安装插件。
 
-![](https://i-blog.csdnimg.cn/img_convert/c32b3839c08f5c24cd3fcc31ca5291c2.png) 
+![](https://www.youlai.tech/storage/blog/2025/02/23/c32b3839c08f5c24cd3fcc31ca5291c2.png) 
 
 ### 自动代码生成
 
 在 IDEA 右侧导航栏点击 **Database**，打开数据库配置面板，选择新增数据源。
 
-![](https://i-blog.csdnimg.cn/img_convert/a2cad24770ce5d5adc4e47c31ad45505.png) 
+![](https://www.youlai.tech/storage/blog/2025/02/23/a2cad24770ce5d5adc4e47c31ad45505.png) 
 
 输入数据库的 **主机地址**、**用户名** 和 **密码**，测试连接成功后点击 `OK` 保存。
-![](https://i-blog.csdnimg.cn/direct/6e8259d52a2041a4b573dfd15dc54c15.png)
 
- 
+![](https://www.youlai.tech/storage/blog/2025/02/23/6e8259d52a2041a4b573dfd15dc54c15.png)
 
+ 
 配置完数据源后，展开数据库中的表，右击 **sys_user** 表，选择 **MybatisX-Generator** 打开代码生成面板。
 
-![](https://i-blog.csdnimg.cn/direct/4dd6c3ca2daf4eefbca0a94d624b8d5e.png)
+![](https://www.youlai.tech/storage/blog/2025/02/23/4dd6c3ca2daf4eefbca0a94d624b8d5e.png)
 
 
 设置代码生成的目标路径，并选择 **Mybatis-Plus 3 + Lombok** 代码风格。
 
-![](https://i-blog.csdnimg.cn/direct/4609cbba1ca74fb784a3c30a36ffc9cf.png)
+![](https://www.youlai.tech/storage/blog/2025/02/23/4609cbba1ca74fb784a3c30a36ffc9cf.png)
 
 
-![](https://i-blog.csdnimg.cn/img_convert/3804dea39c8abe0acf193093d9eecd1d.png) 
+![](https://www.youlai.tech/storage/blog/2025/02/23/3804dea39c8abe0acf193093d9eecd1d.png) 
 
 点击 `Finish` 生成，自动生成相关代码。
 
-![](https://i-blog.csdnimg.cn/img_convert/7e4f7cf07c1aedf8303e2c77e78283a9.png)
+![](https://www.youlai.tech/storage/blog/2025/02/23/7e4f7cf07c1aedf8303e2c77e78283a9.png)
 
 MybatisX 生成的代码存在以下问题：
 
 - `SysUserMapper.java` 文件未标注 `@Mapper` 注解，导致无法被 Spring Boot 识别为 Mybatis 的 Mapper 接口。如果已配置 `@MapperScan`，可以省略此注解，但最简单的方法是直接在 `SysUserMapper.java` 文件中添加 `@Mapper` 注解。注意避免导入错误的包。
 
-![](https://i-blog.csdnimg.cn/img_convert/a35123dfa197213e06941541a716f76b.png)
+![](https://www.youlai.tech/storage/blog/2025/02/23/a35123dfa197213e06941541a716f76b.png)
 
 
 ## 项目代码生成(前后端代码)

src/youlai-boot/3.开发指南/2.修改包名.md

@@ -1,32 +1,39 @@
 ---
 title: 修改包名
 icon: list
-order: 3
+order: 2
 category:
   - 开发指南
 tag:
   - 修改包名
 ---
+
 :::tip
-在项目中，如果需要修改默认的包名，需要做以下改动：
+如果需要修改项目名，请按以下步骤同步调整配置（示例：将 com.youlai.boot 改为 com.wuhui.boot）：
 :::
 
-默认包名为 `com.youlai.boot`，如需修改为 `com.wuhui.boot`，需要做以下改动：
+## 配置修改清单
+
+### 启动类包路径
+
+重命名启动类文件： `YoulaiBootApplication.java` ➔ `WuhuiBootApplication.java`。
+
+### 应用标识
 
-- 修改启动类名称
+- application.yml 修改：
 
-  将启动类从 `YoulaiBootApplication` 改为 `WuhuiBootApplication`。
+  在 `application.yml` 中将 `spring.application.name` 的值从 `youlai-boot` 修改为 `wuhui-boot`；
 
-- 修改应用名称
+- pom.xml 修改：
 
-  在 `application.yml` 中将 `spring.application.name` 的值从 `youlai-boot` 修改为 `wuhui-boot`；在 `pom.xml` 中将 `<groupId>` 值从 `com.youlai` 改为 `com.wuhui`
+  在 `pom.xml` 中将 `<groupId>` 值从 `com.youlai` 改为 `com.wuhui`
 
-- 修改接口文档包路径，否则接口文档不显示接口描述
+### 接口文档配置
 
-  `application-*.yml` 修改接口文档扫描包路径
+  在 `application-*.yml` 修改接口文档扫描包路径 , 否则接口文档不显示接口描述
 
-  ![](https://i-blog.csdnimg.cn/img_convert/8f6c053061051f5c40733785c4512d5e.png) 
+  ![](https://www.youlai.tech/storage/blog/2025/02/23/8f6c053061051f5c40733785c4512d5e.png) 
 
-- 代码生成的项目名称
+### 代码生成配置
 
   `codegen.yml` 里修改后端项目名称 `codegen.backendAppName` 替换 youlai-boot 为 wuhui-boot

src/youlai-boot/3.开发指南/3.数据权限.md

@@ -0,0 +1,82 @@
+---
+title: 数据权限
+icon: list
+order: 3
+category:
+  - 开发指南
+tag:
+  - 数据权限
+---
+
+:::tip
+数据权限是指用户在系统中对数据的访问权限。通过数据权限，可以实现对用户访问数据的控制，保证数据的安全性。
+:::
+
+## 实现原理
+
+通过自定义拦截器实现 `DataPermissionHandler` 接口。在 youlai-boot 中，`MyDataPermissionHandler` 是其具体实现类，用于在 SQL 执行前动态拼接权限过滤条件。
+处理逻辑如下：
+
+- 获取用户权限范围（如部门或用户）。
+- 动态生成筛选条件：如部门及以下的 `dept_id IN (...)` 或个人创建的 `create_by = ...`。
+- 将条件追加到原始 SQL 的 `WHERE` 子句。
+
+## 使用示例
+
+在数据持久层的方法中，如果需要实现数据权限控制，可以直接在方法上添加 `@DataPermission` 注解。
+
+**UserMapper.java**  
+
+```java
+@Mapper
+public interface UserMapper {
+
+    @DataPermission(
+        deptAlias = "u", // 部门字段的表别名，用于标记 SQL 中部门字段的来源表
+        deptIdColumnName = "dept_id", // 部门字段的列名，默认为 dept_id
+        userAlias = "u", // 用户字段的表别名，用于标记 SQL 中用户字段的来源表
+        userIdColumnName = "create_by" // 用户字段的列名，默认为 create_by
+    )
+    Page<UserBO> getUserPage(Page<UserBO> page, UserPageQuery queryParams);
+}
+```
+
+**UserMapper.xml**  
+
+```xml
+<select id="getUserPage">
+    SELECT
+        u.id,
+        u.username,
+        u.nickname,
+        u.dept_id
+    FROM
+        sys_user u
+    WHERE
+        u.is_deleted = 0
+</select>
+```
+
+动态 SQL 示例：
+
+- **权限范围：部门及以下**
+
+  ```sql
+  SELECT u.id, u.username, u.nickname, u.dept_id 
+  FROM sys_user u 
+  WHERE u.is_deleted = 0 
+    AND u.dept_id IN (SELECT id FROM sys_dept WHERE id = 3 OR FIND_IN_SET(3, tree_path));
+  ```
+
+  其中`AND u.dept_id IN (SELECT id FROM sys_dept WHERE id = 3 OR FIND_IN_SET(3, tree_path))`是 `MyDataPermissionHandler` 根据用户权限为“部门及以下”动态追加的筛选条件。
+
+- **权限范围：本人创建**
+
+  ```sql
+  SELECT u.id, u.username, u.nickname, u.dept_id 
+  FROM sys_user u 
+  WHERE u.is_deleted = 0 
+    AND u.create_by = 2;
+  ```
+
+  其中：`AND u.create_by = 2`是 `MyDataPermissionHandler` 根据用户权限为“本人创建”动态追加的筛选条件。