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

989 次代码提交

此分支
此分支
所有分支
作者 SHA1 备注 提交日期
API Changelog Bot
9c33bc4dc2 feat(评价): review_source 改字典 + 产品详情 topReview 补 source/sourceLabel (HL #2988/PR #2989) 
- 新增 review_source 系统字典(MINIPROGRAM/小程序 + YOUZAN/有赞)
- admin 端筛选「来源」下拉可改用通用字典接口 GET /admin/dict/data/review_source
- /mp/product/{id} 的 reviewSummary.topReview 新增 source + sourceLabel 字段
- ReviewSourceEnum 后端枚举保留(字典只给前端下拉用)
 2026-05-25 12:53:47 +08:00
wx
1538a0b2eb fix: /mp/product reviewSummary 字段从 null 恢复(测试服已部署验证) (PR #2984) 2026-05-25 12:29:14 +08:00
API Changelog Bot
4d914be807 feat(评价): admin 已通过↔已拒绝评价可互转 + 必填理由 (HL #2983/PR #2985) 
- 新增 POST /admin/review/{id}/revert body={targetStatus, remark}
- 仅允许 APPROVED↔REJECTED 互转, MACHINE_REJECTED 仍走 /override-approve
- ReviewVO/ReviewListVO 加 revertRemark 审计字段(MpReviewVO 不加)
- 错误码 551076 REVERT_STATUS_NOT_ALLOWED
- 现有 /approve /reject /override-approve 完全不动
 2026-05-25 11:18:43 +08:00
API Changelog Bot
11fb1a6c9b feat(评价): admin/mp 评价接口加 source 来源字段 (HL #2978/PR #2981) 
- admin /admin/review/list 加 source/sourceLabel + source 筛选入参
- mp /mp/review/target & /product/{id} 加 source/sourceLabel
- 枚举 MINIPROGRAM(小程序) / YOUZAN(有赞)
- 小程序创建评价后端写死 MINIPROGRAM
- 有赞数据本期不做导入接口,wx 自行 INSERT
 2026-05-25 10:40:14 +08:00
API Changelog Bot
2360218e73 correction(mini): 撤回链式继承 adminId 建议 — 后端 sharerOpenid 反查链已就绪, 真正缺的是其他可分享页补 shareOpenId 2026-05-24 16:06:58 +08:00
API Changelog Bot
208f67b53a headsup(mini): 小程序 onShareAppMessage/Timeline 需链式继承 adminId 才能正确归属定制师 (配合 PR #2977) 2026-05-24 15:46:12 +08:00
API Changelog Bot
cb7898dc2d headsup(banner): 测试服造 1 条 NONE 类型 banner 供 mmg 联调无跳转场景 2026-05-23 11:43:27 +08:00
API Changelog Bot
b5ceb15d50 docs: 23日累计 3 条 changelog (banner 字段补全 + SMS info hotfix + compare 抹空) 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-23 11:22:04 +08:00
API Changelog Bot
fece5d472f add R7 真测网关错误响应规范化 changelog: 5 项 (Result.traceId + X-Trace-Id + 中文化) 2026-05-23 10:59:27 +08:00
yaosutu
905e64ee42 chore: 修正路径 changelogs-v2/ -> changelogs/ (admin代用户发起退款接口) 
PR #2932 / Issue #2930 的 changelog 原推到了 changelogs-v2/, 但按
最新约定一期老前端走 changelogs/ 默认目录, changelogs-v2/ 仅给 v3 项目仓。
本次为 admin 改动应在 changelogs/, 故 git mv 修正路径。

原 commit: e3ca303 (保留, 不 force push)
 2026-05-23 10:55:09 +08:00
yaosutu
e3ca30311a 新增接口：管理后台 admin H5 客服代用户发起退款 POST /admin/order/refund/apply（PR #2932，Issue #2930） 2026-05-23 10:51:56 +08:00
API Changelog Bot
f026b7fa04 feat(banner): /mp/banner/active 主题补 description + tags (PR #2938 + #2941 Closes #2936) 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-23 10:39:54 +08:00
API Changelog Bot
e44bb592ca add R6 真测 bug 修复 changelog: insurance 翻页 + refund review PARTIAL 静默错位 2026-05-23 10:17:24 +08:00
API Changelog Bot
21ce4af85e hotfix(product-v2): 拖动行程字段抹平为 null 修复 (PR #2933) 
P0 数据损坏 修复 + 真测通过, 前端无 API 变化无需改。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-23 10:11:47 +08:00
API Changelog Bot
704881d3c4 feat(product-v2): 行程天数拖拽重排 
PR #2926 / Closes #2925

新增 POST /admin/product/item/{productId}/itinerary/reorder
- items: [{dayId, newDayNumber}, ...]
- 状态校验 (EDITABLE_STATUSES), @Idempotent 5s 防抖
- 子表 product_day_hotel 同步 day_number

测试服真测 T1-T5 全绿,单测 49/49 全绿。
前端 mmg 需实现拖动 UI + 调端点。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-23 09:19:36 +08:00
API Changelog Bot
2d38dcd139 docs: 二轮 CR P0 整改 (定制师反查 by-userid/by-openid) 
PR #2924 后端内部 Feign 链路重构,前端无感知。

- 手机号不再走 Feign URL query (不出 user-service 进程)
- mp /mp/customizer/me + order-v2 sharerOpenid 反查从 2 次 Feign 减为 1 次
- SMS helper 抽取 + GlobalExceptionHandler.handleLoginFail 补单测

测试服真测 T1/T2/T3 全绿 + 单测 194 全绿。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-23 00:18:17 +08:00
API Changelog Bot
0bbb1bb9f9 fix: /mp/customizer/me 角色判定 P0 修复 + 网关白名单 + sharerOpenid 空串 (#2922 / PR #2923) 2026-05-22 22:50:38 +08:00
API Changelog Bot
539fc0fc6e feat(user): SMS 登录限定制师 + active role 自动切 CUSTOMIZER (#2918 / PR #2920) 2026-05-22 19:05:38 +08:00
yaosutu
c51c78512d feat(order-v2): admin 订单列表改造 changelog 追加 updateTime 排序 (PR #2916) 
原 changelog (commit bf1788a) 漏了 updateTime 排序选项, 同文件追加:
- 关键变化总览: 列表排序补 "+ updateTime (最近更新)"
- 第 2 节排序枚举表: 加 updateTime 行 + 业务场景说明
- 前端建议段: 加"最近更新"下拉选项 + 与 createTime 区别提示
- 第 7 节测试建议: 加 updateTime DESC 验证 case
- 第 8 节关联: 加 PR #2916 + Issue #2915

Closes #2915
 2026-05-22 18:55:36 +08:00
yaosutu
bf1788ae5e feat(order-v2): admin 订单列表+详情综合改造 (搜索/排序/行程/状态 tab) 
覆盖今日 4 PR:
- PR #2903 详情新增 itinerary (景点+酒店 按天)
- PR #2906 列表 keyword 加联系电话 + 排序加 depositAmount
- PR #2909 完整 11 位手机号精确加密匹配 (修 #2906 假阳性)
- PR #2914 displayStatus 参数对齐原型 5 tab (修待出行 0 单 BUG)

前端动作:
- 搜索框 placeholder 提示完整手机号
- 排序下拉新增"订金金额"
- tab 切换迁到 displayStatus 参数
- 详情页"行程概览"段渲染 itinerary 字段

向后兼容: 不读新字段/不传新参数行为完全不变。

关联: Closes #2899 #2905 #2908 #2912
 2026-05-22 18:20:05 +08:00
API Changelog Bot
933adcdcad feat(user/order): 定制师分享 + 锁定剩余次数 + AdminLoginResponse.mobile (#2907 / PR #2913) 2026-05-22 18:09:01 +08:00
API Changelog Bot
032bc3dd0a feat(user): 管理端手机号验证码登录 (#2889 / PR #2904) 2026-05-22 16:57:45 +08:00
API Changelog Bot
47315eedbd add R5 真测 bug 修复 changelog: PII 应急 + 配房 BLOCKER + 6 P1 2026-05-22 16:28:33 +08:00
API Changelog Bot
4b1d24c7e1 feat(user): admin_user 加 mobile 字段 (#2886 / PR #2897 / merge #2898) 2026-05-22 15:51:01 +08:00
API Changelog Bot
c434ef5743 append hotfix #2881 (#2880) AdminOrderStatusLogController 路径回滚: PR #2864 引入 Ambiguous handler 500 回归已闭环 2026-05-22 14:20:07 +08:00
yaosutu
b80f575fae 新增 22_2867-2868_订单详情枚举统一+service-standard修复 changelog 2026-05-22 12:37:39 +08:00
API Changelog Bot
16a25bdff3 add QA真测发现 bug 修复 changelog: gateway 6 路由 + 订单 list/detail 字段 2 bug 
PR #2864 (#2863) gateway 补 5 v3 路由 + AdminOrderStatusLogController 路径冲突
PR #2866 (#2865) OrderMainVO 补 orderNo+teamNo / list tags string[]→TagVO[]

⚠️ 前端契约变更: list[].tags 类型从 string[] 变 object[],hl-ui mmg 必同步改。
 2026-05-22 09:52:37 +08:00
API Changelog Bot
89cc504e59 add r4 backlog changelog: HTML 清零 + BFF + 红线5 二期 + MoneyUtil + Service+Impl 合并 
5 PR squash 合并到 dev-v3:
- #2858 (#2855) 红线 5 二期
- #2859 (#2856) MoneyUtil 抽取
- #2860 (#2857) Service+Impl 合并 8 个
- #2861 (#2854) BFF Facade 抽离 444→107
- #2862 (#2852) HTML 标签 1589 文件清零 8709→57

0 URL / 0 VO 字段 / 0 响应结构变更,前端无感知。
 2026-05-21 23:38:58 +08:00
API Changelog Bot
a3dae9f2d5 docs(changelog-v2): Round 3 收尾 13 项 (PR #2853 Closes #2851) 2026-05-21 22:34:54 +08:00
API Changelog Bot
c14e9bcc55 docs(changelog-v2): Round 2 收尾 7 项 (PR #2850 Closes #2849) 2026-05-21 21:38:52 +08:00
API Changelog Bot
0388716634 docs(changelog-v2): Round 1 review followup (PR #2845-2848) 
dev-v3 5 天工作流 Round 1 review 4 张 P0/P1 工单(#2841-2844)修复落地测试服:
- HOUSE 砍死代码 -1198 行(3 零订阅 Event + publishHotelSwapped + 4 薄 Service + ErrorCode 段位合并)
- 红线整改反向违规修复 + CRYPTO/MD5 错误码 4 处去重 + BusinessException cause 重载
- product-v2 简化(EntityFieldDiffUtil + restore @Lock4j + meal_option 缓存)
- HOUSE 收尾(DRIVER 撤 + maskPhone 复用 PiiMaskUtil + writeOpLog 统一)

前端关注:
- 产品操作日志 changes 详情格式从展开收敛为聚合 summary
- 大交通 mode Converter 默认值删除,后端 Service 显式补
- HOUSE 换酒店 DRIVER 通知暂撤,等 FLEET 接通后恢复
 2026-05-21 20:48:43 +08:00
API Changelog Bot
ed10a93879 docs(changelog-v2): order-v3 review 跟进 (PR #2833-2836 + hotfix #2840) 
review 检出 P0/P1 共 4 张工单(#2821-2824)修复落地测试服:
- HOUSE 配房工作台 §2.1-§2.5 + 询房 §3.3/§3.6 共 7 个接口路径迁移
- HOUSE-SWAP 越权校验 + 状态机 from 推导 + DRIVER 通知补发 + 4 个错误码同步文档
- 出行人 internal Feign transportPlanIds 真实化 + 错误码段位修正
- 大交通 TransportPlanVO Long 字段返字符串(防 JS 精度)+ batchReplace 加幂等
- order_todo 加唯一索引(hotfix V20260521_004 generated column UNIX_TIMESTAMP → COALESCE)
- 通知中心 internal VO 后缀 + dispatch 单一真相源(前端不调,内部规范)

前端必看:7 个路径变更 + Long 字段类型变化 + 出行人错误码段位 5 处。
 2026-05-21 18:15:11 +08:00
API Changelog Bot
5371ba071b docs: /dict/all 外层 dictType 组新增 remark 字段 (HL PR #2827+#2828, Closes HL#2826) 2026-05-21 16:59:37 +08:00
wx
248c052e13 feat: 2026-05-21 fix mp message summary field misalign 2026-05-21 16:03:18 +08:00
yaosutu
ab2aaef3f5 修正 司机详情 attachments 字段类型 Map -> 强类型 DriverAttachmentsVO (#2812 / PR #2818) 
前序 21_2791_司机档案 changelog §3.2 描述的 Map<String,List<>> 已废，以本文档为准。
前端需要把 data.attachments['id_card'] 改成 data.attachments.idCard。
 2026-05-21 15:52:46 +08:00
yaosutu
761ca0742d 新增 车辆档案 6 接口 + 司机档案 6 接口 全模块快照 changelog（fleet 模块批量补发） 
两份 changelog 都按 SKILL.md 多接口模板（按接口分小节）+ 严格代码契约（不照搬文档）写：

文件 1: changelogs-v2/2026-05/21_车辆档案-修改接口-管理后台.md
- 6 接口（page/detail/create/update/delete/import）全契约
- 真枚举 VehicleAttachmentCategoryEnum（6 类目 + 张数上限）+ fleet/vehicleStatus @Pattern 强校验
- 错误码：600100 + 600107-600110（与文档 v1.4 差异已显式注解）+ 共用 601001-601005
- 标注：本模块无单独 PR 改动，本次为全模块快照首推

文件 2: changelogs-v2/2026-05/21_2791_司机档案-修改接口-管理后台.md
- 6 接口全契约 + 详情接口新增 relatedOrders mock 字段（PR #2796）
- 真枚举 DriverAttachmentCategoryEnum（8 类目 + 张数上限，前 3 类换证留历史语义）
+ DriverStatusEnum / SeasonEnum / InsuranceTypeEnum @Pattern 强校验
- 4 嵌套 VO 完整字段表（DriverLicenseVO/DriverEmergencyVO/DriverInsuranceVO/DriverStatsVO）
- attachments 是 Map<category, List> 按类目分组
- 错误码：600200-600205 + 601001-601005
- 5 tab 后端实现说明（season=active/pending/archived/blacklist + 全部不传）
- 关联 Issue #2791 + PR #2796
- mock 警示（固定 3 条假数据，所有司机返回相同，待真实化）

校准（代码 vs 文档）：
- 车辆错误码段位实际避让到 600107-600110（与车型管理库 600101-600106 冲突）
- 司机详情 attachments 是 Map<String, List<Item>> 按类目分组返回（不是扁平 array）
- DriverImportRespVO 字段名与 VehicleImportRespVO 不同（前者 insertedCount/renewedCount/errorCount，后者 success/failed/errorRows）
 2026-05-21 15:33:02 +08:00
yaosutu
1a796e52b1 fix(车型管理库 changelog): typeKey 是表字段不是枚举，§6 改为说明无字典，建议值移到 §9 业务边界并强调前端不要硬编码 2026-05-21 15:21:58 +08:00
yaosutu
3aa9f425ca 新增 车型管理库 9 接口全模块快照 changelog（含分页 2 接口新增 + 7 个 CRUD 现状） 
- 服务: hl-fleet-service
- PR: HL #2786（Issue #2785）
- 端类型: 管理后台
- 变更类型: 新增接口（§3.2 大类分页 + §3.7 型号分页 2 个新端点）
- 范围: 整模块快照分发（其余 7 接口契约零变化，一并打包方便前端联调）

文件: changelogs-v2/2026-05/21_2785_车型管理库-新增接口-管理后台.md

关键校准（按代码契约写，文档为辅）:
- 实际 9 端点（API 文档 §1 标题"6 接口"是 §1.4 合并算法）
- 分页参数实际 page（不是文档误写的 pageNo）
- 错误码 600101-600106 全 6 个（文档 §1.4 只列了 3 个）
- VehicleTypeSaveReqVO / VehicleModelSaveReqVO 完整校验注解（@Size/@Min/@Max/@DecimalMin）
 2026-05-21 15:15:56 +08:00
API Changelog Bot
4061b956ea notify(2026-05-21): 素材审核拆除正式环境部署完成 
- 正式 K3s hl-prod ns: hl-resource-service + hl-user-service 已部署 (commit 66c462c8)
- 正式 RDS round-trip 验证全过: material.review_status 列已 DROP, material_review_status 字典已删, 数据 5153 行完好
- 顺手记录踩坑: Flyway out-of-order 因 deploy-prod.sh 未 mvn clean 留孤儿 V99999999, 已根治 marker + rm 孤儿文件
 2026-05-21 14:53:31 +08:00
API Changelog Bot
1dc7db6480 notify(2026-05-21): 素材审核拆除 + 团队成员角色字典化 
- 21_refactor_material_remove_review_feature.md (Closes HL#2789, PR HL#2795)
  通知 mmg 删 reviewMaterials/rejectMaterials API 与批量审核/驳回 UI
  测试服已验证: GET material/list 无 reviewStatus 字段 + material_review_status 字典空

- 21_refactor_team_role_picker_use_staff_type_dict.md (Closes HL#2790, hl-api-changelog#7)
  通知 mmg StaffPickerModal.vue roleOptions 改 useDict('staff_type') 动态加载
  后端零改动 (staff_type 字典 7 项已就绪, 不含 DEPUTY_LEADER/DRIVER)
 2026-05-21 14:04:34 +08:00
yaosutu
c2aef2a3d3 📦 docs: tag-library 私人标签库 6 接口真实化完成 + QA 验证通过 
变更：

- 新增 changelogs-v2/2026-05/21_tag-library真实化完成QA验证通过-修改接口-管理后台.md
- 关联 19 号骨架版 changelog
- 通知前端：接口契约 0 变化，可正式进入真实联调时机

QA 结果：33/33 全通过（覆盖创建/列表/更新/删除/排序/置顶 6 接口 × 各场景）

错误码契约（581421/581423/581424/581425/581427）全部按设计触发，多用户隔离、事务回滚、软删后同名复用、Long ID 字符串序列化均已验证。
 2026-05-21 12:07:15 +08:00
API Changelog Bot
751ed717d3 fix: 把 3 个 order-v3 changelog 从 changelogs/ 挪到 changelogs-v2/ 
错放原因:#2565 / #2569 / #2571 都是 order-v3 二期 PR,通知员漏判,写到了一期 changelogs/,
导致一期前端 mmg 在 sync-log 里看到了三条 v3 条目并反馈"全部跳过"。

按用户 2026-05-21 重申:order-v3 的任何内容严禁出现在 changelogs/,只能写 changelogs-v2/。

涉及文件:
- 18_2355_admin-order-v3-create-sharer-customizer.md (PR #2565)
- 19_feat_admin_order_list_consultant_name_filter.md (PR #2569)
- 19_fix_admin_order_detail_travelers_no_longer_empty.md (PR #2571)

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-21 11:28:07 +08:00
API Changelog Bot
376e28930f changelog: refactor product-v2 餐饮选项 meal_option 字典化 (#2778) 2026-05-21 10:49:56 +08:00
API Changelog Bot
9b1f59c96c docs(changelog): #2677 素材列表分类查询严格只查自身（接口字段不变,语义变更） 
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-20 15:06:34 +08:00
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
a9228e7aa8 feat(api-changelog): v3 行程 day/node 写操作真实化（PR #2613 / Issue #2598） 2026-05-19 16:38:01 +08:00
API Changelog Bot
1e141e445c docs(changelog): #2586 合同/保险模块 TODO 接通 — 从占位 → 完整可用 
v3 contract / insurance 三 PR 累计变更（#2590 + #2591 + #2603）。
前端关键变化 4 点：
1. 合同/保险全部接口从占位/抛错转为真实可用
2. POST /v3/admin/insurance/purchase 新增订单状态+支付状态双重校验
3. POST /v3/admin/order/{id}/transition CONFIRM 异步触发自动签约/投保
4. 出行人变更触发已签约订单作废重做（状态白名单过滤）

新增字段：ContractScheme.defaultDestination / defaultDepartureCity
新增错误码：540022 ORDER_NOT_CONFIRMED_FOR_INSURANCE / 510206 合同方案未配置模板
新增异步事件：ChecklistConfirmedEvent / TravelerChangedEvent

测试服真测通过：单测 1096 全绿 + 9443 网关 + 真 admin token + P0-1 正反例齐全。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-19 16:16:23 +08:00
API Changelog Bot
b2618f97e8 docs(changelog): 19_fix_hl_ui feetype 方案调整 '手动' → '其他' 
用户决策更新:不要 null + v-if 那套,改为最小一行字面量替换:
feeType: '手动' → feeType: '其他'。"其他" 是合法分类,admin chip 和
C 端主标题都正常显示。脏数据清理 SQL 同步改为 UPDATE = '其他'。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-19 15:14:54 +08:00
API Changelog Bot
c03a32b4ac fix(hl-ui): 费用包含手动添加把"手动"塞进 feeType 导致 C 端显示成独立分类 
CostDescPanel.vue:159 confirmIncludedAdd 硬编码 feeType:'手动',落库后 C 端
detail.js:428 把它当主标题渲染,在小程序产品详情显示成跟「景区/游玩项目」并列的
独立分类。改 feeType:null + 第 231 行 chip 加 v-if 即可。脏数据 1 条,产品
2056554654480248833 升级满洲里套娃酒店,建议运营 admin 自助删了重加。
纯前端 BUG,无后端接口/SQL/Nacos 改动,接收方 mmg。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
 2026-05-19 15:10:09 +08:00
yaosutu
0bbcdd23e7 docs(tag-library): 新增 v5.14 私人标签库 6 接口契约（管理后台） 
- GET    /v3/admin/tag-library              查我的标签库（keyword/pinnedOnly）
- POST   /v3/admin/tag-library              新增预设（tagName/tagColor）
- PUT    /v3/admin/tag-library/{id}         修改预设（重命名/换色）
- DELETE /v3/admin/tag-library/{id}         软删预设
- PUT    /v3/admin/tag-library/sort         批量排序（拖拽）
- PUT    /v3/admin/tag-library/{id}/pin     置顶/取消置顶 toggle

错误码段位 581420-581429（hl-order-service-v3 拥有）。
当前 ServiceImpl 为 Mock 实现，契约本次发布后不再变。
关联 PR：wx/HL#2045（骨架）+ wx/HL#2240（Gateway 路由修复）
 2026-05-19 14:32:04 +08:00