From 252607cf8905f54373dc52af08101a7ebf7dc4f8 Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Tue, 24 Mar 2026 15:03:54 +0800
Subject: [PATCH] =?UTF-8?q?=E5=87=BA=E8=A1=8C=E4=BA=BAgender=E5=AD=97?=
 =?UTF-8?q?=E6=AE=B5=E7=B1=BB=E5=9E=8B=E5=8F=98=E6=9B=B4=EF=BC=9AInteger?=
 =?UTF-8?q?=20=E2=86=92=20String=EF=BC=88=E5=8C=B9=E9=85=8D=E5=AD=97?=
 =?UTF-8?q?=E5=85=B8=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) <noreply@anthropic.com>
---
 .../2026-03-24_traveler_gender_string.md      | 70 +++++++++++++++++++
 1 file changed, 70 insertions(+)
 create mode 100644 changelogs/2026-03/2026-03-24_traveler_gender_string.md

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，选择器绑定值直接用即可，无需类型转换