docs(order-v3): §6 枚举/字典按字段分组重排 + SKILL 同步更新

原 §6 把 5 个枚举(createSource/orderStatus/flowStatus/consultantSource/paymentMode)
混在一张 23 行大表里,前端 AI 按字段查表难定位。
改为每枚举一个 H3 子节(6.1~6.5),每节附「所属字段 + 枚举类 + 类型 + 必填」头部说明。
这个提交包含在:
yaosutu 2026-05-18 15:37:54 +08:00
父节点 40e0a3cc60
当前提交 2a3ffb7737

查看文件

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