89a1938cb9
回复 hl-api-changelog#1 前端反馈的 5 处契约不明 / 冲突，并同步补足 4 处文档与代码不一致： §1 订单核心模块（15 处修改）： - §3.1/§3.2/§3.3/§3.14 示例值：orderStatus/flowStatus 全部从中文标签改为英文枚举值 （后端 OrderInfo.orderStatus/flowStatus 直接透传 DB 列的英文枚举字符串） - §3.3 OrderMainVO 字段表： * customerName/customerPhone (admin 明文) → customerName + customerPhoneMasked（admin 也脱敏） * exceptionBadges/progressStepper 标注「运行时暂返 null，OrderInfoConverter 派生逻辑待 Issue 接通」 * 新增 6 个 Tab 状态徽标字段（contractStatus/insuranceStatus/refundStatus/hasRefund/hasServiceStandard/hasFinanceDetail） * subStatus 枚举补 NOT_APPLICABLE + 列示 ASSIGN_PARALLEL 子项结构 * 主聚合示例 transportPlanIds 改用真实雪花 ID（19 位）String - §3.11 取消预览业务边界：粗状态集改英文枚举 + 说明 v3 已删「已确认」 - §3.14 transition：eventCode 入参表内联 9 个值，便于前端跳读 - §6.2 orderStatus：全表替换为 10 个英文枚举（PENDING_PAY/PENDING_COMPLETE/CUSTOMIZING/PENDING_DEPARTURE/PENDING_BALANCE/TRAVELLING/REVIEWING/SETTLED/REFUNDING/CANCELLED） - §6.3 flowStatus：全表替换为 13 个英文枚举（AWAITING_DEPOSIT/.../CANCELLED_BEFORE_PAY） - §6.4 consultantSource：补 SHARED + ROUND_ROBIN，说明 user-service 透传规则 - §6.17 加后端 enum 路径备注 §2 traveler 模块（9 处修改）： - §3.1 出行人列表：每条 17 字段 → 16 字段（off-by-one 笔误） - §3.1/§3.3 curl 示例：路径 /travelers → /traveler/list 和 /traveler/add（对齐字段表与代码 @PostMapping） - §3.1 transportPlanIds：补全局 Long→String 序列化规则脚注 + 示例值改真实雪花 ID - §3.4 错误码段位让位：581119 → 581106（已签合同禁删），581120 → 581107（最后成人禁删） （DB 段位 581119/581120 已分别被 TRAVELER_ID_CARD_DUPLICATE / TRANSPORT_PLAN_NOT_FOUND 占用） - §3.9 smart-parse 错误码段位让位：581120/581121/581122/581123 → 581131/581132/100501/581134 （581122 限流走 HL 全局 CommonErrorCode.RATE_LIMITED） - §12 注意事项同步删人错误码 关联： - Issue: #1 - 验证代码 commit: HL@dev-v3 47d24228 - 验证报告: HL/.claude/tmp-changelog/issue1-analysis.md（仅本地）