From 962e06787fd7a97b2ec1b778e826c6aec2bd3a03 Mon Sep 17 00:00:00 2001 From: liufumingren Date: Fri, 3 Jul 2026 16:11:39 +0800 Subject: [PATCH] 1 --- .../repo/entry-receiving-match-callback.md | 28 ------------------- .../repo/express-platform-code-routing.md | 4 --- memories/repo/stock-detail-cache-service.md | 27 ------------------ 3 files changed, 59 deletions(-) delete mode 100644 memories/repo/entry-receiving-match-callback.md delete mode 100644 memories/repo/express-platform-code-routing.md delete mode 100644 memories/repo/stock-detail-cache-service.md diff --git a/memories/repo/entry-receiving-match-callback.md b/memories/repo/entry-receiving-match-callback.md deleted file mode 100644 index 08e4df0..0000000 --- a/memories/repo/entry-receiving-match-callback.md +++ /dev/null @@ -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 不可用时直接查询数据库 diff --git a/memories/repo/express-platform-code-routing.md b/memories/repo/express-platform-code-routing.md deleted file mode 100644 index 247a13f..0000000 --- a/memories/repo/express-platform-code-routing.md +++ /dev/null @@ -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。 diff --git a/memories/repo/stock-detail-cache-service.md b/memories/repo/stock-detail-cache-service.md deleted file mode 100644 index 36a1591..0000000 --- a/memories/repo/stock-detail-cache-service.md +++ /dev/null @@ -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。