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/010./347/263/273/347/273/237/351/273/230/350/256/244/346/235/203/351/231/220/346/250/241/345/235/227.md

@@ -0,0 +1,824 @@
+# 系统默认权限模块
+
+应用开启权限控制时，若选择包含“系统默认权限”的模板，应用会自动引入实体、逻辑、依赖库用作权限配置、并且应用已经搭建了页面用于在制品应用中对权限进行管理，引入后即支持直接使用、同时也支持二次修改。
+
+<img src="../assets/quanxianyurenzhengmubanpeizhi_20240821_2.png" alt="0" style="width:500px;border: 1px solid #ccc;" />
+
+## 1. 系统默认权限配置
+
+### 1.1 配置实体
+
+系统默认配置实体如下：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_2.png" style="border: 1px solid #ccc;width: 450px;" />
+
+* LCAPRole：角色实体。默认包含唯一标识、角色名称、角色描述、角色状态、是否可编辑属性。
+* LCAPUser：制品应用的用户实体。默认包含用户id、用户名、登陆密码、手机号、邮箱、昵称、状态、用户来源、上级领导属性。
+* LCAPUserRoleMapping：用户与角色的关联实体。默认包含用户唯一ID、角色唯一ID属性分别用于关联用户实体和角色实体，每为用户分配一个角色则需要创建一条实体实例，即用于在数据库中建立用户和角色的中间关系表。
+* LCAPPermission：功能权限实体。默认包含唯一标识、权限名称、权限描述属性。
+* LCAPResource：资源实体。资源数据由开发者在IDE中为组件、页面开启权限控制后由系统自动上报，默认包含唯一标识、资源名称、资源描述、资源类型、端标识属性。
+* LCAPPerResMapping：功能权限与资源的关联实体。默认包含权限唯一ID、资源唯一ID属性分别用于关联功能权限实体和资源实体，每为权限分配一个资源则需要创建一条实体实例，即用于在数据库中建立权限和资源的中间关系表。
+* LCAPRolePerMapping：角色与功能权限的关联实体。默认包含角色唯一ID、权限唯一ID属性分别用于关联角色实体和权限实体，每为角色分配一个权限则需要创建一条实体实例，即用于在数据库中建立角色和权限的中间关系表。
+* LCAPDepartment：部门实体。默认包含部门名称、部门唯一标识、上级部门标识属性。
+* LCAPUserDeptMapping：用户与部门关联实体。默认包含用户唯一ID、部门唯一标识属性分别用于关联用户实体和部门实体，每为用户添加一个部门则需要创建一条实体实例，即用于在数据库中建立用户和部门的中间关系表；同时包含属性用户判断当前关联用户是否为部门主管。
+* LCAPEntityMeta：实体元信息实体。实体元信息由开发者在IDE中为实体开启数据权限后又系统自动上报，默认包含实体名、实体表名、实体描述、属性列表属性。
+* LCAPLogicMeta：逻辑元信息实体。逻辑元信息由开发者在IDE中为服务端逻辑开启数据权限后又系统自动上报，默认包含逻辑名、逻辑返回值形式、属性列表、逻辑描述属性。
+* LCAPDataPermission：数据权限实体。默认包含所属实体名或逻辑名、所属资源类型、行权限类型、行权限自定义规则间的逻辑关系、所属角色ID属性，其中所属实体名或逻辑名属性对应元信息实体、所属角色ID属性用于关联角色实体。每个角色均可以设置所有数据权限，即每个角色下的一个实体 / 逻辑元信息即对应一条实体数据。
+* LCAPRowRuleItem：行权限自定义规则实体。当行权限范围自定义时的规则，默认包含所属数据权限ID属性用于关联数据权限实体。
+* LCAPColumnRule：数据列权限实体。由于列权限和行权限的不同点在于，数据的行权限唯一、而每一个数据列的权限均可以单独设置权限，因此行权限可以直接在数据权限实体中定义，列权限则单独使用实体定义，每个数据权限的一个属性对应一条实体数据。默认包含所属数据权限唯一ID、实体的属性名、列权限规则属性，其中所属数据权限ID属性用于关联数据权限实体。
+
+> 以上实体的实体名称及默认属性均不允许修改，但支持为实体新增自定义属性。
+
+实体之间的关系说明如下：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_3.png" style="border: 1px solid #ccc;" />
+
+**用户与角色**
+
+* 用户和角色的关系：一个用户可以被分配到一个或多个角色，一个角色可以被分配给一个或多个用户。通过将用户赋予角色，可以简化权限管理，使得用户可以继承角色所拥有的权限。
+
+**角色与权限**
+
+* 角色和功能权限的关系：一个角色可以拥有一个或多个功能权限，一个权限可以被分配给一个或多个角色。通过将权限赋予角色，可以定义角色所能进行的操作或访问权限中的资源。
+* 角色和数据权限的关系：一个角色可以包含所有的数据权限。通过对数据权限的细粒度控制，可以定义角色所能进行的操作或访问的数据的范围。
+
+**功能权限**
+
+* 资源和功能权限的关系：一个资源可以被分配给一个或多个功能权限，一个功能权限可以包含一个或多个资源。这些权限定义了对资源的操作或访问权限。通过将资源赋予权限，可以限制用户或角色对资源的访问和操作，即限制使用功能。
+
+**数据权限**
+
+* 列权限和数据权限的关系：一个数据权限指定一个元信息，一个元信息包含多个属性，每个属性指定一个列权限。通过指定元信息的列权限，可以实现数据列级别的细粒度控制。
+* 行权限自定义规则和数据权限的关系：一个数据权限指定一个元信息，一个元信息包含一个行权限。当行权限选择自定义时，一个行权限可以包含一个或多个自定义规则。通过指定元信息的行权限，可以实现数据行级别的细粒度控制。
+
+**用户与部门**
+
+* 用户和部门的关系：一个用户可以隶属一个或多个部门，一个部门可以包含一个或多个用户。通过为用户分配部门，可以帮助实现行权限针对于“仅本人”、“本人及下属”、“本部门及下属部门”等细粒度控制。
+
+**实体关联属性说明如下**：
+
+以上关联实体通过主键（id）或唯一标识实现关联关系，且**关联属性实体记录删除规则**均为允许删除且同时删除本实体记录。
+
+<details>
+      <summary title="点击展开示例说明" style="font-weight: bold; color: #679CF8; cursor: pointer;">
+          点击展开示例说明
+          </summary>
+
+* 假设已有角色、功能权限、资源信息如下
+
+  > 已省略描述部分由应用自动生成的属性
+
+  * 角色实体（LCAPRole）下的角色DEV-NormalRole
+
+    ```
+    "lCAPRole": {
+        "id": 2830063725361920,
+        "name": "DEV-NormalRole",
+    }
+    ```
+
+  * 功能权限实体（LCAPPermission）下的权限DEV-NormalRole
+
+    ```
+    "lACPPermission": {
+        "id": 2830063725492992,
+        "name": "DEV-NormalRole",
+        "description": null
+    }
+    ```
+  * 资源实体（LCAPResource）下的资源/dashboard
+
+    ```
+    "lACPResource": {
+        "id": 2829934556306176,
+        "name": "/dashboard",
+        "description": "总览页",nt_type: pc
+    }
+    ```
+* 当为权限DEV-NormalRole添加资源/dashboard，应构建权限与资源的关联实体（LCAPPerResMapping）数据如
+
+    ```
+    "lCAPPerResMapping": {
+        "permission_id": 2830063725492992,
+        "resource_id": 2829934556306176
+    }
+    ```
+* 当为角色DEV-NormalRole赋予权限DEV-NormalRole，应构建角色与权限的关联实体（LCAPRolePerMapping）数据如
+
+    ```
+
+    "lCAPRolePerMapping": 
+        "role_id": 2830063725361920
+        "permission_id": 2830063725492992,
+    }
+    ```
+
+* 若删除权限实体（LCAPPermission）下的权限DEV-NormalRole，应用自动删除上述关联实体（LCAPPerResMapping和LCAPRolePerMapping）数据，即删除角色和该权限的关联关系、该权限与资源的关联关系。
+
+</details>
+
+### 1.2 配置依赖库
+
+系统默认配置权限相关依赖库如下：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_4.png" style="border: 1px solid #ccc;" />
+
+* lcap_auth：用于处理登陆流程中的token颁发、认证和清除操作。相关文档请参考：[lcap_auth依赖库使用说明](../../../40.扩展与集成/20.集成开发方式/50.登录认证与权限集成/050.lcap_auth依赖库使用说明.md)。
+* lcap_permission：用于完成功能权限管理的资源上报、鉴权和获取资源列表。相关文档请参考：[lcap_permission依赖库使用说明](../../../40.扩展与集成/20.集成开发方式/50.登录认证与权限集成/060.lcap_permission依赖库使用说明.md)。
+* lcap_user：用于获取用户与部门间、部门与上下级部门间的组织架构关系。
+* lcap_annotation_data_permission：用于完成数据权限管理的资源上报、鉴权和获取权限列表功能。相关文档请参考：[lcap_annotation_data_permission依赖库使用说明](028.lcap_annotation_data_permission依赖库使用说明.md)。
+* lcap-fe-annotation-data-permission：用于完成数据权限管理的运行时组件显隐控制。
+
+依赖库lcap_annotation_data_permission中包含自定义参数，开发者可前往“更多”->"应用配置"中的自定义参数配置，根据实际需求调整参数值。
+
+<img src="../assets/xtylk_0530_1659_1.png" style="border: 1px solid #ccc;" />
+
+* dataPermissionCacheExpireSeconds：数据权限规则的缓存过期时间。默认60s，即新设置的规则在缓存后生效，非实时处理时不影响应用性能。
+* dataPermissionCacheMaximumSize：数据权限规则的缓存空间大小。默认60M。
+* skipLCAPEntity：数据权限是否不对系统实体进行控制。默认为true，即不控制。
+
+### 1.3 配置逻辑
+
+系统默认配置服务端逻辑如下：
+
+> 以下逻辑均支持修改，或由开发者重新设计新的逻辑。
+
+|            服务端逻辑名称             |                     作用                     |                                           在页面中引用                                           |
+| :-----------------------------------: | :------------------------------------------: | :----------------------------------------------------------------------------------------------: |
+|        LCAPIsRoleNameRepeated         |            判断角色名称是否已存在            |                   在角色管理页面中，在创建角色信息时要求角色名不存在时支持创建                   |
+|       LCAPGetPermissionByRoleId       |      根据角色ID查询相关联的功能权限信息      |                在角色管理页面中，作为当前角色展示在关联功能权限表格中的数据的来源                |
+|   LCAPLoadUserRoleMappingTableView    |      为角色添加成员页面的数据列表数据源      |                  在角色管理页面中，作为当前角色展示在关联用户表格中的数据的来源                  |
+|    LCAPLoadRoleManagementTableView    |         角色管理页面的数据表格数据源         |                        在角色管理页面中，作为展示在角色表格中的数据的来源                        |
+|         LCAPGetUserTableView          |          用户管理页面数据表格数据源          |                        在用户管理页面中，作为展示在用户表格中的数据的来源                        |
+|            LCAPGetAllUsers            |              获取所有的用户信息              |                         在用户管理页面中，经过二次处理并获取全部用户名称                         |
+|          LCAPGetUserByUserId          |            根据UserId查询User信息            |                         在角色管理页面中，在为角色添加用户时获取用户信息                         |
+|       loadAddRoleUserTableView        |          查询除UserIdList以外的用户          |                      在角色管理页面中，作为角色添加成员的选择器的数据的来源                      |
+|    LCAPLoadPerManagementTableView     |               查询功能权限列表               |                    在功能权限管理页面中，作为展示在功能权限表格中的数据的来源                    |
+|       LCAPGetLAllACPPermission        |            获取所有的功能权限数据            |                     在功能权限管理页面中，经过二次处理并获取全部功能权限名称                     |
+|  LCAPLoadAddRolePermissionTableView   |     查询除permissionIdList以外的功能权限     |                    在角色管理页面中，作为角色添加功能权限的表格中的数据的来源                    |
+| LCAPGetMappingByRoleIdAndPermissionId |    根据角色ID和权限ID查询角色权限关联数据    |                   在角色管理页面中，在为角色移除权限时查询两者的关联数据并删除                   |
+|        LCAPIsUserNameRepeated         |            判断用户名称是否已存在            |                   在用户管理页面中，在创建用户信息时要求用户名不存在时支持创建                   |
+|   LCAPGetPermissionResourceRelated    |            获取功能权限关联的资源            |          在功能权限管理页面中，在修改功能权限前先执行查询与权限关联的资源作为已添加资源          |
+|  LCAPGetPermissionResourseNotRelated  |           获取功能权限未关联的资源           |      在功能权限管理页面中，在新增/修改功能权限前先执行查询与权限未关联的资源作为可添加资源       |
+|  LCAPGetPerResMappingByPermissionId   |          根据权限ID查询已添加的资源          |               在功能权限管理页面中，在修改权限时先执行查询该权限下的所有资源并删除               |
+|         LCAPCreateNormalUser          |                 创建普通用户                 |                                     在用户管理页面中创建用户                                     |
+|         LCAPUpdateNormalUser          |               修改普通用户信息               |                         在用户管理页面中，判断是否修改密码后修改用户信息                         |
+|         LCAPCreateDepartment          |                   创建部门                   |                                     在部门管理页面中创建部门                                     |
+|         LCAPUpdateDepartment          |                   编辑部门                   |                                   在部门管理页面中修改部门信息                                   |
+|       LCAPBatchDeleteDepartment       |                 批量删除部门                 |                                     在部门管理页面中删除部门                                     |
+|           LCAPSetDeptLeader           |                 设置部门主管                 |                                   在部门管理页面中设置部门主管                                   |
+|          LCAPCanceDeptLeader          |                 取消部门主管                 |                                   在部门管理页面中取消部门主管                                   |
+|         LCAPBatchAddDeptUser          |              批量从部门添加成员              |                                     在部门管理页面中添加用户                                     |
+|        LCAPBatchUpdateDeptUser        |              批量从部门调整成员              |                           在部门管理页面中批量管理时调整选中用户的部门                           |
+|        LCAPBatchRemoveDeptUser        |              批量从部门移除成员              |                           在部门管理页面中批量管理时移除选中成员的部门                           |
+|             LCAPGetDepts              |            递归获取所有子部门列表            |                                                /                                                 |
+|              LCAPGetDept              |                 获取部门详情                 |                  在部门管理页面中，点击部门数据列表时作为列表项获取到的详情信息                  |
+|            LCAPSearchDepts            |                 部门名称搜索                 |                        在部门管理页面中，作为展示在部门列表中的数据的来源                        |
+|           LCAPGetDeptUsers            |              获取当前部门下成员              |                        在部门管理页面中，作为展示在成员表格中的数据的来源                        |
+|            LCAPGetDeptList            |               获取所有部门列表               |     在部门管理页面中，作为调整用户部门时可选部门的数据的来源和展示部门的树形视图的数据的来源     |
+|        LCAPJudgeDeptIdRepeated        |             判断部门标识是否存在             |                  在部门管理页面中，在创建部门信息时要求部门标识不存在时支持创建                  |
+|      LCAPLoadDeptSetLeaderSelect      |          设置部门主管下拉选择器数据          |                  在部门管理页面中，作为部门设置主管的选择器的可选用户数据的来源                  |
+|       LCAPLoadDeptAddUserSelect       |   添加成员数据为不在本部门的成员选择器数据   | 在部门管理页面中，在为部门添加用户前先执行查询非本部门用户作为可添加成员并作为选择器的数据的来源 |
+|     LCAPLoadUserManagementSelect      |          用户管理直属领导选择器数据          |                 在用户管理页面中，创建用户时作为可选直属主管的选择器的数据的来源                 |
+|          LCAPSearchDeptUsers          |                 部门成员搜索                 |                        在部门管理页面中，作为展示在成员列表中的数据的来源                        |
+|           LCAPGetChildDepts           |             获取下一级子部门列表             |                           在部门管理页面中，在删除部门时要求无下级部门                           |
+|        LCAPGetSecondParentDept        |        递归获取旧部门开始的第二级部门        |                                                /                                                 |
+|     LCAPJudgeDelEntityOrLogicMeta     | 根据开启权限的实体或逻辑判断是否删除本地数据 |                                                /                                                 |
+|       LCAPDeleteDataPermission        |                 清空数据权限                 |                                                /                                                 |
+|    LCAPJudgeSaveEntityOrLogicMeta     | 根据开启权限的实体或逻辑判断是否保存本地数据 |                                                /                                                 |
+|     LCAPNoneEntityDataPermission      |           实体数据无权限处理返回值           |                                                /                                                 |
+|      LCAPNoneLogicDataPermission      |           逻辑数据无权限处理返回值           |                                                /                                                 |
+|      LCAPLoadDataMetaManagement       |        获取开启了数据权限的实体或逻辑        |                在角色管理页面中，作为当前角色展示在关联数据权限表格中的数据的来源                |
+|  LCAPGetDataPermissionByResourceName  |    根据资源名&资源类型&角色ID获取数据权限    |                在角色管理页面中，点击数据权限表格时作为获取到的数据权限的详情信息                |
+|  LCAPGetColumnRuleByDataPermissionId  |           根据数据权限ID获取列规则           |                  在角色管理页面中，作为当前选中数据权限下列权限表格的数据的来源                  |
+|        LCAPGetUserNameByUserId        |             根据用户ID查询用户名             |                                                /                                                 |
+|   LCAPGetRowRuleByDataPermissionId    |           根据数据权限ID获取行规则           |               在角色管理页面中，作为当前选中数据权限下自定义行规则列表的数据的来源               |
+|           LCAPReportEntity            |       获取开启数据权限的实体并保存本地       |                                                /                                                 |
+|      LCAPGetUnderlingByUserName       |      根据用户ID获取所有本人及下属用户名      |                                                /                                                 |
+|   LCAPGetDeptAndUnderlingByUserName   |   根据用户ID获取所有本部门及下级部门用户名   |                                                /                                                 |
+|         LCAPGetEntityMetaById         |             根据ID获取实体元信息             |               在角色管理页面中，点击数据权限表格时作为获取到的实体元信息的详情信息               |
+|         LCAPGetLogicMetaById          |             根据ID获取逻辑元信息             |               在角色管理页面中，点击数据权限表格时作为获取到的逻辑元信息的详情信息               |
+|       LCAPCreateDataPermission        |                 创建数据权限                 |               在角色管理页面中，在创建角色时即为角色与所有元信息构建对应的数据权限               |
+|         LCAPCreateColumnRule          |                  创建列权限                  |       在角色管理页面中，在创建角色时，完成数据权限构建后，即为角色下所有数据权限构建列权限       |
+|        LCAPGetEntityMetaByName        |            根据名称获取实体元信息            |                                                /                                                 |
+|        LCAPGetLogicMetaByName         |            根据名称获取逻辑元信息            |                                                /                                                 |
+
+> 注：服务端逻辑的作用可在描述中查询，或前往 [权限相关服务端逻辑](../../../20.应用开发/10.页面设计/35.权限模块/012.权限模块服务端逻辑.md) 了解详细介绍。
+> 
+> <img src="../assets/xitongmorenquanxianmokuai_0522_5.png" style="border: 1px solid #ccc;width:400px;" />
+
+### 1.4 配置页面
+
+系统默认配置页面如下：
+
+以下页面均支持修改，或由开发者重新设计新的页面。
+
+<img src="../assets/xitongmorenquanxianmokuai_202409021134_1.png" class="imgStyle" style="width:400px;" />
+
+<table>
+    <tr>
+        <th>父页面</th>
+        <th>子页面</th>
+        <th>子页面</th>
+    </tr>
+    <tr>
+        <td rowspan="4">permission_center（权限中心）</td>
+        <td>departmentManagement（部门管理）</td>
+        <td>实现部门管理，包括创建、删除、修改、查询<br>为部门添加用户<br>为用户设置部门主管</td>
+    </tr>
+    <tr>
+        <td>roleManagement（角色管理）</td>
+        <td>实现角色管理，包括创建、删除、修改<br>为角色添加用户<br>为角色添加功能权限<br>管理角色的数据权限，包括行权限和列权限</td>
+    </tr>
+    <tr>
+        <td>userManagement（用户管理）</td>
+        <td>实现用户管理，包括创建、删除、修改、查询</td>
+    </tr>
+    <tr>
+        <td>permissionManagement（功能权限管理）</td>
+        <td>实现权限管理，包括创建、删除、修改、查询<br>为功能权限添加资源</td>
+    </tr>
+    <tr>
+        <td rowspan="1">login（登陆页）</td>
+        <td colspan="2">实现用户管理页面创建的用户的登录</td>
+    </tr>
+</table>
+
+> 权限中心页面默认开启权限配置并生成页面对应的资源。
+
+## 2. 系统默认权限控制
+
+开发者在开发过程中，可以直接在IDE中实现**资源**、**元信息**的管理。
+
+### 2.1 创建资源
+
+可将页面和组件作为资源。应用发布后，支持由系统自动上报实体信息。具体参考如下：
+
+选中需要控制权限的页面或组件，开启“权限控制”。例如为页面dashboard（总览页）开启权限控制，此时应用会自动生成资源名称为/dashboard的资源，开发者可以自定义资源描述。
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_7.png" style="border: 1px solid #ccc;" />
+
+**应用发布后**效果参考：
+
+* 资源实体（LCAPResource）下包含如下数据，除资源描述外均由应用自动识别生成。
+
+  <img src="../assets/xitongmorenquanxianmokuai_0522_8.png" style="border: 1px solid #ccc;" />
+
+后续将资源加入功能权限、将功能权限赋予角色、将角色赋予用户，即可使用户使用功能权限中的资源。
+
+### 2.2 管理资源
+
+创建资源时直接在IDE中管理角色，并将同一角色可支配的所有资源作为该角色拥有的一个功能权限。应用发布后，支持由系统自动上报实体信息及关联信息。具体参考如下：
+
+**创建角色**
+
+1. 开启组件/页面权限控制后，支持在IDE中直接管理角色。直接在IDE中管理的角色称为编辑态角色。
+
+    <img src="../assets/xitongmorenquanxianmokuai_0522_9.png" style="border: 1px solid #ccc;" />
+2. 点击“创建角色”后可以自定义角色的名称，例如DEV-NormalRole。创建后支持修改或删除。
+
+    <img src="../assets/xitongmorenquanxianmokuai_0522_10.png" style="border: 1px solid #ccc;" />
+
+**应用发布后**效果参考：
+
+* 角色实体（LCAPRole）下包含如下数据，除用户名称外均由应用自动识别生成。
+
+  <img src="../assets/xitongmorenquanxianmokuai_0522_11.png" style="border: 1px solid #ccc;" />
+
+* 功能权限实体（LCAPPermission）下包含与角色同名的功能权限，属性均由应用自动识别生成。直接在IDE中由角色衍生的权限称为编辑态功能权限。
+
+  <img src="../assets/xitongmorenquanxianmokuai_0522_12.png" style="border: 1px solid #ccc;" />
+
+* 角色与功能权限的关联实体（LCAPRolePerMapping）下包含角色唯一ID、权限唯一ID，即生成角色DEV-NormalRole和权限DEV-NormalRole的关联关系。
+
+  <img src="../assets/xitongmorenquanxianmokuai_0522_13.png" style="border: 1px solid #ccc;" />
+
+**授权角色**
+
+开启权限控制后，支持在IDE中直接为**编辑态角色**授权。
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_14.png" style="border: 1px solid #ccc;" />
+
+**应用发布后**效果参考：
+
+* 权限与资源的关联实体（CAPPerResMapping）下包含权限唯一ID、资源唯一ID，例如生成权限DEV-NormalRole和资源/dashboard的关联关系，即实现为角色DEV-NormalRole授予权限DEV-NormalRole下的资源/dashboard。
+
+  <img src="../assets/xitongmorenquanxianmokuai_0522_15.png" style="border: 1px solid #ccc;" />
+
+创建用户后为用户赋予编辑态角色即可使用户使用相关功能权限下的资源。
+
+### 2.3 创建元信息
+
+可分别管理实体元信息和服务端逻辑元信息。应用发布后，支持由系统自动上报实体信息。具体参考如下：
+
+**创建实体元信息**
+
+选中需要控制权限的实体，开启“是否开启数据权限”。例如为实体Demo开启权限控制，此时应用会自动生成实体名为defaultDS.Demo的实体元信息。
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_16.png" style="border: 1px solid #ccc;" />
+
+**应用发布后**效果参考：
+
+* 实体元信息实体（LCAPEntityMeta）下包含如下数据，属性由应用自动识别生成。
+
+  <img src="../assets/xitongmorenquanxianmokuai_0522_17.jpeg" style="border: 1px solid #ccc;" />
+
+**创建逻辑元信息**
+
+选中需要控制权限的服务端逻辑，开启“是否开启数据权限”。例如为服务端逻辑loadDemo开启权限控制，此时应用会自动生成逻辑名为loadDemo的逻辑元信息。
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_18.jpg" style="border: 1px solid #ccc;" />
+
+**应用发布后**效果参考：
+
+* 逻辑元信息实体（LCAPLogicMeta）下包含如下数据，属性由应用自动识别生成。
+
+  <img src="../assets/xitongmorenquanxianmokuai_0522_19.png" style="border: 1px solid #ccc;" />
+
+> 后续在创建角色的同时为该角色创建所有元信息的数据权限、为该角色的所有数据权限创建列权限、将角色赋予用户，即可使用户访问该角色权限范围内的数据。
+>
+> 若在元信息开启权限之前已经存在角色，应用也会通过数据权限实体（LCAPDataPermission）和数据列权限实体（LCAPColumnRule）自动生成角色对应所有元信息的数据权限和列权限。
+
+## 3. 系统默认权限功能页面
+
+开发者可以自定义页面，实现制品用户对用户、权限、角色的管理。系统默认配置页面即可实现效果，若符合需求可直接使用，以下为页面功能实现原理说明：
+
+### 3.1 用户管理
+
+> 应用默认提供userManagement页面实现用户管理。
+
+由于系统默认权限模块由用户、角色、权限组成，且用户作为权限的实际操控者，因此系统默认提供页面用于管理用户，包括但不限于支持新增用户、修改用户和删除用户。
+
+**“新增用户”功能原理说明**
+
+通过新增用户实体（LCAPUser）实体实例即可实现新增用户。
+
+设计思路：
+
+1. 已有表单支持自定义用户名、登陆密码、手机号、邮箱、昵称；
+2. 对用户数据进行处理，例如用户名必填且不可重复，登陆密码必填且长度必须在8-12位之间，新增用户时用户的密码使用Bcrypt算法进行加密；
+3. 调用用户实体（LCAPUser）的create逻辑，将数据存储为实体实例，即创建为用户。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_20.gif" style="border: 1px solid #ccc;" />
+
+通过新增用户实体（LCAPUser）实体实例创建的用户，即作为制品的可登陆用户，前端的公共变量和服务端的服务端全局变量中均可获取当前登陆的用户信息。
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_21.png" style="border: 1px solid #ccc;width: 450px;" />
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_22.png" style="border: 1px solid #ccc;width: 450px;" />
+
+**“修改用户”功能原理说明**
+
+通过更新用户实体（LCAPUser）实体实例即可实现修改用户。
+
+设计思路：
+
+1. 获取用户实体（LCAPUser）中存储的用户实体实例，例如点击“修改”链接时获取当前用户的数据并展示在表单中。
+2. 对表单进行处理，例如表单对应的用户名不可修改。
+3. 判断是否修改密码，若修改密码则需要重新为密码加密。
+4. 调用用户实体（LCAPUser）的update逻辑，更改实体实例中的数据，即更新用户信息。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_23.gif" style="border: 1px solid #ccc;" />
+
+**“删除用户”功能原理说明**
+
+通过删除用户实体（LCAPUser）实体实例即可实现删除用户。
+
+设计思路：
+
+1. 获取用户实体（LCAPUser）中存储的用户实体实例，其用户主键（id）备用于删除实体实例。
+2. 以防误删，在删除前进行二次确认，例如点击“删除”链接时在弹窗中提示是否确认删除用户。
+3. 确认删除后，调用用户实体（LCAPUser）的delete逻辑，删除实体实例，即该用户被注销。
+
+注意：由于用户实体实例被删除，且实体的**关联属性实体记录删除规则**为允许删除且同时删除本实体记录，应用支持自动删除用户与角色的关联实体（LCAPUserRoleMapping）中所有与该用户关联的实体实例。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_24.gif" style="border: 1px solid #ccc;" />
+
+### 3.2 部门管理
+
+> 应用默认提供departmentManagement页面实现部门管理。
+
+由于系统默认权限模块包含数据权限，且数据权限支持依托于部门设置行权限范围，因此系统默认提供页面用于管理部门，包括但不限于支持新增部门、为部门添加用户、为用户调整部门、设置 / 取消部门主管、删除部门。
+
+**“新增部门”功能原理说明**
+
+通过新增部门实体（LCAPDepartment）实体实例即可实现新增部门。
+
+设计思路：
+
+1. 已有表单支持自定义部门名称、部门标识、上级部门标识；
+2. 对部门数据进行处理，例如部门标识必填且不能重复；
+3. 调用部门实体（LCAPDepartment）的create逻辑，将数据存储为实体实例，即创建为部门。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_25.gif" style="border: 1px solid #ccc;" />
+
+**“为部门添加用户”功能原理说明**
+
+通过新增用户与部门关联实体（LCAPUserDeptMapping）实体实例即可实现为部门添加用户。
+
+设计思路：
+
+1. 在部门列表中选择部门时获取当前部门的部门信息，其部门标识（deptId）备用于查询和建立与用户的关联。
+2. 查询用户与部门关联实体（LCAPUserDeptMapping）中所有部门标识属性与当前部门的标识（deptId）相同的实体实例，并根据其用户ID属性查询用户实体（LCAPUser）数据，即部门已添加的用户；新增用户时，将用户实体（LCAPPermission）中不包含在部门已添加用户内的数据作为可关联用户。
+3. 确认添加后，调用角色与权限的关联实体（LCAPRolePerMapping）的deleteBy逻辑，删除用户与部门关联实体（LCAPUserDeptMapping）中用户ID（userId）属性与已选用户的用户id（userId）相同的数据。即删除用户已经关联的部门，保证新添加的部门为用户唯一的部门。
+4. 调用用户与部门关联实体（LCAPUserDeptMapping）的batchCreate逻辑，将部门标识（deptId）和每一个已选用户的用户id（deptId）依次存储为关联实体实例中的部门标识和用户ID，即为部门添加用户。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_26.gif" style="border: 1px solid #ccc;" />
+
+**“为用户调整部门”功能原理说明**
+
+通过更新用户与部门关联实体（LCAPUserDeptMapping）实体实例中的“部门标识”属性即可实现为用户调整部门。
+
+设计思路：
+
+1. 在部门列表中选择部门时获取当前部门的部门信息，其部门标识（deptId）备用于查询与用户的关联。
+2. 查询用户与部门关联实体（LCAPUserDeptMapping）中所有部门标识属性与当前部门的标识（deptId）相同的实体实例，并根据其用户ID属性查询用户实体（LCAPUser）数据，即部门已添加的用户。
+3. 已有表单支持自定义需要调整的部门的部门标识；
+4. 确认调整后，调用用户与部门关联实体（LCAPUserDeptMapping）的batchUpdate逻辑，将已选角色在实体中关联的部门标识（deptId）批量更新为表单中选择的部门标识。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_27.gif" style="border: 1px solid #ccc;" />
+
+**“设置 / 取消部门主管”功能原理说明**
+
+通过更新用户与部门关联实体（LCAPUserDeptMapping）实体实例中的“是否是部门主管”属性即可实现为用户设置 / 取消部门主管。
+
+设计思路：
+
+1. 在部门列表中选择部门时获取当前部门的部门信息，其部门标识（deptId）备用于查询与用户的关联。
+2. 查询用户与部门关联实体（LCAPUserDeptMapping）中所有部门标识属性与当前部门的标识（deptId）相同的实体实例，并根据其用户ID属性查询用户实体（LCAPUser）数据，即部门已添加的用户。
+3. 确认操作后，调用用户与部门关联实体（LCAPUserDeptMapping）的update逻辑。若为设置主管，将“是否是部门主管”属性设为1；若为取消主管，将“是否是部门主管”属性设为0。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_28.gif" style="border: 1px solid #ccc;" />
+
+**“删除部门”功能原理说明**
+
+通过删除部门实体（LCAPDepartment）实体实例即可实现删除部门。
+
+设计思路：
+
+1. 获取部门实体（LCAPDepartment）中存储的部门实体实例，其部门主键（id）备用于删除实体实例。
+2. 以防误删，在删除前进行二次确认，例如点击“删除”链接时在弹窗中提示是否确认删除部门。
+3. 确认删除后，判断部门是否拥有子部门、部门下是否有用户，若均无，调用部门实体（LCAPDepartment）的delete逻辑，删除实体实例，即该部门被删除。
+
+注意：由于部门实体实例被删除，且实体的**关联属性实体记录删除规则**为允许删除且同时删除本实体记录，应用支持自动删除用户与部门的关联实体（LCAPUserDeptMapping）中所有与该部门关联的实体实例。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_29.gif" style="border: 1px solid #ccc;" />
+
+### 3.3 功能权限管理
+
+> 应用默认提供permissionManagement页面实现功能权限管理。在页面中管理的权限称为运行态权限。
+
+由于系统默认权限模块由用户、角色、权限、资源组成，且权限作为资源的拥有者，使拥有权限的用户能够操控权限包含的资源，因此系统默认提供页面用于管理权限，包括但不限于支持新增权限、修改权限、删除权限和关联资源。
+
+**“新增功能权限”功能原理说明**
+
+通过新增权限实体（LCAPPermission）实体实例即可实现新增权限。
+
+通过新增权限与资源的关联实体（LCAPPerResMapping）实体实例即可实现为权限添加资源。
+
+设计思路：
+
+1. 已有表单支持自定义权限名称、权限描述；
+2. 对权限数据进行处理，例如权限名称必填且不能重复；
+3. 获取所有可选择的资源实体（LCAPResource）数据作为未选资源，备用于选择后作为已选资源并建立与权限的关联，选择的资源的主键（id）即作为权限与资源的关联实体（LCAPPerResMapping）中的资源唯一ID。
+4. 调用权限实体（LCAPPermission）的create逻辑，将数据存储为实体实例，即创建为权限。
+5. 获取刚创建的权限实体实例，其权限主键（id）备用于建立与资源的关联，即作为权限与资源的关联实体（LCAPPerResMapping）中的权限唯一ID。
+6. 调用权限与资源的关联实体（LCAPPerResMapping）的batchCreate逻辑，将权限的主键（id）和每一个已选资源的主键（id）依次存储为关联实体实例中的权限唯一ID和资源唯一ID，即为权限添加资源。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_30.gif" style="border: 1px solid #ccc;" />
+
+**“修改功能权限”功能原理说明**
+
+通过更新权限实体（LCAPPermission）实体实例即可实现修改权限。
+
+通过删除所有与当前权限关联的权限与资源的关联实体（LCAPPerResMapping）实体实例并重新新增实体实例即可实现修改权限中的资源。
+
+设计思路：
+
+1. 获取权限实体（LCAPPermission）中存储的权限实体实例，例如点击“修改”链接时获取当前权限的数据并展示在表单中。
+2. 查询权限与资源的关联实体（LCAPPerResMapping）中所有权限唯一ID属性与当前权限的主键（id）相同的实体实例作为修改权限时待删除数据，并根据其资源唯一ID属性查询资源实体（LCAPResource）数据作为已选资源；
+3. 查询资源实体（LCAPResource）中不包含在已选资源内的数据作为未选资源。
+4. 调用权限实体（LCAPPermission）的update逻辑，更新实体实例中的数据，即更新权限信息。
+5. 调用权限与资源的关联实体（LCAPPerResMapping）的batchDelete逻辑，删除权限与资源的关联实体（LCAPPerResMapping）中所有与当前权限关联的数据，即删除当前权限下所有资源；再调用batchCreate逻辑，将权限的主键（id）和每一个已选资源的主键（id）依次存储为关联实体实例中的权限唯一ID和资源唯一ID，即重新为权限添加资源。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_31.gif" style="border: 1px solid #ccc;" />
+
+**“删除功能权限”功能原理说明**
+
+通过删除权限实体（LCAPPermission）实体实例即可实现删除权限。
+
+设计思路：
+
+1. 获取权限实体（LCAPPermission）中存储的权限实体实例，其权限主键（id）备用于删除实体实例。
+2. 以防误删，在删除前进行二次确认，例如点击“删除”链接时在弹窗中提示是否确认删除权限。
+3. 确认删除后，调用权限实体（LCAPPermission）的delete逻辑，删除实体实例。
+
+注意：由于权限实体实例被删除，且实体的**关联属性实体记录删除规则**为允许删除且同时删除本实体记录，应用支持自动删除角色与权限的关联实体（LCAPRolePerMapping）和权限与资源的关联实体（LCAPPerResMapping）中所有与该权限关联的实体实例。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_32.gif" style="border: 1px solid #ccc;" />
+
+### 3.4 角色管理
+
+> 应用默认提供roleManagement页面实现角色管理。在页面中管理的角色称为运行态角色。
+
+由于系统默认权限模块由用户、角色、权限组成，且角色作为用户和权限的桥梁，使得被赋予角色的用户能拥有角色对应的权限，因此系统默认提供页面用于管理角色，包括但不限于支持新增角色、为角色授权、为角色添加用户、修改角色和删除角色。
+
+**“新增角色及角色的数据权限”功能原理说明**
+
+通过新增角色实体（LCAPRole）实体实例即可实现新增角色。
+
+由于每个角色都可以为元信息配置不同的权限，因此可以在创建角色时指定该角色的数据权限。通过新增数据权限实体（LCAPDataPermission）即可实现新增数据权限，数据权限中需要指定角色的标识用于匹配该数据权限属于哪一个角色。
+
+由于每个数据权限都可以根据行和列来制定权限范围，而数据权限默认包含一个行权限和多个列权限，因此可以在数据权限中定义行权限、在创建数据权限后指定该数据权限的列权限。通过新增列权限实体（LCAPColumnRule）即可实现新增列权限，列权限中需要指定数据权限的标识用于匹配该列权限属于哪一个数据权限。
+
+设计思路：
+
+1. 已有表单支持自定义角色名称、角色描述；
+2. 对角色数据进行处理，例如角色名称必填且不能重复；
+3. 调用角色实体（LCAPRole）的create逻辑，将数据存储为实体实例，即创建为角色。
+4. 查询实体元信息实体（LCAPEntityMeta）和逻辑元信息实体（LCAPLogicMeta）的所有数据，循环数据列表，调用数据权限实体（LCAPDataPermission）的create逻辑依次与当前角色创建数据权限。resourceName属性对应实体名或逻辑名，resourceType属性对应实体类型或逻辑类型，rowRuleType属性默认all、即行权限默认访问范围为全部，roleId属性用于关联角色id。
+5. 循环创建数据权限时即可调用列权限实体（LCAPColumnRule）的batchCreate逻辑，根据实体或逻辑的属性列表创建列权限。dataPermissionId属性用于关联数据权限id，propertyName属性对应实体或逻辑的属性的名称、即对应数据列，columnRuleType属性根据实体和逻辑的不同默认值分别为readWrite和read。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_33.gif" style="border: 1px solid #ccc;" />
+
+**“修改角色”功能原理说明**
+
+通过更新角色实体（LCAPRole）实体实例即可实现修改角色。
+
+设计思路：
+
+1. 获取角色实体（LCAPRole）中存储的用户实体实例，例如点击“编辑角色”链接时获取当前角色的数据并展示在表单中。
+2. 调用角色实体（LCAPRole）的update逻辑，更改实体实例中的数据，即更新角色信息。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_34.gif" style="border: 1px solid #ccc;" />
+
+**“为角色添加功能权限”功能原理说明**
+
+通过新增角色与权限的关联实体（LCAPRolePerMapping）实体实例即可实现为角色添加权限。
+
+设计思路：
+
+1. 在角色列表中选择角色时获取当前角色的角色信息，其角色主键（id）备用于查询和建立与权限的关联。
+2. 查询角色与权限的关联实体（LCAPRolePerMapping）中所有角色唯一ID属性与当前角色的主键（id）相同的实体实例，并根据其权限唯一ID属性查询权限实体（LCAPPermission）数据，即角色已添加的权限；新增功能权限时，将权限实体（LCAPPermission）中不包含在角色已添加权限内的数据作为可关联权限；
+3. 调用角色与权限的关联实体（LCAPRolePerMapping）的batchCreate逻辑，将角色的主键（id）和每一个已选权限的主键（id）依次存储为关联实体实例中的角色唯一ID和权限唯一ID，即为角色添加权限。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_35.gif" style="border: 1px solid #ccc;" />
+
+**“移除角色的功能权限”功能原理说明**
+
+通过删除角色与权限的关联实体（LCAPRolePerMapping）实体实例即可实现移除角色的权限。
+
+设计思路：
+
+1. 在角色列表中选择角色时获取当前角色的角色信息，其角色主键（id）备用于查询与权限的关联。
+2. 查询角色与权限的关联实体（LCAPRolePerMapping）中所有角色唯一ID属性与当前角色的主键（id）相同的实体实例，即当前角色已添加的权限。
+3. 以防误删，在删除前进行二次确认，例如点击“移除该权限”链接时在弹窗中提示是否确认移除权限。
+4. 确认移除后，调用角色与权限的关联实体（LCAPRolePerMapping）的delete逻辑，删除实体实例，即移除角色的权限。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_36.gif" style="border: 1px solid #ccc;" />
+
+**“为角色规定行权限”功能原理说明**
+
+根据角色的产生方式的不同，将行权限设置分为两种情况：
+
+* 如果角色在IDE中创建，则角色默认未添加数据权限，也可以理解为数据不被限制权限。首次规定行权限时，通过新增数据权限实体（LCAPDataPermission）实体实例即可实现根据根据部门范围规定行权限；否则通过更新数据权限实体（LCAPDataPermission）实体实例中的“行权限类型”属性实现根据部门范围规定行权限。
+* 如果角色在制品应用中创建，则创建角色时已经为角色创建了所有元信息最大范围内的数据权限，此时通过更新数据权限实体（LCAPDataPermission）实体实例中的“行权限类型”属性即可实现根据部门范围规定行权限。
+
+又由于已有行权限可能不满足实际的权限配置，因此可以在更改行权限时选择自定义。通过新增行权限自定义规则实体（LCAPRowRuleItem）即可为数据权限配置自定义行权限，行权限自定义规则中需要指定数据权限ID用于标识该自定义行权限属于哪一个数据权限。
+
+设计思路：
+
+1. 在角色列表中选择角色时获取当前角色的角色信息，其角色主键（id）备用于查询该角色的数据权限。
+2. 查询数据权限实体（LCAPDataPermission）中所有所属角色ID属性与当前角色的主键（id）相同的实体实例，即该角色的所有数据权限，根据所属资源类型属性分类即可分为实体数据权限和逻辑数据权限。
+3. 在数据权限列表中选择实体 / 逻辑时获取当前数据权限的实体信息。
+4. 保存更改时，根据角色是否存在对应的数据权限，调用数据权限实体（LCAPDataPermission）的create逻辑或update逻辑，根据单选组的选择结果赋值行权限规则属性，“可读本人”为self、“可读本人及下属”为underling、“可读本部门及下级部门”为department、“可读全部”为all、“自定义”为custom。即规定当前数据权限的行权限。
+5. 若行权限规则为“自定义”，先调用行权限自定义规则实体（LCAPRowRuleItem）的deleteBy逻辑删除所属数据权限ID与当前数据权限的主键（id）相同的数据、即删除数据权限已有的自定义规则，再调用行权限自定义规则实体（LCAPRowRuleItem）的batchCreate逻辑批量创建新的自定义规则。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_37.gif" style="border: 1px solid #ccc;" />
+
+页面默认效果说明：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_38.png" style="border: 1px solid #ccc;" />
+
+* 可读本人：支持查看由用户本人创建的数据。
+* 可读本人及下属：若用户为部门主管，支持查看由本部门内用户创建的数据；否则仅支持查看本人创建的数据。
+* 可读本部门及下级部门：支持查看由本部门用户或下级部门用户创建的数据。
+* 可读全部：支持查看所有用户的数据。
+* 自定义：自定义行权限范围。例如仅支持查看用户本人在2024-1-1之后创建的数据。
+
+  <img src="../assets/xitongmorenquanxianmokuai_0522_39.png" style="border: 1px solid #ccc;" />
+
+**“为角色规定列权限”功能原理说明**
+
+同上，根据角色的产生方式的不同，通过创建或更新列权限实体（LCAPColumnRule）实体实例中的“列权限规则”属性即可实现根据“无权限”、“仅查看”、“查看并修改”规定列权限，其中“查看并修改”仅限于实体元信息权限。
+
+设计思路：
+
+1. 在角色列表中选择角色时获取当前角色的角色信息，其角色主键（id）备用于查询该角色的数据权限。
+2. 查询数据权限实体（LCAPDataPermission）中所有所属角色ID属性与当前角色的主键（id）相同的实体实例，即该角色的所有数据权限，根据所属资源类型属性分类即可分为实体数据权限和逻辑数据权限。
+3. 在数据权限列表中选择实体 / 逻辑时获取当前数据权限的信息，其数据权限主键（id）备用于查询该数据权限的列权限。
+4. 查询列权限实体（LCAPColumnRule）中所有所属数据权限ID属性与当前数据权限的主键（id）相同的实体实例，即该数据权限的所有列权限。
+5. 保存更改时，根据数据权限是否存在对应的列权限，调用列权限实体（LCAPColumnRule）的batchCreate逻辑或batchUpdate逻辑，根据单选组的选择结果赋值列权限规则属性，“无权限”为none、“仅查看”为read、“查看并修改”为readWrite。即批量规定当前数据权限的列权限。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_40.gif" style="border: 1px solid #ccc;" />
+
+页面默认效果说明：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_41.png" style="border: 1px solid #ccc;" />
+
+* 无权限：不支持查看、创建和修改。
+* 仅查看：支持查看、创建，但不支持修改。
+* 查看并修改：支持查看、创建和修改。
+
+**“为角色添加用户”功能原理说明**
+
+通过新增用户与角色的关联实体（LCAPUserRoleMapping）实体实例即可实现为角色添加用户。
+
+设计思路：
+
+1. 在角色列表中选择角色时获取当前角色的角色信息，其角色主键（id）备用于查询和建立与用户的关联。
+2. 查询用户与角色的关联实体（LCAPUserRoleMapping）中所有角色唯一ID属性与当前角色的主键（id）相同的实体实例，并根据其用户唯一ID属性查询用户实体（LCAPUser）数据，即角色已添加的用户；添加用户时，将用户实体（LCAPUser）中不包含在角色已添加用户内的数据作为可添加用户；
+3. 调用用户与角色的关联实体（LCAPUserRoleMapping）的batchCreate逻辑，将每一个已选用户的主键（id）和角色的主键（id）依次存储为关联实体实例中的用户唯一ID和角色唯一ID，即为角色添加用户。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_42.gif" style="border: 1px solid #ccc;" />
+
+**“移除用户的角色”功能原理说明**
+
+通过删除用户与角色的关联实体（LCAPUserRoleMapping）实体实例即可实现移除用户的角色。
+
+设计思路：
+
+1. 在角色列表中选择角色时获取当前角色的角色信息，其角色主键（id）备用于查询与用户的关联。
+2. 查询用户与角色的关联实体（LCAPUserRoleMapping）中所有角色唯一ID属性与当前角色的主键（id）相同的实体实例，即当前角色已添加的权限。
+3. 以防误删，在删除前进行二次确认，例如点击“移除”链接时在弹窗中提示是否确认移除用户。
+4. 确认移除后，调用用户与角色的关联实体（LCAPUserRoleMapping）的delete逻辑，删除实体实例，即移除用户的角色。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_43.gif" style="border: 1px solid #ccc;" />
+
+**“删除角色”功能原理说明**
+
+通过删除角色实体（LCAPRole）实体实例即可实现删除角色。
+
+设计思路：
+
+1. 获取角色实体（LCAPRole）中存储的角色实体实例，其角色主键（id）备用于删除实体实例。
+2. 以防误删，在删除前进行二次确认，例如点击“删除”链接时在弹窗中提示是否确认删除用户。
+3. 确认删除后，调用角色实体（LCAPRole）的delete逻辑，删除实体实例，即该角色被删除。
+
+注意：由于角色实体实例被删除，且实体的**关联属性实体记录删除规则**为允许删除且同时删除本实体记录，应用支持自动删除角色与功能权限的关联实体（LCAPRolePerMapping）、数据权限实体（LCAPDataPermission）、用户与角色的关联实体（LCAPUserRoleMapping）中所有与该角色关联的实体实例。
+
+> 具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_44.gif" style="border: 1px solid #ccc;" />
+
+### 3.5 登录页
+
+#### “登录用户”功能原理说明
+
+判断用户实体（LCAPUser）中用户名密码匹配后通过依赖库lcap\_auth实现登录。
+
+设计思路：
+
+- 根据用户输入的用户名获取用户实体（LCAPUser）中存储的用户实体实例。
+- 通过系统逻辑 [validatePassword](../..//15.逻辑功能实现/10.逻辑IDE/15.逻辑分类/60.系统逻辑.md) 校验用户输入密码与用户实体实例中的密码是否相同。
+- 校验通过时，调用依赖库lcap\_auth中的逻辑创建token，实现用户登录。
+- 完成登录，跳转至应用首页。
+
+具体操作步骤建议在IDE中查看。
+
+页面默认效果展示：
+
+<img src="../assets/xitongmorenquanxianmokuai_202409021134_2.gif" class="imgStyle" style="" />
+
+#### 其他说明
+
+- H5端同样包含login（登录页）用于普通用户登录。
+- 制品应用在未登录用户的情况下，支持访问所有未开启权限控制的页面；若访问的页面开启了权限控制，制品应用会自动跳转至登录页。具体代码实现可参考应用端的事件逻辑->页面切换前事件。
+
+  > 应用内置逻辑如无必要，请勿删除。
+
+  <img src="../assets/xitongmorenquanxianmokuai_202409021134_3.png" class="imgStyle" style="" />
+
+- 此处登录用户仅为通过制品应用的用户实体（LCAPUser）创建的普通用户，更多业内常用登录及其接入方式请参考：[权限认证模块配置](../../10.页面设计/35.权限模块/005.权限模块配置.md)。
+
+
+## 4. 系统默认权限数据
+
+* 上述管理的角色和功能权限分为两种，分别是**编辑态**和**运行态**。
+
+  * 编辑态：在IDE中，打开组件 / 页面权限控制后即可直接在IDE中管理角色、授权角色，应用发布后由系统自动上报相关角色和功能权限数据，该角色即编辑态角色、同名功能权限即编辑态功能权限。编辑态角色、编辑态功能权限、角色关联功能权限、功能权限关联资源均能够在制品应用的系统默认权限功能页面中展示，但无法进行编辑角色、删除角色、编辑功能权限、删除功能权限、管理角色关联功能权限、管理功能权限关联资源操作，仅支持由开发者在IDE中操作。
+  * 运行态：若角色和功能权限在制品应用中创建，则该角色为运行态角色、权限为运行态功能权限。运行态角色**不展示在IDE的角色管理中**，角色关联功能权限、功能权限关联资源直接在制品应用中管理。
+
+* 应用默认提供编辑态角色**DEV-AdminRole**及该角色被赋予的编辑态权限**DEV-AdminRole**。在IDE中，打开组件 / 页面权限控制时，授权角色默认包含角色DEV-AdminRole，即权限DEV-AdminRole默认拥有操控所有资源的能力。
+* 应用发布或在应用详情的访问信息中，均可查看对应环境的默认用户信息，该用户默认作为角色DEV-AdminRole下的用户，即可操控所有资源。**该用户不可删除，也不推荐修改。**
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_45.png" style="border: 1px solid #ccc;width: 800px;" />
+
+<img src="../assets/xitongmorenquanxianmokuai_0522_46.png" style="border: 1px solid #ccc;" />
+
+## 5. 补充说明
+
+* 角色实体（LCAPRole）包含属性editable，该属性的值由系统自动生成。编辑态角色editable属性值为false，即默认不可编辑角色；运行态角色editable属性值为true，即默认可编辑角色。不推荐手动修改属性值。
+
+<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年09月02日</span>
+</div>
+
+<style>
+
+  /* 折叠块加边框、背景色、边距 */
+  details {
+      border: 1px solid #679CF8; /* 添加边框 */
+      border-radius: 6px;
+      background-color: #F8FCFF; /* 添加底色 */
+      padding: 10px 10px 10px 40px;
+      /* 可选：设置默认背景色，如果需要的话 */
+  }
+
+  /* 折叠块标题不需要内边距 */
+  details summary {  
+    margin: 0 0 0 -20px;
+  }
+
+</style>