团队管理

01 功能介绍：团队、部门、账号与负责人不是一回事

入口为 平台管理 → 系统设置 → 团队管理。左侧是团队资料，右侧是来自 Listing 的负责人映射；“分配成员”用于调整系统账号的业务团队归属。

• 业务团队是本系统的业务归属对象，有独立编码、名称和启停状态。
• 飞书部门与员工属于组织和人员资料。同步部门、关联员工与分配业务团队是不同操作，不能把部门人数当团队人数，见组织架构。
• 登录账号是本页分配成员所选对象；员工资料没有对应账号时，不会仅凭员工姓名出现在成员候选中，见用户管理。
• 业务负责人来自业务数据里的负责人名称，并通过负责人记录关联团队、绑定用户。姓名相同不代表同一个登录账号，应核对用户名与租户。

分配团队不会在这里自动给账号分配角色，也不会授予全部视图或所有业务数据权限。功能权限和视图授权分别见角色管理、账号权限与数据范围。

02 使用前确认：租户、权限与已有关系

普通账号读取需要团队读取权限（teams:read），创建、编辑、删除、分配和映射维护需要团队维护权限（teams:write）。只读账号可以看列表，但维护按钮不可用。

1. 确认当前租户、目标团队编码，以及要调整的账号用户名。
2. 核对该账号当前团队和负责人绑定；不能只凭显示姓名操作。
3. 明确要改变的是账号归属、团队负责人池，还是负责人对应的登录账号。
4. 检查现有按团队配置的知识库访问范围和业务筛选，先确认调整影响。

超级管理员会看到“团队配置租户”，团队与负责人池随所选租户变化；成员候选仍限制为目标租户的启用账号。跨租户管理接口还校验超级管理员身份，普通维护权限不代表可管理其他租户。

03 查询定位：一个关键词分别过滤两张列表

1. 在 搜索团队、负责人或用户 输入关键词，列表即时过滤，不需要点击查询。
2. 左侧匹配团队名称、编码和状态值；状态值为 active／inactive，当前没有独立状态下拉筛选。右侧匹配负责人、团队编码／名称、用户名、显示姓名等信息。
3. 核对“当前结果：团队… · 负责人…”；有关键词时标题数量显示命中数／总数，两张列表独立匹配，不是联动下钻。
4. 点击输入框右侧“清空搜索”恢复列表。右上刷新图标重新加载团队、账号与负责人资料，不是飞书同步或外部 Listing 拉取。

主列表搜索忽略英文大小写及首尾空格。当前没有分页、日期筛选、导出、员工导入或点击人数展开名单的入口。搜索无匹配时也可能显示“暂无团队数据”，先清空搜索再判断是否真的没有团队。

04 阅读列表：成员数与 Listing 条数分开看

团队行展示名称、更新时间、编码、启用／停用状态、成员数及操作菜单。成员数按本次加载账号的当前团队归属计数，包含停用账号；不是员工人数、负责人数量或在线人数。分配面板只展示启用账号，因此人数可能与可勾选成员数不同。

负责人区显示负责人名称、Listing 条数、所属团队、绑定用户及“绑定用户”入口。“来源批次”是已读取的最新 Listing 周次，不是团队更新时间或成员调整时间。来源会排除删除标记为 1 的 Listing 及空负责人名称，负责人名称去首尾空格、忽略大小写后分组，条数按该周来源记录计数，不是去重后的商品数量。

读取负责人列表时会依据已有最新来源补齐本地负责人池，但不会在这里发起外部采集。最新周没有可用负责人时，列表可能为空；旧负责人不在本周来源中，不等于相关账号或旧映射已经删除。

05 团队资料：新建、编辑与删除的边界

1. 点击“新建团队”，或在目标行操作菜单选择“编辑团队”。
2. 填写非空“团队编码”“团队名称”，选择“启用”或“停用”。编码最长 50 字符、名称最长 100 字符；同租户团队编码不能重复，不要靠改名区分错误的团队对象。
3. 点击“保存”，等待“提交中...”结束；成功后抽屉关闭，页面重新加载，并提示“团队创建成功”或“团队更新成功”。
4. 失败时检查错误及编码，修正后再提交。关闭抽屉不等于保存，再次打开按已有记录核对；没有专门的未保存离开确认。

停用团队不再出现在“分配成员”的目标团队中，但不会因此自动清空旧成员或负责人映射，也不能当作账号禁用。普通资料编辑可调整编码、名称与状态。

删除团队（未演示）：行菜单提供“删除团队”，当前没有额外的删除确认步骤，不要用点击删除来试探。实现会清除该团队负责人归属及账号旧团队字段，再删除团队、刷新当前映射；没有“只有空团队才能删除”的页面限制。它不是删除用户或员工。其他引用或服务异常仍可能使请求失败，应核查结果；不能凭菜单可点就保证任意被引用团队都能删除。

06 成员管理：按账号选择当前归属

1. 点击右上 分配成员，打开“分配团队成员”。
2. 在“搜索账号、姓名、当前团队”输入关键词。这里按输入原文匹配，英文大小写和空格会影响结果，与主列表搜索规则不同。
3. 对照“显示姓名 · @用户名”和当前团队勾选账号；同名人员必须按用户名区分。
4. 在“目标团队”选择同租户的启用团队，再核对“分配（人数）”。没有选人或目标团队时不能提交。

候选只包括目标租户启用账号；停用账号、其他租户人员不会出现在这里。搜索只是隐藏不匹配项，不会清除已勾选人员，提交人数可能大于当前可见勾选数。单人也使用同一分配入口；当前没有“移出团队设为空”的选择，空选项不能提交。

本页对每个账号显示一个当前团队，分配是变更该归属，不是给账号追加多个团队。后端通过业务负责人关联团队，并兼容旧账号团队字段；部分下游还会合并读取旧字段，不能据此宣称全系统历史数据永远只认一个团队。

07 批量分配：逐人确认，部分成功不回滚整批

1. 清空搜索复核所有勾选人员及目标团队，避免隐藏选项被一起提交。
2. 点击“分配（人数）”，提交期间显示“保存中…”，选择控件禁用，不能关闭分配抽屉。
3. 等待逐人结果。页面显示“已成功 X 人，未完成 Y 人”，列出未完成账号及错误。
4. 成功人员取消勾选，失败人员保留勾选。先刷新核对实际归属，再按剩余人员重试；不要把部分失败当作整批未执行。
5. 重新打开分配面板查看账号当前团队，并对照团队成员数；关闭再打开会重置本次选择和结果面板。

分配按账号分别请求，每批最多同时处理 5 人，不是一个整批原子操作。同一账号在选择中不会重复加入。请求未确认时，实际结果仍需重新读取，不能直接断言成功或失败。

请求会沿用账号已有负责人名称；缺失时依次使用显示姓名、用户名。后端按租户内负责人名称关联或创建记录，名称冲突可能导致某个人分配失败。同名人员要先核对负责人身份，不能通过反复提交假定系统会按姓名自动区分。

08 负责人映射：替换清单与绑定用户分两步

1. 在目标团队行操作菜单选择“映射负责人”，核对“当前团队”。
2. 勾选该团队需要的完整负责人池，包括原先仍需保留的人。
3. 点击“保存映射”后，成功会提示“团队负责人映射更新成功”，再重新读取核对。

这是替换当前团队全部负责人映射，不是追加所选项。未勾选的原负责人会移除团队归属；选择已属其他团队的负责人会改变其归属，不是新增第二个团队。空清单可清空该团队映射。当前候选来自已加载的最新来源，旧映射没有出现在候选时，保存完整清单尤其需要谨慎。

绑定用户（未演示）：右侧负责人必须先有团队，才能点击“绑定用户”。在“绑定负责人用户”中选择“目标用户”，核对 @用户名后提交。一个负责人已被另一账号绑定时会冲突；给某账号换绑负责人可能改变其旧关联，不能理解成追加身份。当前没有取消绑定选项，列表“-”只说明该字段未展示有效关联。

绑定用户候选与分配成员的启用过滤不同，不能用“能被选到”判断账号当前可登录。保存后应同时核查负责人所属团队、绑定账号及账号最终团队，不只看成功提示。

09 权限与状态边界：空白和旧数据不能当作正常结果

团队、账号、负责人三类数据分别加载。某个来源失败时，其他成功部分仍可展示；失败部分可能保留上次结果。因此先看错误提示，再判断人数和绑定关系，不能把局部旧数据显示成全部最新。

• 无权限时先检查团队读取／维护权限及租户，不用其他系统设置权限代替。
• 找不到成员先查租户、账号启用状态、搜索条件与是否真正有登录账号；员工或飞书部门资料不能替代。
• 成员数为 0 可能是真实空团队，也可能是账号来源未加载成功；须结合请求错误与刷新结果判断。
• 团队存在但无法分配，检查是否停用、目标租户是否匹配、人员是否仍有效，以及负责人名称冲突。
• 保存失败时查看提示与错误码，核对名称重复、对象删除或服务异常。成功提示与刷新错误同时出现时，写请求已返回成功但列表读取未完整完成，需重新读取核对，勿重复创建。

页面不提供角色分配、视图授权、外部组织同步或导出入口。业务状态限制与功能权限要分别核查。

10 保存后核对：下游按各自规则消费

1. 重新读取本页，按团队编码核对成员、负责人及绑定用户，确认来源批次和错误状态。
2. 对代表账号核对按团队配置的知识库访问；现有消费会读取账号旧团队字段及负责人团队，取并集，并与文档可见范围等条件共同判断。正常分配会清理旧账号团队字段，但历史遗留关系仍需核查。
3. 对照利润报表的月份、团队和负责人筛选。该看板团队条件使用当前负责人—团队映射及启用团队，匹配利润事实中的负责人名称，不是按团队成员人数汇总。
4. 若旧月份筛选结果变化，先对照当前映射与事实负责人，不能假定旧月份使用历史团队快照，也不能说维护团队已重算历史利润。

团队维护会刷新当前负责人—团队映射，但这不等于自动重建所有下游报表、同步部门、增加角色或开放全部数据。以上为已核对的代表性路径，其他模块需按自己的范围和版本解释。

11 常见异常：先辨别身份、来源与部分完成

同名人员：核对用户名、租户、已有负责人名称，不按显示姓名直接合并。负责人名称按去空格、忽略大小写匹配，不能假定每个同名员工都有独立负责人记录。

人数不一致：团队成员数包含停用账号，分配候选只含启用账号；右侧 Listing 条数和负责人数量是另外两种粒度。先清空搜索，再排除来源加载失败。

批量分配失败：逐个读取“未完成”错误，核对成功人员实际归属；对请求未确认的人员先刷新再重试，不要重新提交全部成员。

负责人不在列表：检查“来源批次”是否有数据、最新来源是否存在该名称、来源是否删除或名称为空；不要直接删除团队尝试修复。

团队筛选与报表不一致：对齐当前映射、团队启用状态、报表月份和事实负责人名称，再查业务权限与视图过滤；团队人数不是销售或利润指标的分母。

12 常见问题