wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 工作流 软件包 项目 发布 百科 活动
1,185 提交 29 分支 0 Git 标签
59932b6048cb8313b14f149f60a1e7ca7bea02d2
提交图
100 次代码提交
此分支
此分支
所有分支
作者 SHA1 备注 提交日期
yaosutu 59932b6048 feat(changelog): 订单详情补产品封面字段 productCoverImg (#4026) 
GET /v3/admin/order/{id} 的 main 块新增出参字段 productCoverImg，
与订单列表同名同义，历史订单无快照时返回 null，前端做占位图降级即可。
 2026-06-19 09:57:14 +08:00
yaosutu 321154e5b1 docs(changelog): 子流程加 displayText 完整文案 + statusName 改纯状态 (#4023) 
更新 currentSubFlows changelog：statusName 改纯状态(待配/处理中,房车一致)，
新增 displayText=name+状态完整文案(配房已打回/配车处理中)；明确前端展示直接用 displayText。
 2026-06-19 09:50:10 +08:00
yaosutu 9f1b885bfa fix(changelog): 修正 productTypeName 数据字典 label（ROUTE/CUSTOM/GROUP） 
原 changelog 初稿使用了错误 label（线路产品/定制产品/团队产品），
实际 label 以数据字典 product_type 为准：
- ROUTE：自驾路书
- CUSTOM：私人定制
- GROUP：小蒙马
同时补充说明 productTypeName 来源是 sys_dict product_type，
以及修正 PR #4022（Issue #4021）关联链接。
 2026-06-19 09:45:03 +08:00
yaosutu 20032ec600 feat(changelogs-v2): 订单列表/详情新增 productType+productTypeName 出参字段 
影响接口:
- GET /v3/admin/order/list
- GET /v3/admin/order/{id} (data.main 节点)

枚举: CORE/ROUTE/CUSTOM/GROUP 四值
关联: Issue #4009 / PR #4010
 2026-06-19 09:19:30 +08:00
yaosutu d4dbe654d3 docs(changelog): 订单详情概览 overview 字段对接说明（含 nullable + 备注字段） 
GET /v3/admin/order/{id} 概览 overview 字段说明(非契约变更):
customerInfo(联系人/电话/商户/定制师/创建时间/人数)+remarkInfo(4备注)+travelers字段路径类型含义；
特别标注可能为 null 的字段(商户软删/无定制师/未填备注/儿童婴儿未填手机等)。
 2026-06-18 18:24:07 +08:00
yaosutu 3eac7ce2a7 Merge branch 'main' of https://git.1814.love:8443/wx/hl-api-changelog 2026-06-18 18:06:10 +08:00
yaosutu ba2a6d16cd docs(changelog): 更正证件类型 changelog 为字典 id_card_type 4 值标准 (#3962) 
原稿误列旧词表(BIRTH_CERT/HK_MACAU/TAIWAN/MILITARY)会误导前端造脏数据。
更正为字典唯一标准 4 值(身份证/护照/回乡证/台胞证)，强调前端拉字典不硬编码，
婴幼儿用身份证，字典未命中返回原值码(非null)。
 2026-06-18 18:05:42 +08:00
yaosutu 2c04507372 feat(collab): 新增订单打标签弹窗 tag-picker 聚合接口 + 批量替换标签接口（#3988） 2026-06-18 17:17:24 +08:00
yaosutu ab83944191 feat(changelog): 订单列表接口新增出参字段 tripNights（Issue #4002，PR #4003） 
GET /v3/admin/order/list 的 OrderListItemRespVO 补齐 tripNights（行程晚数），
与订单详情口径一致，前端可展示「X天Y晚」格式。
 2026-06-18 17:10:24 +08:00
yaosutu a0c5c92ba4 docs(changelog): currentSubFlows 子流程状态删 label 加全态 statusName (#3983 #3997) 
管理后台订单列表+详情 currentSubFlows[] 出参：删除 label、新增 statusName（全态中文）。
配房/配车 6 态(待提交需求/待审核/待配房/配房中/已打回/已完成)，领队/摄影(待指派/已完成)。
前端统一读 statusName。
 2026-06-18 17:10:07 +08:00
yaosutu 362e104708 docs(changelog): 出行人类型改为由出生日期派生，birthday 必填、travelerType 入参移除（小程序端客户出行人补全接口，PR #3981，Issue #3976） 2026-06-18 15:49:59 +08:00
yaosutu 663b93a641 docs(changelog): birthday required, travelerType removed in admin 3 APIs (PR #3981) 2026-06-18 15:49:46 +08:00
yaosutu 8a0d38493f docs(changelog): 出行人证件类型新增 idTypeName 中文字段 (#3962 #3970) 
管理后台 3 接口出参新增 idTypeName（字典 id_card_type 优先、IdCardType 枚举兜底）：
- GET /v3/admin/order/{id}/traveler/list
- POST /v3/admin/order/{id}/traveler/add
- GET /v3/admin/order/{id} 的 overview.customerInfo.travelers[]
 2026-06-18 14:14:19 +08:00
yaosutu 49cd72a481 feat(order-v3): 出参字段 flowDisplayText 重命名为 flowStepName（#3967/PR#3969） 
三个接口（创单/列表/详情）破坏性改名，前端需全局替换引用。
 2026-06-18 12:52:14 +08:00
yaosutu 05fa996c27 新增 changelog：待支付订单流程状态归入补全信息步（管理后台，PR #3961，Issue #3960） 2026-06-18 10:58:37 +08:00
yaosutu 5a6f8675b6 docs(changelog): order-v3 合同/保险镜像状态 NONE→null 前端变更说明 (#3956) 
- 受影响接口：GET /v3/admin/order/{id}、GET /v3/admin/order/{id}/contract-insurance、GET /v3/admin/order/group-batch/{groupBatchId}/orders
- 无合同/无保险时 contractStatus/insuranceStatus 由 "NONE" 改为 null
- Issue #3953 / PR #3956
 2026-06-18 10:15:07 +08:00
yaosutu cee040f814 新增 changelog：到达计划出行人类型中文名新增字段（小程序端，PR #3954，Issue #3951） 2026-06-18 10:05:48 +08:00
yaosutu 3df368d9c1 新增 changelog：出行人类型枚举化+类型中文走数据字典（管理后台，PR #3954，Issue #3951） 2026-06-18 10:05:31 +08:00
yaosutu a47582056d 【changelog】PR#3943 标签库作用域分类(SYSTEM/PERSONAL)入出参变更 + PR#3944 订单标签移除tagType字段及分组结构——管理后台 2026-06-17 20:03:34 +08:00
yaosutu 4620642b9f feat(order-v3): 推送订单列表3个接口变更changelog(#3923/#3930/#3938) 
- 修改接口: 待支付订单flowStatusName/flowDisplayText返null(#3923)
- 新增接口: GET /v3/admin/order/status-options 订单状态下拉(#3930)
- 新增接口: GET /v3/admin/order/status-group-counts Tab分组计数(#3939)
- 修改接口: GET /v3/admin/order 新增入参statusGroup Tab过滤(#3939)
 2026-06-17 18:10:44 +08:00
yaosutu 4fdf27bb6e feat(changelog): 推送保险订单列表接口路径改名 changelog（#3682/#3681） 
GET /v3/admin/insurance/orders 改名为 GET /v3/admin/insurance/list
旧路径已删除，调用返回 404，前端需立即切换。
入参出参字段不变，仅路径变更。
 2026-06-16 10:34:39 +08:00
yaosutu 1453fae332 docs(changelog): #3681 保险订单列表 /orders 改名 /list（破坏性·旧路径下线404） 
PR #3682 已合并 dev-v3。声明旧 GET /v3/admin/insurance/orders 下线返 404，
新路径 GET /v3/admin/insurance/list；入参出参不变；详情 /orders/{id} 与
按订单 /orders/by-order/{orderId} 路径保持不变。
 2026-06-11 11:48:30 +08:00
yaosutu 71c06434ab docs(changelog): v3保险投保接口入参契约说明（管理后台切v3联调补充） 
补 v3 /v3/admin/insurance/purchase 入参契约：idCardType/idCardNo 标准名 +
@JsonAlias 兼容老名 idType/idNo（仍接收不下线）；v3 被保人入参无 gender 字段；
insuredPersons/coverage 日期可空自动填充。澄清 404 属网关路由非契约范畴。
 2026-06-11 10:57:24 +08:00
yaosutu 0456209b4e docs(changelog): 补出行中取消路径下线说明（cancel/on-trip 改 terminate） 
前期 #3556 changelog 只写了新路径入参出参，未点明旧路径已删除，
导致前端联调仍调旧 URL 收到 404。本篇专补路径下线这一环，自包含。
 2026-06-11 10:09:10 +08:00
yaosutu 694c1c2ee6 破坏性变更：订单详情记录Tab时间线接口LogTimelineVO 6字段重构为13字段（改名/新增/拆分），管理后台前端必须同步迁移（PR #3574） 2026-06-08 08:47:22 +08:00
yaosutu d39345076e docs(changelog/order-v3): 团期级 staff 两级配置（团期共享+订单专属）#3560 
新增 GET/PUT /v3/admin/group-batch/{groupBatchId}/staff（团期配置+扇出）；
order/{id}/staff 出参加 source，团期共享行订单侧只读（582109）。管理后台 v3。
 2026-06-07 14:47:31 +08:00
yaosutu 2106e5be43 新增终止行程退款 changelog（预览新接口 + 终止接口改造，#3556 / PR #3557） 
- 终止退款预览：新增 POST /v3/admin/order/{id}/terminate/refund-preview，返回资源清单+行程信息
- 终止行程接口改造：入参改资源已用判定+调整额，出参补退款明细字段（破坏性，前端必改）
 2026-06-06 23:29:56 +08:00
yaosutu d5f234455c docs(changelog): 订单取消3退款模式(管理后台)+C端自主取消(小程序) 接口契约 (#3550 #3549) 2026-06-06 18:56:58 +08:00
yaosutu 459f5075a3 Merge branch 'main' of https://git.1814.love:8443/wx/hl-api-changelog 2026-06-06 15:20:46 +08:00
yaosutu b54b294ed5 chore(changelog): 撤回 git add -A 误带入的他人文档 
02_3283-3285 订单列表字段说明 / 01_3317 餐厅收费字段 系同事未提交文档，
上一 commit 因 git add -A 误带入并推送，现从仓库移除（本地保留为 untracked，
待同事自行提交）。仅保留 06_3539 补全出行信息接口错误码修正。
 2026-06-06 15:20:12 +08:00
yaosutu b3f88c29fa docs(changelog): 修正补全出行信息接口错误码表(实测校准) 
身份证重复 581105->581119，补 581102(订单不存在)/581104(分组超限)/581118(缺必填)/400/401。23 用例真实 HTTP 测试校准。
 2026-06-06 13:59:17 +08:00
yaosutu 7d133e4276 docs(changelog): 新增补全出行信息聚合接口(管理后台) 
PUT /v3/admin/order/{id}/traveler-info —— 订单详情补全出行信息弹窗专用，全量同步出行人(增/改/删)+紧急联系人+备注。含入参 TravelerInfoSaveReqVO/TravelerItem、出参 RespVO、状态规则、JSON 示例、错误码(581108/581116/581107等)。Issue #3539 / PR #3547。
 2026-06-06 12:22:07 +08:00
yaosutu ec5758d597 docs(changelog): 删除冗余大交通列表接口 transport-plans，切换到 transport-plan/list（PR #3536，Issue #3535） 2026-06-05 21:12:03 +08:00
yaosutu f38c79e150 docs(changelog): 行程Tab补 HotelGroupVO/VehicleGroupVO 中间层表格(管理后台) 
补齐遗漏: 配房组/配车组两个中间层对象由行内 = a + b 写法改为字段表格，全文对象结构表格化一致。
 2026-06-05 17:08:12 +08:00
yaosutu a0946839d8 docs(changelog): 订单接口契约清单全文表格化(管理后台) 
格式统一: 所有嵌套 VO 子类(SubFlowVO/TravelerPlainVO/ServiceStandardVO 子结构等 20+)由行内顿号改为 字段|类型|含义 三列表格; 每个接口补入参示例; 附录A枚举字典改表格展示。
 2026-06-05 17:04:29 +08:00
yaosutu ab3770f9f9 docs(changelog): 订单列表+详情+懒加载接口契约清单改按接口纵切重写(管理后台) 
重构文档结构: 从按维度横切(入参/出参/示例分节)改为按接口纵切，每个接口自成一节，含 接口地址/接口介绍/本次修改点/入参/出参/JSON示例 6 块。

10 个接口逐个: 列表/详情/财务/合同保险/发票(新增)/行程/大交通/状态时间线/退款/服务标准。公共枚举抽到附录A，枚举口径差异抽到附录B。每个接口补完整 JSON 请求+响应示例(903 真实数据 + 合理构造)。
 2026-06-05 16:57:13 +08:00
yaosutu 4f91e2ff4e docs(changelog): 订单列表+详情+懒加载Tab接口契约清单(管理后台) 
整理 order-v3 订单核心 10 个查询接口最新契约：列表 + 详情主接口 + 8 个懒加载 Tab(finance/contract-insurance/invoices/itinerary/transport-plans/status-log/refund/service-standard)。

含 13 节自包含文档：全字段出参(含嵌套)、16 类枚举、错误码 581007、典型/边界/异常示例、修改前后对比。

纳入近期变更：#3521 新增发票 Tab、#3514 合同保险真实化、#3523 删 surchargeType、#3509 出行人明文、#3502 删 itinerary days、#3488 overview 重构、#3385 主接口瘦身、#3340 服务标准聚合。

基线 commit f95757df7。
 2026-06-05 16:49:38 +08:00
yaosutu 29ac2669cb docs(changelog): 撤回 #3451 settleType 入参 changelog（用户决定暂不推） 
Revert f78430a。内容备份在 D:\tmp\changelog_3451_settleType_backup.md，需要时可重推。
 2026-06-04 15:54:41 +08:00
yaosutu f78430a11f 文档(核单v3): 新增 Step1 住宿行入参 settleType 字段 changelog (#3451/#3452) 2026-06-04 15:52:02 +08:00
yaosutu和Claude Opus 4.8 9a63a84f1a docs(order-v3): 订单进度模型重构 changelog（派生 6 步 + 嵌套 progressStepper，管理后台） 
进度统一为派生双层：删 flowItems/progress；flowStep 改线性 6 步、flowStepTotal 8→6；
progressStepper 扁平 9 节点 → 嵌套 6 主节点(code/isCurrent/subFlows，删 parallel)；
列表加 flowStepCode/flowStepStatus/currentSubFlows。含降级说明(资源准备只判配房)。

Issue #3365 #3368 / PR #3366 #3369

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-03 09:27:19 +08:00
yaosutu 8398fd26a0 docs(changelog-v2): 订单服务标准接口返回真实成品 + notices 加 title (#3363/#3364) 
GET /v3/admin/order/{id}/service-standard 由恒空改为新订单返回完整服务标准成品;
notices[] 每条新增 title 字段。管理后台端。
 2026-06-02 19:55:14 +08:00
yaosutu 0fda85a6f8 文档(mp): 活动是否收费字段变更通知（小程序端）— PR #3334 Issue #3331 2026-06-01 22:42:51 +08:00
yaosutu 6f56b950fa 文档(resource): 活动+物资是否收费字段变更通知（管理后台）— PR #3334 Issue #3331 2026-06-01 22:42:22 +08:00
yaosutu 52f35eacc8 feat: 酒店是否收费字段 changelog（管理后台 + 小程序端）#3325 #3326 2026-06-01 22:11:56 +08:00
yaosutu 5472817dc3 修正路由：景区是否收费 changelog 从一期 changelogs/ 迁移到 v2 系列目录 
- 删除误放文件：changelogs/2026-06/01_3313_feat_admin_scenic_is_charged.md
- 删除误放文件：changelogs/2026-06/01_3315_feat_mp_scenic_is_charged.md
- 新建管理后台：changelogs-v2/2026-06/01_3313_景区是否收费-修改接口-管理后台.md
- 新建小程序端：changelogs-v2-mp/2026-06/01_3315_景区是否收费-修改接口-小程序端.md

接口路径 /admin/scenic/* 和 /mp/scenic/* 均属二期 v3，应路由至 v2/v2-mp 目录，对齐餐厅 #3317 的推送方式。
 2026-06-01 17:47:26 +08:00
yaosutu 66f94cadcd 文档(restaurant): 餐厅新增「是否收费」字段 — 小程序端接口 changelog (#3317/#3318) 2026-06-01 17:41:58 +08:00
yaosutu 9f13f63ef6 文档(restaurant): 餐厅新增「是否收费」字段 — 管理后台接口 changelog (#3317/#3318) 2026-06-01 17:41:44 +08:00
yaosutu 78ff66b36d feat(mp): 小程序景区详情/列表透传「是否收费」字段 (Closes #3315) (#3316) 2026-06-01 16:21:56 +08:00
yaosutu 70a8fcdc6f 文档(admin-scenic): 新增「是否收费」字段 changelog (#3313/#3314) 2026-06-01 16:06:51 +08:00
yaosutu 1c6b38f548 docs(changelog): 资源退费说明 changelog 追加 settleScope 字典化用法说明 (PR #3291) 
对应后端 PR #3291 (Issue #3290): settleScope 字段补字典化, 出参补 settleScopeLabel。

在原 30_3272_资源退费说明CRUD模块_PR3273.md 的 settleScope 枚举说明后追加:

- 用法 A: 直接用出参 settleScopeLabel (展示场景)
- 用法 B: 调字典接口 GET /internal/dict/data?dictType=order_refund_settle_scope
         拉下拉框选项 (编辑场景)
- 容错说明 + 字典元信息

前端零代码改动也能用 (用法 A); 编辑场景拉一个统一字典接口即可。
 2026-06-01 10:14:39 +08:00
yaosutu 884f52e2e1 feat: 2026-05-30 二期管理后台 3 份 changelog 
PR #3273 (Issue #3272): 资源退费说明 CRUD 模块
- hl-resource-service 新建表 resource_refund_note + 3 admin 接口
- 给运营在景区/活动详情下维护退费说明
- 后续 PR 接入产品快照 + PDF + 核单 Step 5

PR #3284 (Issue #3283): orderStatus/flowStatus 补 label 中文映射
- 订单列表/详情/创单响应新增 orderStatusName + flowStatusName
- 非破坏性,前端可选改造删掉自己的映射表

PR #3286 (Issue #3285): 订单接口加 8 步步骤条字段 + 修 2 个文案
- 新增 flowStep/flowStepTotal/flowDisplayText (16→8 步映射 + 中文文案)
- 修订 2 个枚举 label: 待提交房型→待提交配房需求, 待提交用车→待配车需求
- 前端请确认有无按老文案做字符串硬比较

3 PR 已全部 squash 合并到 dev-v3, 等部署后生效。
 2026-05-30 20:20:55 +08:00
yaosutu 720c1cce5f 新增 changelogs-v2-mp/ 目录：二期小程序端 changelog 推送目录 
- changelogs/         一期老前端（管理后台 + 小程序），凡是非 /v3/* 接口
- changelogs-v2/      二期管理后台（v3 admin），/v3/admin/* 接口
- changelogs-v2-mp/   二期小程序端（v3 mp），/v3/mp/* 接口（本次新增）

详见 HL 项目 .claude/CLAUDE.md 的 Changelog / 通知约定段。
 2026-05-28 11:04:22 +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
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
yaosutu b80f575fae 新增 22_2867-2868_订单详情枚举统一+service-standard修复 changelog 2026-05-22 12:37:39 +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
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
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: https://git.1814.love:8443/wx/HL/pulls/2614 (merged 087c4331)
- 前端 issue: https://git.1814.love:8443/wx/hl-api-changelog/issues/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
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
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: https://git.1814.love:8443/wx/hl-api-changelog/issues/1
- 后端 PR: https://git.1814.love:8443/wx/HL/pulls/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: https://git.1814.love:8443/wx/hl-api-changelog/issues/1
- 验证代码 commit: HL@dev-v3 47d24228
- 验证报告: HL/.claude/tmp-changelog/issue1-analysis.md（仅本地）
 2026-05-19 10:28:11 +08:00
yaosutu 9dfe5b270d feat(order-v3): 订单列表新增定制师姓名模糊筛选参数 consultantName（PR #2569） 2026-05-19 02:49:53 +08:00
yaosutu 67a38f91bf fix(admin-order-detail): PR #2571 补通 overview.travelers 真实出行人数据 
订单详情接口 GET /v3/admin/order/{id} 的 overview.travelers 字段
原来恒为空数组占位，现已接通真实出行人列表（按 traveler_id 升序）。
字段口径与 /traveler/list 完全一致，admin 端明文返回敏感字段。
 2026-05-19 02:47:37 +08:00
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