wms/nflg-wms-scheduled/CLAUDE.md

根目录 > nflg-wms-scheduled

nflg-wms-scheduled - 定时任务执行器

模块职责

基于 PowerJob 的定时任务执行器服务，负责：

• SAP 库存数据从 SAP 同步到 WMS
• WMS 库存变动同步到 SAP
• LDAP 域账号定期同步
• 盘点任务定时处理
• 物料图片 ZIP 包导入（WMS + 发货模块）

入口与启动

项	值
入口类	com.nflg.wms.scheduled.ScheduledApplication
端口	8103
服务名	scheduled-local

关键依赖

• nflg-wms-common
• nflg-wms-starter
• SAP JCo3 (ERP 集成)
• PowerJob Worker (定时任务执行)
• Spring LDAP Core
• Redisson (分布式锁)
• Loki Logback Appender

关键目录说明

路径	说明
ScheduledApplication.java	启动入口
config/SAPConfig.java	SAP JCo 连接池配置
config/PowerJobWorkerConfiguration.java	PowerJob Worker 配置
processor/	定时任务处理器（PowerJob BasicProcessor 实现）
processor/SyncStorageFromSAPProcessor.java	SAP -> WMS 库存同步
processor/SyncStorageToSAPProcessor.java	WMS -> SAP 库存同步
processor/LDAPSyncProcessor.java	LDAP 域账号同步
processor/InventoryCheckTaskProcessor.java	盘点任务处理
processor/MaterialZipImportProcessor.java	物料图片 ZIP 导入
processor/ShipmentMaterialZipImportProcessor.java	发货物料图片 ZIP 导入
service/SapService.java	SAP RFC 调用服务
service/LdapService.java	LDAP 查询服务
util/JCoUtil.java	SAP JCo 工具类

配置

• 支持 dev / sit / prod 环境
• PowerJob Worker 通过 Nacos 获取 PowerJob Server 地址
• SAP 连接池配置通过 Nacos 共享配置

特殊说明

• 包含 lib/sapjco3.jar 本地依赖
• 所有任务处理器实现 PowerJob BasicProcessor 接口
• 任务调度由 PowerJob Server 控制，本服务仅为 Worker 端

测试

• DeployTest.java - 部署测试

相关文件清单

• src/main/java/com/nflg/wms/scheduled/ - 全部源码（12 个文件）
• src/main/resources/application*.yml - 配置文件（4 个环境）
• lib/ - 本地 JAR 依赖
• pom.xml - 模块依赖定义

变更记录 (Changelog)

时间	操作	说明
2026-05-23 14:16:58	初始化	首次生成模块文档