[REQ-20260916-0020] 送货工单 MCP 查询工具（列表+详情） #18

2026-09-16T16:40:59+08:00

wangheng commented

2026-09-16 16:40:59 +08:00

What

新增送货工单只读 MCP 工具两个（关联需求 REQ-20260916-0020）：

delivery.order.list.query：送货工单列表查询，支持送货单号/来源单号/代理/站点/类型/状态/配送方式/申请人/申请日期/完成日期分页筛选，返回状态文案，固定 id DESC，rows 上限 100。申请日期筛选查业务字段 apply_time（修复旧接口误查 create_time 的逻辑）。
delivery.order.detail.query：工单详情，参数 id 或 deliveryOrderNo，返回 record/logistics/goods/shippingFiles/processes/relatedDocuments/relatedInstallOrderNo。附件仅返回 bucket+objectKey，详情无权限与不存在统一 NOT_FOUND_OR_FORBIDDEN。

Why

其他 agent 需要通过 MCP 端点查询送货工单，行级权限与老后台 applyDeliveryOrderRowFilter 保持一致（总部全量；代理限本代理+授权代管代理+代管物业+本人参与流程；销售非负责人限自建物业+代管代理物业）。

Test

Asia/Shanghai 时区全量单测 245/245 通过
新增 DeliveryOrderToolsTest 6 例 + PermissionServiceDeliveryOrderRowFilterTest 3 例

## What 新增送货工单只读 MCP 工具两个（关联需求 REQ-20260916-0020）： - `delivery.order.list.query`：送货工单列表查询，支持送货单号/来源单号/代理/站点/类型/状态/配送方式/申请人/申请日期/完成日期分页筛选，返回状态文案，固定 id DESC，rows 上限 100。申请日期筛选查业务字段 apply_time（修复旧接口误查 create_time 的逻辑）。 - `delivery.order.detail.query`：工单详情，参数 id 或 deliveryOrderNo，返回 record/logistics/goods/shippingFiles/processes/relatedDocuments/relatedInstallOrderNo。附件仅返回 bucket+objectKey，详情无权限与不存在统一 NOT_FOUND_OR_FORBIDDEN。 ## Why 其他 agent 需要通过 MCP 端点查询送货工单，行级权限与老后台 applyDeliveryOrderRowFilter 保持一致（总部全量；代理限本代理+授权代管代理+代管物业+本人参与流程；销售非负责人限自建物业+代管代理物业）。 ## Test - Asia/Shanghai 时区全量单测 245/245 通过 - 新增 DeliveryOrderToolsTest 6 例 + PermissionServiceDeliveryOrderRowFilterTest 3 例

wangheng added 1 commit 2026-09-16 16:40:59 +08:00

feat(mcp): add delivery order query tools (REQ-20260916-0020) 58da0c59d8

wangheng merged commit 6c8fe2e3bb into main

2026-09-16 16:41:08 +08:00

wangheng deleted branch feat/REQ-20260916-0020-delivery-order-tools

2026-09-16 16:41:08 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: wangheng/xiaoqu_mcp_service#18