工作区

用途与权限

切换租户数据范围，查看当前工作区成员，并由所有者或管理员添加成员、调整角色或移除成员。工作区品牌设置属于企业版能力；社区版以成员和数据隔离操作为主。

入口

左侧菜单“系统设置 → 工作区”，路由为 /settings/workspaces。

页面总览

页面由当前工作区选择器、工作区信息、成员列表组成；企业版还会显示工作区品牌设置。

主要操作

1. 在“当前工作区”下拉框中选择工作区，确认提示后再操作其他模块。
2. 所有者或管理员点击“添加成员”，输入已存在的用户 ID，选择管理员、成员或只读角色。
3. 在成员列表调整角色或移除不再参与的成员。
4. 企业版可填写工作区品牌文字、Logo、版权文案与链接并保存。

字段/限制

• 角色：owner、admin、member、viewer；添加成员时不能直接指定 owner。
• 只有当前工作区的所有者或管理员可以管理成员。
• 用户必须先在系统用户管理中存在，添加成员使用用户 ID。
• 当前选择保存在 dwz.workspace_id，并通过 X-Workspace-Id 请求头传递。
• 工作区品牌及 Logo 上传为企业版接口，社区版不应依赖该能力。

常见错误

• 添加成员失败：核对用户 ID、当前工作区权限及用户是否已是成员。
• 无法调整角色：当前用户可能不是所有者/管理员，或目标成员为所有者。
• 切换后列表为空：目标工作区确实可能尚无业务数据。
• 品牌设置不可用：检查当前发行版是否包含企业版能力。

关联 API

• GET|POST /api/v1/workspaces
• PUT /api/v1/workspaces/current
• GET|POST /api/v1/workspaces/current/members
• PUT|DELETE /api/v1/workspaces/current/members/{user_id}
• GET|PUT /api/v1/ee/branding/workspace（企业版）