diff --git a/changelogs/2026-03/2026-03-24_traveler_gender_string.md b/changelogs/2026-03/2026-03-24_traveler_gender_string.md new file mode 100644 index 0000000..333ac4d --- /dev/null +++ b/changelogs/2026-03/2026-03-24_traveler_gender_string.md @@ -0,0 +1,70 @@ +# 出行人性别字段类型变更:Integer → String(匹配字典) + +> 日期:2026-03-24 +> 影响范围:小程序出行人模块、订单出行人模块 +> 关联字典:`gender` + +## 变更说明 + +出行人相关接口的 `gender` 字段从 `Integer` 改为 `String`,与字典 `gender` 的 `dict_value` 保持一致。 + +**之前**:`gender` 返回 Integer(如 `1`),前端用字典匹配时类型不一致导致报错 +**现在**:`gender` 返回 String(如 `"1"`),可直接与字典 `dict_value` 匹配 + +## 字典值对照 + +| dict_value (String) | dict_label | 说明 | +|---------------------|------------|------| +| `"1"` | 男 | — | +| `"2"` | 女 | — | + +## 受影响接口 + +### 小程序 - 出行人接口 + +| 接口 | 方法 | 路径 | +|------|------|------| +| 添加出行人 | POST | `/mp/user/traveler` | +| 出行人列表 | GET | `/mp/user/traveler` | +| 出行人详情 | GET | `/mp/user/traveler/{id}` | +| 更新出行人 | PUT | `/mp/user/traveler/{id}` | + +**请求参数变更**: +```json +{ + "gender": "1" // 之前是 Integer 1,现在是 String "1" +} +``` + +**响应字段变更**: +```json +{ + "gender": "1" // 之前是 Integer 1,现在是 String "1" +} +``` + +### 订单 - 创建订单(出行人信息) + +| 接口 | 方法 | 路径 | +|------|------|------| +| 创建订单 | POST | `/mp/order` | + +**travelers 数组中的 gender 字段**: +```json +{ + "travelers": [ + { + "name": "张三", + "gender": "1", // String,不再是 Integer + "idCardType": "ID_CARD", + "idCardNo": "110101199001011234" + } + ] +} +``` + +## 前端适配要点 + +1. **提交时**:`gender` 传 String 类型(`"1"` 或 `"2"`),不要传 Integer +2. **展示时**:返回值已经是 String,可直接用字典 `dict_value` 匹配显示中文标签 +3. **编辑回显**:`gender` 是 String,选择器绑定值直接用即可,无需类型转换