`

      itc信息化业务中台

Panyu10109

16

        AI助手

权限管理 > 权限点管理

权限点管理

+ 新增一级菜单

查询

重置

输入权限点名称

输入权限点编码

新增权限点

×

*名称

新建客户

*权限编码

crm_customer_create

描述

允许在客户模块新建客户

API URL

POST /api/crm/customers

保存失败

×

!

权限点未保存

服务暂时不可用。本次填写内容已保留,权限点列表及角色授权均未改变。

错误编号:POINT-SAVE-503 发生时间:2026-07-24 16:18:32 日志结果:失败(记录失败原因,不记录不存在的权限点)

关闭

重试保存

删除权限点

×

!

确认删除“导出客户”?

删除后,该权限点不再出现在角色功能权限配置中且不可恢复。

权限编码:crm_customer_export
当前角色引用:0 个 提交时将再次校验引用,并记录操作人、时间、对象快照和结果。

删除前校验

取消

确认删除

无法删除权限点

×

!

请先在角色功能权限配置中解除全部引用,再返回本页删除。

“新建客户”正被 3 个角色引用,禁止删除。

销售总监

启用 · 18 名在职使用人员

前往角色配置

销售专员

启用 · 76 名在职使用人员

前往角色配置

报备专员

停用 · 0 名在职使用人员

前往角色配置

停用角色的引用也必须解除;系统不自动改写任何角色授权。

知道了

删除失败

×

!

“导出客户数据”未删除

提交时发生服务异常,权限点及所有角色授权保持不变。

错误编号:POINT-DELETE-503 操作日志:已记录失败结果与原因 下一步:可关闭后稍后重试

关闭

重试删除

启用权限点

×

!

确认启用“导出客户数据”?

启用后,该权限点将进入角色功能权限配置,但不会自动授予任何已有角色。

权限编码:crm_customer_export
当前角色引用:0 个 操作成功后记录操作人、时间、对象快照和结果。

启用前校验

取消

确认启用

停用权限点

×

!

确认停用“导入线索”?

该权限点当前未被角色引用。停用后将退出角色功能权限配置,之后可以重新启用。

权限编码:crm_lead_import 角色引用:0 个 提交时将再次校验引用并记录操作日志。

停用前校验

取消

确认停用

无法停用权限点

×

!

请先在角色功能权限配置中解除全部引用,再返回本页停用。

“新建客户”正被 3 个角色引用,禁止停用。

销售总监

启用 · 18 名在职使用人员

前往角色配置

销售专员

启用 · 76 名在职使用人员

前往角色配置

报备专员

停用 · 0 名在职使用人员

前往角色配置

停用角色的引用也必须解除;本次未停用权限点,角色授权和员工权限均保持不变。

知道了

启用失败

×

!

“导出客户数据”仍处于停用状态

提交时发生服务异常,权限点未进入角色功能权限配置,所有角色授权保持不变。

错误编号:POINT-ENABLE-503 操作日志:已记录失败结果与原因 下一步:可关闭后稍后重试。

关闭

重试启用

需求

需求说明

变更记录

1. 功能范围

1、权限点管理用于维护 CRM 角色可配置的一级菜单、二级菜单和权限点。

2、页面及相关接口仅平台超级管理员可访问。其他账号访问时展示无权限状态,并提供返回后台首页的入口。

3、本功能只维护权限资源定义、层级及启停状态,不自动实现业务功能鉴权,不自动授予或解除角色权限,也不处理员工权限来源、数据范围和字段脱敏规则。

4、API URL用于说明和定位接口,不自动生成接口权限;对应业务功能和接口鉴权由开发实现。

5、侧边导航栏从菜单数据读取图标。一级菜单和二级菜单各保存一个图标文件。

2. 资源层级

1、权限资源分为一级菜单、二级菜单和权限点。

2、一级菜单下可以新增二级菜单。页面型一级菜单可以直接新增权限点;目录型一级菜单不能直接新增权限点。

3、二级菜单只能建立在一级菜单下,固定为可点击页面,其下可以新增权限点。

4、权限点可以建立在页面型一级菜单或二级菜单下。

5、不支持三级菜单,权限点下不允许新增资源。

6、权限编码在三种资源类型之间全局唯一。

3. 权限资源树


3.1 查询

1、支持以下查询条件:

权限名称:模糊匹配。

权限编码:模糊匹配。

状态:全部、启用、停用。


2、点击“查询”后按当前条件筛选;点击“重置”后清空条件并重新加载。

3、筛选命中二级菜单或权限点时,同时展示其父级节点,以保留层级关系。

4、状态筛选按资源自身状态计算,不按上级菜单停用造成的暂时不可用状态计算。

5、补充展示的父级节点不计入每页条数和结果总数。



3.2 列表内容

1、资源以树形结构展示,支持单节点展开或收起,以及“全部展开”和“全部收起”。

2、列表展示以下字段:

名称。

类型:一级菜单、二级菜单或权限点。

权限编码。

路由路径:权限点显示“—”。

API URL:菜单显示“—”。

描述。           

状态:启用或停用。上级菜单停用时,下级资源同时展示“上级已停用”。

操作。


3、列表支持分页、切换每页条数和跳转页码。

4、分页按树中所有实际节点计算。任何分页场景下,当前页子节点缺少父级时均补充展示父级;补充的父级不计入每页条数和结果总数。

5、图标只用于侧边导航栏展示,权限资源树不增加图标列。



3.3 列表操作

1、页面顶部提供“新增一级菜单”。

2、目录型一级菜单提供新增二级菜单、编辑、启用或停用操作;页面型一级菜单增加“新增权限点”。

3、二级菜单提供新增权限点、编辑、启用或停用、删除操作。

4、权限点提供编辑、启用或停用、删除操作。

5、所有未删除资源均可编辑。

6、新建资源默认为停用。资源启用且所有上级菜单均启用时进入角色权限配置;资源停用或任一上级菜单停用时退出角色权限配置。

7、删除只在资源停用后显示。停用菜单存在下级资源时仍不显示删除。

4. 新增资源


4.1 通用规则

1、从对应入口打开新增弹窗。资源类型由入口确定并只读。

2、名称必填,长度为1~50个字符。

3、权限编码必填、全局唯一、至少3位,只允许字母、数字和下划线。

4、描述选填,最多50个字符。

5、排序必填,默认值为1,只能填写正整数,排序范围为同一父级下的资源。

6、弹窗提供“取消”和“保存”。保存成功后新增资源默认为停用,不进入角色权限配置。



4.2 新增一级菜单

弹窗字段如下:

类型:一级菜单,只读。

菜单形态:必填,可选“目录”或“页面”。目录不可点击,仅展示二级菜单;页面可点击进入,并可直接建立权限点。

名称。

图标文件:必填,上传UI提供的图标文件。

权限编码。

描述。

路由路径:目录不填写;页面必填。

排序。



4.3 新增二级菜单

弹窗字段如下:

类型:二级菜单,只读。二级菜单固定为可点击页面。

名称。

图标文件:必填,上传UI提供的图标文件。

所属上级:当前一级菜单,只读。

权限编码。

描述。

路由路径:必填。

排序。



4.4 新增权限点

弹窗字段如下:

类型:权限点,只读。

名称。

权限编码。

描述。

API URL:必填,一个权限点填写一个

排序。


5. 编辑资源

1、编辑弹窗的字段与对应新增弹窗一致。

2、资源类型和权限编码只读;二级菜单的所属上级只读。

3、其他字段可以修改,并遵循新增时的字段规则。一级菜单允许修改菜单形态;页面型一级菜单存在直挂权限点时,不允许改为目录,需先删除全部直挂权限点。

4、编辑一级菜单或二级菜单时展示当前图标。未重新上传时保留当前图标;重新上传并保存成功后,以新图标替换当前图标。

5、权限点的新增和编辑弹窗不展示图标字段。

6、保存后,资源ID、状态、层级及已有角色引用保持不变。

7、修改当前可用资源的展示信息后,管理端立即生效,不要求员工重新登录。


6. 保存校验

6.1 权限编码重复

1、新建时发现权限编码已被任一类型资源使用,不创建资源。

2、权限编码字段下方展示全局重复提示,弹窗内同时展示保存失败提示。

3、保留当前填写内容,允许修改编码后重新保存。

4、角色权限配置不发生变化。


6.2 服务异常

1、新建或编辑发生服务异常时,本次内容不写入,并保留当前填写内容。

2、权限资源树、角色授权和员工权限保持不变。

3、失败弹窗展示错误编号和发生时间,并提供“关闭”和“重试保存”。

4、关闭失败弹窗后返回原新增或编辑弹窗;操作日志记录失败结果和原因,不提供跳转入口。

7. 启用资源

7.1 启用确认

1、启用前展示确认弹窗,包含资源名称、权限编码和当前角色引用数。

2、弹窗说明资源启用且所有上级菜单均启用时进入角色权限配置,但默认不选中,也不会自动授予任何已有角色。

3、用户确认后提交启用。



7.2 启用结果

1、启用成功后,资源状态变为启用。所有上级菜单均启用时,资源进入角色权限配置;存在停用的上级菜单时,资源保持暂时不可用。

2、重新启用菜单后,下级资源恢复停用菜单前各自的状态;其中自身为启用的资源重新进入角色权限配置。

3、启用失败时,资源保持停用,不进入角色权限配置;角色授权保持不变。

4、失败弹窗展示错误编号、下一步处理方式、“关闭”和“重试启用”;操作日志记录失败结果和原因,不提供跳转入口。

8. 停用资源

8.1 停用校验

1、只有未被角色引用的启用资源可以停用。

2、停用一级或二级菜单时,本菜单或任一下级资源被角色引用,均不允许停用。

3、停用角色中的引用同样计入校验,系统不自动解除任何角色引用。

4、提交停用时,服务端再次校验资源是否存在、当前状态及本资源和下级资源的角色引用情况。

5、存在引用时,弹窗展示引用数量、角色名称、角色状态、在职使用人数和各角色的“前往角色配置”入口,并提示先解除全部引用。



8.2 停用确认

1、校验通过后展示确认弹窗,包含资源名称、权限编码和当前角色引用数。

2、停用权限点时,弹窗说明其将退出角色权限配置,后续可以重新启用。

3、停用菜单时,弹窗同时展示受影响的下级菜单及权限点数量,并说明整棵下级资源将暂时退出角色权限配置;重新启用菜单后,下级资源按各自原状态恢复。

4、停用不会自动修改角色授权或员工权限。



8.3 停用结果

1、停用成功后,资源状态变为停用并退出角色权限配置。

2、停用菜单成功后,整棵下级资源暂时退出角色权限配置,但各自状态不变;列表展示各自状态及“上级已停用”。

3、停用失败时,资源保持启用,角色授权和员工权限保持不变。

4、失败弹窗展示错误编号、下一步处理方式、“关闭”和“重试停用”;操作日志记录失败结果和原因,不提供跳转入口。


需求

需求说明

变更记录

9. 删除资源

9.1 删除校验

1、只有停用资源可以删除。

2、权限点无角色引用时可以删除。

3、菜单无角色引用且不存在任何下级资源时可以删除。

4、一级菜单存在二级菜单或权限点、二级菜单存在权限点时,禁止删除。弹窗展示下级资源数量,并提示先删除全部下级资源。

5、存在角色引用时,禁止删除。弹窗展示引用数量、角色名称、角色状态、在职使用人数和各角色的“前往角色配置”入口。

6、停用角色中的引用也必须解除,系统不自动解除任何角色引用。

7、提交删除时,服务端再次校验资源是否存在、当前状态、下级资源和角色引用情况。并发产生下级资源或角色引用时同样阻止删除。



9.2 删除确认

1、校验通过后展示确认弹窗,包含资源名称、权限编码和当前角色引用数。

2、弹窗说明删除后资源不再显示且无法恢复。

3、用户确认后提交删除。



9.3 删除结果

1、删除成功后,资源从权限资源树及角色权限配置中移除。

2、删除失败时,资源、下级资源和全部角色引用保持不变。

3、失败弹窗展示错误编号、下一步处理方式、“关闭”和“重试删除”;操作日志记录失败结果和原因,不提供跳转入口。


10. 提交与并发校验

1、启用、停用和删除提交时,服务端重新校验资源是否存在、当前状态、层级关系及角色引用情况。

2、校验结果以提交时的数据为准;校验失败时不执行部分写入。

3、所有失败场景均应明确资源最终状态,以及角色授权和员工权限是否发生变化。

11.  页面状态

1、尚无权限资源时,展示空状态和“新增一级菜单”入口。

2、筛选无结果时,提示未找到匹配的权限点,并提供“重新筛选”。

3、加载失败时,提示权限点数据暂时不可用,并提供“重新加载”。

4、无访问权限时,提示当前账号无权访问权限点管理,并提供“返回后台首页”。

权限资源树

⌄ 全部展开

› 全部收起

名称

类型

权限编码

API URL

描述

状态

操作

客户管理

一级菜单

+新增二级菜单

编辑

客户列表

二级菜单

crm_customer_view

新建客户

权限点

crm_customer_add

编辑客户

crm_customer_edit

导出客户

crm_customer_export

客户公海

crm_customer_pool

商机管理

启用

启用

启用

启用

停用

启用

启用

客户相关业务模块

客户列表与详情入口

允许在客户模块中新建客户

--

--

--

权限点

权限点

二级菜单

一级菜单

停用

删除

+新增权限点

编辑

停用

删除

编辑

停用

删除

编辑

停用

删除

编辑

删除

启用

+新增权限点

编辑

停用

删除

新增一级菜单

×

*名称

客户

*权限编码

crm_customer_view

描述

控制客户管理菜单及模块

路由路径

/customers

排序

1

类型

编辑一级菜单

×

*名称

客户

*权限编码

crm_customer_view

描述

控制客户管理菜单及模块

取消

保存

路由路径

/customers

排序

1

一级菜单

类型

一级菜单

新增二级菜单

×

*名称

客户公海

*权限编码

crm_customer_view

描述

客户公海列表与详情入口

路由路径

/customers

排序

1

类型

编辑二级菜单

×

*名称

客户公海

*权限编码

crm_customer_view

描述

客户公海列表与详情入口

路由路径

/customers

排序

1

二级菜单

类型

二级菜单

类型

权限点

排序

1

编辑权限点

×

*名称

新建客户

*权限编码

crm_customer_create

描述

允许在客户模块新建客户

API URL

POST /api/crm/customers

类型

权限点

排序

1

取消

保存

路由路径

+新增权限点

+新增二级菜单

编辑

停用

删除

+新增权限点

crm_opportunity

crm_customer

--

--

/customers/cus

--

--

POST /api/crm/customers


--

PATCH /api/crm/customers/:id

--

POST /api/crm/customers/export

/customers/pool

--

--

--

--

*菜单形态

*菜单形态

所属上级

客户

所属上级

客户

新增权限点

×

*名称

新建客户

*权限编码

crm_customer_create

描述

允许在客户模块新建客户

API URL

POST /api/crm/customers

类型

权限点

排序

1

该权限编码已存在,请使用新的全局唯一编码。

!

创建失败,请修改编码后重新保存。

取消

保存

取消

保存

取消

保存

取消

保存

取消

保存

停用一级菜单

×

!

确认停用“客户管理”?

停用后,其下2个二级菜单和7个权限点将暂时不可用。

重新启用后,下级权限将恢复原有状态。

权限编码:crm_lead_import 角色引用:0 个 提交时将再次校验引用并记录操作日志。

停用前校验

取消

确认停用

停用二级菜单

×

!

确认停用“客户管理”?

停用后,其下3个权限点将暂时不可用。

重新启用后,下级权限将恢复原有状态。

权限编码:crm_lead_import 角色引用:0 个 提交时将再次校验引用并记录操作日志。

停用前校验

取消

确认停用

无法删除一级菜单

×

!

无法删除“客户管理”

客户管理”下存在2个二级菜单和7个权限点,禁止删除。

请先删除所有下级节点,再返回本页删除。

知道了

*图标文件

选择文件

*图标文件

未选择任何文件

选择文件

当前已上传图标

*图标文件

选择文件

未选择任何文件

*图标文件

选择文件

当前已上传图标

权限管理

业务规则

日志管理

    角色权限

    权限点管理

用户管理

系统设置

返回前台

    权限点管理

`

      itc信息化业务中台

Panyu10109

16

        AI助手

权限管理 > 权限点管理

权限点管理

+ 新增一级菜单

查询

重置

输入权限点名称

输入权限点编码

权限资源树

⌄ 全部展开

› 全部收起

权限管理

业务规则

日志管理

    角色权限

    权限点管理

用户管理

系统设置

返回前台

    权限点管理

没有匹配的权限点

请调整名称或权限编码后重试。

重置筛选

筛选 · 无结果

`

      itc信息化业务中台

Panyu10109

16

        AI助手

权限管理 > 权限点管理

权限管理

业务规则

日志管理

    角色权限

    权限点管理

用户管理

系统设置

返回前台

    权限点管理

页面 · 加载失败

!

权限点数据加载失败

网络异常或服务暂时不可用。

重新加载

`

      itc信息化业务中台

Panyu10109

16

        AI助手

权限管理 > 权限点管理

权限管理

业务规则

日志管理

    角色权限

    权限点管理

用户管理

系统设置

返回前台

    权限点管理

页面 · 无权限

无权访问权限点管理

该页面仅平台超级管理员可用;普通 CRM 管理员不展示导航入口,直接访问也会被拒绝。

返回后台首页

`

      itc信息化业务中台

Panyu10109

16

        AI助手

权限管理 > 权限点管理

权限点管理

+ 新增一级菜单

查询

重置

输入权限点名称

输入权限点编码

权限资源树

⌄ 全部展开

› 全部收起

权限管理

业务规则

日志管理

    角色权限

    权限点管理

用户管理

系统设置

返回前台

    权限点管理

列表尚无权限点

还没有权限点

创建 CRM 菜单或功能权限点后,才能在角色功能权限中进行分配。

+ 新增权限点