Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt

Use this file to discover all available pages before exploring further.

本文说明功能开关、角色权限开关、roleName 和工作区能力分别在哪里控制、由什么后端数据初始化，以及默认值如何生效。

​
控制来源与默认值

开关类型在哪里控制后端来源默认规则说明
功能开关，例如 FEATURE_XPERTSettings / Feature：/settings/features/tenant 和 /settings/features/organizationfeature 定义由 DEFAULT_FEATURES 初始化；租户和组织级覆盖值存储在 feature-organization 记录中。feature 默认解析为开启。如果存在同名环境开关且值严格等于 false，默认解析为关闭；如果没有同名环境开关，则默认解析为开启。租户和组织记录创建时会复制当时解析出的 feature 值。查询开关需要 ALL_ORG_VIEW；更新开关需要 ALL_ORG_EDIT；系统级升级/补齐需要 SUPER_ADMIN。
角色权限开关，例如 ALL_ORG_EDITSettings / Roles：/settings/rolesrole permission 记录由 DEFAULT_ROLE_PERMISSIONS 初始化。初始化时只给下方默认权限表中列出的角色开启对应权限；未列出的角色-权限组合默认关闭或不存在。修改角色权限需要 CHANGE_ROLES_PERMISSIONS。SUPER_ADMIN 角色的权限不能通过 role-permission API 修改或删除。
roleName 校验，例如 SUPER_ADMIN 或 ADMIN用户角色分配路由 guard 或后端 decorator 校验当前用户角色。默认系统角色包括 SUPER_ADMIN、ADMIN、TRIAL、AI_BUILDER、ANALYTICS_BUILDER、VIEWER。这不是 feature 开关；必须给用户分配对应角色。
工作区能力，例如 workspace.capabilities.canManage工作区 owner、成员、可见性和共享规则运行时计算出的 workspace capability，不是枚举权限。不在全局角色权限矩阵中提供统一默认开关。用户进入 Xpert 功能后，工作区内操作继续受该能力控制。

​
按模块划分的默认功能开关

模块功能开关默认值控制 / 回退
平台首页FEATURE_HOME、FEATURE_DASHBOARD默认开启。平台默认 feature 定义中硬编码开启。当前菜单中的 dashboard 入口已注释，Home 下的 Analytics 子功能另由 FEATURE_HOME_CATALOG、FEATURE_HOME_TREND 控制。
平台设置FEATURE_ORGANIZATION、FEATURE_USER、FEATURE_EMAIL、FEATURE_EMAIL_TEMPLATE、FEATURE_SETTING、FEATURE_FILE_STORAGE、FEATURE_SMTP、FEATURE_ROLES_PERMISSION、FEATURE_INTEGRATION默认开启。同名环境变量只有在值严格等于 false 时才会把 feature 解析为关闭；没有同名环境开关的 feature 会解析为开启。初始化后，租户/组织级开关在 Settings / Feature 中维护。
平台未启用默认项FEATURE_SMS_GATEWAY当前默认 feature 列表中没有作为启用项初始化。枚举和环境开关存在，但默认 feature 定义中的 SMS Gateway 子项被注释。
AI / CopilotFEATURE_COPILOT、FEATURE_COPILOT_KNOWLEDGEBASE、FEATURE_COPILOT_CHAT默认开启。由环境默认值和租户/组织 feature 开关共同控制。
AI / XpertFEATURE_XPERT默认开启。由环境默认值和租户/组织 feature 开关共同控制。
AI / Xpert 子入口FEATURE_XPERT_CLAWXPERT、FEATURE_XPERT_CHATBI、FEATURE_XPERT_CODEXPERT、FEATURE_XPERT_DEEP_RESEARCH在 AI feature 默认定义中默认开启。这些是 Xpert 下的子开关，运行时仍按租户/组织 feature 记录判断。
BI / AnalyticsFEATURE_BUSINESS_AREA、FEATURE_INDICATOR、FEATURE_INDICATOR_MARKET、FEATURE_INDICATOR_REGISTER、FEATURE_INDICATOR_APP、FEATURE_MODEL、FEATURE_STORY、FEATURE_PROJECT、FEATURE_HOME_CATALOG、FEATURE_HOME_TREND默认开启。Analytics 模块准备阶段会把这些 feature 定义追加到系统默认 feature 列表。
BI / Data FactoryFEATURE_DATA_FACTORY当前默认 feature 列表中没有作为启用项初始化。枚举存在，但默认 feature 定义目前被注释；依赖该开关前需要结合具体入口确认。
仅权限控制的页面Organizations、Feature 维护、Tenant 设置、Plugins本矩阵中无 feature 开关。这些入口由 role permission 或 roleName 控制，不由 feature 控制。

​
按角色划分的默认权限开关

这些默认值描述初始化时写入的 role-permission 记录。非 SUPER_ADMIN 角色的权限后续可以在 Settings / Roles 中调整，前提是当前用户拥有 CHANGE_ROLES_PERMISSIONS。
权限分组权限默认开启角色说明
租户和组织管理ALL_ORG_VIEW、ALL_ORG_EDIT、CHANGE_SELECTED_ORGANIZATION、CHANGE_ROLES_PERMISSIONSSUPER_ADMIN、ADMIN、TRIALALL_ORG_EDIT 是更新租户/组织 feature 开关，以及执行租户级组织/用户操作的权限开关。
用户查看ORG_USERS_VIEWSUPER_ADMIN、ADMIN、TRIAL、AI_BUILDERAI_BUILDER 默认可以查看组织用户。
用户维护ORG_USERS_EDITSUPER_ADMIN、ADMIN、TRIAL新建、编辑、维护组织用户。
邀请查看ORG_INVITE_VIEWSUPER_ADMIN、ADMIN、TRIAL、AI_BUILDER查看邀请记录。
邀请维护ORG_INVITE_EDITSUPER_ADMIN、ADMIN、TRIAL创建、重发、删除邀请。
集成查看INTEGRATION_VIEWSUPER_ADMIN、ADMIN、TRIAL、AI_BUILDERAI_BUILDER 默认可以查看集成。
邮件和 SMTP 设置VIEW_ALL_EMAIL_TEMPLATES、CUSTOM_SMTP_VIEWSUPER_ADMIN、ADMIN、TRIALAI 和 BI 之外的设置项。
集成编辑INTEGRATION_EDITSUPER_ADMIN、ADMIN、TRIAL、AI_BUILDERAI_BUILDER 默认可以编辑集成。
高危管理SUPER_ADMIN_EDIT、ACCESS_DELETE_ACCOUNT、ACCESS_DELETE_ALL_DATASUPER_ADMINdemo 模式会移除删除账户和删除全部数据权限。
AI 查看/使用COPILOT_VIEW、CHAT_VIEW全部默认角色CHAT_VIEW 默认分配给 SUPER_ADMIN、ADMIN、TRIAL、AI_BUILDER、ANALYTICS_BUILDER、VIEWER。
AI 构建/管理XPERT_EDITSUPER_ADMIN、ADMIN、TRIAL、AI_BUILDER、ANALYTICS_BUILDERVIEWER 默认没有 XPERT_EDIT。
AI 管理COPILOT_EDIT、KNOWLEDGEBASE_EDITSUPER_ADMIN、ADMIN、TRIAL、AI_BUILDERANALYTICS_BUILDER 和 VIEWER 默认没有这些编辑权限。
BI 查看MODELS_VIEW、STORIES_VIEW全部默认角色这是默认覆盖最广的 BI 查看权限。
BI 构建/管理DATA_SOURCE_VIEW、DATA_SOURCE_EDIT、MODELS_EDIT、STORIES_EDIT、BUSINESS_AREA_EDIT、CERTIFICATION_EDIT、INDICATOR_EDIT、DATA_FACTORY_VIEW、DATA_FACTORY_EDITSUPER_ADMIN、ADMIN、TRIAL、ANALYTICS_BUILDERAI_BUILDER 默认没有这些 BI 编辑权限。
BI 只读扩展BUSINESS_AREA_VIEW、INDICATOR_VIEW、INDICATOR_MARTKET_VIEWSUPER_ADMIN、ADMIN、TRIAL、ANALYTICS_BUILDER、VIEWERVIEWER 默认可以查看这些 BI 区域，但不能编辑。

​
默认角色

roleName默认可用范围
SUPER_ADMIN全量平台、AI、BI 管理权限；包含超级管理员专属能力和危险删除能力。
ADMIN大部分平台、AI、BI 管理权限；不含超级管理员专属能力和危险删除能力。
TRIALAI 全量权限，BI 建模/故事/指标等构建权限，大部分平台管理权限；部分操作仍会被单独限制。
AI_BUILDERAI 构建能力；平台侧可查看/编辑集成、查看组织用户和邀请；BI 侧主要为模型和故事查看。
ANALYTICS_BUILDERBI 构建能力；AI 侧可进入聊天和 Xpert 构建，不含 Copilot/知识库编辑。
VIEWER查看型角色；可进入聊天，查看部分 BI 内容，平台侧主要为个人资料和组织切换。