From 8144e7d197e56c9c8081fd369b6a9dbae8b7ae58 Mon Sep 17 00:00:00 2001 From: yaosutu <770858045@qq.com> Date: Mon, 22 Jun 2026 16:23:40 +0800 Subject: [PATCH] =?UTF-8?q?docs(v2):=20=E6=97=A9=E9=B8=9F=E4=BC=98?= =?UTF-8?q?=E6=83=A0=20v3=20=E7=AE=A1=E7=90=86=E5=90=8E=E5=8F=B0=E5=AF=B9?= =?UTF-8?q?=E6=8E=A5=20changelog=20=E8=A1=A5=E5=BB=BA=E8=8F=9C=E5=8D=95?= =?UTF-8?q?=E8=AF=B4=E6=98=8E?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 前端迁移指引加第1步：v3 后台需新建早鸟优惠菜单入口（二期独立工程不会从 v2 自动带菜单），页面照搬 v2 即可。注意事项同步补一条。 --- .../22_4082_早鸟优惠管理页面v3对接-接口说明-管理后台.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/changelogs-v2/2026-06/22_4082_早鸟优惠管理页面v3对接-接口说明-管理后台.md b/changelogs-v2/2026-06/22_4082_早鸟优惠管理页面v3对接-接口说明-管理后台.md index 8d7537d..569daea 100644 --- a/changelogs-v2/2026-06/22_4082_早鸟优惠管理页面v3对接-接口说明-管理后台.md +++ b/changelogs-v2/2026-06/22_4082_早鸟优惠管理页面v3对接-接口说明-管理后台.md @@ -332,10 +332,11 @@ maxPeople 不传=不限；productIds 不传=不限产品；applicableTravelerTyp | 枚举值 / 数据字典 | 不变 | 完全一致 | 否 | | 页面 UI / 交互逻辑 | 不变 | 完全一致 | 否 | -**前端迁移两步走**： +**前端迁移三步走**： -1. 将所有早鸟管理接口的请求路径加 /v3 前缀（/admin/order/early-bird* 改为 /v3/admin/order/early-bird*） -2. 列表接口如果之前调的是空路径 /admin/order/early-bird（无 /list 后缀），改为 /v3/admin/order/early-bird/list +1. 在 v3 管理后台新建「早鸟优惠」菜单入口（页面可直接照搬 v2 早鸟优惠管理页面，UI / 字段 / 交互不变；v3 管理后台为二期独立前端工程，菜单需要新增，不会从 v2 自动带过来） +2. 将所有早鸟管理接口的请求路径加 /v3 前缀（/admin/order/early-bird* 改为 /v3/admin/order/early-bird*） +3. 列表接口如果之前调的是空路径 /admin/order/early-bird（无 /list 后缀），改为 /v3/admin/order/early-bird/list --- @@ -357,6 +358,7 @@ maxPeople 不传=不限；productIds 不传=不限产品；applicableTravelerTyp 4. PUT 全字段覆盖：修改接口不支持 PATCH，未传的选填字段会被重置为 null / 默认值。前端编辑弹窗提交时需确保把所有当前值一并回传。 5. toggle 启用触发冲突校验：将已禁用的计划重新启用时，若同产品 + 同时间段 + 同人数区间已有其他启用计划，接口返回 581610 并拒绝操作，前端需处理该错误码并展示 msg。 6. 早鸟不追溯已有订单：管理员修改或删除计划后，已下单订单中已结算的早鸟优惠金额不变，仅影响后续新下单的订单。 +7. 需新建菜单：v3 管理后台是二期独立前端工程，早鸟优惠菜单不会从 v2 自动继承，前端需在 v3 后台手动新建「早鸟优惠」菜单入口（页面照搬 v2 即可）。 ---