同步日志
每次点 同步钉钉信息，系统都会在这里留下一行：什么时候开始、同步了多少条、其中新增几条、更新几条、成功还是失败。它只管组织架构（部门与用户），审批模板的同步记录不在此处。
这一页同样是只读台账，没有新增、修改、删除入口。它的价值在于回答两个问题：通讯录到底有没有同步下来，以及同步之后为什么还缺人。
功能路径：系统 → 第三方平台 → 同步日志
一、功能概述
1. 核心用途
- 留痕：每次组织同步的时间与数量都有据可查；
- 定位失败：同步失败或只成功一半时，从这里看数量分布；
- 判断新鲜度：平台侧刚加的人没出现，先看最近一次同步是什么时候。
2. 整体结构
标准列表页：顶部四个筛选器（开始时间、平台类型、同步类型、同步状态）与搜索框，表头右上显示 8 个中 0 个被选 一类的计数，列表按开始时间倒序。
二、界面布局说明
| 列 | 含义 |
|---|---|
| 平台类型 | 平台代码，钉钉为 dingtalk |
| 同步类型 | 全量同步 / 增量同步 / 手动同步 |
| 同步状态 | 成功 / 失败 / 部分成功 |
| 同步数量 | 本次从平台取回的记录总数 |
| 新增数量 | 其中第一次出现、新建了映射行的数量 |
| 更新数量 | 已存在、只刷新了姓名/手机号/职位的数量 |
| 开始时间 | 本次同步的发起时间 |
失败数量与错误原因不在列表列里。要看失败明细，点进该行的详情，或直接去 用户绑定 右侧的 同步日志 面板——那里显示最近 5 次，行文案为 同步n | 新增n | 更新n | 失败n，比本页更常用。
三、业务操作步骤
步骤 1：确认最近一次同步
按开始时间筛选器圈定时间段，看有没有对应记录。完全没有记录说明同步按钮点了但没落库（多为凭证或权限问题），有记录但时间很早说明期间新加的人根本没被同步进来。
步骤 2：读数量关系
一条正常的增量同步应当满足 同步数量 = 新增数量 + 更新数量。看两个典型形态：
| 形态 | 含义 |
|---|---|
同步37 新增0 更新37 | 例行同步，通讯录没变化，只刷新了既有资料 |
同步37 新增37 更新0 | 首次同步，37 个人全部新建映射行，接下来都要去绑定 |
同步0 新增0 更新0 且状态 失败 | 接口调用失败，去查详情里的错误信息 |
步骤 3：处理部分成功
状态为 部分成功 意味着有记录取回来了但其中若干条失败（常见于个别人资料接口调用超时）。这类记录不会中断整体流程，只要缺的那几个人不影响业务，可以等到下次同步自动补齐；急着用时对相关人员做一次手工绑定。
步骤 4：同步完接着去绑定
同步只是把人搬进来，不会自动建立对应关系。每次新增之后都要回 用户绑定 点一次 自动绑定，否则新员工提交审批仍会被拦。
四、字段详细说明
| 字段 | 含义 |
|---|---|
| 同步类型 | 钉钉走的是 增量同步；企业微信的记录写成 手动同步。全量同步 是保留枚举，日常操作不会产生 |
| 同步状态 | 建行时先记 部分成功，结束时若失败数为 0 才升为 成功；抛异常则记 失败 并写错误信息 |
| 同步数量 | 平台侧返回的记录数，不等于 ERP 里最终的映射行数 |
| 新增数量 | 新建映射行的人，这些人在绑定页全部处于「待绑定」 |
| 更新数量 | 已有映射行被刷新资料的人，已建立的绑定关系不会被清除 |
五、典型使用场景
新人提不了审批。 报错 当前用户未配置钉钉账号映射，请先在组织同步中完成用户映射。先看本页最近一次同步时间——太早就再同步一次；同步记录里 新增数量 为 0 说明平台侧就没返回这个人，去钉钉通讯录确认他是否在应用可见范围内。
怀疑同步把绑定冲掉了。 查最近一次同步的 更新数量，然后到 用户绑定 看「已绑定」数字有没有掉。更新只刷平台侧资料，绑定关系是保留的；数字真掉了通常是有人在绑定页做了 解绑。
同步一直失败。 状态 失败 且数量全为 0，进详情看错误信息。集中在两类：凭证不对（回 平台配置 核对 AppKey/AppSecret），或应用没开通讯录权限（去平台后台补权限）。
六、权限控制与前置条件
- 只读台账，无写入口；能看到本页即能看到全部同步记录。
- 同步动作的触发点只有两个：用户绑定 的 同步钉钉信息 按钮，以及服务端的组织同步接口。没有定时任务，不会每天自动同步，通讯录变化必须有人手工点一次。
- 前置是 平台配置 已启用；未启用时同步会被拦下，提示
未找到钉钉授权配置一类信息。
七、常见问题
为什么没有自动同步？ 组织同步目前只有手动触发一条路。想让通讯录保持新鲜，只能约定一个频次（比如每周一）由管理员点一次 同步钉钉信息，再点一次 自动绑定。
同步会不会把离职的人删掉？ 不会删。平台侧离职的人在 ERP 里被标记为失效，从 用户绑定 的列表里消失，计入「已失效」卡片，历史映射仍保留在库里以便审计。
「部分成功」需要处理吗？ 一般不用。它是「取回了一部分」的意思，下次同步会补上剩下的。只有当确实有人一直同步不下来时，才需要按错误信息去平台侧核对该账号的权限范围。
这里能看到审批模板的同步记录吗？ 看不到。本页只记组织架构。审批模板同步的结果直接在 审批模板 的按钮反馈里给出（同步完成！新增: n个 更新: n个 失败: n个），不写日志表。
记录能清理吗？ 不能，页面上没有删除入口。日志量按同步次数增长，正常一年也就几十到几百行，不影响性能。