|
|
@@ -0,0 +1,39 @@
|
|
|
+# MCP 排舱单号字段文案统一设计
|
|
|
+
|
|
|
+## 背景
|
|
|
+
|
|
|
+`query_order_exact` 使用 `outbound_number` 和 `outbound_numbers` 查询
|
|
|
+`fms_outbound.outbound_number`。当前工具说明将该字段称为“出库单号”，但业务页面
|
|
|
+使用的准确名称是“排舱单号”，容易使 AI 和员工误解字段含义。
|
|
|
+
|
|
|
+## 目标
|
|
|
+
|
|
|
+- 对外说明统一使用“排舱单号”。
|
|
|
+- 明确该字段不是海外仓出库单号，减少号码类型误判。
|
|
|
+- 保持现有接口和查询行为不变。
|
|
|
+
|
|
|
+## 方案
|
|
|
+
|
|
|
+保留 `outbound_number` 和 `outbound_numbers` 字段名，因为它们已经与数据库字段、
|
|
|
+Python Gateway、PHP 校验及查询逻辑对齐。仅修改以下文案和回归断言：
|
|
|
+
|
|
|
+1. `outbound_number` 说明改为单个排舱单号精准查询，并提示不是海外仓出库单号。
|
|
|
+2. `outbound_numbers` 说明改为多个排舱单号批量精准查询。
|
|
|
+3. 工具总说明中的“出库单号”改为“排舱单号”。
|
|
|
+4. 工具元数据测试断言同步改为“排舱单号”，并验证区分海外仓出库单号的提示。
|
|
|
+5. 项目文档记录本次业务术语修正。
|
|
|
+
|
|
|
+## 不在范围内
|
|
|
+
|
|
|
+- 不修改数据库字段名。
|
|
|
+- 不修改 MCP 入参或返回字段名。
|
|
|
+- 不修改 PHP 查询、校验和权限逻辑。
|
|
|
+- 不把 `outbound_date_start`、`outbound_date_end` 的“出库日期”改为“排舱日期”；
|
|
|
+ 日期字段与本次单号术语修正不是同一业务概念。
|
|
|
+
|
|
|
+## 验证
|
|
|
+
|
|
|
+- 运行 `tests.test_query_order_exact_tool`，确认工具元数据文案正确。
|
|
|
+- 运行 Python Gateway 全量单元测试，确认字段结构和调用行为无回归。
|
|
|
+- 搜索 `query_order_exact` 相关说明，确认不再将 `outbound_number(s)` 标注为
|
|
|
+ “出库单号”。
|
jackson