创建角色并配置权限#

验证状态：已源码核验、未联调；适用基线：源码归纳 @ 2026-09-14

用途与场景#

创建角色。

使用位置#

页面/功能	角色或空间分支
创建角色并配置权限	当前 $spaceId；按钮可见性与后端授权分别校验

端点#

POST /main-service/system-api/authority/role/save — 创建角色。

端点全量事实（参数、请求/响应字段、错误码、权限点）见清单层 authority · role 角色；业务语义（wire 惯例、限频、租户声明等）见授权业务 · role 角色。

动线与完成判据#

status=200 && data=true 表示复合写入未抛异常；保存实现以“无异常”为 true，不提供 affected-row 数。当前 Web 仅依赖 Promise 的 onSuccess，App 应显式检查业务 status 和 data。

错误与边界#

错误出口与四类映射见错误响应差异。角色代码重复返回 Role exists/Role repeat；administrator 代码及现有 administrator 角色禁止通过此入口创建或改写。本组写操作无幂等键；超时后须先核对资源状态再决定重试。

调用关系与资源清理#

角色与 permissionCodes 同步在同一事务；成功后应重新读取详情取得服务端权限集合。

已知缺口#

无已知关键缺口；未执行真实联调。