一、什么是 OA 系统OAOffice Automation办公自动化系统就是企业内部的管理网站员工日常办公都在用它。核心功能功能模块说明示例员工管理员工信息、部门架构、入职离职张三是研发部的考勤打卡上下班打卡、请假、出差张三今天请病假审批流程报销审批、采购审批张三的报销单需要经理审批公告通知公司发文、通知端午节放假通知日程管理会议预约、工作日程周五下午3点开评审会在项目中的角色OA 系统公司人事数据 │ │ 数据同步 ↓ 工具柜系统你们开发的 │ └─ 员工登录用 OA 的账号体系 └─ 员工权限根据 OA 的部门/角色 └─ 数据来源员工信息从 OA 同步二、什么是 MES 系统MESManufacturing Execution System制造执行系统是工厂生产管理系统管理车间的生产活动。核心功能功能模块说明示例生产计划今天要生产什么派给谁今天张三在3号车间生产A产品物料管理原材料、成品库存管理螺丝还剩500个不够了设备管理机器状态、维修保养3号机床温度异常需要检修质量检测合格/不合格品记录这批产品合格率 98%数据分析生产效率、成本统计本月产量提升 15%在项目中的角色MES 系统工厂生产数据 │ │ 生产任务 / 员工工位信息 ↓ 工具柜系统你们开发的 │ └─ 谁去哪个工位 → 给他开哪个柜子的门 └─ 借还记录同步到 MES用于生产统计 └─ MES 可以下发命令给某个员工开锁三、为什么要对接原因 1数据互通避免重复录入❌ 不对接的痛点 OA 新增了员工李四 → 工具柜系统里也得手动加一遍 → 容易遗漏、数据不一致 ✅ 对接后的效果 OA 新增员工李四 → 自动同步到工具柜系统 → 李四第二天就能正常用原因 2权限统一管理❌ 不对接的痛点 张三离职了 → OA 禁用账号 → 工具柜系统里张三还能开锁安全隐患 ✅ 对接后的效果 OA 禁用张三 → 工具柜系统自动同步 → 张三账号立即失效原因 3业务流程闭环场景生产任务管理 MES 系统 工具柜系统 │ │ │ 张三今天去3号工位 │ │──────────────────────────→│ │ │ 检查张三有3号柜权限吗 │ │ 有 → 允许开锁 │ │ │ 张三完成了工作 │ │←───────────────────────────│ │ │ 记录张三用了哪些工具 │ │四、系统对接的核心方式API 接口简单理解系统之间通过 HTTP 接口互相调用传递数据。场景OA 同步新员工到工具柜 OA 系统 工具柜系统你们 │ │ │ 1. POST /api/employee │ │ Body: { │ │ name: 张三, │ │ department: 研发部, │ │ phone: 13800138000 │ │ } │ │──────────────────────────→│ │ │ │ │ 2. 验证AppKey 合法吗 │ │ 3. 保存写入员工表 │ │ 4. 返回成功 / 失败 │ │ │ {code: 200, msg: ok} │ │←───────────────────────────│五、三种对接模式模式 1主动推送PushOA 有新数据时主动调用你们的接口 OA 系统 工具柜系统 │ │ │ 员工信息变更新增/修改 │ │ └→ 调用 POST /api/employee │ │──────────────────────────→│ │ │ 写入数据库 │ {code: 200} │ │←───────────────────────────│ 优点实时性好 缺点对方服务挂了就收不到数据模式 2定时拉取Pull工具柜系统定时去 OA 查数据 工具柜系统 OA 系统 │ │ │ 每小时一次 │ │ GET /api/employee/list? │ │ lastUpdateTimexxx │ │──────────────────────────→│ │ │ 查询xxx 时间之后变动的员工 │ │ │ [员工列表] │ │←───────────────────────────│ │ │ │ 写入/更新本地数据库 │ │ │ 优点对方服务暂时挂了也没事下次会补 缺点有延迟最多延迟1小时模式 3混合模式推荐平时用主动推送实时 每天凌晨用定时拉取兜底确保没漏掉 OA 系统 工具柜系统 │ 实时推送有变更时 │ │──────────────────────────→│ │ │ │ │ 凌晨2点定时拉取兜底 │ [全量/增量数据] │ │←───────────────────────────│六、在项目中的具体对接点对接点方向频率说明员工信息同步OA → 工具柜实时 定时新增/修改员工部门架构同步OA → 工具柜定时部门变更员工离职处理OA → 工具柜实时账号自动失效借还记录回传工具柜 → MES实时每次借还生产任务下发MES → 工具柜实时员工权限工具柜状态查询MES → 工具柜按需统计分析