From 38a38a3bf33988fd540a7c34c9964d549a073063 Mon Sep 17 00:00:00 2001 From: API Changelog Bot Date: Sun, 22 Mar 2026 18:58:36 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=85=A8=E5=B1=80=E7=8A=B6=E6=80=81?= =?UTF-8?q?=E6=9E=9A=E4=B8=BE=E5=8F=82=E8=80=83=EF=BC=88=E8=AE=A2=E5=8D=95?= =?UTF-8?q?/=E6=94=AF=E4=BB=98/=E6=B5=81=E7=A8=8B/=E4=BF=9D=E9=99=A9/?= =?UTF-8?q?=E5=90=88=E5=90=8C/=E4=BA=A7=E5=93=81/=E5=BE=85=E5=8A=9E?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.6 (1M context) --- .../2026-03/2026-03-22_status_reference.md | 236 ++++++++++++++++++ 1 file changed, 236 insertions(+) create mode 100644 changelogs/2026-03/2026-03-22_status_reference.md diff --git a/changelogs/2026-03/2026-03-22_status_reference.md b/changelogs/2026-03/2026-03-22_status_reference.md new file mode 100644 index 0000000..1a5961e --- /dev/null +++ b/changelogs/2026-03/2026-03-22_status_reference.md @@ -0,0 +1,236 @@ +# 全局状态枚举参考（小程序 + 管理端） + +**日期**: 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` | 已作废 |