j2

负责项

• 【j2】配置管理（19）、组织管理（角色权限、数据权限）（23）

在线评审视频链接

• 2025-6-1-001-配置管理（19）接口评审

接口责任人划分

详情

整体评审

1. 字典类型，要整体性的增加【字典类型编码】字段。前端会高强度的使用该字段来查询数据字典项列表的

2. 角色 id 到底是【pgId】还是【pg_id】？请统一字段命名规范，和注释命名规范。不要一会叫做【角色权限组 id 】，别的接口又叫做【角色 Id】。

3. 缺少接口。缺少类似的【获取未关联员工列表（条件+分页）】接口。

详情

需要约会议面谈

负责字典类型和字典项的同学，需要和前端拉会议谈，这部分接口设计不合适。

获取配置项名称列表

/configmanager/c-mapping-domain/all-domain-name

1. 在配置中心页面内，左侧侧边栏按钮需要改接口，补全配置项编码。即满足脑图所讲的字段（唯一标识、编码、名称）。

详情

1. 脑图说明了需要字段：

2. 用于此处渲染菜单：

3. 请补全字段：

2. 再多加字段，配置项描述。用于在配置中心内显示描述字段。

配置中心页面，前端需要该字段展示效果

获取配置列表（条件+分页）

/configmanager/config/query

1. 不能用配置项的中文名称来查询右侧的表格数据。应该用配置项的 id 来查询。因为中文名称是可以更改的。

详情

2. 在返回响应中，【配置项编号】字段，应该是必填字段。

【配置项编号】字段，应该是必填字段

添加配置

/configmanager/config/add

1. 备注更改注释。改成【配置项编码】，避免前端误解。

备注改名即可

删除配置

/configmanager/config/delete

1. 删除时，id 要做必填校验。

删除 id 做必填校验

添加字典类型

/configmanager/dict-spec/add

1. 字段缺漏。和字典类型列表、编辑接口所需的字段对不上。需要补全。

详情

获取字典类型名称列表

/configmanager/dict-spec/query-names

1. 返回响应，字段缺漏。应该补全字典类型实体应该有的名称与 id 字段。

详情

添加字典

/configmanager/sys/add-t_dict

1. id 是什么谁的字段？是【字典类型 id】么？需要解释。
2. 前端不可能去给后端存储【字典类型】的中文名称的，应该存储【字典类型】的 id。

详情

修改字典

/configmanager/sys/modify-t_dict

1. 修改【字典项】时，不需要传递【字典类型】的任何字段。

详情

获取字典列表(条件+分页)

/configmanager/sys/query-t_dict

1. 名称、字典类型、值。这三个查询条件不可能是必填的，是可选的。
2. 查询条件【字典类型】specName，前端不可能传递中文名称来查询，应该传递【字典类型 id】来查询。

详情

获取字典名称列表

这是高频调用的接口。该接口设计全错了。需要开会当面谈。

详情

1. 需要的字段都没有给足。

2. 该接口只需要传递唯一一个【字典类型编码】字段即可。其他的字段全部都无意义。

添加角色 无误、已生成前端接口

/orgmanager/role-manage/add

1. 多出了额外的 Query 参数。需要删除。

详情

删除角色 无误、已生成前端接口

/orgmanager/role-manage/delete

1. 写清楚 pg_id 的注释。
2. 删除时，id 为必填项校验。

详情

获取角色列表 无误、已生成前端接口

/orgmanager/role-manage/query

1. store_id 可以从 token 中解析获取。不需要前端传递。

根据当前管理员获得列表。

详情

获取菜单名称树

/orgmanager/role/func

1. 前端不存在 roleType 角色种类字段。无法给后端传递该字段。请和【获取角色列表】的接口负责人沟通，查询角色对应的菜单时，是否要使用【角色权限组 id】pg_id。
2. 如果需要类似的角色 id，请设置为必填项。根据原型业务交互，必须先传递角色 id，才能查询角色对应的菜单名称树。

详情

该变量前端无法传递。因为其他接口没有提供相关变量。

修改角色权限

/orgmanager/role/func/update-permissions

1. 剩余的字段，无法表述清楚如何传递前端所勾选的树形数据。在实际的交互中，前端点击树的节点，就会把树对应的全部菜单 id，即每个节点的 id 上传给后端。该接口应该是高频调用的接口。但本接口的剩余几个字段无法传递前端节点信息。表意不明，需要负责此接口的人与前端拉会议沟通。

详情

获取已关联小区列表（条件+分页）

/orgmanager/role/community/listRoleCommunity

1. role_id 应该改成大驼峰命名。
2. 角色 id 应该是必填项。

详情

角色 id 应该是必填项

根据交互效果，用户是先选择角色，再开始查询对应的小区列表的。所以对于【可关联】和【已关联】的小区列表接口，都必须先传递角色 id，再开始查询数据。

获取可关联小区列表（条件+分页）

/orgmanager/role/community/listOrgNoCommunity

1. role_id 应该改成大驼峰命名。
2. 角色 id 应该是必填项。
3. 缺少查询条件【小区名称】。
4. 缺少返回字段【小区地址】。

缺少查询条件【小区名称】

没有所需要的小区名称字段。

缺少返回字段【小区地址】

原型需要该字段。

返回响应内没有所需字段。

新增关联

/orgmanager/role/community/addRoleCommunity

1. 字段名应该为大驼峰。
2. 【小区名称】不需要。在关联小区时，为了满足业务，只需要小区 id、角色 id 即可。
3. 小区 id 应该满足能够上传多个小区 id。

详情

小区 id 应该满足能够上传多个小区 id

可以多选多个未关联的小区。

已关联的小区就可以同时查到多条信息。

针对此问题，有专门的录制视频：

• 录制：2025-6-2-01-物业关联小区、角色关联小区
• 日期：2025-06-02 15:00:03
• 录制文件：https://meeting.tencent.com/crm/2aMXq0LGc1

删除关联

/orgmanager/role/community/deleteRoleCommunity

1. 不可能传递过多的必填参数。实现删除关联业务，最多需要【小区 id】和【角色 id】。
2. 字段名改成小驼峰。

不需要过多参数

获取已关联员工列表（条件+分页）

/orgmanager/group/role/emplist

1. pgId 权限组 id 是什么意思？不理解该字段的来源和业务设计，需要解释清楚。

新增关联 删除关联

/orgmanager/group/role/emplist/orgmanager/group/role/emplist

1. pId 和 pgId 是什么意思？请补全注释说明。
2. 为什么新增关联和删除关联时，这两个字段都是非必填的？
3. 新增关联接口应该要做到能够新增多个用户。

详情

添加数据权限 修改数据权限 无误

/orgmanager/data/add/orgmanager/data/data-privilege

勘误

前端理解错了。前端可以传递 communityId 给后端。

详情

获取数据权限列表（条件+分页）无误

/orgmanager/data/dataPrivilege/{communityId}

勘误

前端理解错了。前端可以传递 communityId 给后端。

获取未关联单元列表（条件+分页）

/orgmanager/data/unit/no-related-unit

1. unitNum 和 floorNum 应该是非必填。

分页接口的查询条件是非必填的

前端是可以不传递 【单元编号】 和 【楼栋编号】 的。

删除关联单元

/orgmanager/data/unit/remove-related-unit

1. dpUnitId 应该是必填项。删除接口要做 id 的必填项校验。

详情

添加关联单元

/orgmanager/data/unit/add-related-unit

1. 数据权限关联小区单元时，不需要上传 unitNum 和 floorNum。
2. 要能够实现同时关联多个小区的功能。

是可以同时关联多个小区的

关于此内容，有额外的视频，和其他的业务高度耦合：

• 录制：6 月 2 号 02-楼栋单元要先数据授权给单元和用户才能看到
• 日期：2025-06-02 17:36:05
• 录制文件：https://meeting.tencent.com/crm/2qvz0evdea

不需要上传 unitNum 和 floorNum

贡献者

ruan-cat

页面历史

最后编辑于 2 分钟前

查看完整历史

1872c7e-📃 docs(docs-01-star): 正式对外外发项目 https://github.com/ruan-cat/11comm/