Initial Dever 0.0.1

lib/doc/dever-auth-roles.md

@@ -0,0 +1,59 @@
+# 角色与权限
+
+角色操作作用于当前认证租户和站点，不能用参数切换授权库。
+
+## dever.auth.Permission
+
+一个接口或业务权限的名称、所属组件、领域、站点及操作信息。
+
+## dever.auth.Role
+
+角色及其权限设置。protected 标识保留角色，permission_keys 是分配的权限键。
+
+## dever.auth.permissions
+
+读取当前站点的有效权限目录。
+
+## dever.auth.currentPermissions
+
+读取当前用户启用角色的有效权限并集。
+
+## dever.auth.roles
+
+读取当前站点角色，包含禁用与受保护角色。
+
+## dever.auth.role
+
+读取当前站点单个角色，不存在时返回 null。
+
+## dever.auth.userRoles
+
+读取当前站点指定用户的角色。
+
+## dever.auth.isOwner
+
+根据受保护角色判断 Owner，不依赖特殊用户编号。
+
+## dever.auth.saveRole
+
+原子保存角色与权限，仅允许受保护写 API。
+
+## dever.auth.grantRole
+
+授予普通角色，保留 Owner 由运维入口建立。
+
+## dever.auth.revokeRole
+
+撤销普通角色。
+
+## dever.auth.disableRole
+
+禁用普通角色，保留关系用于管理回显。
+
+## dever.auth.deleteRole
+
+原子删除普通角色及授权关系。
+
+## dever.auth.owner
+
+只检查受保护标记，角色是否启用不改变保留身份。