用途:这是 ibl.ai 角色访问控制(RBAC)系统的参考技能,适用于构建、审计或扩展 RBAC 行为。多数应用只需 SDK 内置管理界面加逐资源权限校验,无需从零手写 RBAC UI。
主要能力:列出平台预置的默认角色,如 TENANT_ADMIN、STUDENT、MENTOR_VIEWER/EDITOR、ANALYTICS_VIEWER、NOTIFICATION_MANAGER、ENROLLMENT_MANAGER、CRM 系列等,并指向返回全部动作定义的实时端点。
使用方式:SDK 提供开箱即用的 Roles + Policies 界面,位于 @iblai/iblai-js/web-containers,包括 <Admin>(用户、组、角色、策略、团队、告警,标签页按权限门控)、<RolesTab tenant={key} />、<PoliciesTab tenant={key} />。代理级共享用 <AgentAccessTab>。逐动作权限门控用 checkRbacPermission(rbacPermissions, path, enableRbac)。动作定义端点:GET https://base.manager.iblai.app/api/core/rbac/actions/definitions/,需 Authorization: Token <dm-token>。自定义角色可经 <RolesTab> 或 POST rbac/roles/ 创建,再经 <PoliciesTab> 或 POST rbac/policies/ 绑定。
限制与约定:不要给 SDK 组件添加自定义样式、颜色或 CSS 覆盖;除非用户明确要求,不要实现深色模式。优先使用 SDK 组件,其次 shadcn/ui(npx shadcn@latest add <component>),不要重复造轮子。品牌色 Primary #0058cc,渐变 linear-gradient(135deg, #00b0ef, #0058cc)。资源为层级结构,以 /platforms/ 开头、以 / 结尾。Ibl.* 通配符会绕过字段级读取,应谨慎使用。