78 Commits

Author SHA1 Message Date
liufumingren
990fcf1314 feat(storage): 新增维护库存效期接口 storage.inventory.updateExpiry
- systems/storage/inventory.js 新增 updateExpiry:校验 storage_id 为正整数、两个
  日期至少传一个、当前仓库上下文(ctx.user.store_id);单事务 + 行锁
  (SELECT ... FOR UPDATE)按 id + warehouse_id + is_enabled=1 + delete_at IS NULL
  定位库存记录,跨仓库按 404 处理
- 新增模块级 helper parseStorageDateInput:undefined 视为未传、null/空串清空,
  YYYY-MM-DD / YYYY/MM/DD / YYYY-MM-DD HH:mm:ss / ISO / Date 统一规范化为
  YYYY-MM-DD 并校验日期真实存在,其它判非法
- 合并后(未传字段取库内现值)生产日期不能晚于到期日期;两值均与库内一致返回
  changed=false,不写库、不记日志
- 成功路径写业务操作日志(operation_code=STORAGE_UPDATE_EXPIRY,记维护前后两个
  日期与 storage/space/stock/batch 快照)
- systemMethods/storage/inventory.js 新增方法层包装(透传 code/message/data);
  businessDict 新增 STORAGE_UPDATE_EXPIRY 操作码
2026-09-15 16:18:39 +08:00
liufumingren
74b3f04b79 feat(storage): 新增按库位查询有量库存商品列表
- systems/storage/inventory.js 新增 getStorageListBySpaceId(spaceId):
  校验库位归属当前仓库(区分「库位不存在」与「库位属于其他仓库」),
  返回该库位 quantity>0 的库存并按 stock_id 汇总,
  商品信息复用 stock_warehouse 通用链路(getStockDetails)补全属性
- systemMethods/storage/inventory.js 开放 listBySpaceId,
  免权限/免鉴权/免日志名单同步补充
2026-09-13 15:31:05 +08:00
liufumingren
e19b5fc18c feat(order): 取消单据支持 CK 出库单与 RK 入库单
- 奇门 order.cancel:CK 组(PTCK/DBCK/B2BCK/QTCK/CGTH)委托 systems.stockoutOrder.cancel 取消出库单(仅 CREATED/PENDING 可取消,释放 QM_STOCKOUT 锁定,不回传);RK 组由裸改状态升级为复用 systems.storage.entry.cancel 完整作废流程(状态守卫 + 回退收货单占用 + 操作日志,已作废幂等成功)。

- openapi order.cancel:新增 CK 组与 RK 组路由,成功/失败文案与奇门口径一致。

- storage.stockout.cancel 改为委托共享实现,对外契约与文案不变,改为单事务 + 行锁。

- storage.entry.cancel 扩展入参能力(entryOrderCode 定位 / skipExternalSync / idempotent / notFoundMessage),系统方法入口行为不变。

- 文档:methods/{qimen,openapi,system}.json 及对应 changes 同步。

注:app/service/systems/stockout_order.js 与 methods/openapi.json 同时承载此前未提交的出库单(stockout)共享服务与文档,文件粒度无法拆分,一并纳入本次提交。
2026-09-13 02:24:18 +08:00
liufumingren
0fe43c87b1 fix: 跨仓 order_express 校验与 recheckOrder 原生 SQL 表名修复
- 跨仓 bug 修复:order_express 读取强制校验订单所属仓库 id(order.detail 与全部订单列表等 17 处)

- recheckOrder 原生 SQL 表名补 wms_ 前缀,修复 queryRecheckOrderSingleList 恒 500

- 同步 methods 文档与变更记录
2026-09-10 03:46:41 +08:00
liufumingren
86222a24eb feat: COMPLETED 入库单绑定收货单与防超扣台账链路
- 入库单 COMPLETED 状态放开绑定收货单,事务内按 SKU 同步收货单明细入库进度(stored_quantity/storage_status)

- wms_entry_order_receiving 新增 allocated_quantity 台账列(迁移已在生产执行),多收货单绑定按剩余可分配量封顶防超扣

- 统一锁序(入库单主行→绑定行→收货明细行)修复并发绑定死锁;解绑/作废按台账回滚,不再整体清零共享收货单

- 同步 entry_items.received_quantity 口径,与绑定收货单 stored_quantity 可对账

- 同步 methods 文档与变更记录、AI_METHOD_ROUTING 方法清单
2026-09-07 22:16:54 +08:00
liufumingren
6939d9600a feat: 拦截链路完善与车绑定修复
- 订单表新增 intercept_time 拦截时间字段(迁移覆盖基表与全部分表),全拦截链路写入拦截时间、解除拦截清空

- 新增自动库内拦截确定定时任务(1h 间隔,扫描 requested+未打印订单,超时自动库内拦截确定)

- 复核链路自动移除波次内未打印拦截订单回池,拦截解除后可重新抓取发货

- 打印解绑车判定排除拦截订单,修复波次含拦截订单时车无法解锁

- 同步 methods 文档与变更记录;含 wave_scope 回填、workbench token 过期等前序迁移
2026-09-07 03:48:43 +08:00
liufumingren
95067aeb8a feat(wms): 工作台成员、波次范围、库存明细与报表修复等多项更新
- workbench: 工作台成员拆分 wms_workbench_member 表,下线 barcode 字段,新增绑定/移除成员接口

- order: 订单配送新增 wave_scope 波次范围字段与历史回填,自动分配快递排除备注与储位分配限制修复

- storage.transaction.list: 重写为 wms_storage_transaction 逐条明细查询,消除聚合慢查询

- stock.report: 分页默认生效、排序白名单扩充、where.stock_id 数组兼容修复

- storage.entry: quickInbound/commit 新增 noNeedNotice 通知开关

- storage.inventory.list: stock_query 支持数组多关键字并集匹配

- store: 手工单回传通知策略 notify_manual_sync

- docs: 同步接口文档与变更记录、路由表;test: 补充快递排除与储位分配限制测试
2026-09-05 22:43:38 +08:00
liufumingren
b64ba0b00b fix(storage.receiving): 收货单货主名称实时解析,store_remask 优先、company_name 兜底,修复约 26% 历史数据快照为空问题 2026-09-03 17:03:44 +08:00
liufumingren
25442ba215 feat(storage): 拦截锁定库存改造,拦截确认库存移入 intercept_locked_quantity 不归还可用,可用数量统一口径 quantity-locked-intercept,负库存入库平账冲销 GAP 挂账 2026-09-03 17:00:37 +08:00
liufumingren
ff84a99306 fix(storage.receiving): 收货完成同步商品图片增加存量上限保护,已有图片超2张跳过复制,批量预统计去重并清理调试输出 2026-09-01 00:50:14 +08:00
liufumingren
b5e5d4d588 feat(storeWarehouse,report,notice,order): 签约导出与代开户备注兜底、报表meta下线、入库完成通知与编码规范化
- storeWarehouse: 货主签约列表异步导出 export/exportTaskProgress(26列中文表头Excel+进度回写);openAccount 代开户未传 store_remask(或传空)时默认取公司全称前50字符填充,保证货主名称在列表/导出中始终有值

- report: 下线 report.meta(破坏性),窗口参数改由 definition.typeList、勾选字段经 definition.list 提供;报表投递目标货主状态放宽为 1/2(正常/审核中);reportDelivery 实体展示名称兼容下划线/驼峰并优雅回退 ID

- notice/order: 入库单完成通知货主(entry_order_completed,固定订阅回退链:收货组→售后组→仓库异常群);入库明细 itemId 规范化(非法值降级按 item_code 精确/归一化条码匹配,剥离中文后缀,多命中报错防错配);库存预警定时任务与 webhook 模型调整

- storage: 快捷直入/入库单基本信息等相关小改(inbound_direct_log、storage/entry、storage/inventory)

- docs: methods/system 0.3.62→0.3.63、openapi/qimen 同步,AI_METHOD_ROUTING 与 report-config-guide 同步,methods/changes/*.json 补变更记录
2026-08-31 17:17:48 +08:00
liufumingren
58cc5bb7b6 feat(storage): 快捷直入回写虚拟入库标记 2026-08-30 07:28:29 +08:00
liufumingren
15e109f992 fix(notice): 收货通知链路修复(幂等键含事件维度、ext_data 透传、审核模板与收货人行调整、商品编码反查兜底) 2026-08-28 04:42:22 +08:00
liufumingren
59eb736740 feat(storage): 补货需求支持货主筛选并补充货主名称与SKU条码,快捷直入按绑定收货单截断并回写入库状态 2026-08-27 23:41:47 +08:00
liufumingren
f8915a5733 fix(openapi/storage): 修复服务命名冲突、完善导入入库收货单占用与入库单详情字段
- openapi.js 重命名为 openapiEntry.js,消除与 openapi/ 目录同名冲突,恢复 ctx.service.openapi.callback 可用,修复 quickInbound API 回传报 Cannot read properties of undefined (reading 'sendWithRetry')
- 导入/PDA 入库 commit 新增非绑定模式收货单占用:带 receiving_detail_id 的记录优先按明细扣减,剩余导入量按 stock_id 匹配绑定收货单明细占用并回写收货单入库状态
- storage.entry.get 响应新增 total_order_lines / total_quantity / received_quantity 字段
- 同步 AI_METHOD_ROUTING.md 与 methods/changes 变更记录
2026-08-27 17:58:52 +08:00
liufumingren
adb7405396 feat(receiving): 审核通过通知返回 Excel 审核明细下载链接,失败回退正文展示明细 2026-08-26 17:40:49 +08:00
liufumingren
fbd9ac2326 feat(receiving): 收货单通知模板调整(车牌/快递单号未登记显示无)并新增完成时未匹配商品货主通知 2026-08-26 17:22:52 +08:00
liufumingren
93c0a620c7 feat(stockout): 出库单操作日志/取消/确认回传与 STOCKOUT 渠道订单同步,workbench 查询与打包状态回写,默认库位配置及权限迁移 2026-08-26 15:35:35 +08:00
liufumingren
c7266c53a8 fix(storage): receivingCompare 多收货单先合并明细再统一对照,修复入库计划数量重复展开 2026-08-24 18:47:41 +08:00
liufumingren
0fe7b724ed feat(storage): 新增 storage.inventory.directPutaway 收货单直入库存接口(一步完成)
- systems/storage/inventory.js#directPutaway:一步写库存并生成入库单(SCRK,直接 COMPLETED)
  - 入库单明细与收货明细一一对应(不合并),按收货明细库位 space_id 入库,批次/效期取收货明细
  - 悲观行锁更新 wms_stock_warehouse 总库存 + 写 wms_storage 库位库存(同键累加)
  - 全量日志:wms_stock_transaction(SCRK)+ wms_storage_transaction(entry_order)+ wms_inbound_direct_log(committed)+ 操作日志(entry_order/storage/stock 三维度)
  - 收货单锁定防重、重复直入 400 拒绝
- systemMethods/storage/inventory.js:注册 directPutaway 入口(_noNeedAuth)
- store_warehouse.js:POLICY_CONFIG_FIELDS 白名单新增 allow_receiving_direct_putaway 开关(修复 getter sanitize 过滤导致开关读不到)
- database/migrations/20260824-add-direct-putaway-permission.js:新增 API 权限记录(幂等,含 down)
- methods/system.json / methods/changes/system.json:接口文档与变更记录

与 quickPutaway(转入库单)并存:转单链路为 quickPutaway→entry.addItem→entry.commit;
直入为 directPutaway 一步完成。两链路开发环境真实接口全量对比(15+ 表)一致。
2026-08-24 03:23:15 +08:00
liufumingren
705678487d fix(returnUnpack): 拆包视频拼接 CDN 域名,商品复核字段透出与缓存失效修复
- returnUnpack: list/detail/videoList/queryByWaybill 输出 videos[].video_url 自动拼接
  http://w{warehouseId}-c{recordingComputerId}.o.gztbyc.com{path},与 order.packing 同口径
  (录制电脑从 wms_print_computer 按 is_recording=true 获取,无录制电脑时保持原始相对路径)
- recheckOrder: scanOrder/scanTask 报文 stock 明细新增 need_recheck 字段(缺省 Y)
- stock: getStockDetails 双实现透出 need_recheck;saveWarehouseStock/handleBatchChange 更新成功后
  显式清除商品详情缓存(bulk update 不触发实例级 afterUpdate hook,修复旧缓存被持续读取)
- delivery_order: 订单创建时间统一取服务器当前时间,不采用报文 createTime,避免被平台上报时间覆盖
- 同步 methods/system.json 文档与 methods/changes/system.json 变更记录
2026-08-23 22:13:33 +08:00
liufumingren
aacf9c8539 feat(storage): 新增按商品查有量库存接口与库存列表零量过滤
- listByStockId:传入 stock_id 返回 quantity>1 的库存,支持 group_by_space 双模式(逐条明细/按库位汇总)
- 修复 store_stock 关联未按仓库收敛导致同 id 库存行重复返回,统一改用 buildStoreStockInclude
- list/export 基础条件增加 quantity>0,过滤总数量为0的商品或明细行
- list 支持 where.stock_query 虚拟筛选(商品编码/名称/货物编码/条码/SKU ID 模糊匹配)
- 重构 getInventoryList 明细分支:提取 _loadInventoryWarningRanges/_formatBatchStorageRows 复用
- 同步 methods/system.json 与 methods/changes/system.json 文档及变更记录
2026-08-22 01:57:27 +08:00
liufumingren
f6ee444d36 feat(storage): 入库单列表行级新增 total_quantity/received_quantity 数量汇总
- storage.entry.list/listStore 按当前页入库单批量聚合 wms_entry_items(SUM(count)/SUM(received_quantity))注入每行
- 无明细行补 0,不影响筛选/分页/排序逻辑
2026-08-21 23:34:06 +08:00
liufumingren
6d33210624 fix(storage): 修复库存/商品列表按数量等字段排序不生效
- stock.warehouse.list: 透传 sort 参数给 getWarehouseStock(此前漏传,后端始终按 id DESC 排序,quantity/available_quantity 等排序字段均无效)
- systems/storage/inventory getInventoryList/exportInventoryList:
  - 汇总模式(按 stock_id 合并)order 原写死 last_inbound_time,现支持按聚合别名排序:quantity/locked_quantity/available_quantity/batch_count/first_inbound_time/last_inbound_time/production_date/expiry_date,其余回退 last_inbound_time
  - 明细模式新增真实列白名单,非法字段回退默认列,避免 SQL 报错/注入
  - sortOrder 统一归一化为 ASC/DESC,分页兼容 currentPage
2026-08-21 23:23:06 +08:00
liufumingren
ac4222c49a fix(receiving): 收货绑定货主通知按已填车牌/快递单号展示已登记信息
- sendStoreBoundNotice 根据 receiving.license_plate / tracking_number 动态生成
  第三行文案:已填车牌显示已登记信息,均未填写才提示及时补充
- create/bindStore/updateReceivingStats 三个触发点的快照均补充两字段
2026-08-19 00:00:28 +08:00
liufumingren
591a69d35e fix(notice): 收货通知群路由细化与奇门取消拦截转快递群
- receiving_completed/rejected 只通知仓库收货群,不再通知货主(货主端链接不再生成)
- receiving_reviewed 货主侧三级回退:货主收货群→货主售后群→仓库异常群(sendToWarehouseChannel 支持 fallbackTargets 回退链)
- 新增 receiving_store_bound:收货单创建/首次绑定货主时提醒货主填写车牌号/快递单号,路由同三级回退
- qimen order.cancel 两个拦截分支仅限有运单时创建拦截工单并通知对应快递群,与正常货主发起拦截一致
- 新增 script/backfill-inbox-permissions.cjs:客服/仓库组主管员工回填 inbox 页面与 API 权限(已执行 dev 与线上)
2026-08-17 22:10:47 +08:00
liufumingren
7ad08e488d feat(notice): 统一通知仓库接口通道与订单同步通知去抖
- warehouseNotify: 按固定群订阅经 wms_api_app 回调推送(MD5 验签),消息表登记+失败重试
- notice: 货主群缺失时降级发仓库异常群(前缀标记失败),合约停用/已解除货主不发货主群也不降级
- order_async: 订单同步通知 3 分钟去抖合并,Redis 队列+定时冲刷+失败重试
- receiving: 收货完成/驳回/审核通知走仓库通道,仓库/货主侧文案分离
- storage/inventory: 移除移库完成群通知(事件码保留,库存余量提醒仍复用)
- 新增 debug:warehouse:push-receiver 调试接收服务与文档/变更记录
2026-08-17 02:03:34 +08:00
liufumingren
75a248fdf6 feat: 收货单列表新增 stock_query_where 商品维度过滤(条码/编码/ID) 2026-08-13 21:43:01 +08:00
liufumingren
b436b6dd9e feat: 拦截链路全流程完善 — 新增interceptScan + 运单表同步 + 工单通知
新增:
- order.recheckOrder.interceptScan: 拦截扫描接口,入参运单号,查express标记退回,处理工单,更新订单拦截状态
- afterSale.createInterceptWorkOrdersAndNotify: 共享方法,幂等创建工单+通知快递群

修复:
- confirmIntercept: 补运单is_back同步(仅限is_intercept=Y),补工单创建+通知
- batchIntercept: 补运单is_intercept同步,补工单创建+通知
- batchUnintercept: 补运单is_intercept/is_back清除
- Qimen/OpenAPI cancel: 补运单is_intercept同步,补工单创建+通知
- interceptScan: 删除死查询,加空指针兜底

文档:
- methods/system.json: interceptScan + confirmIntercept 完整API文档
- methods/changes/system.json: 变更记录
2026-08-12 20:47:19 +08:00
liufumingren
3e7c9a7a10 fix: 修复 docs 页面 JS 失效 + 入库 locked_quantity 流水补全 + stock_store 查询条件补全 is_valid
1. docs.js: 修复模板字面量中 '\n' 被服务端解释为换行符导致客户端 JS SyntaxError,所有交互功能失效(搜索/发送按钮)
2. inbound_direct_log.js: batch_no 修正为 effectiveBatchNo;storage 表更新时补全 before_locked_quantity/after_locked_quantity;新增 stock_id 归属校验
3. stock_store.js: 多处查询/更新补全 is_valid='Y' 过滤条件,避免软删除/失效数据泄露或误操作
4. storage/entry.js: 入库完成时补全 storage 表 before_locked_quantity/after_locked_quantity 流水字段
2026-08-09 00:23:42 +08:00
liufumingren
358fef0f71 chore: apply ESLint auto-fixes, JSDoc additions, and CRLF→LF normalization (no logic changes) 2026-08-08 20:28:18 +08:00
liufumingren
61b82512f2 feat(auth): 新增客服组权限授权/取消脚本,更新 dev-agent 配置
- scripts/auth/grant-cs-up.js: 客服组及以上角色批量授权(dev+prod)

- scripts/auth/revoke-cs-up.js: 客服组及以上角色批量取消授权(dev+prod)

- .github/agents/开发.agent.md: 新增关键定位地图第5项-客服组权限授权脚本

- .cursor/agents/wms-dev-agent.md: 同步 dev-agent 配置
2026-08-04 18:08:46 +08:00
liufumingren
8ee12374b3 fix(storage.entry.get): 移除 items[].stock 中多余的 quantity/locked_quantity 字段 2026-08-02 00:34:32 +08:00
liufumingren
315e366c4c feat(inventory): 新增库存异步导出功能
- systemMethods 层:export 提交异步任务 + exportTaskProgress 查询进度
- systems 层:exportInventoryList 导出实现(支持按 stock_id 聚合/按 storage_id 明细)
- 导出任务通过 Redis 缓存管理进度状态(TTL 30min)
2026-08-01 03:45:16 +08:00
liufumingren
fb2c00027e refactor(storage.receiving): 导出功能 storeId 改为从 ctx.user.store_id 获取 warehouseId;新增导出相关接口文档 2026-07-27 17:46:56 +08:00
liufumingren
81350c0d6b fix: 定时任务同步日志 + 基础设施修复 + 权限迁移(收尾)
【定时任务】sync_outbound_orders_to_delivery: 执行日志写缓存 + 错误详情提取(parent/validation)

【基础设施】system.js: snake_case→camelCase 服务路由转换(兼容 express_interface 等)

【看板】dashboard: queryWarehouseStats 支持 storeId 货主维度过滤

【订单基类】order/base: getOrderModel 兼容无上下文时传入 warehouseId(货主侧场景)

【库存】inventory: 全量移库软删除→硬删除(force destroy)释放唯一键 + 唯一约束/校验错误友好提示

【快递平台】express_platform: KS(快手)平台 receiver.phone 不传(平台要求)

【迁移】delivery 自增起点 + supervisor CS 权限修复
2026-07-27 03:49:27 +08:00
liufumingren
510b87632a feat(stock): 库存/仓库模块货主侧查询与报表增强
- stock/warehouse: 新增 externalList/externalExport(外仓/货主维度查询)

- storeWarehouse/store: 新增货主侧接口(list/get 等)

- stock_store: getWarehouseStock 支持 externalWarehouseId/externalStoreId

- store_warehouse: 合同关系改为单向维度查询(不再 OR 两边)

- storage/report: 库存报表支持 store 维度 + stockIds/keyword 精确筛选

- stock/transaction: storeList/exportStore store_id 从 ctx 获取防越权

- stock_warehouse: getStockDetails 支持显式传 null 跳过仓库过滤

- storage/management: 储位分配待处理排除待审核(step=1)订单
2026-07-27 03:48:06 +08:00
liufumingren
3c53b3c8fa feat(storage): 入库/收货模块货主侧功能 (listStore, export)
- entry: 新增 listStore(货主维度列表)、export/exportTaskProgress(异步导出)

- entry: 新增 storeExport/storeExportTaskProgress(货主侧导出)

- receiving: 新增 getStoreReceivingList(货主维度收货单查询)

- receiving: 新增 export 异步导出 + fix 时间字段 created_at→updated_at

- 迁移: receiving_detail creator_id 去 zerofill + 货主收货权限
2026-07-27 03:47:49 +08:00
liufumingren
a69fd3f393 fix(storage.entry): 入库超量静默裁剪 + containerList 按可用量过滤
1. inbound_direct_log._addSingleItem: 入库数量超过计划时不再拒绝,改为静默裁剪为 maxAllowed(仅无可入数量时拒绝)
2. storage/entry.containerList: NOT EXISTS 一刀切排除改为计算 actual_quantity - SUM(已占用),只返回可用量>0的收货明细
2026-07-23 17:42:28 +08:00
liufumingren
3e813c4975 fix: 将 storage.report 模块迁移至 stock.report,修正语义错误
库存报表属于 stock(商品库存)域而非 storage(库位存储)域。

变更:
- systemMethods/storage/report.js → systemMethods/stock/report.js
- 类名 StorageReportMethodService → StockReportMethodService
- 缓存键 storage_report_export_ → stock_report_export_
- 日志前缀 [storage.report] → [stock.report]
- methods/system.json: module + 5 method 名同步更新
- methods/changes/system.json: 追加迁移记录
- systems/storage/entry.js: 注释引用修正

旧文件直接删除,不保留兼容(旧 method 名为语义错误)。
2026-07-17 00:30:54 +08:00
liufumingren
6d58d7ff1f docs: 仓储报表微调 + methods 接口文档同步更新
- storage/report: 报表逻辑微调

- methods/system.json: storeWarehouse 系列接口文档更新

- methods/changes/system.json: 新增 2026.07.08/07.09 变更记录
2026-07-09 03:36:19 +08:00
liufumingren
d1818ae0bf fix: 修复 receiving.js 编码损坏导致语法错误(use_status → warehouse_use_status 重做) 2026-07-06 22:19:34 +08:00
liufumingren
76c52fa268 use_status 重命名为 warehouse_use_status,新增 store_use_status;仓库/货主侧独立控制签约使用状态,unbind 按身份分派字段 2026-07-06 22:12:23 +08:00
liufumingren
df1bd38601 商品流水增加锁定类目语义类型 2026-07-06 19:28:45 +08:00
liufumingren
7d92522c2f 库存报表导出增加新字段 2026-07-06 17:18:35 +08:00
liufumingren
7f05b26db2 1 2026-07-04 21:40:31 +08:00
liufumingren
5d7964132e 1 2026-07-03 16:56:39 +08:00
liufumingren
478ad2ab0d 1 2026-07-03 16:10:46 +08:00
liufumingren
5ef99e3bed 1 2026-07-01 14:00:59 +08:00
liufumingren
e7fcd2549e 20260625 2026-06-25 02:01:59 +08:00