From 7a90d75b5ae982ffab61fb7b334238af2ad55d3e Mon Sep 17 00:00:00 2001
From: wx <2636507191@qq.com>
Date: Sun, 19 Jul 2026 11:06:48 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E8=A1=A5=E5=85=85=E6=A0=B8=E5=9B=A2?=
 =?UTF-8?q?=E5=87=BA=E8=A1=8C=E4=BA=BA=E5=87=BA=E7=94=9F=E6=97=A5=E6=9C=9F?=
 =?UTF-8?q?=E5=B9=B4=E9=BE=84=E5=A5=91=E7=BA=A6=20(#5068)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...…出行人补充出生日期和年龄-修改接å�£-管ç�†å�Žå�°.md | 85 +++++++++++++++++++
 1 file changed, 85 insertions(+)
 create mode 100644 changelogs-v2/2026-07/65_5068_核团详情出行人补充出生日期和年龄-修改接�-管���.md

diff --git a/changelogs-v2/2026-07/65_5068_核团详情出行人补充出生日期和年龄-修改接�-管���.md b/changelogs-v2/2026-07/65_5068_核团详情出行人补充出生日期和年龄-修改接�-管���.md
new file mode 100644
index 0000000..6e17d14
--- /dev/null
+++ b/changelogs-v2/2026-07/65_5068_核团详情出行人补充出生日期和年龄-修改接�-管���.md
@@ -0,0 +1,85 @@
+# �修改接�·管���】核团详情出行人补充出生日期和年龄（#5068）
+
+> **Issue**: [#5068](https://git.1814.love:8443/wx/HL/issues/5068) | **PR**: [#5069](https://git.1814.love:8443/wx/HL/pulls/5069) | **�务**: `hl-order-service-v3` | **更新时间**: 2026-07-19 11:06
+
+## 1. 关键�化
+
+- 核团详情 `travelers[]` 新增�空字段 `birthday` 和 `age`。
+- `birthday` 为出行人出生日期，格� `yyyy-MM-dd`。
+- `age` 为按订�出�日期计算的周�。
+- 出生日期为空�订�出�日期为空，或出生日期晚于出�日期时，`age` 返回 `null`。
+- 出行人手机�和�件�继续沿用原有脱�规则。
+
+## 2. �影�接�
+
+`GET /v3/admin/order/{orderId}/settlement/return-detail`
+
+- HTTP 方法�URL�认��路径�数��应整体结构���。
+- 本次�增加 `data.travelers[]` 的�应字段，�增加请求�数。
+
+## 3. 新增�应字段
+
+| 字段 | JSON 类型 | 是��空 | 说明 |
+|---|---|---|---|
+| `data.travelers[].birthday` | string | 是 | 出生日期，格� `yyyy-MM-dd` |
+| `data.travelers[].age` | number | 是 | 以订�出�日期为基准计算的周� |
+
+### �应示例
+
+```json
+{
+  "code": 200,
+  "message": "�功",
+  "data": {
+    "travelers": [
+      {
+        "travelerId": "71001",
+        "travelerName": "张三",
+        "travelerType": "ADULT",
+        "travelerTypeName": "�人",
+        "birthday": "1990-07-20",
+        "age": 36,
+        "idType": "ID_CARD",
+        "idTypeName": "身份�",
+        "phone": "138****1234",
+        "idCardNo": "110***********1234"
+      }
+    ]
+  },
+  "success": true
+}
+```
+
+> 示例仅展示本次相关结构；核团详情中的订���机车辆�应收和收款等字段����。
+
+## 4. 年龄计算与空值边界
+
+| 场景 | `birthday` | `age` |
+|---|---|---|
+| 出生日期和订�出�日期�有效 | 返回出生日期 | 返回两个日期之间的完整周� |
+| 出生日期为空 | `null` | `null` |
+| 订�出�日期为空 | 返回出生日期 | `null` |
+| 出生日期晚于订�出�日期 | 返回出生日期 | `null` |
+
+当�已�并实现�会在订�出�日期缺失时改用�务器当�日期。Issue #5068 �始�述中的“按当�日期兜底�尚未进入代�；若业务�需�该�径，应�行�更�端实现和本通知。
+
+## 5. �端适�清�
+
+- [ ] 在核团详情出行人列表展示 `birthday` 和 `age`。
+- [ ] 对两个字段�� `null` 兼容，�拼接 `null�` 或展示无效日期。
+- [ ] 年龄直接使用�端返回值，�在�览器端按当�日期�新计算。
+- [ ] 继续使用现有脱��的 `phone` 和 `idCardNo`，���试��明文。
+- [ ] �改�接� URL�请求�数和其他�应字段的解�逻辑。
+
+## 6. 兼容性与�布边界
+
+- 新增字段对忽略未知 JSON 字段的旧客户端��兼容。
+- 字段为�空值，�端�能把 `birthday` 或 `age` 设为必填。
+- PR #5069 已于 2026-07-19 10:47 �并到 `dev-v3`，�并�交为 `1da9389fbbc567dfd8b98703a6b9ebbfb2ea1d69`。
+- 本通知没有测试环境部署或网关真实请求��；代��并�等�于测试环境已生效。
+
+## 7. 验���
+
+- #5069 原始定�测试覆盖正常年龄�生日边界�空出生日期�空出�日期和未�出生日期。
+- 与 PR #5064 最新基线���，相关冲�� 41 项测试全部通过。
+- 最终 `hl-order-service-v3` reactor 共 5,799 项测试：0 failures�0 errors�15 �件跳过。