wx/hl-api-changelog
1
0
派生 0
代码 工单 合并请求 工作流 软件包 项目 发布 百科 活动
1,673 提交 29 分支 0 Git 标签
docs/5236-transport-driven-transfer
提交图
100 次代码提交
此分支
此分支
所有分支
作者 SHA1 备注 提交日期
yaosutu 614cad68e6 通知小程序出行人资料完整度语义变更
changelog-filename-gate / validate (push) Successful in 2s
详情
2026-07-24 17:47:04 +08:00
yaosutu 12fa3b7489 通知管理后台出行人手机号订单级门禁变更
changelog-filename-gate / validate (push) Successful in 1s
详情
2026-07-24 17:39:10 +08:00
yaosutu 8288bfcc7f 补充Step2票种规格字典与默认值说明
changelog-filename-gate / validate (push) Successful in 1s
详情
2026-07-23 16:43:36 +08:00
yaosutu 1e7c98f270 新增酒店房型轻量下拉接口说明
changelog-filename-gate / validate (push) Successful in 1s
详情
2026-07-23 14:07:27 +08:00
yaosutu c352c72060 再次通知前端核单Step1全量保存约定
changelog-filename-gate / validate (push) Has been cancelled
详情
2026-07-23 10:08:39 +08:00
yaosutu fc2ebf84ac 补充核单Step1数据来源提交约定
changelog-filename-gate / validate (push) Has been cancelled
详情
2026-07-23 09:55:07 +08:00
yaosutu 33d0999a68 纠正对公转账代收人契约说明 2026-07-21 16:40:57 +08:00
yaosutu 39acbeb0e8 通知前端修正调整订单尾款取值 2026-07-21 15:03:48 +08:00
yaosutu bb01b978b8 修正核团出行人年龄变更验证证据 2026-07-19 11:24:21 +08:00
yaosutu 5e2c374ab1 新增核团核算列表详情接口变更说明 2026-07-18 18:03:32 +08:00
yaosutu ce5bac10e6 补充核单Step1住宿字段前端变更通知 2026-07-18 16:53:16 +08:00
yaosutu 74461331cb 推送核单Step2景区游玩项目字段前端变更 2026-07-18 16:42:29 +08:00
yaosutu 4a88454172 新增预支审批列表接口变更说明 2026-07-18 15:47:44 +08:00
yaosutu cb3c557702 新增核单操作日志查询接口变更说明 2026-07-18 15:22:45 +08:00
yaosutu e3c0209f5b 推送费用明细已收款拆分接口变更通知 2026-07-18 10:13:12 +08:00
yaosutu c7e99515de 新增订单详情推送记录接口前端变更说明 2026-07-15 10:47:12 +08:00
yaosutu 61f23b9190 新增确认订单checklist删除actionPath变更说明 2026-07-13 11:00:04 +08:00
yaosutu 20d782c02b 补充确认订单预览提交接口 changelog 2026-07-13 10:16:49 +08:00
yaosutu 037748dcd2 推送调整订单出行人tab紧急联系人接口通知 2026-07-11 17:42:28 +08:00
yaosutu 318917e6cf 新增线下收款代收人接口变更说明 2026-07-10 16:37:52 +08:00
yaosutu 5aad9d2ed3 补充核单Step3合并辅助结算变更通知 2026-07-10 16:18:35 +08:00
yaosutu 96797a8e93 新增确认行程专用接口变更说明 2026-07-09 14:26:41 +08:00
yaosutu 1815d4008f 新增：定制师订单待办 7 个管理端接口（PR #4805/#4814/#4819） 2026-07-07 18:16:13 +08:00
yaosutu 83cbc282aa 推送 4 条核单侧改造接口变更 changelog（PR1 线下收款 / PR2 子表扩列 / PR3 recon+payout / PR5 submit收口） 2026-07-07 18:00:42 +08:00
yaosutu f1d36b8522 docs(changelog-v2): 签单 sign-voucher 金额改取协议成本价修改接口通知 
GET /v3/admin/order/{id}/sign-voucher 出参 unitPrice/amount/totalAmount 取值来源
从客户成交价(sell_price)改为协议成本价(景点 node.unit_price / 酒店 house.proto_price)，
字段名与结构不变。关联 HL #4722 / PR #4724。
 2026-07-02 14:51:07 +08:00
yaosutu 55944610fb docs(changelog-v2): 签单 sign-voucher 移除服务/接送预订单修改接口通知 
GET /v3/admin/order/{id}/sign-voucher 出参 entries 不再返回 type=SERVICE 的
服务/接送预订通知单，只保留 HOTEL 酒店 + SCENIC 景点两类。关联 HL #4715 / PR #4716。
 2026-07-02 11:50:18 +08:00
yaosutu f9634974c8 docs(changelog-v2): 电子行程单 documentType 三取值改名（消除撞名）修改接口通知 
GET /v3/admin/order/{id}/itinerary-document 的 documentType 三取值改名：
ITINERARY_C→CUSTOMER / ITINERARY_PRINT→CUSTOMER_PRINT / SIGNING→CUSTOMER_QUOTE。
业务零变动，出参结构不变，仅入参枚举值改名。关联 HL #4675 / PR #4705。
 2026-07-01 17:00:02 +08:00
yaosutu 50c1cb9b20 docs(changelog): 打印行程单注意事项改用订单服务标准 + 交接清单对齐原型（Issue #4700/#4702，PR #4701/#4703） 
notices 由三档 NoticeGroupVO[] 改服务标准服务承诺条目平铺 NoticeItem[] + 新增 noticesIntro；handoverChecklist 文案对齐原型。破坏性，管理后台前端须同步。
 2026-07-01 16:43:44 +08:00
yaosutu 0e32011617 docs(changelog): 打印行程单费用块收敛（Issue #4696，PR #4697） 
顶层删 orderAmount/payableTotal/outstandingBalance 移入 feeDetail；feeDetail 补优惠/附加费/已付；报价分价改可空(feeDetail 恒返回)。破坏性，管理后台前端须同步。
 2026-07-01 15:10:00 +08:00
yaosutu 985240047c docs(changelog): 打印行程单出参二次调整（Issue #4691，PR #4692） 
去 printTime / dateRange 拆 departDate+returnDate / 顶层补订单号+订单总额+应收总额+应收尾款 / 餐食三布尔改 meals 数组 / 节点加 serviceStandard。多处破坏性，管理后台前端须同步。
 2026-07-01 14:38:23 +08:00
yaosutu 7d68720e9b docs(changelog): 打印行程单出参增强 changelog（Issue #4682，PR #4683） 
notices 改自描述数组（破坏性）/ breakfast·lunch·dinner 改 Boolean（破坏性）/ 新增 days[].week / nodes[].description / nodes[].contactPerson·contactPhone（仅SCENIC）
 2026-07-01 09:34:52 +08:00
yaosutu c005372652 feat(order-v3): 新增打印行程单接口 changelog（Issue #4644，PR #4650） 
GET /v3/admin/order/{id}/print-itinerary
11 区块全量聚合，含字段表/枚举/3组示例/注意事项/关联链接
 2026-06-30 18:37:05 +08:00
yaosutu 10037c3266 docs(changelog): A2 订单实配层合并进行程节点 — 行程节点结算入参+签单出参+删景点餐接口 (#4628) 
管理后台 changelog：行程节点接口加 7 结算入参 / 签单出参加 type=SERVICE+景点出单+房型真名 / 删 6 个景点餐配置接口改走行程节点。epic #4628 五期 PR #4630/#4633/#4640/#4651/#4656。
 2026-06-30 16:30:33 +08:00
yaosutu dc65788d5d 文档(order-v3/调整记录): 新增 TRAVELER_EDIT 出行人资料修改变更项说明 (#4612 #4614) 2026-06-29 14:09:59 +08:00
yaosutu aff12f1333 docs(order-v3): 打印签单出参重制为自包含通知单+字段中文化 (#4549/#4566/#4584) 
GET /v3/admin/order/{id}/sign-voucher 出参三轮变更合并一份:删 header 概要/FROM 下沉到 entry、新增司机/导游/经办人/付款方式、房型/结算/付款 code 转中文。前端必改:原读 header 改读 entries[]。
 2026-06-29 10:09:16 +08:00
yaosutu 8de86f6680 补充 changelog：终止退款弹窗加应收尾款 outstandingBalance + 现场实收尾款 onsiteBalance（管理后台 #4579 #4581） 
预览出参增 outstandingBalance(应收尾款)；提交入参增必填 onsiteBalance(现场实收尾款,纯记录不参与退款)。并入同弹窗已有 changelog（42_4548）。
 2026-06-28 17:30:50 +08:00
yaosutu 0b8d673b20 新增管理后台 changelog：订单调整记录新接口 (#4540/#4556) + 退役行程编辑历史接口 (#4565/#4569) 2026-06-28 15:40:31 +08:00
yaosutu 884d6a42b9 新增 changelog：终止行程退款弹窗预览补字段 + 提交下界校验（管理后台 #4548 #4563） 
预览接口出参新增 days 数组(结束日选项)+订单基本信息(orderNo/customerName/productName/batchNo/consultantName)；提交接口新增错误码 581044(结束日前资源必须已用)+对应入参约束。
 2026-06-28 15:11:43 +08:00
yaosutu ea9d7ed769 docs(changelogs-v2): 订单调整 snapshot/submit 契约重制（#4488/#4498/#4502/#4509/#4516） 
snapshot 出参：basic 每次必返+承载订单号/产品名/团号+5金额，删顶层 discounts/surcharges/金额，行程改 days[].nodes[] 带价；
submit 入参：删 editReason/tabLocks/confirmDiffHash/basic/feeChanges，行程改 days[].nodes[]；出参精简为仅 success。
 2026-06-27 18:14:19 +08:00
yaosutu和Claude Opus 4.8 eaf6c7f3cd docs(changelog-v2): 订单调整弹窗出行人tab+改期tab(管理后台 #4458) 
GET .../adjustment/snapshot 出参加 schedule 块+travelers脱敏→明文(破坏性)+editableTabLocksHint门控;
POST .../adjustment/submit 启用 updates.travelers(原空转)+新增 updates.schedule;
出参加 newDepartDate/newReturnDate/newFlowStatus+changedDims.DEPART_DATE;
错误码 587034-587038;两tab窗口(出行人≤待出行/改期≤待确认)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-27 09:59:10 +08:00
yaosutu 4836fc9229 docs(order-v3): 预支借款对象改下拉同步——候选接口+payeeStaffId+585007（#4465） 
更新预支管理终态文档:新增 GET /advance/payee-candidates 候选下拉+AdvancePayeeCandidateVO 出参+创建入参 payeeStaffId 必填+585007 错误码+585002 废弃;借款对象语义从强制主报账人改为本单人员下拉选定(默认主报账人)。
 2026-06-26 18:42:40 +08:00
yaosutu 558425c4f8 新增 changelog：合同·保险 Tab 无合同/无保险时子对象返 null（订单详情接口 #4460/PR #4461） 2026-06-26 17:35:24 +08:00
yaosutu c88cc66ffd feat: 订单时间线 11 事件类型扩展 + 转单入参正式生效（管理后台 changelog） 
覆盖 6 PR：#4422 #4426 #4434 #4449 #4454 #4464
关联 Issue：#4419 #4423 #4428 #4446 #4451 #4459
 2026-06-26 17:35:13 +08:00
yaosutu 98e35c6096 docs(order-v3): 预支门槛收紧同步——已完成订单不可创建预支（#4462） 
gate 允许集去掉 COMPLETED，改为 待出发/出行中；同步 ③门槛 + ⑨业务边界。
 2026-06-26 17:18:41 +08:00
yaosutu 93aac89a3e feat(changelog): 取消单财务口径修正 — payableAmount/balanceAmount 对 CANCELLED 订单固定归零（PR#4432+#4457） 
- 涉及接口：GET /v3/admin/order/list、GET /v3/admin/order/{id}、GET /v3/admin/order/{id}/finance
- 仅 orderStatus=CANCELLED 订单受影响；非取消单口径不变
- payableAmount(应收总额)：取消=合同作废=应收消灭，固定0
- balanceAmount(待收尾款)：取消终态无待收，固定0
- totalAmount/paidAmount/refundAmount 历史台账保留不变
- 关联 Issue #4431/#4456，PR #4432/#4457
 2026-06-26 16:41:09 +08:00
yaosutu 037b82eaaa docs(order-v3): 订单预支管理最终态接口契约（创建即待审批+去草稿，#4452） 
合并 #4429/#4440/#4452 为单一自包含文档：5 端点（创建即SUBMITTED/审批/驳回/撤回/列表）+借款类型字典+错误码585000-585006；声明 submit 端点已删 404。
 2026-06-26 16:40:18 +08:00
yaosutu和Claude Opus 4.8 de1292823a docs(changelog-v2): 终止行程接口终态汇总(管理后台 #3556) 
合并 #3556 系列 3 篇 + #3965 金额String化 为一份终态,供前端一处对接:
- POST /v3/admin/order/{id}/terminate/refund-preview 终止退款预览
- POST /v3/admin/order/{id}/terminate 终止行程(执行)
点明: 旧路径 cancel/on-trip 已删返404; 金额+LongID 全String化;
终态 COMPLETED+PENDING_REVIEW(非CANCELLED); 581007/581018 错误码。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 10:04:32 +08:00
yaosutu 23d659a74b feat(changelog): 退款明细Tab懒加载出参重构——新增退款原因+申请时间，删除预计到账和逐项明细，修正退款渠道语义 (#4418) 2026-06-26 09:59:26 +08:00
yaosutu和Claude Opus 4.8 bc140004b6 docs(changelog-v2): 合同保险Tab创建合同与投保接口对接说明(管理后台) 
订单详情合同保险Tab两组操作按钮(选择合同方案+创建合同 / 选择保险方案+投保)
的后端接口对接说明,4个接口自包含契约:
- GET /v3/admin/contract/scheme/list 合同方案下拉
- POST /v3/admin/contract/create-by-scheme 创建合同(按方案)
- GET /v3/admin/insurance/scheme/list 保险方案下拉
- POST /v3/admin/insurance/purchase-by-scheme 投保(按方案)
后端接口早已存在,本文为前端首次对接说明。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
 2026-06-26 09:27:28 +08:00
yaosutu e0be4ce0d0 新增接口：标签库分页列表 GET /v3/admin/tag-library/page（PR #4416，Issue #4415） 2026-06-26 09:06:25 +08:00
yaosutu 500f824518 docs(changelog): 订单详情合同保险Tab出参终态 双端管理后台 (#4390 #4403) 
合同顶层补方案名/签署人/签署方式+富时间线(actor/状态/描述);保险结构重构为
聚合层+policies数组(多保单各张独立含时间线,删旧顶层policyNo/premium/events,破坏性)。
覆盖 PR #4391 #4399 #4406。
 2026-06-25 18:01:00 +08:00
yaosutu 799981cbe8 推 changelog：发票推送明细日志 #4395/#4397（管理后台，新增 GET push-logs 接口+发票详情出参加 pushLogs 数组，每渠道每次一条含操作人/时间/状态） 2026-06-25 15:18:09 +08:00
yaosutu 2d52ce1513 推 changelog：发票管理列表搜索补齐 #4383/#4384（管理后台，GET invoice/page 入参新增 contactName+orderNo 接线生效+跨 tab 完整搜索） 2026-06-25 11:25:44 +08:00
yaosutu 10340d0104 推 changelog：发票推送渠道改走数据字典 invoice_push_channel #4379（管理后台，PUT push 渠道合法值由硬编码改字典驱动+降级兜底，渠道值不变） 2026-06-25 10:35:21 +08:00
yaosutu 76dcf10531 推 changelog：发票模块 #4337/#4349/#4360（ALL 改订单视角+封面图+申请删 amount+门槛放宽+开票核单门槛，管理后台+小程序端） 2026-06-25 10:17:51 +08:00
yaosutu 597096129b docs(refund): 退款详情 orderInfo 补订单字段（#4356 修改接口-管理后台） 
GET /v3/admin/refund/application/{id} 出参 orderInfo 块原恒为 null，
本次修复接通 OrderService 后正常填充，并新增 teamNo / tierName / peopleSummary
三字段，与退款列表接口（PR #4344）保持口径一致。非破坏性变更。

Issue: https://git.1814.love:8443/wx/HL/issues/4356
PR:    https://git.1814.love:8443/wx/HL/pulls/4359
 2026-06-24 17:47:11 +08:00
yaosutu a9e26fa47b 退款待办列表出参新增团号/档位/人员数三字段（#4344，Closes #4343） 2026-06-24 16:11:58 +08:00
yaosutu 43d55d0a4d 发票管理列表 ALL tab 改订单视角 (#4338) - changelogs-v2/2026-06 2026-06-24 15:17:37 +08:00
yaosutu 9965b110fb docs(changelog): 待收尾款 balanceAmount 退款口径修正 + 详情头部/列表补 refundAmount 管理后台 (#4333) 
balanceAmount 修正(有退款订单数值变大,无退款不变)+ main/list 新增 refundAmount。
 2026-06-24 14:37:43 +08:00
yaosutu 45e2af81f8 docs(changelog): 财务详情新增应收总额 payableAmount 字段 双端管理后台 (#4321) 
财务Tab/订单详情头部/订单列表 3 个 admin 接口出参各新增 payableAmount(应收总额)派生字段。
 2026-06-24 10:32:39 +08:00
yaosutu f85aa74eb5 docs(发票): PR #4311 收口——4份发票 changelog 勘误（amount 改 JSON number 元） 
修正范围：
- 23_4290_发票申请入参票种修正-修改接口-管理后台.md
- 23_4290_发票申请票种修正-修改接口-小程序端.md
- 23_4258_发票详情接口-新增接口-管理后台.md
- 23_4265_发票列表page结构调整-修改接口-管理后台.md

主要变更（4份文件均已对齐最终线上契约）：
1. amount 入参/出参全部改为 JSON number（单位元，如 986.00），
   原「integer 分/字符串分/×100」描述已作废
2. 各文件顶部勘误节追加「截至 PR #4311 收口」条目，
   关联 Issue #4290/#4296/#4310、PR #4292/#4302/#4311
3. 详情接口边界示例：专票 email 由 null 改为始终有值（全电子交付）
4. 列表接口：records.amount 和 stats.amount 均改为 number 类型
 2026-06-23 17:09:06 +08:00
yaosutu 3e00271082 docs(changelog-v2): 退款待办统计接口出参改数组+分页新增statusGroup参数（#4303/#4308） 2026-06-23 17:06:40 +08:00
yaosutu a47eeeedcb docs(invoice): 发票申请最终契约 - 新增2文件 + 勘误2文件（#4290 #4292 #4302） 
新增：
- changelogs-v2/2026-06/23_4290_发票申请入参票种修正-修改接口-管理后台.md
- changelogs-v2-mp/2026-06/23_4290_发票申请票种修正-修改接口-小程序端.md

勘误：
- 23_4258_发票详情接口：删除 mailAddress 出参字段、去掉 ELECTRONIC 枚举、email 改为始终有值
- 23_4265_发票列表：invoiceType 枚举去掉 ELECTRONIC（普票/专票两值）

契约定稿要点：invoiceType 只有 VAT_NORMAL/VAT_SPECIAL；email 始终必填+格式；
专票限 COMPANY 抬头（581523）；专票五项全必填（581515）；删 mailAddress（全电子交付）
 2026-06-23 16:05:51 +08:00
yaosutu 2a24c42ba5 feat(发票模块): 新增发票详情接口 + 发票列表 page 结构升级（管理后台·#4258/#4265） 
- 新增 GET /v3/admin/order/invoice/{id} 发票详情接口（全量字段含专票四项/开票痕迹/推送痕迹）
- GET /v3/admin/order/invoice/page 列表行新增 9 个订单冗余字段
- tab 入参新增 NONE（未申请，代客申请候选）
- tabCounts 和 stats 从扁平对象改为数组（破坏性）
 2026-06-23 12:37:57 +08:00
yaosutu 7907e2aaa6 docs(changelog): 退款申诉新增接口 + 统一售后工单下线 双端 (#4250) 
售后拆分重构(PR #4251 #4254)对外接口变更:
- 小程序端(changelogs-v2-mp): 申诉新增 4 接口(发起/我的/详情/撤回)+ /v3/mp/aftersale/ticket* 下线 404
- 管理后台(changelogs-v2): 申诉新增 2 接口(分页/详情,关联展示来源+触发退款)+ /v3/admin/aftersale/ticket* 下线 404
- 申诉复用退款审批(无独立申诉审批);投诉仅移包路径不变
- 13 节自包含:全字段+枚举(appealType/appealStatus)+错误码 530601-609+示例(含工单 404 异常)
 2026-06-23 12:26:01 +08:00
yaosutu 75dea54f2f docs(changelog): 退款待办工作台后端接口(stats统计+resubmit重新发起+page列表增强) 管理后台 (#4226) 2026-06-22 17:48:20 +08:00
yaosutu 41acbe58bb 文档：发票待办补齐三 PR - 财务列表 NONE Tab + 订单字段 + 推送接口（#4233/#4235/#4238，Issue #4228~4230） 2026-06-22 17:10:36 +08:00
yaosutu df6bee83b8 docs(v2/aftersale): v2 申诉退款 execute-appeal 接口废弃 → 迁移至 v3 售后工单 resolve 
v2 PUT /order/refund/{id}/execute-appeal 在 v3 不存在（404）
新流程：POST /v3/admin/aftersale/ticket/{id}/resolve 处置时核定金额，OA 通过后自动退款
关联 Issue #4161
 2026-06-22 17:05:26 +08:00
yaosutu ee75e0ca36 文档：退款原因管理补 reason/list 列表端点（PR #4243，Issue #4242） 2026-06-22 16:35:50 +08:00
yaosutu 8144e7d197 docs(v2): 早鸟优惠 v3 管理后台对接 changelog 补建菜单说明 
前端迁移指引加第1步：v3 后台需新建早鸟优惠菜单入口（二期独立工程不会从 v2 自动带菜单），页面照搬 v2 即可。注意事项同步补一条。
 2026-06-22 16:23:41 +08:00
yaosutu 3c50202413 文档：退款政策与原因管理接口 v2->v3 路径对照与算法差异说明（管理后台） 2026-06-22 16:23:41 +08:00
yaosutu d564ea71e7 docs(order/admin): 早鸟优惠管理页面 v3 接口对接说明 — 路径迁移指引（#4053/#4064/#4076/#4082） 2026-06-22 16:20:59 +08:00
yaosutu 0df61a7b61 docs(order/admin): 订单列表售后 Tab 接口变更通知 (#4222/#4225) 
GET /v3/admin/order/status-group-counts 返回数组由 5 项增至 6 项，新增末项售后(AFTERSALE)。
GET /v3/admin/order statusGroup 参数新增枚举值 AFTERSALE。
售后为横切叠加语义，计数不纳入全部总数，与出行阶段 Tab 正交。
 2026-06-22 15:47:41 +08:00
yaosutu 60350ddecf 推 changelog：订单财务明细查询（优惠/增项清单）接口说明 — #4205 变更预览历史数据源用法 2026-06-22 14:58:50 +08:00
yaosutu cbad66ecc7 文档(aftersale+order/admin): 管理后台——售后工单机审auditStatus(#4196 PR#4203)+订单售后中展示aftersaleStatus(#4197 PR#4208) 2026-06-22 14:25:34 +08:00
yaosutu a9185984e7 文档(aftersale/mp): 售后工单接入wx机审——小程序端入参新增mediaTraceIds，出参新增auditStatus (#4196 PR#4203) 2026-06-22 14:25:21 +08:00
yaosutu 0e9a44568f feat: 订单增减项改造 changelog（Issue #4205，PR #4207） 
新增统一端点 POST /v3/admin/order/{orderId}/adjustment + 字典化项目名 + 出参增 itemCode/itemName
 2026-06-22 12:40:39 +08:00
yaosutu 77a1c4a780 docs: 新增 order-v3 退款域管理后台接口说明（政策/原因/申请管理，共 21 个接口） 2026-06-22 00:26:20 +08:00
yaosutu a6cc4feb93 新增接口通知：v3 售后申诉（小程序端）4 个新接口 — 发起工单/我的列表/工单详情/撤回（Issue #4161） 2026-06-22 00:17:45 +08:00
yaosutu 63e3b0c964 新增接口通知：v3 售后申诉中心（管理后台）4 个新接口 — 工单分页/详情/受理/处置，退款类处置走企微 OA 审批（Issue #4161） 2026-06-22 00:17:34 +08:00
yaosutu 7c93c5b89d 发票补齐系列：管理后台财务开票闭环+定制师代申请 + 小程序端申请可见性签名下载 2026-06-21 22:47:57 +08:00
yaosutu 43d69d38d1 docs: 新增早鸟优惠计划管理 CRUD 接口 changelog（管理后台，PR #4076） 2026-06-20 10:17:15 +08:00
yaosutu d553718b36 docs(changelog): 到达计划自驾时段 selfDrivePeriodLabel 文案含时间范围(小程序端) 
mp 到达计划出参 selfDrivePeriodLabel 口径变化(上午→上午(06:00-12:00))，前端直显无需改代码。
 2026-06-19 17:51:32 +08:00
yaosutu 8c8edd364b Merge branch 'main' of https://git.1814.love:8443/wx/hl-api-changelog 2026-06-19 17:50:21 +08:00
yaosutu a770215188 docs(changelog): 大交通接口对齐v2——list分组结构变更+补全label/接送/类型/来源字段 
管理后台大交通(#4061/#4075/#4080):list返回改{arrivals,departures}分组(破坏性)，
补 directionLabel/modeLabel/transportTypeLabel/selfDrivePeriodLabel+createTime+creatorType，
add/edit入参补pickup，嵌套出行人补travelerType。
 2026-06-19 17:50:07 +08:00
yaosutu 82080d7c4a 新增订单标签筛选项接口 tag-options（PR #4068，Issue #4065） 
新增 GET /v3/admin/order/tag-options，返回所有订单已挂标签的去重升序列表，
供订单列表标签筛选下拉使用（替代 /tag-library 避免选到无订单的标签）。
同步说明 tagNames 多选为 OR 语义及传参方式。
 2026-06-19 16:41:10 +08:00
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