docs(api): 同步 system 接口文档、变更记录与方法路由(确认打印相关)

This commit is contained in:
liufumingren 2026-09-20 16:14:03 +08:00
parent 17f7e3d87b
commit 1771b5c6c9
3 changed files with 1367 additions and 148 deletions

View File

@ -304,7 +304,7 @@ rg "class .*Service|module.exports" app/service/qimenMethods
- 临时清单输出:temp/tmp-service-method-inventory.md
<!-- SERVICE_METHOD_INVENTORY:BEGIN -->
自动生成时间: 2026-09-19T07:16:48.802Z
自动生成时间: 2026-09-19T19:08:16.992Z
扫描范围: app/service/**/*.js
文件数: 216
@ -785,6 +785,8 @@ rg "class .*Service|module.exports" app/service/qimenMethods

View File

@ -1,4 +1,111 @@
[
{
"version": "2026.09.20-workbench-pack-backfill-confirm-print",
"date": "2026-09-20",
"type": "updated",
"summary": "打包链路(workbench.packOrder / workbench.finishPack)回写打包状态时同步补确认打印状态:扫描打包即视为面单已真实存在,confirm_print_status 未写入(none/null)时补 fin,团购按波次、散单按单,拦截订单跳过,并递增统计版本号驱动确认打印未领单长轮询。",
"methods": [
"workbench.packOrder",
"workbench.finishPack"
],
"notes": [
"实现入口:systems/workbench.js _updateOrderPackStatus(覆盖开始打包/完成打包/关闭旧任务全部路径)",
"幂等:仅 confirm_print_status 为 none/null 时补 fin"
]
},
{
"version": "2026.09.20-wave-confirmPrintScan-need-right",
"date": "2026-09-20",
"type": "updated",
"summary": "order.wave.confirmPrintScan 改为需要接口权限(isNeedAuth=true),从免权限名单移除;confirmPrintUnclaimedWaveCount 保持免权限。",
"methods": [
"order.wave.confirmPrintScan"
],
"notes": [
"运行时:wave.js _noNeedRight/_noNeedAuth 已移除 confirmPrintScan,checkAuth 走 checkApiPermission",
"权限记录由 permission:sync:system-api 从 system.json isNeedAuth=true 接口同步并授权角色 2"
]
},
{
"version": "2026.09.20-pendingOrder-list-confirm-print-claim-fields",
"date": "2026-09-20",
"type": "updated",
"summary": "order.pendingOrder.list 文档补充 confirm_print_status(确认打印)与 claim_status(领料)的 where 筛选说明与响应字段说明(功能已支持,本次仅同步文档)。",
"methods": [
"order.pendingOrder.list"
],
"notes": [
"列表输出 ORDER_LIST_BASE_ATTRIBUTES 已包含 confirm_print_status/claim_status;where 无字段白名单,两列可直接透传筛选"
]
},
{
"version": "2026.09.20-wave-batchList-claim-status",
"date": "2026-09-20",
"type": "updated",
"summary": "order.wave.batchList 波次列表新增 claim_assignment_status 领料状态显示(含 claim_time/claim_operator)与 where.claim_assignment_status 筛选(波次表 claim_time 口径)。",
"methods": [
"order.wave.batchList"
],
"notes": [
"领料状态以波次表 wms_wave_batch.claim_time 是否为空判定(二态:未领料/已领料),与 confirmPrintUnclaimedWaveCount 口径一致",
"where 新增 claim_assignment_status 筛选字段(仅 eq,unclaimed/claimed,兼容中文)"
]
},
{
"version": "2026.09.20-wave-confirm-print-count-fix",
"date": "2026-09-20",
"type": "updated",
"summary": "order.wave.confirmPrintUnclaimedWaveCount 统计口径修正:未领单由订单维度 claim_status 改为波次表维度 wms_wave_batch.claim_time IS NULL,避免历史领单(波次表加 claim_time 字段前)导致少算。",
"methods": [
"order.wave.confirmPrintUnclaimedWaveCount"
],
"notes": [
"根因:B2026081500088/89 等波次订单 claim_status='fin'(历史领单)但 wave_batch.claim_time=null,订单维度口径误判为已领单导致 count 少算",
"新口径:wave_batch(wave_status 0/1、claim_time IS NULL)+ 波次下存在 confirm_print_status='fin' 的非取消订单"
]
},
{
"version": "2026.09.20-wave-confirm-print-scan-count",
"date": "2026-09-20",
"type": "added",
"summary": "order.wave 新增两个接口:confirmPrintScan(扫面单批量确认打印并写日志,与领单操作一致)与 confirmPrintUnclaimedWaveCount(快速查询已确认打印但未领单波次数量,支持 60s 长轮询,由确认打印/领单版本号驱动)。",
"methods": [
"order.wave.confirmPrintScan",
"order.wave.confirmPrintUnclaimedWaveCount"
],
"notes": [
"confirmPrintScan 复用 print.confirmWavePrint 实现(同入参同返回)",
"confirmPrintUnclaimedWaveCount 长轮询:1s 间隔轮询 Redis 版本号(wave:confirm-print:unclaimed:version:{warehouseId}),60s 超时;Redis 不可用时降级为轮询 DB count",
"确认打印(print.confirmWavePrint)与领单(pick.waveClaimScan)成功后均递增统计版本号"
]
},
{
"version": "2026.09.20-wave-batchList-confirm-print",
"date": "2026-09-20",
"type": "updated",
"summary": "order.wave.batchList 波次列表新增 confirm_print_assignment_status 显示与筛选(确认打印状态:未确认打印/部分确认打印/已确认打印)。",
"methods": [
"order.wave.batchList"
],
"notes": [
"where 新增 confirm_print_assignment_status 筛选字段(仅 eq,英文枚举 unconfirmed/partially_confirmed/confirmed)",
"list 每条新增 confirm_print_assignment_status 汇总状态字段"
]
},
{
"version": "2026.09.20-confirm-wave-print",
"date": "2026-09-20",
"type": "added",
"summary": "订单表新增 confirm_print_status(确认打印状态)字段,并新增 print.confirmWavePrint 波次确认打印接口:打印完成后扫描波次内任一订单面单,批量确认波次下已打印订单。",
"methods": [
"print.confirmWavePrint"
],
"notes": [
"订单表 wms_order_delivery 及全部分表新增 confirm_print_status ENUM('none','fin'),默认 none;迁移 20260920100000-add-confirm-print-status-to-order-delivery",
"波次下存在未打印订单(print_status != 'fin',拦截订单除外)时阻断确认",
"拦截订单跳过(不确认、不阻断);全部已确认时重复扫描返回 already_confirmed"
]
},
{
"version": "2026.09.19-workbench-packOrder-server-side-verification",
"date": "2026-09-19",

File diff suppressed because one or more lines are too long