组织架构

01 功能介绍：组织目录与业务权限分开看

从「平台管理 → 系统设置 → 组织架构」进入，也可直接打开组织架构。左侧按飞书授权范围显示部门层级，右侧查询该范围内的员工，点击姓名查看「员工资料」。

部门名称、上下级、员工组织归属及岗位等工作资料在飞书维护，再由员工同步流程读取。本页没有新增、重命名、移动、删除或启停部门的按钮，也不提供直接编辑员工姓名、工号或岗位的表单。

以下对象要分别核对：

• 组织部门：飞书组织关系，一个员工可以属于多个部门。
• Tower 账号：登录系统使用；有员工资料不代表已经开通或关联账号。
• 业务团队：在团队管理维护，与组织部门相互独立。
• 角色与数据权限：决定功能和业务数据访问，参见账号权限与数据可见范围。不能仅凭员工进入某部门就认定已获业务权限。

02 使用前：确认租户、同步范围与时间

开始前确认当前租户和目标人员；查看组织需要员工读取权限。若出现「尚未配置本租户的飞书同步来源」，请管理员检查应用及来源配置。出现「当前配置尚无完整组织结果」时，不能把空列表解释为公司没有部门或人员。

顶部时间表示最近一次有效组织结果的同步时间，不是当前打开页面的时间。同步范围或应用改变后，旧结果不能直接作为新配置的组织目录；需要当前配置完成组织同步后才显示相应结果。

如果提示「本次组织同步未完成，显示上次有效结果」，当前树和人员归属仍可能来自上次有效组织关系。先记录提示与时间，再处理原因，不以“还能看到人员”判定最新同步成功。员工工作资料可能已先更新，因此列表「资料更新时间」与顶部组织时间不一定相同。

03 部门树：展开、搜索与选择

1. 默认选择「全部人员」，部门树初始展开。点部门前的「收起/展开」箭头只改变树的显示，不改变右侧人员范围。
2. 在「搜索部门」输入名称片段，树即时保留匹配部门及其祖先。搜索期间会展开匹配路径，便于看到原来折叠的下级。
3. 点击部门名称后，右侧标题变为该部门，人员列表回到第 1 页，已经打开的员工详情关闭。
4. 找不到目标时，先清空部门搜索并展开层级。仅输入树搜索不会自动选择部门，也不会清除右侧人员搜索。
5. 要查询整个同步范围，点击「全部人员」。若切换后仍缺人，继续检查右侧已提交的搜索条件。

选择的部门若提示「上级部门信息未获取，当前展示已授权的组织范围」，表示上级不可用，不应凭当前树推断完整公司层级，也不能把根部显示的位置当作公司最高部门。

04 查询定位：姓名、工号与分页

1. 先选择「全部人员」或具体部门，再确定是否勾选「包含下级」。默认勾选；在「全部人员」时该选项禁用。
2. 在「姓名 / 工号」输入关键词，点「搜索」或按回车。输入本身不立即查询；搜索作用于当前部门和下级范围，匹配姓名或工号的一部分，不搜索岗位、部门名、邮箱或账号。
3. 核对人员姓名下方的工号、部门和直属上级，避免仅凭同名认定同一人。
4. 底部分页每页 30 人，使用「上一页」「下一页」。列表按姓名及员工标识排列，本页没有切换排序或每页条数的控件。
5. 清除人员搜索时，删掉输入后再次点「搜索」。树搜索和人员搜索独立；点击「刷新」不会替你重置搜索、部门或页码。

切换部门、提交搜索或勾选/取消「包含下级」会回到第 1 页；选部门时会保留已提交的人员关键词。查询失败显示错误和「人数读取失败」，不是 0 人；加载中显示「读取人员中…」。若只看到「没有匹配的人员」，先放宽自己的查询条件，再检查同步范围。

05 人员范围与人数：按人去重，不加部门小计

底部「同步范围内共 N 人（去重）」是当前部门、包含下级和已提交关键词共同限定的全部匹配人数，不是当前一页行数。部门树没有单独展示部门人数。

• 取消「包含下级」：只取直接属于所选部门的人。
• 勾选「包含下级」：取所选部门与当前组织结果中全部后代部门的人员并集。
• 同一个人同时属于父部门和子部门，或两个兄弟部门，在一次查询中仍只计一人；在两个部门分别查询都能看到他属于正常情况，不能把各部门查得的人数直接相加。
• 「全部人员」按当前有效组织结果中的员工计数，没有部门归属的人也可能在这里出现；因此按部门累计既可能重复，也可能漏掉无部门人员。
• 人数不是 Tower 账号数、公司全员数或在职人数。本页没有“仅在职”筛选；应结合「飞书状态」阅读，未关联账号的人也可显示。

去重依赖员工身份，不是姓名或工号文本。组织范围限定在当前租户、飞书应用和有效组织结果内，不能把其他租户或旧同步范围的人员一并计算。

06 查看员工详情与账号关系

点击人员姓名打开「员工资料」，依次核对姓名、工号、部门、岗位、直属上级、飞书状态、状态确认时间和资料更新时间。部门可以显示多个；「未提供」代表未取得相应字段，直属上级「尚未同步」也不等于此人没有上级。

「状态已核实」说明状态确认结果；「状态未确认」表示本次未取得明确受雇状态，详情会提示检查飞书“获取用户受雇信息”权限。保留的最后确认信息不能当作新一轮确认。不要把飞书状态、Tower 账号状态与是否关联混为一谈。

具有账号读取权限时，详情可显示 Tower 账号、账号状态和「账号管理」链接；无此权限时，这些信息被隐藏，不应理解为员工必然未关联。进入用户管理再核对账号维护能力。

如同时具备员工关联和账号读取权限，详情中可出现「关联已有账号」：搜索账号、选择并核实归属后点「关联」；已有关系时有「解除关联」。这会改变账号对应关系，并非修改飞书部门或绑定飞书登录。提交前需核对账号没有关联其他员工及飞书身份不冲突；提示「关联已变化」时刷新后重新核对，不要覆盖别人的最新关联。本页没有直接“开通账号”的入口。关联与解除关联未演示。

「业务团队」还需要团队读取权限，显示的是关联账号的团队；未关联账号、未分配团队与团队读取失败是不同情况，应去团队管理处理，不能修改部门来替代。

07 从其他页面定位同一员工

用户管理的员工资料提供「组织架构」入口时，使用该链接可按员工标识进入本页。带员工定位信息的链接会重新读取当前组织范围，选中返回的第一个所属部门，清空人员搜索、回到第 1 页并打开该员工详情；没有所属部门时回到「全部人员」。这不是依据同名部门或员工姓名猜测位置，也不保证多部门员工被选中的是业务上的“主部门”。

定位完成或失败后，地址中的一次性员工定位参数会被消费。若提示「该员工不在当前组织同步范围内」，先查租户、当前同步范围与同步状态；不能依据员工旧资料中的部门名称强行定位。等待定位时手动改选部门，会取消待处理定位，避免迟到的结果把页面切回。

本页详情的「账号管理」链接同样按员工标识进入用户管理。团队管理与组织目录仍是两个页面；不能假定所有团队行都存在组织跳转入口。只有实际提供相应员工链接的入口才能定位，查找团队成员应先确认其关联员工身份。

08 刷新与飞书同步：先看任务，再核对目录

「刷新」重新读取已保存的组织和人员列表，同时关闭员工详情；它不发起飞书请求，也不修改来源范围。

有相应权限时点击「飞书同步」打开「飞书人员同步」，先看是否就绪及「最近同步」：

1. 「立即同步」要求本租户来源启用、应用匹配、同步服务在线，并具有发起同步权限。存在排队或运行中的任务时按钮不可用；看到按钮不表示一定有执行权限。
2. 真实环境点击后，「同步已排队，结果会自动更新」只说明请求已接受；「已有同步任务正在处理」表示复用当前任务，不是完成。面板打开时会定期读取状态。
3. 查看最近任务的「排队中」「同步中」「已完成」「部分完成」「失败」「已取消」及错误提示；核对资料更新、状态未确认、自动关联人数，不能把它们相加当作组织总人数。
4. 关闭面板会刷新本页，再核对顶部组织时间、状态提示、目标部门和人员。任务状态与组织可用结果要同时核对，尤其是部分完成时。

源配置管理还需要单独权限。「读取范围」读取飞书授权候选；保存范围不是本页树筛选，会改变租户实际同步范围。配置变化时旧任务可被取消，旧组织结果在新配置完整同步前不显示。出现配置版本冲突时先重新读取，不反复保存旧表单。

组织不完整、上下级关系异常或来源授权变化时，先处理明确错误；保留上次结果不代表本次成功。同步服务未就绪应交管理员核对服务；飞书权限不足应核对通讯录与受雇信息权限。同步只创建/更新员工资料，不会因此创建新登录账号；存在已验证飞书登录身份时可能关联既有账号，不能靠姓名匹配认定。发起同步、读取外部范围、保存配置均未演示。

09 权限与状态边界

• 组织和人员读取：需要 employees:read。只有 teams:read 或 users:read 不能替代；缺权限显示「暂无组织资料查看权限」。
• 账号信息及同步面板读取：在员工读取基础上另需 users:read；账号字段还受服务端访问结果控制。
• 账号关联/解除：另需 employees:link，并校验当前租户、预期旧关联和身份冲突。
• 发起同步：在员工、账号读取基础上另需 employees:sync；来源与服务就绪条件也必须满足。
• 来源候选及配置：另需 employees:sync_manage。管理范围权限与发起同步权限不是同一个权限。
• 业务团队查看：需要 users:read 与 teams:read 及可读取的账号关系；团队维护和角色分配另在各自页面进行。

本页没有组织导入、导出或批量编辑入口。同步人员范围是来源授权边界，不等同于业务视图授权；组织同步不会自动完成角色分配或团队分配，也不代表用户已经能看某一业务数据。

10 核对结果：时间、身份、范围三项一致

1. 记录租户、部门、包含下级和人员搜索条件，再看顶部有效组织时间及状态提示。
2. 选一名多部门员工，在「全部人员」只计一次；分别查所属部门时可能重复出现，不相加。
3. 对照工号、员工详情中的部门与直属上级，再分别核对账号和业务团队。未关联不代表组织资料不存在。
4. 同步后重新读取并检查目标员工；若只更新资料时间而组织仍提示旧结果，继续处理组织同步问题。
5. 人员缺失时核对当前来源是否包含该部门或直接授权人员，不能依据飞书公司总人数判断本页同步一定遗漏。

11 常见异常处理

• 部门或人员找不到：分别清部门搜索、清人员输入并提交，选全部人员；再检查租户、来源范围和有效组织结果。未配置、尚未完整同步与真正空结果分开处理。
• 部门人数之和大于总人数：先查多部门归属。用员工身份去重，不按部门列表简单累加。
• 总数大于当前页：每页 30 人，总数是全部匹配人数；继续翻页。读取失败时不记录为 0 人。
• 找得到员工但没有账号信息：先查账号读取权限，再判断是否未关联；不要直接新建重复账号。
• 同步失败仍有资料：看是否显示上次有效结果；记录错误和时间交管理员，处理后再同步并核对。当前目录可读不等于来源最新。
• 已改飞书但页面不变：刷新只读本地结果，查看任务是否真正执行以及范围是否覆盖目标；不要把刷新当同步。
• 账号或团队访问无权限：由管理员核对各自权限；扩大飞书范围或更换部门不能替代角色和数据授权。

12 常见问题