From d720016808d210cb64f9015178f106390eb6244e Mon Sep 17 00:00:00 2001
From: API Changelog Bot <changelog@hulalv.com>
Date: Sat, 20 Jun 2026 09:42:11 +0800
Subject: [PATCH] =?UTF-8?q?changelog(order-v3/early-bird):=20=E6=97=A9?=
 =?UTF-8?q?=E9=B8=9F=E4=B8=80=E4=BA=A7=E5=93=81=E8=87=B3=E5=A4=9A=E7=94=9F?=
 =?UTF-8?q?=E6=95=88=E4=B8=80=E4=B8=AA=E6=97=A9=E9=B8=9F-=E9=98=B2?=
 =?UTF-8?q?=E5=90=8C=E8=AE=A2=E5=8D=95=E5=86=B2=E7=AA=81=E4=BF=9D=E7=95=99?=
 =?UTF-8?q?=E9=98=B6=E6=A2=AF(PR=20#4097)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...ˆä¸€ä¸ªæ—©é¸Ÿ_防å�Œè®¢å�•å†²çª�ä¿�留阶梯-行为å�˜æ›´-管ç�†å�Žå�°.md | 41 +++++++++++++++++++
 1 file changed, 41 insertions(+)
 create mode 100644 changelogs-v2/2026-06/20_4097_早鸟一产�至多生效一个早鸟_防�订�冲��留阶梯-行为�更-管���.md

diff --git a/changelogs-v2/2026-06/20_4097_早鸟一产�至多生效一个早鸟_防�订�冲��留阶梯-行为�更-管���.md b/changelogs-v2/2026-06/20_4097_早鸟一产�至多生效一个早鸟_防�订�冲��留阶梯-行为�更-管���.md
new file mode 100644
index 0000000..5cc22ff
--- /dev/null
+++ b/changelogs-v2/2026-06/20_4097_早鸟一产�至多生效一个早鸟_防�订�冲��留阶梯-行为�更-管���.md
@@ -0,0 +1,41 @@
+# �行为�更·管���】早鸟优惠——�一产��止两个"会对�一订��时生效"的早鸟计划(人数阶梯�留)
+
+> �务:hl-order-service-v2(8094) + hl-order-service-v3(8086) | 分支:dev-v3 | PR:#4097 | 工�:#4094
+> 已部署测试�并�网关 9443 真 admin token 端到端实测通过(2026-06-20):冲� create 返 585010;人数���的阶梯档 create 正常 200。
+
+## ⚠� 关键说明
+
+1. **早鸟新增"防�订�冲�"校验**:一个产���挂多个早鸟计划当**人数阶梯**(满5�100/满10�300,下�按人数命中最优一档,此能力**�留��**)。新增的�制是:**�止�一产�出现两个"会对�一笔订��时生效"的早鸟**——�两个计划都�用�且**生效日期窗���且人数区间��**时拒�。
+2. **触�入�**:新建(create)�编辑(update,本计划处�用�时)��用(toggle �用)三处。命中冲�时**�存/�用失败**,返回业务�:
+   - order-v2(线上购买/报价端):**`code=585010`**「产�(ID=X)已存在生效时间与人数区间��的早鸟计划(planId=Y),�能��创建或�用�
+   - order-v3:**`code=581610`**(�义消�)
+3. **�端需留�**:早鸟计划�置页�存/�用**����功**,命中冲�会返上�的业务�(HTTP � 200,`success=false`)。请按 `success===true` 判定�功,失败时把�端 `message` 直接 toast 出�(消�已是�读中文,无需�端拼文案)。
+4. **�算冲��照旧放过的情况**:① 人数区间���(如满1-4 与 满5-9,这就是阶梯);② 生效日期窗���(��档期);③ 对方计划已�用;④ 编辑时与自己�算冲�。
+
+## 1. �场景行为对照
+
+| 场景(�一产�) | 旧 | 新 |
+|---|---|---|
+| 新建早鸟,产�已有�用且日期+人数都��的计划 | �许,�行时被动按 priority 选一个(有按错价风险) | **拒�**,返 585010/581610 |
+| 新建早鸟,人数区间���(阶梯档) | �许 | �许(阶梯能力�留) |
+| 新建早鸟,日期窗���(��档期) | �许 | �许 |
+| 编辑/�用计划致与他计划"�订��时生效" | �许 | **拒�** |
+| �用计划 | �许 | �许(�校验,�用�会�少生效计划) |
+
+## 2. 端到端实测记录(测试�,网关 9443 真 admin token)
+
+```text
+TEST1 冲�:产� 2056938821550747650 已有�用计划(min1+/2026-05-01~06-30)
+  POST /admin/order/early-bird {minPeople:2,maxPeople:10,startDate:2026-06-01,endDate:2026-06-15,productIds:[...]}
+  → code=585010 success=false   ✅ 按预期拒�
+TEST2 阶梯:产� 2047268852147875842 已有�用计划(min6+)
+  POST /admin/order/early-bird {minPeople:1,maxPeople:5,startDate:2026-07-01,endDate:2026-07-31,productIds:[...]}
+  → code=200 success=true       ✅ 人数���的阶梯档照旧放过(实测�已删除临时数�)
+```
+
+## 3. �端内部�更(备查)
+
+1. `EarlyBirdPlanService`(v2/v3)新增 `validateNoActiveConflict`,在 create/update/toggle 三入�接线。冲�判定 = �产�(排除自身)的�一�用计划,日期窗�� 且 人数区间��(minPeople 空按 1�maxPeople 空按无上�)。
+2. `EarlyBirdPlanMapper`(v2/v3)新增 `selectEnabledByIds`(LambdaQueryWrapperX)。
+3. 新错误�:v2 `OrderEarlyBirdErrorCode.PRODUCT_HAS_CONFLICTING_PLAN=585010`�v3 `EarlyBirdErrorCode.PRODUCT_HAS_CONFLICTING_PLAN=581610`。
+4. 未动数�库/匹�算法(`doFindBestMatch`)/网关路由;纯�置端 Java 校验。