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