docs(order): 订单列表 where 补充 lock_status 筛选说明

- pendingOrder.list 的 where 参数说明补充:未锁定传 lock_status=none,
  已锁定(所有非 none)传 lock_status={operator:ne,value:none}
- 筛选值使用数据库原始枚举 none/warehouse/store 而非响应 Y/N,条件值为空自动忽略
- 补充 2026.08.18-order-list-lock-status-filter-doc 变更记录
This commit is contained in:
liufumingren 2026-08-19 00:00:40 +08:00
parent d18da89925
commit 29e7b6ae70
2 changed files with 17 additions and 1 deletions

View File

@ -1,4 +1,20 @@
[
{
"version": "2026.08.18-order-list-lock-status-filter-doc",
"date": "2026-08-18",
"type": "enhanced",
"summary": "订单列表 where 补充 lock_status 筛选说明:未锁定传 lock_status=none,已锁定(所有非 none)传 lock_status={operator:ne,value:none};筛选用数据库原始枚举 none/warehouse/store 而非响应 Y/N,条件值为空自动忽略。",
"methods": [
"order.pendingOrder.list"
],
"notes": [
"仅文档补充,无代码改动:methods/system.json 中 order.pendingOrder.list 的 where 参数 description 增加 lock_status 筛选说明",
"行为依据:app/service/systemMethods/order/base.js listByModule/buildWhere 对 where 无字段白名单(仅禁止 warehouse_id/warehouseId),可直接传订单表列名;app/lib/query_condition_parser.js 支持 ne 操作符且条件值为空时自动忽略(isEmptyValue 跳过)",
"lock_status 数据库原始枚举 none/warehouse/store(app/model/order_delivery.js LOCK_STATUS),列表响应仍统一输出 Y/N(normalizeLockStatusFlag:none→N,其余→Y),筛选入参必须用原始枚举而非响应 Y/N",
"同样经 listByModule 的其它工作台订单列表(order.reviewOrder.list / order.outboundOrder.list / order.expectionOrder.list / order.entrustOrder.list / order.deliveryOrder.list / order.deliveryExpectionOrder.list / order.archiveOrder.list)where 语义一致,本次保持其文档不变,重点仅更新 order.pendingOrder.list"
],
"module": "order"
},
{
"version": "2026.08.18-setting.expressInterface.update-doc-params",
"date": "2026-08-18",

View File

@ -2945,7 +2945,7 @@
"type": "object",
"required": false,
"source": "body",
"description": "统一 where 条件对象;禁止传入 warehouse_id / warehouseId。"
"description": "统一 where 条件对象;禁止传入 warehouse_id / warehouseId。where 无字段白名单,可直接传订单表列名。lock_status 锁定状态筛选(筛选值用数据库原始枚举 none/warehouse/store,不是响应中的 Y/N;ne 表示不等于;条件值为空自动忽略):未锁定 {\"lock_status\":\"none\"};已锁定(所有非 none){\"lock_status\":{\"operator\":\"ne\",\"value\":\"none\"}}。"
},
{
"name": "sort",