From 2a3ffb7737a60762fd431c8a31ffed5966ab5903 Mon Sep 17 00:00:00 2001
From: yaosutu <770858045@qq.com>
Date: Mon, 18 May 2026 15:37:54 +0800
Subject: [PATCH] =?UTF-8?q?docs(order-v3):=20=C2=A76=20=E6=9E=9A=E4=B8=BE/?=
 =?UTF-8?q?=E5=AD=97=E5=85=B8=E6=8C=89=E5=AD=97=E6=AE=B5=E5=88=86=E7=BB=84?=
 =?UTF-8?q?=E9=87=8D=E6=8E=92=20+=20SKILL=20=E5=90=8C=E6=AD=A5=E6=9B=B4?=
 =?UTF-8?q?=E6=96=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

原 §6 把 5 个枚举（createSource/orderStatus/flowStatus/consultantSource/paymentMode）
混在一张 23 行大表里，前端 AI 按字段查表难定位。
改为每枚举一个 H3 子节（6.1~6.5），每节附「所属字段 + 枚举类 + 类型 + 必填」头部说明。
---
 .../18_test_订单创建-修改接口-管理后台.md     | 84 +++++++++++++------
 1 file changed, 60 insertions(+), 24 deletions(-)

diff --git a/changelogs-v2/2026-05/18_test_订单创建-修改接口-管理后台.md b/changelogs-v2/2026-05/18_test_订单创建-修改接口-管理后台.md
index d4caa7e..6c5bfe2 100644
--- a/changelogs-v2/2026-05/18_test_订单创建-修改接口-管理后台.md
+++ b/changelogs-v2/2026-05/18_test_订单创建-修改接口-管理后台.md
@@ -83,30 +83,66 @@ v5.17 起入参扩展为 13 字段（新增 createSource / groupBatchId / roomCo
 
 ## 6. 枚举 / 数据字典
 
-| 所属字段 | 枚举类 | 值 | 中文 | 说明 |
-|----------|--------|----|------|------|
-| `createSource` | OrderCreateSource | `CUSTOMER` | 客户自助 | 客户在小程序自助下单 |
-| `createSource` | OrderCreateSource | `CONSULTANT` | 定制师代下单 | 默认值，B 端代下单 |
-| `createSource` | OrderCreateSource | `OTA` | OTA 渠道 | 携程 / 美团等 OTA 引流 |
-| `createSource` | OrderCreateSource | `WALK_IN` | 门店步入 | 线下门店现场下单 |
-| `createSource` | OrderCreateSource | `B2B` | B2B 渠道 | 旅行社代下单 |
-| `createSource` | OrderCreateSource | `VIP_REPURCHASE` | VIP 复购 | 老客户回购通道 |
-| `createSource` | OrderCreateSource | `REFERRAL` | 老客户转介绍 | — |
-| `createSource` | OrderCreateSource | `PROMOTION` | 营销活动 | — |
-| `createSource` | OrderCreateSource | `INTERNAL` | 内部测试 | 不计入业绩 |
-| `orderStatus` | OrderStatus | `待支付` | — | 创单后默认状态 |
-| `orderStatus` | OrderStatus | `待完善` | — | 订金到账后进入 |
-| `orderStatus` | OrderStatus | `定制中` | — | 出行人 + 房车齐后 |
-| `orderStatus` | OrderStatus | `已确认` | — | — |
-| `orderStatus` | OrderStatus | `出行中` | — | — |
-| `orderStatus` | OrderStatus | `已完成` | — | — |
-| `orderStatus` | OrderStatus | `已取消` | — | — |
-| `flowStatus` | OrderFlowStatus | `待支付订金` | — | 创单后默认细状态 |
-| `consultantSource` | ConsultantSource | `DEFAULT_ASSIGNED` | 系统默认分配 | 走轮询规则 |
-| `consultantSource` | ConsultantSource | `LINK_BOUND` | 链接绑定 | 客户扫了定制师专属码 |
-| `consultantSource` | ConsultantSource | `MANUAL` | 手动指定 | B 端 admin 强制指派 |
-| `paymentMode` | PaymentMode | `DEPOSIT` | 定金模式 | 30% 定金 + 余款 |
-| `paymentMode` | PaymentMode | `FULL` | 全款模式 | 100% 一次付清 |
+> 接口里出现的枚举按字段分开列。本接口共 5 个枚举字段。
+
+### 6.1 createSource（OrderCreateSource）
+
+**所属字段**：入参 `createSource` | **类型**：`String` | **必填**：❌（不传默认 `CONSULTANT`）
+
+| 值 | 中文 | 说明 |
+|----|------|------|
+| `CUSTOMER` | 客户自助 | 客户在小程序自助下单 |
+| `CONSULTANT` | 定制师代下单 | 默认值，B 端代下单 |
+| `OTA` | OTA 渠道 | 携程 / 美团等 OTA 引流 |
+| `WALK_IN` | 门店步入 | 线下门店现场下单 |
+| `B2B` | B2B 渠道 | 旅行社代下单 |
+| `VIP_REPURCHASE` | VIP 复购 | 老客户回购通道 |
+| `REFERRAL` | 老客户转介绍 | — |
+| `PROMOTION` | 营销活动 | — |
+| `INTERNAL` | 内部测试 | 不计入业绩 |
+
+### 6.2 orderStatus（OrderStatus）
+
+**所属字段**：出参 `orderStatus`（订单粗状态）| **类型**：`String`
+
+| 值 | 中文 | 说明 |
+|----|------|------|
+| `待支付` | 待支付 | 创单后默认状态 |
+| `待完善` | 待完善 | 订金到账后进入 |
+| `定制中` | 定制中 | 出行人 + 房车齐后 |
+| `已确认` | 已确认 | — |
+| `出行中` | 出行中 | — |
+| `已完成` | 已完成 | — |
+| `已取消` | 已取消 | — |
+
+### 6.3 flowStatus（OrderFlowStatus）
+
+**所属字段**：出参 `flowStatus`（订单细状态）| **类型**：`String`
+
+| 值 | 中文 | 说明 |
+|----|------|------|
+| `待支付订金` | 待支付订金 | 创单后默认细状态 |
+
+> 本节仅列创单接口能返回的细状态值；完整 flowStatus 枚举见订单状态机文档。
+
+### 6.4 consultantSource（ConsultantSource）
+
+**所属字段**：出参 `consultantSource`（定制师分配来源）| **类型**：`String`
+
+| 值 | 中文 | 说明 |
+|----|------|------|
+| `DEFAULT_ASSIGNED` | 系统默认分配 | 走轮询规则 |
+| `LINK_BOUND` | 链接绑定 | 客户扫了定制师专属码 |
+| `MANUAL` | 手动指定 | B 端 admin 强制指派 |
+
+### 6.5 paymentMode（PaymentMode）
+
+**所属字段**：出参 `paymentMode`（支付模式）| **类型**：`String`
+
+| 值 | 中文 | 说明 |
+|----|------|------|
+| `DEPOSIT` | 定金模式 | 30% 定金 + 余款 |
+| `FULL` | 全款模式 | 100% 一次付清 |
 
 ## 7. 错误码