docs: 补充 5132 详细出行人契约

这个提交包含在:
API Changelog Bot 2026-07-22 11:07:42 +08:00
父节点 f96f5302af
当前提交 d8cb0d6128

查看文件

@ -56,16 +56,23 @@ GET /admin/fleet/board/orders/{orderId}
| `travelers` | Array | 出行人脱敏基本信息;无出行人或下游降级时返回 `[]` | | `travelers` | Array | 出行人脱敏基本信息;无出行人或下游降级时返回 `[]` |
| `travelers[].travelerId` | String | 出行人雪花 ID,必须按字符串处理 | | `travelers[].travelerId` | String | 出行人雪花 ID,必须按字符串处理 |
| `travelers[].travelerType` | String/null | `ADULT` / `CHILD` / `YOUNG_CHILD` / `BABY` | | `travelers[].travelerType` | String/null | `ADULT` / `CHILD` / `YOUNG_CHILD` / `BABY` |
| `travelers[].travelerTypeName` | String/null | 人员类型中文名,如“成人”“儿童” |
| `travelers[].nameMasked` | String/null | 脱敏姓名 | | `travelers[].nameMasked` | String/null | 脱敏姓名 |
| `travelers[].gender` | String/null | 性别字典值 | | `travelers[].gender` | String/null | 性别字典值 |
| `travelers[].genderName` | String/null | 性别中文名 |
| `travelers[].ageAtDeparture` | Number/null | 按订单出发日计算的周岁 | | `travelers[].ageAtDeparture` | Number/null | 按订单出发日计算的周岁 |
| `travelers[].idType` | String/null | 证件类型字典值 | | `travelers[].idType` | String/null | 证件类型字典值 |
| `travelers[].idTypeName` | String/null | 证件类型中文名 |
| `travelers[].idNoMasked` | String/null | 脱敏证件号 | | `travelers[].idNoMasked` | String/null | 脱敏证件号 |
| `travelers[].phoneMasked` | String/null | 脱敏手机号 | | `travelers[].phoneMasked` | String/null | 脱敏手机号 |
| `travelers[].nationality` | String/null | 国籍 | | `travelers[].nationality` | String/null | 国籍 |
| `travelers[].race` | String/null | 民族 |
| `travelers[].emergencyContactMasked` | String/null | 脱敏紧急联系人姓名 | | `travelers[].emergencyContactMasked` | String/null | 脱敏紧急联系人姓名 |
| `travelers[].emergencyPhoneMasked` | String/null | 脱敏紧急联系人电话 | | `travelers[].emergencyPhoneMasked` | String/null | 脱敏紧急联系人电话 |
| `travelers[].roomGroupNo` | Number/null | 同住分组号 |
| `travelers[].transportPlanIds` | String[] | 关联大交通批次 ID,必须按字符串处理 |
| `travelers[].profileStatus` | String/null | 资料状态:`PENDING` / `COMPLETED` | | `travelers[].profileStatus` | String/null | 资料状态:`PENDING` / `COMPLETED` |
| `travelers[].profileStatusName` | String/null | 资料状态中文名 |
`productName` 是已有字段,结构不变;本次页面必须消费,不再只保存在 `normalizeBoardOrder().product` 而不展示。 `productName` 是已有字段,结构不变;本次页面必须消费,不再只保存在 `normalizeBoardOrder().product` 而不展示。
@ -127,16 +134,23 @@ GET /admin/fleet/board/orders/{orderId}
{ {
"travelerId": "3001", "travelerId": "3001",
"travelerType": "ADULT", "travelerType": "ADULT",
"travelerTypeName": "成人",
"nameMasked": "孔**", "nameMasked": "孔**",
"gender": "2", "gender": "2",
"genderName": "女",
"ageAtDeparture": 35, "ageAtDeparture": 35,
"idType": "ID_CARD", "idType": "ID_CARD",
"idTypeName": "身份证",
"idNoMasked": "150***********1234", "idNoMasked": "150***********1234",
"phoneMasked": "138****1234", "phoneMasked": "138****1234",
"nationality": "中国", "nationality": "中国",
"race": "蒙古族",
"emergencyContactMasked": "王*", "emergencyContactMasked": "王*",
"emergencyPhoneMasked": "139****5678", "emergencyPhoneMasked": "139****5678",
"profileStatus": "COMPLETED" "roomGroupNo": 1,
"transportPlanIds": ["4001"],
"profileStatus": "COMPLETED",
"profileStatusName": "已完善"
} }
], ],
"transport": { "transport": {
@ -179,7 +193,7 @@ GET /admin/fleet/board/orders/{orderId}
- 主文案显示 `nodeName` - 主文案显示 `nodeName`
- `durationMinutes` 有值时显示易读时长。 - `durationMinutes` 有值时显示易读时长。
- `description` 有值且与日简介不重复时显示节点简介。 - `description` 有值且与日简介不重复时显示节点简介。
4. 右侧新增“出行人信息”区,默认展示脱敏姓名、人员类型、性别、出发时年龄、脱敏手机号和资料状态;证件/紧急联系人可在行内展开或次要信息区展示。 4. 右侧新增“出行人信息”区,默认展示脱敏姓名、人员类型、性别、出发时年龄、国籍/民族、脱敏手机号和资料状态;证件、同住分组、关联大交通批次及紧急联系人可在行内展开或次要信息区展示。
5. 禁止为了展示此页面调用明文接口 `POST /admin/fleet/board/orders/{orderId}/travelers/plain`。Step1 只使用详情响应中的脱敏 `travelers[]` 5. 禁止为了展示此页面调用明文接口 `POST /admin/fleet/board/orders/{orderId}/travelers/plain`。Step1 只使用详情响应中的脱敏 `travelers[]`
6. 空态明确:无节点显示“暂无行程节点”,无出行人显示“暂未填写出行人信息”;不得生成模拟节点或模拟出行人。 6. 空态明确:无节点显示“暂无行程节点”,无出行人显示“暂未填写出行人信息”;不得生成模拟节点或模拟出行人。
7. 雪花 ID 禁止 `Number()` / `parseInt()`,统一按字符串处理。 7. 雪花 ID 禁止 `Number()` / `parseInt()`,统一按字符串处理。
@ -206,6 +220,7 @@ GET /admin/fleet/board/orders/{orderId}
- [ ] 每日安排按节点顺序展示时间、节点名、时长和简介。 - [ ] 每日安排按节点顺序展示时间、节点名、时长和简介。
- [ ] 节点无 `startTime` 时可回退显示 `timePeriod`,不会出现 `undefined` - [ ] 节点无 `startTime` 时可回退显示 `timePeriod`,不会出现 `undefined`
- [ ] 右侧可看到全部出行人的脱敏基本信息。 - [ ] 右侧可看到全部出行人的脱敏基本信息。
- [ ] 每位出行人明确展示按出发日计算的年龄,并可查看人员类型、性别、证件、国籍/民族、同住分组、关联大交通及资料状态。
- [ ] 无节点/无出行人时展示真实空态,不生成模拟数据。 - [ ] 无节点/无出行人时展示真实空态,不生成模拟数据。
- [ ] 页面 Network 只需现有详情请求,不调用出行人明文接口。 - [ ] 页面 Network 只需现有详情请求,不调用出行人明文接口。
- [ ] 现有留言、特殊要求、步骤条和操作记录不受影响。 - [ ] 现有留言、特殊要求、步骤条和操作记录不受影响。