dootask/resources/ai-kb/zh/howto/org-department/sync.md

id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified

id	title	type	feature	scope	locale	aliases	related_tools	related_pages	prerequisites	negative	last_verified
org-department.sync.howto	同步部门成员	howto	org-department	admin	zh	同步部门 同步部门成员 部门成员同步 把子部门成员同步到上级 父部门看到子部门成员 部门成员归集			需要系统管理员权限（userIsAdmin） 目标部门下有子部门	同步是"子部门成员合并到当前部门"，**不是**反向（不会把当前部门成员推到子部门） 同步是单向、追加：只新增 `users.department` 里没有该部门 ID 的用户，已在的不重复加 已 disable_at 的用户被跳过，不会同步进部门或部门群 没有子部门时返回成功但不做事，提示「同步完成，子部门中没有成员需要同步」 同步与 LDAP 拉取无关：DooTask 内部不直接通过此接口对接 LDAP	v1.7.90

同步部门成员

是什么

"同步部门成员"是把所有子部门（递归）的成员合并到当前部门的一键操作。常用于：父部门负责人希望看到/管理下属部门的全部成员，但不想手动逐个调整 users.department。

入口

• 桌面端：管理后台 → 团队管理 → 某部门行尾「⋯」→ 「同步部门成员」
• 接口：GET api/users/department/sync，参数 id（要同步的目标部门 id）

操作步骤

1. 选中目标父部门
2. 点击「⋯」→「同步部门成员」
3. 提交，弹出结果提示：
   • 同步完成，共同步 N 个成员
   • 若部分人员已在当前部门：其中 M 个成员已在当前部门

返回字段

字段	含义
synced_count	本次新加入该部门的人数
already_in_dept_count	已在该部门、跳过的人数
sub_department_ids	所有递归子部门 ID 列表

副作用

• 子部门成员的 users.department 追加目标部门 ID
• 部门群（dialog_id）会自动 joinGroup 把"在部门但不在群"的人补齐
• 全程事务：失败回滚

不支持

• 不支持"反向同步"（把父部门成员推下去）
• 不支持"仅预览不写入"

相关

• 部门概念：org-department.concept
• 删除部门会自动移出成员：org-department.delete.howto