# 全局状态枚举参考（小程序 + 管理端）

**日期**: 2026-03-22
**类型**: 参考文档

---

## 一、订单状态（order_status）

后端字段：`status`，共 11 个值。

| 值 | 中文 | 说明 |
|----|------|------|
| `PENDING_PAY` | 待支付 | 下单后未支付 |
| `DEPOSIT_PAID` | 已付定金 | 定金模式已付定金 |
| `PAID` | 已全额支付 | 全款模式已付全款 |
| `CONFIRMED` | 已确认 | 管理员/系统确认订单 |
| `PENDING_BALANCE` | 待付尾款 | 定金模式，待付尾款 |
| `PENDING_DEPARTURE` | 待出行 | 内部流程全部就绪 |
| `TRAVELLING` | 旅行中 | 出发日自动切换 |
| `COMPLETED` | 已完成 | 行程结束自动切换 |
| `CANCELLED` | 已取消 | 用户/管理员/系统取消 |
| `REFUNDING` | 退款中 | 退款申请已提交 |
| `REFUNDED` | 已退款 | 退款到账 |

### 状态流转

```
PENDING_PAY → DEPOSIT_PAID / PAID / CANCELLED
DEPOSIT_PAID → CONFIRMED / REFUNDING
PAID → CONFIRMED / REFUNDING
CONFIRMED → PENDING_BALANCE / PENDING_DEPARTURE / REFUNDING
PENDING_BALANCE → PENDING_DEPARTURE / REFUNDING
PENDING_DEPARTURE → TRAVELLING / REFUNDING
TRAVELLING → COMPLETED
COMPLETED → REFUNDING
REFUNDING → REFUNDED
```

---

## 二、小程序展示状态（order_display_status）

后端字段：`displayStatus`，简化为 7 个 Tab 用值。

| 值 | 中文 | 对应的内部状态 |
|----|------|---------------|
| `PENDING_PAY` | 待支付 | PENDING_PAY |
| `PENDING_DEPARTURE` | 待出行 | DEPOSIT_PAID, PAID, CONFIRMED, PENDING_BALANCE, PENDING_DEPARTURE |
| `TRAVELLING` | 出行中 | TRAVELLING |
| `PENDING_REVIEW` | 待评价 | COMPLETED（未评价） |
| `COMPLETED` | 已完成 | COMPLETED（已评价） |
| `AFTER_SALE` | 售后 | REFUNDING, REFUNDED |
| `CANCELLED` | 已取消 | CANCELLED |

---

## 三、内部流程状态（process_status）

后端字段：`processStatus`，订单确认后的 7 步内部工作流。

| 值 | 中文 | 步骤 |
|----|------|------|
| `PENDING_INFO` | 待补全信息 | 0（初始） |
| `PENDING_INSURANCE` | 待配保险 | 1 |
| `PENDING_CONTRACT` | 待签合同 | 2 |
| `PENDING_ROOM` | 待配房 | 3 |
| `PENDING_VEHICLE` | 待配车 | 4 |
| `PENDING_FINANCE` | 待核算 | 5 |
| `READY` | 就绪 | 6（流程完成） |
| `INTERNAL_CONFIRMED` | 内部已确认 | 特殊 |

### 流转顺序

```
PENDING_INFO → PENDING_INSURANCE → PENDING_CONTRACT → PENDING_ROOM → PENDING_VEHICLE → PENDING_FINANCE → READY
```

---

## 四、支付交易状态（payment_status）

后端字段：`PaymentTransaction.status`

| 值 | 中文 | 说明 |
|----|------|------|
| `PENDING` | 待支付 | 预下单已创建 |
| `SUCCESS` | 支付成功 | 微信回调确认 |
| `CLOSED` | 已关闭 | 交易关闭 |
| `FAILED` | 支付失败 | 支付异常 |

### 支付类型（pay_type）

| 值 | 中文 |
|----|------|
| `FULL` | 全款 |
| `DEPOSIT` | 定金 |
| `BALANCE` | 尾款 |

### 交易方式（trade_type）

| 值 | 中文 |
|----|------|
| `JSAPI` | 小程序支付 |
| `H5` | H5支付 |

### 商户号

| mchId | 别名 | 中文 |
|-------|------|------|
| `1106110439` | hulai | 呼籁 |
| `1246532201` | shanhe | 山河 |
| `1684769133` | wenlu | 文旅 |

---

## 五、退款状态

### 退款交易状态（refund_status）

| 值 | 中文 |
|----|------|
| `PENDING` | 退款中 |
| `SUCCESS` | 退款成功 |
| `FAILED` | 退款失败 |
| `ABNORMAL` | 退款异常 |

### 退款申请状态（refund_application_status）

| 值 | 中文 | 说明 |
|----|------|------|
| `PENDING` | 待审核 | 用户提交退款申请 |
| `APPROVED` | 已通过 | 管理员审核通过 |
| `REJECTED` | 已拒绝 | 管理员驳回 |
| `REFUNDING` | 退款中 | 已发起微信退款 |
| `REFUNDED` | 已退款 | 退款到账 |
| `CANCELLED` | 已撤回 | 用户撤回申请 |
| `APPEALING` | 申诉中 | 用户对驳回发起申诉 |
| `APPEAL_APPROVED` | 申诉通过 | 申诉审核通过 |
| `APPEAL_REJECTED` | 申诉驳回 | 申诉被驳回 |

### 退款类型（refund_type）

| 值 | 中文 |
|----|------|
| `DEPOSIT` | 定金 |
| `BALANCE` | 尾款 |
| `FULL` | 全款 |

---

## 六、保险状态（insurance_status）

后端字段：`InsuranceOrder.status`

| 值 | 中文 |
|----|------|
| `PENDING` | 待出单 |
| `INSURED` | 已承保 |
| `CANCELLED` | 已退保 |
| `FAILED` | 投保失败 |

---

## 七、合同状态（contract_status）

后端字段：`Contract.status`

| 值 | 中文 | 说明 |
|----|------|------|
| `PENDING` | 待生成 | 合同记录已创建 |
| `GENERATED` | 已生成 | 合同文件已生成 |
| `SIGNING` | 签署中 | 等待用户签署 |
| `SIGNED` | 已签署 | 双方签署完成 |
| `VOIDING` | 作废中 | 发起作废 |
| `VOIDED` | 已作废 | 合同已作废 |
| `REPORTED` | 已上报 | 合同已上报12301 |
| `UPLOADED` | 已上传 | 合同已上传至平台 |

---

## 八、产品状态（product_status）

后端字段：`Product.status`

| 值 | 中文 | 说明 |
|----|------|------|
| `DRAFT` | 草稿 | 新建/编辑中 |
| `PENDING_REVIEW` | 待审核 | 提交审批 |
| `REVIEWED` | 已审核 | 审批通过 |
| `REJECTED` | 已驳回 | 审批驳回 |
| `PUBLISHED` | 已上架 | 小程序可见 |
| `UNPUBLISHED` | 已下架 | 小程序不可见 |
| `COMPLETED` | 已完成 | 定制产品完成设计 |
| `ORDERED` | 已下单 | 定制产品已下单 |

### 产品类型（product_type）

| 值 | 中文 |
|----|------|
| `CORE` | 核心产品 |
| `ROUTE` | 路书产品 |
| `CUSTOM` | 私人定制 |
| `GROUP` | 小蒙马拼团 |

---

## 九、待办状态（todo_status）

| 值 | 中文 |
|----|------|
| `PENDING` | 待处理 |
| `COMPLETED` | 已完成 |
| `CANCELLED` | 已取消 |

### 待办类型（todo_type）

| 值 | 步骤 | 中文 | 负责角色 |
|----|------|------|----------|
| `INSURANCE` | 1 | 待配置保险 | 定制师 |
| `CONTRACT` | 2 | 待签订合同 | 定制师 |
| `ARRANGE_ROOM` | 3 | 待安排住宿 | 房务 |
| `ARRANGE_VEHICLE` | 4 | 待安排车辆 | 车务 |
| `CONFIRM_CHECKLIST` | 5 | 待确认清单 | 定制师 |
| `PROCESS_REFUND` | 紧急 | 需退款处理 | - |

---

## 十、发票状态（invoice_status）

| 值 | 中文 |
|----|------|
| `PENDING` | 待开票 |
| `ISSUED` | 已开票 |
| `FAILED` | 开票失败 |
| `VOIDED` | 已作废 |
