[根目录](../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 | 初始化 | 首次生成模块文档 |