356 Commits

Author SHA1 Message Date
liufumingren
e3eff20aaa feat(waybill): 批量更新运单揽收状态(waybill.getreceive)与 Y/N 标记列治理
- 新增出站回调 waybill.getreceive(注册到 callback_functions,管理端可勾选):
  请求 { request: { waybill_codes: [...] } },响应裸数组/包装体均兼容,
  1/0 与 Y/N 归一后回写 wms_order_express.is_galaxy_receive(按 warehouse_id 隔离)
- 回调签名新增 signMode=simple(MD5(appSecret+timestamp+bodyJson)),
  waybill.getreceive 使用该口径,与仓库通知协议一致;其它事件默认口径不变
- 新增 waybill.warehouse.updateReceive / updateReceiveTaskProgress:
  复用导出的异步任务ID与进度模式(前缀 waybill_receive_),单批 10 单自动切批;
  支持 waybillCodes 或与 waybill.warehouse.list 一致的 where 条件圈选(上限 5000);
  仓库未配置外部接口时直接失败,不创建任务
- 抽出 buildListQueryWhere / resolveWaybillCodesByWhere,列表与批量更新共用筛选口径
- order_express:is_back / is_intercept / is_galaxy_receive 补默认值 N
- 迁移:存量 NULL 回填为 N(Y 不动);三列分别建立单列索引(INPLACE + LOCK=NONE)
- 文档:methods/system.json(0.3.324)、变更记录、设计文档与出站回调说明同步

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-11 04:22:30 +08:00
liufumingren
25dac21b4b feat(waybill): OMS 取号与抖音打印 params 按店铺隔离
- express/express_platform: 新增 OMS 回源取号(need_oms_waybill=1)与统一失败收尾,
  失败时标记订单异常、写失败日志并清理未完成占位行;队列消费与手工分配共用同一口径
- order_print: 抖音打印按运单落库的 logistics_interface_id 精确命中取号接口配置,
  临时 key 缓存键带店铺与 token 指纹,避免多店铺串用 token;打印前按 OMS 记录换新 params
- order_express: 新增 print_history_id、cai_niao_auth_info_id 字段
- consume_waybill_allocate_queue / pendingOrder / delivery_order / order_async /
  printer_data_builder / order_delivery_table_schema: 配套调整
- migrations: 运单 wave_no 索引、OMS 打印字段

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-10 02:53:15 +08:00
liufumingren
3c0c7634c5 fix(inbox): notify.reply 按群/消息来源应用路由回执
同一仓库存在多个仓库级 API 应用且都勾选 notify.reply 时,回执按 id 升序逐个尝试,
可能被首个返回 200 的其它适配器接走,导致错投且被记为已送达。

- receiver: 群已存在时补写空白的 source_type/source_extra,来源不一致仅告警不覆盖
- processor: 回执来源优先级改为 群(wms_inbox_group) → 入站消息 → ext_id 解析,
  来源应用承接时只发给它;来源缺失或未承接时保持原候选顺序并告警
- warehouseNotify: push 支持 preferredAppKey,系统通知按群来源应用发送

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-10 02:42:25 +08:00
liufumingren
fc7c7ff42e fix(express): 面单商品描述默认值由「物品」改为「化妆品」
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 04:46:42 +08:00
liufumingren
765bb2c0f7 feat(order): from_key 改为承载上游应用 appKey 字符串
背景:from_key 是「回原通道」的应用标识,出库单回传与取号业务分支都依赖它。
历史只存过奇门/ERP 的纯数字 appKey(聚水潭 23060081、吉客云 24869601),
OpenAPI 创建来源的 appKey 是字符串(wms_api_app.self_app_key,如
WMSD08A3696BBA9551F261C88BBF7F462BD),INTEGER 列无法承载,
normalizeOrderFromKey 会把字符串归一化成 null,导致 API 渠道订单 from_key 全为空。

改动:
- from_key 列 INTEGER(11) -> VARCHAR(100),迁移覆盖基表与全部分表
  (current/history/dispatch/outsourced),整数改字符串需重建表,
  迁移在改列后校验并恢复 AUTO_INCREMENT 水位,避免分表 id 区间重叠
- normalizeOrderFromKey 不再按整数归一化,改为去空白 + 截断 100 落库
- DY 平台聚水潭判断改为字符串比较,兼容改造后的存量数据

落库口径:QM 取 wms_qimen_apps.app_key,API 取 wms_api_app.self_app_key,
MANUAL/STOCKOUT 为空。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-04 04:46:38 +08:00
liufumingren
28c862b7c9 Add intercept status to order export
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-11-03 18:29:42 +08:00
liufumingren
87bb9c87eb fix(express): 寄件人国家默认值由空值改为 CN
菠萝派下单寄件人 country 传空会被平台判为无效地址,统一默认 CN。
2026-10-28 23:08:05 +08:00
liufumingren
9edc0e3e47 fix(stock.check): 账面口径改取可用数量并新增静态盘点拣货完成校验
账面口径统一为 wms_storage SUM(available_quantity)(不再加 locked_quantity),避免静态盘点在仍有在途拣货时开盘产生假盘亏(PD20261027000001 商品 160240 -115)。

静态盘点(is_static=1)新增拣货完成判定 _fetchStockLockedQuantityMap:workData/workDataDetail 输出 picking_completed 与明盘 locked_quantity,report 对仍有锁定量(未完成拣货)的商品返回 400 拒绝上报。

同步更新 methods/system.json(0.3.319~0.3.321)与 changes 变更记录。ESLint 0 错误。
2026-10-28 23:08:00 +08:00
liufumingren
562f63f18e feat(stock.check): 商品视图按商品汇总、账面按静态标记取值、静态盘点锁定缓存与库存操作拦截
盘点作业数据(workData / workDataDetail)
- workData goods 视图按 stock_id 汇总为一行(同商品多库位明细合并):行级账面=各库位之和,
  作业记录跨明细按库位合并,locations 每项补 detail_id/snapshot_quantity,行级不再返回 detail_id。
- workDataDetail 商品分支改为 id + stock_id 钻取,返回 summary(汇总)+ rows(按库位分行:
  明细ID/库位ID/账面快照/当前账面/实盘/差异);兼容传商品范围 detail_id。
- 账面取值按任务 is_static 区分:静态盘点取明细快照(冻结基准),普通盘点取当前 wms_storage;
  新增 storage_quantity / is_static / book_source 字段,差异统一为「实盘 - system_quantity」。
- report 的 detail_id 改为可选:商品行可只传 id + stock_id + space_id,服务端按库位明细反查。

静态盘点(is_static)
- wms_stock_check 新增 is_static(TINYINT(1) DEFAULT 0,迁移 20261028010000);create 支持 is_static
  (仅商品盘点有效,库位盘点恒 0);静态定式 pattern=static 创建的任务自动置 1。
- 新增公共查询 stock.check.staticLockList:返回 is_static=1 且 approved/checking 任务的商品集合,
  按仓库缓存(TTL 300s、状态流转先递增代次再重建、回源前后代次校验防脏读、空集合也缓存、
  进程内 singleflight 防击穿),并提供 isStockStaticLocked / getStaticLockConflict 供内部判断。
- 审核通过时刷新商品明细账面快照(快照基准=开始盘点时点),finish 立即释放锁定并返回 released_stock_ids。
- 库存操作拦截:分配储位命中锁定商品时按「库存不足」同流程将该订单标记失败(storage_status=error +
  order_flag),同批次其它订单继续;移库(transferLocation / transferByProduct)命中锁定直接 400。

其他
- 新增开发环境实测脚本 script/stock-check-goods-summary-verify.cjs。
- 测试:stock_check.test.js 覆盖汇总/钻取/静态标记/锁定缓存/账面口径;新增 static_lock_guard.test.js
  覆盖分配与移库拦截;methods/system.json 与 changes 更新至 0.3.318。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 07:22:44 +08:00
liufumingren
8f2e141fe0 fix(express): 菠萝派平台返回空 results 时判定为系统级失败
- polyapi 取号结果 results 为空数组且请求含订单时(如 code=40000 / GSE.REQUEST_FAILURE.SYSTEMERROR),
  旧逻辑会当成 0 条结果继续走成功分支,订单既不回写运单号也不标记异常;
  现直接按失败抛出,失败原因拼接 submessage/message,并附带 polyapirequestid 便于平台侧定位。
- 顺带修正 providercode 判断处的代码风格(if 后空格)。

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-28 07:22:33 +08:00
liufumingren
8adede7ec7 fix(express): 视频号取号补 extend_props 空值保护并修正京东/小红书入参
- 视频号(platid 672)取号前判空 extend_props,避免 null 直接抛 TypeError 掩盖真实业务错误
- JD 取号补充 pickUpDate / pickUpEndDate / shipperno
- XHS 透传 site_code / shipperno,sender.country 置空以适配菠萝派要求

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 19:01:30 +08:00
liufumingren
640ce501cb feat(user): 新增账号用户名/密码修改与自定义密码标记
- wms_account 新增 is_custom_password(TINYINT(1) NOT NULL DEFAULT 0),同步模型与迁移 20261025135000;开发库、生产库均已执行

- user.getAccountInfo 返回 is_custom_password,仍不返回 password_hash/salt/last_login_ip

- 新增 user.updateUsername:仅改当前账号,服务端重名校验并排除自己,重名返回 409,更新后清理用户缓存

- 新增 user.changePassword:is_custom_password=0 时旧密码可不传,修改后置 1;再次修改必须校验旧密码;已排除操作日志避免明文密码落库

- 单测覆盖 getAccountInfo/updateUsername/changePassword,20 通过;同步 AI_METHOD_ROUTING

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 03:08:51 +08:00
liufumingren
de2f66a2d1 fix(stock.check): 上报强制 space_id 并按库位ID落库,修复作业挂到已删除分区的库位
- stock.check.report:space_id 必传(兼容 spaceId/location_id/locationId),校验仓库归属、分区有效、与 location 编码一致,缺失/非法/跨仓库/无头库位均返回 400;服务端不再按库位编码猜库位
- report:实盘数量上限 2147483647(原超限落库 Out of range 变 500);写库库位以 space_id 为准
- workData / workDataSpaceDetails / workDataDetail:space 视图行与 goods 视图 locations[] 补 space_id、location_id;space 视图记录库位归一(同编码不再出现幽灵行),明细按「库位+商品」索引、记录按「库位+商品」聚合
- 操作日志 STOCK_CHECK_REPORT:message 补库位编码/库位ID,before_changes 落库位与明细库位快照
- location.zone:createZone/updateZone 增加同仓库 zone_code 唯一校验(归档分区不占用编码,沿用规则编码),避免重复货架生成同编码库位
- 新增运维脚本(默认只读,--prod 指定生产):盘点库位一致性体检/订正(只改坏记录,两分支互斥)、作业记录指向已删除库位体检与 CSV 导出;无头库位引用统计改为分批 IN 查询,避免大表相关子查询导致生产连接重置

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-27 03:04:07 +08:00
liufumingren
0e7545bd9a feat(user): 新增 user.getAccountInfo 账号级信息查询
- 新增 user.getAccountInfo:仅查询当前登录账号的 wms_account 信息

- 白名单返回 id/username/real_name/phone/email/status/last_login_at/created_at/updated_at,排除 password_hash、salt、last_login_ip

- 未登录返回 401,账号不存在返回 404;不接收账号ID,避免越权查询

- 同步 methods/system.json(0.3.304 → 0.3.305)、变更记录、AI_METHOD_ROUTING 与方法文档库表

- 新增单测 test/app/service/systemMethods/user.getAccountInfo.test.js(5 通过)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-25 13:43:26 +08:00
liufumingren
861c384917 feat(order): 新增配送订单每日汇总 order.deliveryOrder.summary
- 新增 order.deliveryOrder.summary:以自然日为维度汇总订单量、迁入配送表订单量、
  发货量(订单数/商品件数/金额)、拦截数量、库内确定拦截数量与取消数量
- 数据源为订单常用表 + 配送表分表(history/outsourced 不参与),日期分组按
  CONVERT_TZ 换算到服务器本地时区,避免 UTC 存储导致自然日偏移
- 缺省最近 7 个自然日、单次最多 90 天,区间内无数据日期补 0;可选 store_id 过滤
- 同步 methods/system.json(0.3.302 → 0.3.303)、变更记录与 AI_METHOD_ROUTING.md

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
2026-10-21 17:13:40 +08:00
liufumingren
1afe068e73 feat(return-unpack): 新增配送订单批量转退件拆包单 transferByOrders
- 包装层新增 transferByOrders(鉴权 + 操作日志,ids 去重后上限 200)
- 业务层实现:仅库内拦截订单可转,1 单新建 1 张拆包单,明细 1:1 复制,单条失败不阻断主流程
- 迁移 20261017100000:新增权限 643 并授予仓库组员工/主管
- 同步 methods/system.json 与变更记录
- package.json 修正 depeeloy 脚本名拼写为 deploy
2026-10-21 15:46:18 +08:00
liufumingren
e9e39eafa7 chore: 提交工作区其余未提交改动(微信协议版本 / 扫描报文接口 / container 模型 / 退件 like 数组)
- 微信开放平台:首次授权时写入系统默认用户须知作为首个协议版本
  (ctx.service.systems.wechat.ensureDefaultAgreementVersion),含 seed / backfill 两个迁移
- 新增扫描报文接收接口 POST /scan:把「时间 + 条码」追加写入项目根目录 scan_records.xlsx
  (串行队列 + 原子写,避免并发写坏文件)
- 新增 wms_container(容器/笼筐)模型与建表迁移
- 退件收货单 / 退件运单列表:like 查询条件支持字符串数组(多关键词 OR)
- 新增 wms_return_unpack.created_at 索引迁移
- package.json:deploy 脚本改名为 depeeloy

注:scan_records.xlsx 是 /scan 接口写入的运行时数据文件,未纳入本次提交。
2026-10-16 05:29:13 +08:00
liufumingren
fdec622f2d feat(auto-outbound): 自动出库改为「开关 + 规则数组」,支持多条规则与跨天放行
- subject_config 新增 auto_outbound_enabled(默认 false);auto_outbound_rules 由对象改为数组,
  每项仅含 require_pack / require_weigh / require_sync / exclude_same_day_outbound /
  same_day_outbound_deadline_time / same_day_outbound_release_time
- 固定基线:已复核(recheck_status=fin)+ 已分配储位(storage_status=fin);已打印、已拣货不再校验
- 规则内 AND、规则间 OR(任一命中即出库);空数组不出库且不告警
- 旧对象结构不再兼容:读路径按默认(关闭)处理,写路径返回 400 提示重新配置
- 放行时间支持跨天 00:00~47:59(27:00 = 次日 03:00);按订单复核时间所在北京日计算未放行窗口
- 定时任务与手动触发统一走新规则;自动出库写入操作日志 ORDER_AUTO_OUTBOUND
- 同步 methods/system.json、methods/changes/system.json 与 AI_METHOD_ROUTING.md

涉及接口:setting.warehouse.getSettings / getFieldMeta / saveSettings、outbound.autoOutbound
2026-10-16 05:27:30 +08:00
liufumingren
e602d205b2 fix(workbench): 打包与查订单改按订单主键定位,不再按发货单号反查(防跨货主串单)
背景:wms_order_delivery 唯一索引是 (delivery_order_code, store_id, warehouse_id),
跨货主可重复,按「发货单号 + 仓库」反查订单在撞号时会把打包记到别的货主的订单上。
生产案例:发货单号 1345551 同仓命中团购单 306715 与散单 1096062,
打包记录因此落到 306715(团购波次 B2026082911192),而波次号字符串却取了扫码单的 E2026101300061。

- workbench._packOrder 新增 order_id 入参:优先按订单主键查单(current → dispatch 分表遍历),
  主键未命中才按 delivery_order_code 兜底;
- key 模式透传后端扫码上下文的主键:business(packOrder) 与 packOrderByToken 均带上 cachedCtx.order_id;
- 旧参数模式从设备上报 body 中剥离 order_id(只信任后端缓存注入,防篡改);
- 主键与发货单号不一致时打 warn 留痕,落库字段与响应结构不变;
- inbox 查订单:运单号命中后的订单定位与关联运单查询改为按订单主键(id / order_id)。

未改动(已核查,属创建查重 / 用户按单号搜索入口 / 外部接口契约 / 只读展示)。
2026-10-13 23:54:54 +08:00
liufumingren
16134e88c6 feat(workbench): 打包开始下发 OSD 前跳转摄像头预设点1,失败仅告警不阻塞 2026-10-13 20:43:02 +08:00
liufumingren
938e46e04c fix(panel): 拣货看板 top 分组 SQL 第一分支补今日任务窗口,消除 pto 全历史关联扫描(慢日志 1.75M 行/9.4s 超时) 2026-10-13 02:46:06 +08:00
liufumingren
3171ce4fab fix(pick): 拣货跳过拦截单区分打印状态,已打印面单不再自动移出波次(0.3.294) 2026-10-13 00:53:06 +08:00
liufumingren
eb4ce994ba fix(panel): scatterPacking 移除 wave 波次数(散单无波次语义,0.3.293) 2026-10-12 23:43:29 +08:00
liufumingren
ef933bc353 feat(panel): 新增 touchLastChangeAt 公共方法,拣货/复核/打包完成时通知大屏刷新(0.3.292) 2026-10-12 23:38:53 +08:00
liufumingren
75333b2eb6 fix(panel): 环节卡 doing/abnormal 统一订单表状态口径(拣货中/打包中/各环节异常双表,0.3.291) 2026-10-12 23:29:12 +08:00
liufumingren
b62d3247ac fix(panel): 打包卡 doing 改订单表 pack_status=padding 订单数口径(0.3.290) 2026-10-12 23:26:30 +08:00
liufumingren
8d86eb361b fix(panel): 打包汇总(pack 卡/团购/散单块)排除打包中,仅统计已完成 status=2(0.3.289) 2026-10-12 23:16:51 +08:00
liufumingren
2c9f656ac9 fix(panel): 打包卡 today 改真实打包订单数(团购按波次真实订单数替代 pack_quantity 快照,0.3.288) 2026-10-12 00:24:46 +08:00
liufumingren
d3e8421bdc fix(panel): fulfillment 已打包改 pack_status 存量口径,修复已打包大于已复核(0.3.287) 2026-10-12 00:18:55 +08:00
liufumingren
a22e788706 fix(panel): trend 下单量窗口修正为业务日窗口(凌晨从昨日自然日开始时间起算,0.3.286) 2026-10-12 00:01:49 +08:00
liufumingren
2452cef4f1 feat(panel): trend 移除 pack_count 打包数,仅保留总单量累计(0.3.285) 2026-10-11 23:54:20 +08:00
liufumingren
606928194f feat(panel): trend 补充 total 总单量字段(与 fulfillment.total 同口径,0.3.284) 2026-10-11 23:48:55 +08:00
liufumingren
bf1f2b3fad feat(panel): trend 双值改按小时累计(订单数/打包数累加,最后一点=全天总数,0.3.283) 2026-10-11 23:38:20 +08:00
liufumingren
c3f97279da feat(panel): trend 改业务日 24 点双值(创建/打包订单数落桶,label 从自然日开始时间起,0.3.282) 2026-10-11 23:34:57 +08:00
liufumingren
4ca6af82b0 feat(panel): 面板业务日窗口(day_start_time),打包卡 today 改订单数口径(与已打包一致),fulfillment 追加今日退件/拆包,退件表补创建时间索引(0.3.281) 2026-10-11 21:54:08 +08:00
liufumingren
4b8e17c139 fix(stock.check): 盘点范围排除无头库位(zone 不存在/已删除不入明细与作业视图,0.3.280) 2026-10-11 21:05:44 +08:00
liufumingren
731bc8e9fb feat(system): 新增 getWarehousePanelData 仓库面板数据接口(增量缓存返回),平台白名单补 tv 2026-10-10 04:45:14 +08:00
liufumingren
879bfaccbe fix(stock.check): result 无作业记录时返回明细范围行(盘点前/待提交后台查看明细,0.3.262) 2026-10-10 04:36:03 +08:00
liufumingren
d4daa6d671 fix(stock.check): exportDetail 汇总和差异 sheet 增加条码列(0.3.261) 2026-10-10 04:23:05 +08:00
liufumingren
d8ffc01429 fix(stock.check): exportDetail 无库位上报记录库位列按商品任务库位兜底显示(0.3.261) 2026-10-10 04:14:18 +08:00
liufumingren
0785e7df38 fix(stock.check): exportDetail 库位明细按作业记录导出,库位编码显示覆盖(自定义名称→自定义编码→库位编码,0.3.261) 2026-10-10 04:11:21 +08:00
liufumingren
fab2d9c0d1 fix(stock.check): exportDetail 商品盘点固定两 sheet(汇总和差异 + 库位/数量/条码/商品名称),移除 mode 入参(0.3.261) 2026-10-10 03:58:54 +08:00
liufumingren
78b46a740b feat(stock.check): 新增 exportDetail 盘点明细导出(商品盘点库位明细/汇总+差异两模式,库位盘点简化,0.3.261) 2026-10-10 03:34:28 +08:00
liufumingren
1402aa3841 refactor(stock.check): submit 仅刷新明细行账面快照,不写主表 scope_snapshot(明细表已完整记录,0.3.260) 2026-10-10 03:22:40 +08:00
liufumingren
3401645419 feat(stock.check): submit 提交审核时固化商品范围账面快照(明细行库位级 + 主表 scope_snapshot 总数/锁定,0.3.260) 2026-10-10 03:10:13 +08:00
liufumingren
ae107e5cbe fix(stock.check): result 商品范围按商品聚合输出,库位账面快照随行输出(0.3.259) 2026-10-10 02:33:43 +08:00
liufumingren
e4472e2c74 fix(stock.check): space 视图排序仅按 pick_sequence,priority 与 id 不参与(0.3.258) 2026-10-09 22:18:39 +08:00
liufumingren
9d3c6b31fd fix(stock.check): workData space 视图库位排序对齐拣货模块(pick_priority 降序改升序,0.3.257) 2026-10-09 22:08:56 +08:00
liufumingren
05bef9210a fix(wave): 波次自动终结加固,防建波中间态误关(B2026100900660 事故)
- 年龄门槛 5->30 分钟,覆盖建波后订单绑定延迟的分钟级空窗
- 判空新增波次索引表交叉校验:订单表与索引表双空判为未绑定中间态不终结;索引有行时抽样核对识别读偏
- 候选条件与终结 UPDATE 改用 UTC_TIMESTAMP,与 create_time UTC 存储口径显式一致
- 调度执行日志补 unbound/misread/probeFailed 统计
- 测试 9->15 用例(双空/读偏/正常离表/查询失败/抽样失败/时区口径)
2026-10-09 20:05:36 +08:00
liufumingren
29b39a7add fix(order): 二次转 B2B 恢复软删除明细行并重置作业字段
- 场景:转 B2B → 取消(明细软删除)→ 再转 B2B。原 findOrCreate 命中
  软删除行后直接返回,明细行保持 deleted_at 非空(B2B 明细查询不到),
  二次转后订单是 B2B 但无有效作业明细
- 修复:convertOrdersToB2b 明细写入改为 findOne(paranoid:false) + 显式分支——
  存在历史行(含软删)时恢复同一行并重置作业字段(deleted_at=null、
  total_box_count=0、pickup_plate_number=null、prep_remark=null、
  prep_duration_seconds=0、is_picked_up=N、picked_up_at=null、is_print=N、
  更新仓库/货主/发货单号快照,update 带 paranoid:false);不存在才 create
- 验证:临时集成测试转→取消→再转 1/1 PASS(二次转成功、恢复同一行、
  deleted_at 清空、作业字段重置、订单 is_b2b=Y,测后还原);ESLint 0 error
2026-10-09 00:39:03 +08:00