wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 工作流 软件包 项目 发布 百科 活动
884 提交 29 分支 0 Git 标签
ffecdc6fd6f34b25c4d3b8b6375359dad34bae74
提交图
37 次代码提交
此分支
此分支
所有分支
作者 SHA1 备注 提交日期
yaosutu ffecdc6fd6 feat(前端changelog): PR#2565 管理端代下单 v3 接口新增分享追踪字段 + consultantSource 枚举新增 SHARED 
- POST /admin/v3/orders 新增非必填字段 sharerOpenid / customizerId
- consultantSource 枚举新增 SHARED（C端分享锁定定制师）
- 新增错误码 581035 DEPOSIT_AMOUNT_EXCEEDS_TOTAL
- mchId 错误码从 MCH_RESOLVE_FAILED 变更为 AGENCY_NO_DEFAULT_MCHID
 2026-05-18 23:56:12 +08:00
yaosutu 2059566991 fix(§2): 删 §2.7 internal feign 接口节（前端 changelog 不收 internal） 
按 CLAUDE.md changelog 受众判定：
- /v3/admin/* → 前端 changelog（本仓库 hl-api-changelog）
- /v3/internal/* → 后端 changelog（hl-backend-changelog，受众=其他后端服务/运维）

§2.7 GET /v3/internal/order/orders/{orderId}/travelers 是 internal Feign
跨服务接口（合同/保险服务调用），前端不消费，移出本文档：

- §0 模块全貌：删 §2C internal Feign 行，合计 11→10，加范围说明
- §1 接口背景：删 §2.7 解密审计行
- §2 变更清单：删第 9 行，剩 10 条
- §3.9 §2.7 internal feign 节整段删除
- §3.10 §2.8 smart-parse 重编号为 §3.9
- §3.11 §2.9 validate 重编号为 §3.10
- §6.9 purpose（Feign 调用目的）枚举删除
- §6.10 missingFields 重编号为 §6.9
- §11 推送范围：11→10 + 说明 §2.7 走后端 changelog
- §12 注意事项：删 internal 公网约束行
- §13 关联：加 §2.7 单独走后端 changelog 链接 + Issue #2525 备注

§2.7 后端 changelog 会单独推到 hl-backend-changelog 仓库。
 2026-05-18 17:31:11 +08:00
yaosutu 757a5dd60b 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 实现立即可对接。
 2026-05-18 17:08:21 +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
yaosutu 6c5087c6eb docs(order-v3): 删除早期 §1.1 单接口测试 changelog 
18_test_订单创建-修改接口-管理后台.md 是 §1.1 单接口测试样本，
将由后续 §1 总文件取代（含 §1.1+§1.2+§1.4 等 §1A 子模块全集）。
 2026-05-18 15:58:22 +08:00
yaosutu 1701cf7a23 docs(order-v3): §4/§5/§9/§11/§12/§13 清理后端实现/派生/前端 use case 备注 
前端 changelog 只写接口契约（入参/出参/类型/枚举/错误码/边界/示例）。
本次砍掉 7 类无效内容：
1. 后端字段来源（JWT 派生 / 产品快照派生）
2. 后端实现细节（雪花 ID JSON String / DB 层 AES / 从 Nacos 拼接）
3. 后端 DB 字段（写入 order_main.room_count / order_tag tag_type=PERSONAL）
4. 后端运维（端口 / DDL / Redis key / 重启 / 回滚耗时）
5. 前端 use case（弹窗标题用 / 前端拼催款话术）
6. 其他接口跳转（出行人不在本接口传，调 §2 单独添加）
7. 影响其他后端服务

字段 +46 / -75 净减 29 行，聚焦接口契约。
 2026-05-18 15:44:12 +08:00
yaosutu 2a3ffb7737 docs(order-v3): §6 枚举/字典按字段分组重排 + SKILL 同步更新 
原 §6 把 5 个枚举（createSource/orderStatus/flowStatus/consultantSource/paymentMode）
混在一张 23 行大表里，前端 AI 按字段查表难定位。
改为每枚举一个 H3 子节（6.1~6.5），每节附「所属字段 + 枚举类 + 类型 + 必填」头部说明。
 2026-05-18 15:37:59 +08:00
yaosutu 0aee0ceddb docs(order-v3): 订单创建接口 v3 admin POST /v3/admin/order 接口现状快照（测试 v2 目录） 
启用 changelogs-v2/ 新目录，前端 v3 项目仓库后续从此目录读 changelog。
此份为 v3 admin 订单创建接口（OrderController.createOrder）的 v5.18 完整快照，
含 13 节固定模板（入参 13 字段 / 出参 20 字段 / 枚举 21 项 / 错误码 9 个 / 3 组示例）。
 2026-05-18 15:04:12 +08:00
yaosutu 417e635ddf fix(mp): PR#1894 到达/返程批次校验错误文案修正 
620001/620002 message 按 direction 动态拼词，
到达信息不再误显"返程信息"。
 2026-05-08 17:46:25 +08:00
yaosutu 4c65455726 changelog(mp): PR#1878 到达/返程批次支持一起/多批两种模式 — POST /arrival 语义变更 + mode/modeLabel 新增 + batch bug 修复 + 错误码 580010 2026-05-08 16:23:22 +08:00
yaosutu 485a180781 Merge branch 'main' of https://git.1814.love:8443/wx/hl-api-changelog 2026-04-23 17:33:42 +08:00
yaosutu和Claude Opus 4.7 ed27f2dc74 changelog(mp): /mp/order/{orderId}/insurance 接口契约梳理 — 入参+出参+调用时机+边界行为 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-23 17:33:34 +08:00
yaosutu和Claude Opus 4.7 ec974a27f3 fix(changelog/mp): 合同强类型 VO changelog 修正 resend-sms 入参/返回描述 
- 返回类型 Result<Void> → Result<Boolean>
- 入参说明: 前端不需要传 body, BFF 自己从 token 取 userId 包成 MpContractResendSmsReqVO 透传下游

参照实现: hl-mp-service MpContractController#resendContractSms (PR #1314)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-23 17:02:25 +08:00
yaosutu a1467cbbea docs(changelog): 04-23 mp 批次标题/影响面显式标注「微信小程序」端(7 篇) 2026-04-23 16:46:18 +08:00
yaosutu和Claude Opus 4.7 bc43b65dc1 changelog(mp): 订单/行程 5 个聚合接口调用时机梳理 — tab-state 路由决策 + dashboard/pre-trip/today/travel-memory 契约对照 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-23 16:45:27 +08:00
yaosutu 17648b8961 changelog(mp): 04-23 下午批次 7 篇 — 合同强类型 VO / 退款 ratio / balance 统一 / 头像 / groupBatchId / 小童保留 / 行前清单拆分 
- #1314 mp-contract: Map → MpContractVO / MpContractDetailVO 强类型化
- #1313 mp-refund preview refundRatio 恒 0 bug 修复
- #1306 mp-order balanceAmount 计算口径统一(FULL 也返回, 公式含 paid)
- #1309 mp-order guide/photographer avatarUrl 快照补齐(新订单生效)
- #1300 mp-order detail 新增 groupBatchId(GROUP 才有值)
- #1298 mp-group order youngChildCount 保留不再强制清零
- #1289 mp-pre-trip checklist 6→7 项 + DEPARTURE_INFO + WARNING 状态
 2026-04-23 16:43:36 +08:00
yaosutu 3894e88ba9 docs(changelog): 补录 order-v2 接口变更说明（04-17 订单详情重构/04-20 出行人·物资清单·assignment/04-21 酒店 dayNumber） 7 篇 2026-04-23 16:35:12 +08:00
yaosutu a851a89fc9 changelog(admin): 订单交通信息(接送站) 5 个 CRUD + 飞常准查询 7 个梳理 
修 PR #1285 的 404 问题后,把管理后台交通信息这块接口契约完整梳理一遍,给前端迁移指南:

- 订单交通批次 5 个 CRUD (/admin/order/{orderId}/transport 或 /arrival,两个前缀别名):
  查全量 / 新增 / 全量替换 / 修改 / 删除
- 飞常准查询 7 个 (/admin/transport/flight/* + /train/*):
  航班号/机场/城市 + 车次/站点/城市
- 重点标出前端之前用的 v1 遗留契约(legType/departureStation/travelDate)与新契约的字段对照
- 补 FlightVO/TrainVO 完整字段表 + 三种交通方式的请求示例
- 推荐 UX: 航班号输入后自动调飞常准回填时间站点,避免用户手填时分秒
 2026-04-23 15:15:16 +08:00
yaosutu c06ba0bfcf changelog(mp): 修订到达信息辅助接口字段表(非常准航班/火车) 
- 补全 /mp/transport/flight 3 个查询接口(by-airport/by-city)
- 补全 /mp/transport/train 4 个查询接口(by-station/by-city/by-train-no-stations)
- 修正字段名:scheduledDepartTime/flightStatus → planDepartTime/status
- 按 MpFlightInfoVO / MpTrainInfoVO 实际字段列完整(22+14 个)
- 标注哪些字段仅在特定查询下返回(stops / departStatus)
- 补边界行为(空结果/上游异常/日期校验)
 2026-04-22 11:18:30 +08:00
yaosutu和Claude Opus 4.7 eb70d0f930 revert(resource): 撤回 hotel WiFi 字段 changelog 
仅数据库加字段 + 管理端 CRUD 接口扩展，小程序侧 Feign 未接通、todayHotel.wifi 仍为 null，
暂无需推送给小程序前端同事。等 Feign 接通后与 MP 下游变更一起重新发布。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-22 09:37:20 +08:00
yaosutu和Claude Opus 4.7 8ad5d0638d changelog(mp): 微信小程序 · 按资源反查攻略接口 by-resource 
GET /mp/wiki/by-resource

根据资源类型 + ID 反查已关联的已发布攻略文章列表,用于行程中景点/活动
节点的"攻略"按钮。支持 SCENIC/ACTIVITY/HOTEL/RESTAURANT/PRODUCT。

对应原型 7wZKh.s2card。

PR #1122 (Closes #1117)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-21 21:55:04 +08:00
yaosutu 75b2033fa3 changelog(trip): 行程中当前行程页聚合 3 连 (PR #1123/#1124/#1125) 
- order-v2: TripDetailVO itineraryDays/dailyItinerary/hotelArrangements 强类型化 (#1119/#1123)
- mp+order-v2: today-dashboard 聚合扩展 DAY 导航/时间线/今晚住宿/明日预告 + 领队车牌 (#1120/#1124)
- resource: Hotel 表新增 WiFi SSID/密码字段 (#1121/#1125)
 2026-04-21 20:46:19 +08:00
yaosutu和Claude Opus 4.7 229561624b changelog(mp): 微信小程序 · 行程 Tab 路由决策接口 tab-state 
GET /mp/trip/tab-state

一次返回前端应渲染哪个 Tab 页(IN_PROGRESS/BEFORE_START/RETURNING/NEW)
+ orderId + summary。替代之前 3 次接口决策。

对应原型:ew2Kk 行程前 / sGONt 行程中 / wwWKT 回头客 / eYDt9 空态。
PENDING_PAY 订单不计入 Tab 判定。

PR #1116 (Closes #1115)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-21 18:51:53 +08:00
yaosutu和Claude Opus 4.7 98bb0e4b5d changelog(mp): 微信小程序 · 我的旅行回忆 travel-memory(含评分字段合并版) 
GET /mp/order/travel-memory

返回 MpTravelMemoryVO 完整字段(含 rating/reviewId),小程序单接口获取
订单+评分数据。对应原型 wwWKT 行程 Tab·回头客卡片墙。

PR #1004 (Closes #1002) · PR #1014 (Closes #1011)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-21 17:31:10 +08:00
yaosutu 3268374447 Revert "changelog(order-v2): C 端我的旅行回忆 travel-memory 接口 + 评分字段" 
This reverts commit c9cd0ca886.
 2026-04-21 17:29:58 +08:00
yaosutu和Claude Opus 4.7 c9cd0ca886 changelog(order-v2): C 端我的旅行回忆 travel-memory 接口 + 评分字段 
- GET /mp/order/travel-memory 接口首发 (PR #1004 / Issue #1002)
- MpTravelMemoryVO 补 rating + reviewId 字段 (PR #1014 / Issue #1011)
- 对应原型 wwWKT 行程 Tab·回头客

本地已有两份完整 changelog 但此前未推送,本次一并推送远程。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-21 17:19:35 +08:00
yaosutu和Claude Opus 4.7 7e12f0e9ce changelog(mp): 微信小程序 · 订单出行人 CRUD 接口(4 个) 
- GET /mp/order/{orderId}/traveler
- POST /mp/order/{orderId}/traveler
- PUT /mp/order/{orderId}/traveler/{travelerId}
- DELETE /mp/order/{orderId}/traveler/{travelerId}

对应原型 L4xYN 乘坐人员勾选列表、Bf9jC 添加人员弹窗。
身份证 idCardNo 后端自动解析 birthday + gender。

PR #1022 (Closes #1020)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-21 16:38:19 +08:00
yaosutu和Claude Opus 4.7 34621d845b changelog(mp): 微信小程序 · 订单行李推荐接口 
GET /mp/order/{orderId}/supplies-checklist

按分类分组返回订单备品清单 + 装备建议富文本,对应原型 zgNiD 行李推荐弹窗。

PR #1042 (Closes #1041)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-21 16:34:43 +08:00
yaosutu和Claude Opus 4.7 b5941e4f34 changelog(mp): 微信小程序 · 订单到达/离开信息接口(5 个 CRUD) 
- GET /mp/order/{orderId}/arrival
- POST /mp/order/{orderId}/arrival
- POST /mp/order/{orderId}/arrival/batch
- PUT /mp/order/{orderId}/arrival/plan/{planId}
- DELETE /mp/order/{orderId}/arrival/plan/{planId}

PR #1000 (Closes #998)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-21 16:30:50 +08:00
yaosutu 053a5bdd64 fix(order-v2): 财务 Tab 优惠/附加费 DTO 字段对齐契约 (#1100/#1101) 
- DiscountRequest: name→discountName, amount→discountAmount
- SurchargeRequest: name→surchargeName, amount→surchargeAmount
- 清除死字段 discountType/remark
- 金额新增 @DecimalMin(0.01) 正数校验
 2026-04-21 16:20:37 +08:00
yaosutu和Claude Opus 4.7 f4f767863d changelog(mp): 微信小程序 · 行程前出发准备页 + 订单详情页 聚合接口 V1+V3 
- 新接口 GET /mp/trip/{orderId}/pre-trip-dashboard (V1)
- 新接口 GET /mp/order/{orderId}/dashboard (V3)
- PR #1074/#1087/#1090/#1078/#1096 合集交付

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-04-21 16:19:13 +08:00
yaosutu 68c8d61f39 changelog(order-v2): 管理端行程安排接口变更（聚合接口新增 + vehicleCount 下线） 
- 新增 GET /admin/order/{orderId}/itinerary/summary 聚合接口（PR #1064）
- 修复 GET /admin/order/{orderId} 的 hotelAssignmentDetails[].assignmentDate 现算（PR #1064）
- PUT /admin/order/{orderId}/vehicle-assignment 请求 body 删除 vehicleCount（PR #1054）
 2026-04-21 15:38:48 +08:00
yaosutu和Claude Opus 4.6 4bbebf273b changelog: C端订单详情页重构接口变更（详情返回值变更+6个弹窗接口） 
详情接口返回值从OrderDetailVO改为MpOrderDetailVO，
新增serviceItems/priceBreakdown/refundProgress/tripProgress等字段，
新增6个弹窗接口(tickets/hotels/meals/vehicle/guide/photographer)。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-20 18:32:08 +08:00
yaosutu和Claude Opus 4.6 1a99420d5d feat(order-v2): 创建订单/报价预览新增必填参数 tierSeq（档位序号） 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
 2026-04-17 14:14:35 +08:00
yaosutu 666ce6030a feat: 新增商品选择列表接口 simple-list（订单创建用） 2026-04-14 16:07:18 +08:00