docs(order-v3): §2 traveler 模块 11 接口首推(§2.8 smart-parse 字段先定待 wx 实现)

v3 traveler 模块(出行人 + 大交通)全 11 接口完整契约:

§2A 出行人 admin CRUD(4 接口):
- §2.1 GET    /v3/admin/order/{id}/travelers              出行人列表
- §2.2 POST   /v3/admin/order/{id}/traveler/batch-edit    批量编辑(upsert)
- §2.3 POST   /v3/admin/order/{id}/travelers              单个新增
- §2.4 DELETE /v3/admin/order/{id}/travelers/{travelerId} 软删

§2B 大交通批次 admin CRUD(4 接口):
- §2.6.1 GET    /v3/admin/order/{id}/transport-plans            列表
- §2.6.2 POST   /v3/admin/order/{id}/transport-plans            新增
- §2.6.3 PUT    /v3/admin/order/{id}/transport-plans/{planId}   编辑
- §2.6.4 DELETE /v3/admin/order/{id}/transport-plans/{planId}   软删

§2C internal Feign(1 接口):
- §2.7 GET /v3/internal/order/orders/{orderId}/travelers  跨服务查(含明文 + 解密审计)

§2D 动词类操作(2 接口):
- §2.8 POST /v3/admin/order/{id}/traveler/smart-parse   wx 实现中(Issue #2526)
- §2.9 GET  /v3/admin/order/{id}/traveler/validate     出行人信息校验

按 SKILL.md 新约定(多接口 changelog 按接口自含 + 示例必含请求/响应)组织:
- §3.1~§3.11 共 11 子节,每节含使用场景/入参/出参/错误码/业务边界/请求+响应示例
- §6 枚举集中 10 个(travelerType / gender / idType / profileStatus / direction
  / mode / transportType / selfDrivePeriod / purpose / missingFields),按字段
  分组 + 标使用接口位置

设计文档同步:API-SPEC v5.50(§2 章节路径全部 RESTful 复数化,与 v3 代码对齐)。
1125 行 / 13 节齐全 / §2.8 字段先定标  待 wx 实现立即可对接。
这个提交包含在:
yaosutu 2026-05-18 17:08:21 +08:00
父节点 172ab44800
当前提交 757a5dd60b