mcp/CONTEXT.md

MCP Gateway

物流货运系统面向 Workbuddy 的 MCP Gateway 语境。业务规则在 fmsoperate；本文件只定义本仓对外使用的领域词。

合同入口

• 行为与验收：Y:/all_project_docs/mcp/requirements.md
• 实现边界：Y:/all_project_docs/mcp/tech-specs.md
• 物流工具与导出所有权：Y:/all_project_docs/fmsoperate/

Language

打托批次: 海外仓侧把若干订单打成一组托盘后形成的批次，业务号为 PB 开头的打托批次号。命中批次内任一订单，导出该批次的全部订单行和全部打托附件。 Avoid: 入仓单、海外仓入库明细、打托数（件数）、勾选行内部 ID、按筛选拆成半批次

打托数据导出: 按打托批次交出的下载包：与海外仓后台「导出打托数据」相同的 Excel，若这些批次有打托附件则连同附件打成 zip。单个附件下载失败则跳过该文件，任务仍成功；没有任何附件成功下载时只交 Excel。定位条件严格三选一：柜号数组、提单号数组，或海外仓入库时间闭区间（最多 31 天）；两类号码不能混用，也不能与时间混用。由独立异步任务生成，不走后台同步导出。调用方须能进入海外仓列表并使用导出接口；数据只按当前公司隔离。 Avoid: 入仓单号、入仓单列表导出、海外仓库存导出、对话内表格查询、只要 Excel 不要附件、勾选内部 inbound_id、订单号/打托批次号混查、复用后台同步 ExportPalletLogic、套用列表的国家/运输方式范围、任一附件失败就整任务失败

柜号与提单号: 打托数据导出分别按 fms_outbound.container_code 或关联 fms_booking_detail.bl_number 精确匹配，一次只允许一种号码类型，最多 200 个且每项最多 100 个字符。用户只提供号码但未说明类型时必须先询问，不得根据格式猜测或同时试查两类字段。 Avoid: 入仓单号、订单号、打托批次号、内部 ID、跨字段试查

海外仓入库时间: 入仓明细上的入库时间，用来圈定哪些入仓单进入本次导出。起止各自可只填日期或带时间：缺时间则开始日 00:00:00、结束日 23:59:59；填了时间则用该日该时。与存储值闭区间比较，不做列上的时区转换。不按海外仓列表页签再过滤。闭区间最多 31 个日历日。 Avoid: 到仓时间、列表页签状态、预计打托日期、把入库时间列做 CONVERT_TZ