26 lines
1.5 KiB
Markdown
26 lines
1.5 KiB
Markdown
# 取货工单 MCP 工具设计
|
|
|
|
需求：REQ-20260917-0003；开发任务：#21964；设计文档：doc 12684。
|
|
|
|
## 工具
|
|
|
|
- `pickup.order.list.query`：分页查询 `m2.pickup_order`，支持工单号、公司、项目、类型、状态、取货方式、
|
|
申请人和申请/取货/完成日期过滤。固定按 ID 倒序，物流以本页工单号批量读取 m1，避免逐条查询。
|
|
- `pickup.order.detail.query`：按 ID 或工单号查询；返回主单、物流、原取货物品、SN 调整、物流图片、
|
|
已办流程与凭证、关联出入库/调拨/划转单。
|
|
|
|
## 权限
|
|
|
|
列表和详情统一调用 `PermissionService.applyPickupOrderRowFilter`：总部不加过滤；代理用户可见自己、
|
|
授权代管代理/物业范围及本人参与流程的工单（不扩展到直属下级代理）；销售非负责人使用其物业范围并保留本人流程参与范围。
|
|
不存在与无权访问统一返回 `NOT_FOUND_OR_FORBIDDEN`。
|
|
|
|
## 数据约定
|
|
|
|
- 申请日期按业务字段 `apply_time`，不沿用旧列表实际使用的 `create_time`。
|
|
- `pickup_order_details.type IN (0,2)` 为原取货物品，`type=1` 为取货后 SN 明细。
|
|
- 流程只返回 `schedule_state=2` 的已办记录，按 `operation_time,id` 正序。
|
|
- 流程附件限定 `file_type=3`、`in_out_allocation_type=12`。
|
|
- 附件只返回 bucket 与 objectKey，不拼接公开 URL。
|
|
- 不返回旧页面通过姓名字符串推断的 `isReceipt/isPickup` UI 操作标记。
|