This commit is contained in:
liufumingren 2026-07-03 16:11:39 +08:00
parent 478ad2ab0d
commit 962e06787f
3 changed files with 0 additions and 59 deletions

View File

@ -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 不可用时直接查询数据库

View File

@ -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。

View File

@ -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。