更新角色及权限#

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

用途与场景#

更新角色。

使用位置#

页面/功能	角色或空间分支
更新角色及权限	当前 $spaceId；按钮可见性与后端授权分别校验

端点#

PUT /main-service/system-api/authority/role/updateById — 更新角色。

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

动线与完成判据#

status=200 && data=true 才表示目标更新/删除 SQL 报告成功；data=false 可表示目标不存在或没有受影响行。当前 Web 的成功 toast 不检查 data，App 不应复制这一判定。

错误与边界#

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

调用关系与资源清理#

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

已知缺口#

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