codewave-openclaw-installer 1.0.0

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/10./351/241/265/351/235/242/350/256/276/350/256/241/35./346/235/203/351/231/220/346/250/241/345/235/227/022./346/235/203/351/231/220/345/234/272/346/231/257/020./345/246/202/344/275/225/345/256/236/347/216/260/346/225/260/346/215/256/346/235/203/351/231/220/346/216/247/345/210/266.md

@@ -0,0 +1,166 @@
+# 如何实现数据权限控制
+
+## 1. 场景介绍
+
+应用开启权限模块配置时，支持直接引入系统默认的权限模块并使用。本文将介绍如何使用系统默认权限模块在制品应用中实现数据权限控制。
+
+具体示例场景需求如下：
+
+用户支持通过实体创建申请信息，申请信息包括申请内容和申请结果。
+
+- A和B作为部门的普通职员，支持查看并修改本人创建的申请内容、支持查看申请结果。
+- C作为上级领导，支持查看A和B的申请内容、支持修改申请结果。
+
+## 2. 前提条件
+
+### 2.1 开启系统默认权限模块配置
+
+1.  右键点击“PC“端，选择“权限模块配置”。
+
+    <img src="../assets/gnqxkz_202406141052_1.png" style="border: 1px solid #ccc;" />
+2.  开启包含“系统默认权限”的模板后，点击确定。
+
+    <img src="../assets/quanxian_202410231622_1.png" style="border: 1px solid #ccc;" />
+
+3.  如下页面，可直接在制品应用中实现数据权限控制。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_1.png" class="imgStyle" style="" />
+
+### 2.2 创建实体用例
+
+已有实体Application，用于创建数据并进行效果展示。实体属性主要包含申请人（createdBy）、申请内容、申请结果。在实际操作中用户可自行选择需要设置的实体。
+
+<img src="../assets/rhsxsjqxkz_202407041445_2.png" class="imgStyle" style="" />
+
+### 2.3 创建用户用例
+
+1.  发布预览。
+
+    <div class="details">
+    注意：发布预览和正式发布在制品应用中创建的数据存储在不同的数据库中，不会共享。本文仅以开发环境发布预览的操作和数据作为使用说明。
+    </div>
+
+1.  在制品应用中，进入权限中心的用户管理页（相对路径为/permissionCenter/userManagement），创建如下普通用户，用于效果演示。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_3.png" class="imgStyle" style="" />
+
+## 3. 操作步骤
+
+### 3.1 开启数据权限
+
+实现数据权限的首要条件是把需要实现权限控制的数据来源作为元信息，控制元信息的行权限和列权限即表示设置数据权限。
+
+开启数据权限的实体或服务端逻辑被命名为元信息，更多介绍请参考文档[系统默认权限模块](../../35.权限模块/010.系统默认权限模块.md)-创建元信息。
+
+1.  在IDE中，选中实体Application，开启数据权限。应用发布后实体Application即可作为实体元信息。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_4.png" class="imgStyle" style="" />
+
+1.  发布预览。在制品应用中，进入权限中心的角色管理页（相对路径为/permissionCenter/roleManagement）。
+
+### 3.2 根据角色设置数据权限
+
+系统默认权限控制根据用户所属的角色和角色所拥有的权限进行鉴权。因此，需要在不同的角色下设置不同的数据权限，并为用户赋予不同的角色，即可满足用户使用不同的数据权限。
+
+#### 3.2.1 设置普通职员的数据权限
+
+1.  创建角色Staff，用于作为普通职员角色、控制普通职员的权限。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_5.png" class="imgStyle" style="" />
+
+1.  选中角色Staff，选择“数据权限”标签页。进入标签页后即可查看已开启数据权限的实体和服务端逻辑。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_6.png" class="imgStyle" style="" />
+
+1.  选中实体分类中的Application，分别编辑行权限和列权限，完成后点击保存。
+
+    - 将行权限设置为可读本人。表示用户仅支持查看本人创建的数据。
+    - 将“申请内容”的列权限设置为查看并修改。表示用户可以查看和修改申请内容。结合行权限，即表示支持查看和修改本人创建的申请内容。
+    - 将“申请结果”的列权限设置为仅查看。表示用户可以查看申请结果，但不支持修改。结合行权限，即表示支持查看本人创建的申请的申请结果。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_7.png" class="imgStyle" style="" />
+
+#### 3.2.2 设置上级领导的数据权限
+
+1.  创建角色Supervisor，用于作为上级领导角色、控制上级领导的权限。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_8.png" class="imgStyle" style="" />
+
+1.  选中角色Supervisor，分别编辑角色Supervisor下实体分类中的Application的行权限和列权限，完成后点击保存。
+
+    - 行权限：根据拥有上级领导和普通职员角色的用户关系来设置行权限。
+
+        - 情况一：如果角色Supervisor下的用户是角色Staff下用户的直属主管，那么将行权限设置为可读本人及下属。表示用户支持查看本人、以及把该用户作为直属主管的用户创建的数据。
+
+            <img src="../assets/rhsxsjqxkz_202407041445_9.png" class="imgStyle" style="" />
+
+        - 情况二：如果角色Supervisor下的用户和角色Staff下用户同属于一个部门或作为角色Staff下用户的上级部门，那么将行权限设置为可读本部门及下级部门。表示用户支持查看本部门内、下级部门内用户创建的数据。
+
+            <img src="../assets/rhsxsjqxkz_202407041445_10.png" class="imgStyle" style="" />
+
+    - 将“申请内容”的列权限设置为仅查看。表示用户可以查看申请内容，但不支持修改。结合行权限，即表示支持查看行权限范围内数据的申请内容。
+
+
+
+    - 将“申请结果”的列权限设置为查看并修改。表示用户可以查看和修改申请结果。结合行权限，即表示支持查看和修改行权限范围内数据的申请结果。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_11.png" class="imgStyle" style="" />
+
+### 3.3 为用户赋予角色
+
+1.  选中角色Staff，选择“人员管理”标签页，添加用户A、B。即A、B作为角色Staff下的用户，被赋予角色Staff设置的权限。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_12.png" class="imgStyle" style="" />
+
+1.  选中角色Supervisor，选择“人员管理”标签页，添加用户C。即C作为角色Supervisor下的用户，被赋予角色Supervisor设置的权限。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_13.png" class="imgStyle" style="" />
+
+## 4. 效果演示
+
+已有如下数据，分别在A、B用户登录状态下创建。
+
+<img src="../assets/rhsxsjqxkz_202407041445_14.png" class="imgStyle" style="" />
+
+- 当用户A登录时，作为普通职员，A仅可查看本人创建的数据，支持修改申请内容，申请结果即使修改也无法在传输数据后被保存。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_15.gif" class="imgStyle" style="" />
+
+- 当用户B登录时，作为普通职员，B仅可查看本人创建的数据，支持修改申请内容，申请结果即使修改也无法在传输数据后被保存。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_16.gif" class="imgStyle" style="" />
+
+- 当用户C登录时，作为上级领导，C可查看A、B创建的数据，支持修改申请结果，申请内容即使修改也无法保存。
+
+    <img src="../assets/rhsxsjqxkz_202407041445_17.gif" class="imgStyle" style="" />
+
+## 5. 补充说明
+
+当实体开启数据权限时，不会限制数据被创建时的列权限。而在实际应用中，通常不会允许用户在创建或修改时输入权限控制以外的数据。
+
+以本示例为例：
+
+- 在创建 / 修改数据时，A、B仅支持输入申请内容。即要求申请结果表单项不可用。
+- C不支持创建创建数据、仅支持查看A、B创建的数据。即要求触发创建的按钮或用于创建的表单不可用。
+- 在修改数据时，C仅支持输入申请结果。即要求申请内容表单项不可用。
+
+以上要求，可以通过功能权限控制来实现，具体实现方法请参考[如何实现功能权限控制](../../35.权限模块/022.权限场景/025.如何实现功能权限控制.md)。
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">有鲤</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2024年07月04日</span>
+</div>
+                
+<style>
+ .details {
+      border: 1px solid #679CF8; /* 添加边框 */
+      border-radius: 6px;
+      background-color: #F8FCFF; /* 添加底色 */
+      padding: 20px;
+      margin-bottom:20px;
+      margin-top:20px;
+      box-shadow: 0 2px 4px rgba(0, 0, 0, 0.2);
+  }
+</style>

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/10./351/241/265/351/235/242/350/256/276/350/256/241/35./346/235/203/351/231/220/346/250/241/345/235/227/022./346/235/203/351/231/220/345/234/272/346/231/257/025./345/246/202/344/275/225/345/256/236/347/216/260/345/212/237/350/203/275/346/235/203/351/231/220/346/216/247/345/210/266.md

@@ -0,0 +1,153 @@
+# 如何实现功能权限控制
+
+## 1. 场景介绍
+
+应用开启权限模块配置时，支持直接引入系统默认的权限模块并使用。本文将介绍如何使用系统默认权限模块在制品应用中实现功能权限控制。
+
+具体场景需求如下：
+
+用户支持在表单中通过实体创建和修改申请信息，申请信息包括申请内容和申请结果。
+
+* A和B作为部门的普通职员，支持创建申请信息，但创建和修改申请信息时仅支持编辑申请内容。
+* C作为领导，不支持创建申请信息，支持查看A和B的申请信息，并支持修改A和B创建申请信息的申请结果。
+
+## 2. 前提条件
+
+### 2.1 开启系统默认权限模块配置
+
+1. 右键点击“PC“端，选择“权限模块配置”。
+
+   <img src="../assets/gnqxkz_202406141052_1.png" style="border: 1px solid #ccc;" />
+2.  开启包含“系统默认权限”的模板后，点击确定。
+
+    <img src="../assets/quanxian_202410231622_1.png" style="border: 1px solid #ccc;" />
+3. 如下页面，可直接在制品应用中实现功能权限控制。
+
+   <img src="../assets/gnqxkz_202406141052_3.png" style="border: 1px solid #ccc;" />
+
+### 2.2 创建实体用例
+
+创建实体Application，用于创建数据并进行效果展示。实体属性主要包含申请人、申请内容、申请结果。
+
+<img src="../assets/gnqxkz_202406141052_4.png" style="border: 1px solid #ccc;" />
+
+### 2.3 创建用户用例
+
+1. 发布预览。
+
+   <div class="yellowBlock">
+    注意：发布预览和正式发布在制品应用中创建的数据存储在不同的数据库中，不会共享。本文仅以开发环境发布预览的操作和数据作为使用说明。
+    </div>
+2. 在制品应用中，进入权限中心的用户管理页（相对路径为/permissionCenter/userManagement），创建如下普通用户，用于效果演示。
+
+   <img src="../assets/gnqxkz_202406141052_5.png" style="border: 1px solid #ccc;" />
+
+## 3. 设计思路
+
+拖拽实体Application并选择列表（全），生成以下用于申请信息数据增删改查的页面。
+
+<img src="../assets/gnqxkz_202406141052_6.png" style="border: 1px solid #ccc;" />
+
+若要满足场景需求，可以通过控制组件功能的使用范围来实现。即要求用户C不可使用创建按钮、申请内容对应的表单项；要求A、B不可使用申请结果对应的表单项。
+
+<img src="../assets/gnqxkz_202406141052_7.png" style="border: 1px solid #ccc;" />
+
+## 4. 操作步骤
+
+### 4.1 创建资源
+
+实现功能权限的首要条件是把需要实现权限控制的组件 / 页面作为资源，为后续使用权限控制资源范围做准备。
+
+<div class="yellowBlock">
+当组件作为资源不可用时，表现为不可见；当页面作为资源不可用时，表现为无法被访问。
+</div>
+
+1. 在IDE中，分别选中上述按钮、表单项，开启控制权限。应用发布后相应组件即可作为资源。建议在开启控制权限后编辑资源描述，用于快速查找资源。
+
+   <img src="../assets/gnqxkz_202406141052_8.png" style="border: 1px solid #ccc;" />
+
+   <img src="../assets/gnqxkz_202406141052_9.png" style="border: 1px solid #ccc;" />
+
+   <img src="../assets/gnqxkz_202406141052_10.png" style="border: 1px solid #ccc;" />
+2. 为了防止未登录状态下的用户在进入页面时无法识别组件的功能使用权限，为页面也开启控制权限。要求仅允许登录用户访问页面。
+
+   <img src="../assets/gnqxkz_202406141052_11.png" style="border: 1px solid #ccc;" />
+3. 发布预览。在制品应用中，进入权限中心的权限管理页（相对路径为/permissionCenter/permissionManagement）。
+
+### 4.2 创建功能权限
+
+创建功能权限时支持关联资源，拥有对应权限的用户即可使用权限关联的资源。因此以下根据用户需要控制资源的范围创建两类功能权限。
+
+1. 创建普通职员的功能权限，关联资源包括创建按钮、申请内容的表单项、页面。
+
+   <img src="../assets/gnqxkz_202406141052_12.gif" style="border: 1px solid #ccc;" />
+2. 创建上级领导的功能权限，关联资源包括申请结果的表单项、页面。
+
+   <img src="../assets/gnqxkz_202406141052_13.gif" style="border: 1px solid #ccc;" />
+
+### 4.3 根据角色设置功能权限
+
+系统默认权限控制据用户所属的角色和角色所拥有的权限进行鉴权。因此，需要在不同的角色下设置不同的功能权限，并为用户赋予不同的角色，即可满足用户使用不同的功能权限。
+
+进入角色管理页面（相对路径为/permissionCenter/roleManagement）。
+
+<img src="../assets/gnqxkz_202406141052_14.png" style="border: 1px solid #ccc;" />
+
+#### 4.3.1 设置普通职员的功能权限
+
+1. 创建角色Staff，用于作为普通职员角色、控制普通职员的权限。
+
+   <img src="../assets/gnqxkz_202406141052_15.png" style="border: 1px solid #ccc;" />
+2. 选中角色Staff，选择“功能权限”标签页。进入标签页后新增功能权限“普通职员的权限“。
+
+   <img src="../assets/gnqxkz_202406141052_16.png" style="border: 1px solid #ccc;" />
+
+#### 4.3.2 设置上级领导的功能权限
+
+1. 创建角色Supervisor，用于作为上级领导角色、控制上级领导的权限。
+
+   <img src="../assets/gnqxkz_202406141052_17.png" style="border: 1px solid #ccc;" />
+2. 选中角色Supervisor，选择“功能权限”标签页。进入标签页后新增功能权限“上领领导的权限“。
+
+   <img src="../assets/gnqxkz_202406141052_18.png" style="border: 1px solid #ccc;" />
+
+### 4.4 为用户赋予角色
+
+1. 选中角色Staff，选择“人员管理”标签页，添加用户A、B。即A、B作为角色Staff下的用户，被赋予角色Staff设置的权限。
+
+   <img src="../assets/gnqxkz_202406141052_19.png" style="border: 1px solid #ccc;" />
+2. 选中角色Supervisor，选择“人员管理”标签页，添加用户C。即C作为角色Supervisor下的用户，被赋予角色Supervisor设置的权限。
+
+   <img src="../assets/gnqxkz_202406141052_20.png" style="border: 1px solid #ccc;" />
+
+## 5. 效果演示
+
+* 当用户A或B登录时，作为普通职员，支持创建和修改申请内容，无法填写申请结果。
+
+  <img src="../assets/gnqxkz_202406141052_21.gif" style="border: 1px solid #ccc;" />
+* 当用户C登录时，作为上级领导，支持修改申请结果，无法创建和修改申请内容。
+
+  <img src="../assets/gnqxkz_202406141052_22.gif" style="border: 1px solid #ccc;" />
+
+## 6. 补充说明
+
+* 一个功能权限可以关联多个资源，一个角色也可以关联多个功能权限。用户关联角色后，即可使用角色关联所有功能权限下的全量资源。
+* 在实际应用中，通常不仅限于限制功能的使用。为了保证数据的安全性，通常还需要限制用户对数据的访问范围，防止用户使用绕行方案篡改数据。具体实现方法请参考[如何实现数据权限控制](../022.权限场景/020.如何实现数据权限控制.md)。
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">有鲤</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2024年06月14日</span>
+</div>
+
+<style>
+  .yellowBlock {
+    border-left-width: 0.5rem;
+    border-left-style: solid;
+    padding: 0.1rem 1.5rem;
+    margin:1rem 0;
+    background-color: #fcf5e1;
+    border-color: #eaaa08;
+  }
+</style>

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/10./351/241/265/351/235/242/350/256/276/350/256/241/35./346/235/203/351/231/220/346/250/241/345/235/227/022./346/235/203/351/231/220/345/234/272/346/231/257/030./345/246/202/344/275/225/345/256/236/347/216/260/346/231/256/351/200/232/347/224/250/346/210/267/347/231/273/345/275/225.md

@@ -0,0 +1,83 @@
+# 如何实现普通用户登录
+
+## 1. 场景介绍
+
+应用默认引入了lcap-auth依赖库用于处理登录流程中的token颁发、认证和清除操作，同时应用默认内置login（登录页）能够直接在需要用户登录时被使用。本文将介绍如何使用应用默认功能在制品应用中实现使用账号密码登录用户。
+
+## 2. 操作步骤
+
+### 2.1 注册普通用户
+
+由于现有的lcap-auth依赖库已经默认实现了登录的认证逻辑，因此在注册普通用户时，只需要使用应用默认提供的实体LCAPUser存储创建的用户的用户名、登录密码即可使用账号。
+
+#### 2.1.1 开启系统默认权限模块配置
+
+应用默认提供的实体LCAPUser需要为应用开启权限配置后支持使用。
+
+1.  右键点击“PC“端，选择“权限模块配置”。
+
+    <img src="../assets/rhsxpt_202406241007_1.png" class="imgStyle" style="" />
+
+2.  开启包含“系统默认权限”的模板后，点击确定。
+
+    <img src="../assets/quanxian_202410231622_1.png" class="imgStyle" style="" />
+
+3.  系统默认权限模板默认提供userManagement（用户管理）页面，已经实现了通过实体LCAPUser创建用户名、登录密码等相关功能，可直接在制品应用中实现普通用户注册。
+
+    <img src="../assets/rhsxpt_202406241007_3.png" class="imgStyle" style="" />
+
+#### 2.1.2 创建实体LCAPUser数据
+
+1.  发布预览。进入用户管理页面（相对路径为/permissionCenter/userManagement）。
+
+    <div class="yellowBlock">
+
+    注意一：发布预览和正式发布在制品应用中创建的数据存储在不同的数据库中，不会共享。本文仅以开发环境发布预览的操作和数据作为使用说明。
+
+    注意二：由于权限中心相关页面默认开启权限控制，首次进入页面时可以登录制品应用的管理员账号，该账号默认拥有制品应用的所有权限。
+
+    </div>
+
+    <img src="../assets/rhsxpt_202406241007_4.png" class="imgStyle" style="" />
+
+1.  点击“创建普通用户”，在弹出窗口中填写用户信息。其中用户名、登录密码用于账号密码登录，必填。
+
+    <img src="../assets/rhsxpt_202406241007_5.png" class="imgStyle" style="" />
+
+### 2.2 登录普通用户
+
+1.  自行在IDE中设计登录页面的跳转方式。例如点击按钮跳转登录页。
+2.  发布预览。进入登录页（相对路径为/login）。
+3.  在登录页中输入用户名、登录密码，点击“登录”，即可实现普通用户登录。登录后页面自动跳转至应用首页。
+
+<img src="../assets/rhsxpt_202406241007_6.png" class="imgStyle" style="" />
+
+<img src="../assets/rhsxpt_202406241007_7.png" class="imgStyle" style="" />
+
+## 3. 补充说明
+
+- lcap-auth依赖库相关文档具体请参考[lcap\_auth依赖库使用说明](../../../../40.扩展与集成/20.集成开发方式/50.登录认证与权限集成/050.lcap_auth依赖库使用说明.md)。
+- 如果应用默认内置的登录方式无法满足需求，可以自定义具体业务场景。相关文档具体请参考[lcap\_auth复写案例](../../../../40.扩展与集成/20.集成开发方式/50.登录认证与权限集成/055.lcap_auth复写案例.md)。
+- 在导入权限模板时，如果选择的是“系统默认权限+认证模板”，则用户管理、角色管理等页面的路径会与只导入系统默认权限模板有所差异。
+  <img src="../assets/ruheshixianputongyonghudenglu_202410221817_2.png" class="imgStyle" style="width:400px;" />
+
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">有鲤</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2024年06月24日</span>
+</div>
+
+<style>
+
+  .yellowBlock {
+    border-left-width: 0.5rem;
+    border-left-style: solid;
+    padding: 0.1rem 1.5rem;
+    margin:1rem 0;
+    background-color: #fcf5e1;
+    border-color: #eaaa08;
+  }
+
+</style>

package/skills/smart-customer-service/docs/codewave/20./345/272/224/347/224/250/345/274/200/345/217/221/10./351/241/265/351/235/242/350/256/276/350/256/241/35./346/235/203/351/231/220/346/250/241/345/235/227/022./346/235/203/351/231/220/345/234/272/346/231/257/040./345/246/202/344/275/225/350/201/224/345/212/250/351/241/265/351/235/242/344/270/216/345/205/245/345/217/243/346/235/203/351/231/220.md

@@ -0,0 +1,83 @@
+# 如何联动页面与入口权限
+
+## 1. 场景介绍
+
+在权限配置中，组件与页面均支持开启功能权限。对于未被赋予组件功能权限的用户，相应组件将自动隐藏；而未获得页面功能权限的用户，则无法访问对应页面。
+
+而在实际应用场景中，处理页面功能权限时，既要关注页面本身的访问权限，也需兼顾页面入口的显示与隐藏。因此，当组件支持页面跳转（如导航项、菜单栏项等）时，与其跳转的页面的功能权限需要协同管控。
+
+> 本文默认用户了解功能权限模块的实现策略。若对此尚不熟悉，建议先阅读[功能权限入门](../007.功能权限入门.md)与[如何实现功能权限控制](025.如何实现功能权限控制.md)两篇文档。
+
+## 2. 前提条件
+
+1.  已有侧边栏项，例如”商品管理“。为其开启控制权限，示例中组件的资源路径为/dashboard/sidebar\_item2；为其设置页面跳转的链接地址，示例中侧边栏项用于跳转页面/dashboard/productManagement。
+
+    <img src="../assets/quanxian_202508261032_1.png" class="imgStyle" style="" />
+
+1.  已有页面，例如总览页dashboard下的页面productManagement，即点击侧边栏项后支持跳转的页面。为其开启控制权限，示例中页面的资源路径为/dashboard/productManagement。
+
+    <img src="../assets/quanxian_202508261032_2.png" class="imgStyle" style="" />
+
+1.  发布预览。注意，发布预览和正式发布在制品应用中创建的数据存储在不同的数据库中，不会共享。本文仅以开发环境发布预览的操作和数据作为使用说明。
+
+    <img src="../assets/quanxian_202508261032_3.png" class="imgStyle" style="" />
+
+## 3. 设计思路
+
+通常，一个应用会包含多个页面跳转入口及对应的目标页面。我们可以借助**应用发布或导出源码时**自动生成的**页面与入口映射关系文件**，快速定位支持页面跳转的组件及其跳转的目标页面，从而高效整理组件与页面的功能权限联动关系。
+
+发布预览后，页面及侧边栏项即自动生成以各自资源路径命名的资源。在同一个功能权限中关联这两个资源后，便能实现页面入口与页面本身的协同管控 —— 只需为用户配置这一项功能权限，即可同时限制页面入口的显隐状态和页面本身的访问权限。
+
+## 4. 操作步骤
+
+### 4.1 查看页面与入口映射关系
+
+1.  在更多 -> 系统偏好设置中开启权限映射生成。
+
+    <img src="../assets/quanxian_202508261032_4.png" class="imgStyle" style="" />
+
+1.  在更多 -> 导出和部署中导出应用，环境选择与发布环境一致，导出方式为源码，源码形式需要包含后端源码。
+
+    <img src="../assets/quanxian_202508261032_5.png" class="imgStyle" style="" />
+
+1.  解压导出的压缩包，找到页面与入口映射关系文件pagePermissionMapping.json，默认文件路径为src/main/resources/permission。文件结构中页面与入口的映射关系示例如下：
+
+    <img src="../assets/quanxian_202508261032_6.png" class="imgStyle" style="" />
+
+    ```json
+    {
+    "name": "/dashboard/sidebar_item2",
+    "description": "导航到商品管理页",
+    "router": "/dashboard/productManagement"
+    }
+    ```
+
+    - name：页面入口对应组件的资源路径。
+    - description：页面入口对应组件的资源描述。
+    - router：跳转目标页面的链接地址，等同于页面的资源路径。
+
+### 4.2 为功能权限关联联动资源
+
+1.  进入制品应用的权限管理页，默认相对路径为/permissionCenter/permissionManagement。
+
+    <img src="../assets/quanxian_202508261032_7.png" class="imgStyle" style="" />
+
+1.  新增功能权限，为功能权限添加联动资源。当资源较多时，建议直接搜索资源名称，即页面与入口映射关系结构中的name和router。例如创建“商品管理”功能权限，包含页面入口对应的资源/dashboard/sidebar\_item2和目标页面对应的资源/dashboard/productManagement。
+
+    <img src="../assets/quanxian_202508261032_8.png" class="imgStyle" style="" />
+
+## 5. 效果演示
+
+若用户 A 未被赋予上述“商品管理”功能权限，且排除其他涉及该资源的功能权限干扰，其操作权限效果如下：
+
+- 页面入口不可见。
+- 直接输入页面链接地址，跳转至无权限页面。
+
+<img src="../assets/quanxian_202508261032_9.png" class="imgStyle" style="" />
+
+<div style="text-align: right;font-size: 14px;">
+    <span style="color: rgb(78, 110, 142);">创建人：</span>
+    <span style="color: rgb(118, 118, 118);">有鲤</span>
+    <span style="color: rgb(78, 110, 142);margin: 0 0 0 40px;">更新时间：</span>
+    <span style="color: rgb(118, 118, 118);">2025年08月26日</span>
+</div>