团队多级组织架构划分

在企业引入大模型网关的过程中，随着接入的业务系统、开发团队和调用凭据逐渐增多，理清各个团队的组织归属是精细化管理的基础。如果缺乏统一的组织架构映射，调用凭证和使用记录往往难以追溯到具体的责任部门。

OmniCortex 提供了支持多级树状关系的团队组织架构管理功能。系统支持根据企业真实的部门架构搭建各级组织树，集中维护部门人员名册、标记部门业务负责人，并将虚拟密钥（Virtual Key）与所属部门明确绑定，实现调用凭据的清晰归属与按部门统计归集。

---

核心机制与业务场景

1. 多层级组织架构与可视化调整

企业内部通常有“公司 ➔ 事业部 ➔ 研发中心 ➔ 项目组”等多层级结构。OmniCortex 支持树状组织架构的灵活配置：

• 按需搭建层级架构：支持自由创建顶级根部门与各层级子部门，同级部门之间可通过排序权重自定义前后显示顺序，还原企业真实的部门树；
• 拖拽式快速调整归属：当面临部门拆分、合并或架构重组时，管理员无需逐个重新配置。在左侧组织架构树上长按拖拽目标部门至新的上级部门，经弹窗确认后即可完成迁移，下属部门与关联资产自动跟随调整。

2. 部门人员维护与负责人标记

系统支持按部门维护成员名单，建立人员与部门的清晰归属：

• 部门成员统一管理：支持在部门内检索并添加企业员工，集中查看成员的姓名、账号、邮箱及启用状态；
• 标注业务负责人：支持在部门内一键将某位成员标注为“负责人（Leader）”，方便在组织架构中直观展示该业务线的对接人；
• 成员个人凭据查阅：在成员列表可快捷查看该成员名下创建的个人测试密钥，人员调岗或离职时便于快速盘点与交接。

⚠️ 重要说明：负责人不附带数据隔离特权

在当前版本中，团队架构主要承担组织关系映射、人员名单维护与资产归属标记的功能。

• 设置“团队负责人”仅用于在组织架构中展示业务联络人，不赋予任何额外的数据行级查看特权或审批权限；
• 系统中所有管理员的页面访问与接口操作权限，均严格受全局角色（RBAC）管控，尚未支持“各部门负责人仅能查看本部门数据”的行级数据隔离能力。

3. 虚拟密钥归属与部门用量统计

虚拟密钥（Virtual Key）是业务系统接入大模型的主要凭证。系统建立了密钥与部门的明确关联：

• 业务密钥绑定所属部门：创建虚拟密钥时可直接选择所属团队，明确每套凭据由哪个部门负责，便于日常管理与追踪；
• 按部门统计调用量：系统在记录大模型调用日志时会自动关联团队信息，便于后续按部门汇总请求次数与 Token 消耗，为各业务线的大模型使用分析提供依据。

4. 组织架构与资产归属流向

🏢

多级组织架构与资产归属流程

架构梳理 ➔ 人员归属 ➔ 密钥绑定 ➔ 用量归集

层级树状架构 · 权责归属清晰

1. 搭建多级部门架构

集团总部 ➔ 智能创新事业部 ➔ 研发一组 / 智能客服组（支持随时拖拽调整上级）

↓

2. 维护部门成员与负责人

添加部门直属成员 ➔ 标注团队业务负责人 ➔ 便于跨团队沟通与离职交接

↓

3. 业务密钥绑定所属团队

创建虚拟密钥时指定所属部门 ➔ 明确调用凭证的使用方与责任人

↓

4. 按部门统计调用量

调用日志自动关联团队信息 ➔ 清晰呈现各部门调用规模与 Token 消耗

---

企业控制台配置导览

管理入口：「系统管理」➔「团队管理」

1. 工作区布局与组织架构树维护

进入团队管理模块后，系统呈现左右分栏的双面板工作区：

• 左侧组织树工作区：以树形结构呈现企业各级部门，支持按名称实时搜索、一键全部展开/折叠，以及快速新建顶级部门；
• 右侧团队详情与直属成员区：根据左侧选中的组织节点，动态展示该部门的负责人姓名、成员总数、关联虚拟密钥数及直属成员列表。

📸 截图替换指引（图 1：多级团队组织架构管理全景工作区）

• 需截图内容：登录控制台，点击左侧导航栏「系统管理」➔「团队管理」（/system/teams），左侧树形组织展开至少两级，右侧展示选定部门的直属成员列表。
• 关键画面要素：
  1. 顶部紧凑型 Hero 标题栏（包含「团队组织架构」标题与 TEAMS & ORG 徽标）；
  2. 左侧树面板：搜索输入框、展开/折叠按钮、「新建组织」按钮、多级缩进的部门树节点，且高亮选中的目标团队；
  3. 右侧详情面板：顶部展示选中团队名称、负责人姓名，右侧包含「添加成员」与「查看团队密钥」主操作按钮，下方展示直属成员表格（包含成员姓名、用户名、邮箱、状态标签及操作列）。
• 推荐保存路径：
  • 中文版：Documentation/docs/public/images/teams/zh/teams-workbench-overview.png
  • 英文版：Documentation/docs/public/images/teams/en/teams-workbench-overview.png

2. 部门组织新建与上级调整

在左侧组织树面板中，点击顶部「新建组织」可创建顶级部门；将鼠标悬停在特定部门节点上，点击右侧出现的「+」图标，可快速创建归属于该部门的子部门。系统将弹出配置窗口：

📸 截图替换指引（图 2：新建组织/子部门配置弹窗）

• 需截图内容：点击左侧树节点悬停操作栏「+」弹出的「新建子部门」配置模态框。
• 关键画面要素：
  1. 弹窗标题显示「新建子部门」（编辑时显示「编辑部门」）；
  2. 上级组织回显条目（如“上级组织：智能创新中心”）；
  3. 表单包含「组织名称」输入框与「排序权重」数字步进器；
  4. 底部包含取消与保存提交按钮。
• 推荐保存路径：
  • 中文版：Documentation/docs/public/images/teams/zh/team-form-modal.png
  • 英文版：Documentation/docs/public/images/teams/en/team-form-modal.png

核心配置项说明

配置项	界面说明	填写方式	是否必填	配置说明
组织名称	部门名称	文本输入（1 ~ 128 字符）	是	部门在系统中的业务展示名称，将在组织树、密钥归属以及调用日志中清晰呈现。
排序权重	显示顺序	数字步进器（默认 0）	否	用于控制同级部门在组织树中的显示先后，数值越小越靠前显示。
上级组织	上级归属	弹窗中自动显示	否	标识该部门的上级所属部门；创建顶级部门时无需指定。

3. 部门成员管理与负责人设置

在右侧详情面板中，管理员可以集中管理该部门的人员名册：

• 添加成员：点击右上角「添加成员」按钮，在弹窗中按姓名或用户名搜索员工，勾选后即可批量加入当前部门；
• 标注负责人：在成员列表操作列点击「设为负责人」，该成员将显示负责人徽标。注意：此标注仅供展示与业务联系，不具有额外系统管理权限；
• 移出部门：在操作列点击「移出团队」，确认后将该成员从当前部门移除（不会删除该员工的系统登录账号）。

4. 团队密钥资产快捷查阅

点击右侧面板右上角的「查看团队密钥」按钮，可快速拉出抽屉查看归属于该部门的所有虚拟密钥：

📸 截图替换指引（图 3：团队虚拟凭据资产穿透看板抽屉）

• 需截图内容：点击右侧面板右上角「查看团队密钥」滑出的抽屉全景。
• 关键画面要素：
  1. 抽屉标题「团队密钥资产」及归属部门名称回显；
  2. 归属该团队的 Virtual Key 卡片列表（包含 Key 名称、脱敏凭据如 sk-xxxxxxxx...、关联策略集名称、激活状态徽标）；
  3. 卡片上的跳转操作链接，便于直达虚拟密钥详情页。
• 推荐保存路径：
  • 中文版：Documentation/docs/public/images/teams/zh/team-virtual-keys-drawer.png
  • 英文版：Documentation/docs/public/images/teams/en/team-virtual-keys-drawer.png

---

常见问题与排查指南

异常现象 / 错误提示	常见原因	解决方法
删除部门提示报错 Cannot delete team with sub-teams	该部门下仍包含未删除的子部门。系统为避免下级部门成为孤立节点而进行了安全保护。	请先将下级子部门逐一删除，或者通过拖拽将其转移到其他部门名下，清空后再删除当前部门。
删除部门提示报错 Cannot delete team with active members	该部门名下仍关联有在册员工。	在右侧成员列表中将所有直属成员逐一点击「移出团队」，名册清空后即可顺利删除部门。
调整上级失败 Invalid target parent: circular hierarchy	试图将某个部门移动到它自己的子部门或下属层级之下，会造成层级循环冲突。	上级调整只支持平级迁移或移至其他正常分支下，不能将上级部门拖入其自身的下属分支中。
添加成员时搜索不到员工	目标员工尚未在「用户管理」中创建账号，或者账号已被置为「停用」状态。	前往「系统管理」➔「用户管理」核实该员工账号是否存在且状态为「正常」。