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 实现立即可对接。
这个提交包含在:
父节点
172ab44800
当前提交
757a5dd60b