1
This commit is contained in:
parent
478ad2ab0d
commit
962e06787f
@ -1,28 +0,0 @@
|
||||
# 入库单完成 → 异步匹配收货单并回传
|
||||
|
||||
## 实现日期
|
||||
2026-06-18
|
||||
|
||||
## 涉及文件
|
||||
|
||||
### 新建
|
||||
- `app/service/systems/receiving_entry_match.js` — 核心匹配与回传服务
|
||||
|
||||
### 修改
|
||||
- `app/service/systems/entry_order.js` — `entryorderConfirm()` 事务提交后触发异步匹配
|
||||
- `app/service/systems/storage/entry.js` — `completeEntry()` 状态更新后触发异步匹配
|
||||
- `app/service/systems/storage/receiving.js` — `completeReceiving()` 事务提交后清除收货单缓存
|
||||
|
||||
## 核心流程
|
||||
1. 入库单完成(COMPLETED)→ `setImmediate` 异步触发 `matchAfterEntryCompleted`
|
||||
2. 从 Redis 缓存读取仓库近 3 天收货单列表(key: `cache:receiving_orders:warehouse:{warehouseId}`,TTL: 300s)
|
||||
3. 根据入库单 `remark` 字符串包含匹配收货单号
|
||||
4. 对比明细 SKU + 数量 → full_match / receiving_covers_entry / 其他
|
||||
5. full_match / receiving_covers_entry → 按来源回传(QM 奇门 / API OpenAPI)
|
||||
6. receiving_covers_entry → 标记收货单为"部分入库"(storage_status=partial)
|
||||
7. 收货单完成时主动清除对应仓库缓存
|
||||
|
||||
## 注意事项
|
||||
- 异步执行,不阻塞主流程
|
||||
- 所有错误仅记录日志,不影响业务
|
||||
- 缓存回退:Redis 不可用时直接查询数据库
|
||||
@ -1,4 +0,0 @@
|
||||
- 运单分组链路必须是:订单的 sys_platform_code -> wms_platform.print_platform_id -> wms_print_platform.platform_code。
|
||||
- 快递接口匹配与 listByWarehousePlatformCode 的 platform_code 必须使用 wms_print_platform.platform_code,不可直接回退为 sys_platform_code。
|
||||
- 分组维度必须使用 wms_print_platform.platform_code + logistics_code;如果缺少打印平台映射,应视为缺少有效匹配上下文,而不是改回 sys_platform_code 直连。
|
||||
- 相关代码锚点:app/service/systems/express.js、app/service/systems/platform.js、app/model/express_interface.js。
|
||||
@ -1,27 +0,0 @@
|
||||
# 商品明细缓存公共服务(stock_warehouse.js)
|
||||
|
||||
## 文件位置
|
||||
`app/service/systems/stock_warehouse.js`
|
||||
|
||||
## 对外方法
|
||||
|
||||
### `getStockDetails(stockIds, options)`
|
||||
批量获取仓库商品详情(含 StockWarehouse + StockBarcode + 图片),带 Redis 缓存,差量增补。
|
||||
|
||||
- **缓存 key**:`cache:stock_detail:{warehouseId}:{stockId}`
|
||||
- **TTL 默认**:300 秒
|
||||
- **调用方式**:
|
||||
```js
|
||||
ctx.service.systems.stock_warehouse.getStockDetails(stockIds, { warehouseId, cacheTTL })
|
||||
```
|
||||
|
||||
### `invalidateStockDetailCache(stockId, warehouseId)`
|
||||
清除指定商品缓存。
|
||||
|
||||
- **调用时机**:商品资料更新、图片变更、条码变更时调用
|
||||
|
||||
### `_buildStockDetailCacheKey(warehouseId, stockId)`
|
||||
内部工具方法,构建缓存 key。
|
||||
|
||||
## 设计思想
|
||||
作为仓库级公共服务,入库单、出库单、盘点、移库等所有模块都可以复用这个缓存方法,避免各处重复查询 StockWarehouse + StockBarcode。
|
||||
Loading…
x
Reference in New Issue
Block a user