wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 Actions 软件包 项目 版本发布 百科 动态
2,121 提交 20 分支 0 Git标签
提交图

6 次代码提交

作者 SHA1 备注 提交日期
yaosutu
1175979e12 docs(§1 订单核心模块): 同步 HL@087c4331 — §1.2 加 teamNo + §6.17 三元组化 + 加非 transition 段落 
回应前端 mmg 在 #2 issue 提的 2 处契约空白：

§3.2 §1.2 OrderListItemRespVO
- 字段表 17 → 18 字段，新增 teamNo（订金支付成功时生成；列表"团号"展示用）
- 响应 JSON 示例同步加 teamNo 字段
- 前端不再从 displayOrderNo substr 解析团号

§6.17 transition eventCode
- 9 行平铺表 → 16 条规则三元组（事件 → 前置态 → 目标态）
- 显式标注 CONFIRM 复用 2 种语义：
  · CUSTOMIZING → PENDING_DEPARTURE = 确认锁单
  · REVIEWING → SETTLED = 核单通过 / 确认结算
- FINISH 仅用于 TRAVELLING → REVIEWING（结团，不是结算）
- 新增 §6.17.2「非 transition 业务路径」段落：
  · 核单结算走独立 6 步接口 /settlement/step{1-6}/*，Step 6 submit 内部自动推 REVIEWING → SETTLED，前端不 fire eventCode
  · 退款走独立退款接口
  · 「申请解锁」v3 已砍，前端隐藏对应按钮

§13 关联链接 v5.49 → v5.50（同步 PR #2614 升的设计文档版本号）

关联：
- HL PR: wx/HL#2614 (merged 087c4331)
- 前端 issue: #2
 2026-05-19 16:50:34 +08:00
yaosutu
a47588b9a4 docs(v3-order): §6.2/§6.3 二次修订 — OrderStatus/OrderFlowStatus 对齐 SRS 
第一轮 commit 89a1938 按当时代码写了 §6.2 10 项（含 REFUNDING）+ §6.3 13 项支付术语，
但代码本身已偏离 SRS v5.48 设计。HL@PR #2589 完成代码回归 SRS 重构，本次同步修订 changelog：

§6.2 orderStatus：10 → 9 项
  - 删除 REFUNDING（SRS 决议：退款发起瞬间订单 order_status='CANCELLED'，
    退款进度由 refund_status 子字段表达）
  - 保留 PENDING_BALANCE（业务上 SET_PENDING_BALANCE 事件支持重开尾款）

§6.3 flowStatus：13 → 15 项 完全重写为业务术语
  - 旧 13 项支付节奏视角（AWAITING_DEPOSIT / DEPOSIT_PAID_PENDING_CONFIRM /
    CONFIRMED_PENDING_HOTEL...）全废弃
  - 新 15 项业务环节视角（AWAITING_PROFILE / AWAITING_HOTEL_SUBMIT /
    HOTEL_IN_PROGRESS / PENDING_CONFIRM...），与 SRS v5.48 §0.4 行 636 1:1 对齐

受影响的示例值同步修订（5 处）：
- §3.1 创单 flowStatus 默认值 AWAITING_DEPOSIT → AWAITING_PROFILE
- §3.2 列表示例 flowStatus CONFIRMED_PENDING_DEPARTURE → PENDING_DEPARTURE
- §3.3 主聚合示例 flowStatus CONFIRMED_PENDING_DEPARTURE → PENDING_DEPARTURE
- §3.11 取消预览业务边界粗状态集补 PENDING_BALANCE
- §3.14 transition 出参示例 newFlowStatus CONFIRMED_PENDING_DEPARTURE → PENDING_DEPARTURE

关联
- Issue: #1
- 后端 PR: wx/HL#2589
- 第一轮 changelog commit: 89a1938（部分被本次覆盖）
 2026-05-19 11:10:11 +08:00
yaosutu
89a1938cb9 docs(v3-order): 按代码事实修订 §1/§2 changelog（fix issue #1 + 补充 5 项） 
回复 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（仅本地）
 2026-05-19 10:28:11 +08:00
yaosutu
172ab44800 docs(order-v3): §1 changelog 补 §1B + §1C 共 5 接口，§1 模块 15 接口一次推全 
按用户反馈，§1B 取消订单 + §1C 状态机+锁单 与 §1A 一起推送（不分批）：

新增接口：
- §3.11 §1.5.0 GET  /v3/admin/order/{id}/cancel-preview          取消预览（只读）
- §3.12 §1.5.1 POST /v3/admin/order/{id}/cancel/pre-trip         取消出行前（企微 OA + 退款）
- §3.13 §1.5.2 POST /v3/admin/order/{id}/cancel/on-trip          取消出行中（仅登记返还）
- §3.14 §1.7   POST /v3/admin/order/{id}/transition              状态机通用入口
- §3.15 §1.8   GET  /v3/admin/order/{id}/confirm-checklist       锁单前置 5 项校验

每个接口按"自含"结构：使用场景 / 认证 / 入参 / 出参 / 错误码 / 业务边界 / 示例（请求+响应）。

§6 枚举新增：
- §6.17 transition eventCode 9 个状态机事件
- §6.18 transition triggeredEvents 6 个副作用事件
- §6.19 checklist item code 5 项前置校验
- §6.20 customerChannel 通知渠道 3 值

§0 / §2 / §11 / §12 同步更新："待补" 移除，全部 ✅；变更清单加 5 行；注意事项加取消订单分支说明 + CONFIRM 锁单约束。

文件从 1235 行 → 1730 行（diff +506 / -11）。
 2026-05-18 16:47:10 +08:00
yaosutu
bb18e4fac8 docs(order-v3): §1 changelog 修 3 问 + 重组为按接口自含结构 
按用户反馈修复 3 个问题：
(1) §1.3.1 主聚合输出字段：删 6 Tab 字段（finance/itinerary/contractInsurance/
    serviceStandard/statusLog/refund），代码 OrderDetailRespVO 实际只有
    main/tags/overview 3 字段（Issue #2460 已重构）
(2) 示例重组：原 §8 集中节按"多接口 changelog"模式打散，每个接口的请求+响应
    示例下沉到 §3.x 接口章节内紧跟出参/错误码/边界
(3) 补全缺失请求示例：§1.3.2 ~ §1.3.7 6 个 GET Tab 子接口、§1.3.1 异常 case
    等之前漏写请求示例的部分全补上

结构调整：原 13 节模板按"接口集中"组织（§3 详情/§4 入参/§5 出参/§7 错误码/
§8 示例 5 节）拆散为"每接口自含"结构（§3.x 含使用场景/入参/出参/错误码/边界/
示例），§6 枚举仍合并去重 + 标使用字段。

文件结构：
  §0 模块全貌（4 子模块 + 推送状态表）
  §1 接口背景
  §2 变更清单（10 接口表）
  §3 接口详情（10 个 §3.x 子节，每节自含）
  §6 枚举字典（16 节，按字段分组 + 标使用接口位置）
  §11 影响评估 / §12 注意事项 / §13 关联

SKILL.md 加约定：多接口 changelog 必须按接口分小节 + 示例必含请求+响应。

关联：HL feature 分支同步推 commit ae645a59 修 API-SPEC §1.3.1 字段表。
 2026-05-18 16:36:47 +08:00
yaosutu
87fd82c56d docs(order-v3): §1 core 模块首推 §1A（10 接口） 
订单核心模块全新二期首推，含订单 CRUD + 详情主聚合 + 6 Tab 子接口 + 修改字段：
§1.1 POST /v3/admin/order              创建订单
§1.2 GET  /v3/admin/order              订单列表
§1.3.1 GET /v3/admin/order/{id}        详情主聚合
§1.3.2 GET .../finance                 财务 Tab
§1.3.3 GET .../contract-insurance      合同保险 Tab
§1.3.4 GET .../itinerary               行程 Tab（⚠️ Mock）
§1.3.5 GET .../status-log              状态记录 Tab
§1.3.6 GET .../refund                  退款明细 Tab
§1.3.7 GET .../service-standard        服务标准 Tab
§1.4 PUT  /v3/admin/order/{id}         修改订单字段

883 行 / 13 节齐全 / 15 枚举按使用字段分组 / 8 组示例（典型+边界+异常）。
§1B 取消订单 / §1C 状态机后续 commit 追加同一文件。
设计文档同步升 v5.49（API/SRS/DETAIL/DB 4 份 HTML）。
 2026-05-18 16:17:59 +08:00