hl-api-changelog/changelogs/2026-03/2026-03-23_chinese_labels.md
API Changelog Bot ff165ca9ba bug: 订单详情英文枚举值需要中文label
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-23 15:41:42 +08:00

33 行
1.6 KiB
Markdown

此文件含有模棱两可的 Unicode 字符

此文件含有可能会与其他字符混淆的 Unicode 字符。 如果您是想特意这样的,可以安全地忽略该警告。 使用 Escape 按钮显示他们。

# 【BUG】订单详情页英文枚举值需要中文显示
## 问题
订单详情 API 返回了大量英文枚举值,页面直接显示英文。以下是需要处理的字段:
## 后端会修复(补充 xxxLabel 字段)
### 已有 Label 但值是英文的(后端 bug
| 字段 | 当前值 | 应该显示 |
|------|--------|---------|
| timeline[].actionLabel | `CHECKLIST_CONFIRMED` | 确认清单 |
| timeline[].actionLabel | `EDIT_CONFIRMED` | 确认修改 |
| timeline[].actionLabel | `TODO_COMPLETED` | 待办完成 |
| timeline[].actionLabel | `PAYMENT_SUCCESS` | 支付成功 |
| timeline[].actionLabel | `ROOM_UPGRADE` | 房型升级 |
### 缺少 Label 字段(后端会补充)
| 字段 | 示例值 | 中文 | 新增Label字段 |
|------|--------|------|-------------|
| productType | CORE | 核心产品 | productTypeLabel |
| paymentMode | DEPOSIT | 定金+尾款 | paymentModeLabel |
| todos[].todoType | INSURANCE | 投保 | todoTypeLabel |
| todos[].status | PENDING | 待处理 | - (前端已有) |
| todos[].assigneeRoleKey | CUSTOMIZER | 定制师 | assigneeRoleLabel |
| travelers[].idCardType | ID_CARD | 身份证 | idCardTypeLabel |
| travelers[].travelerType | ADULT | 成人 | travelerTypeLabel |
| timeline[].operatorType | ADMIN/USER/SYSTEM | 管理员/用户/系统 | operatorTypeLabel |
| contracts[].contractType | TOUR | 旅游合同 | contractTypeLabel |
| contracts[].mode | STANDARD | 电子签约 | modeLabel |
## 前端处理建议
优先使用 `xxxLabel` 字段显示,如果没有 label 字段,前端做本地映射。后端会尽快补充所有缺失的 label。