diff --git a/docs/fresh-mint-pl-plan-contract-qty-check-demo.html b/docs/fresh-mint-pl-plan-contract-qty-check-demo.html
new file mode 100644
index 000000000..439d7e856
--- /dev/null
+++ b/docs/fresh-mint-pl-plan-contract-qty-check-demo.html
@@ -0,0 +1,551 @@
+
+
+
+
+
+ 运输计划安排 · 合同数量校验 & 框架合同提醒
+
+ 预览「安排运输」时的两类提示:① 有数量合同 — 已安排 + 本次是否超合同总量;
+ ② 框架采购/销售合同(无固定数量)— 每次提醒累计已安排数量。数量口径对齐合同详情三列:
+ 已安排合计 = 已归档 + 未归档已安排(按停靠段 plan_qty / product_id)。
+
+
+ 路径 · /#/pl/plan-module/plan
+ 触发点 · 安排运输 / 保存并安排
+ 场景 A · 超量硬拦截
+ 场景 B · 框架累计提醒
+ 场景 C · 未超限提醒剩余
+
+
+
+
+
+
A. 有数量合同(销售/采购等)
+
+ - 合同产品行存在有效数量时参与校验
+ - 校验式:已安排合计 + 本次 planQty ≤ 合同数量
+ - 超限:安排前提交拦截,弹窗说明差额,必须改数量
+ - 未超限:安排成功之后弹窗提醒剩余可安排量
+ - 汇总口径:有绑合同的段都校验;已安排合计按该合同挂接停靠段(同合同详情三列)
+
+
超限 → 事前硬拦;未超限 → 成功后提醒剩余
+
+
+
B. 框架合同(无数量)
+
+ - 类型:框架销售 / 框架采购(含历史 framework)
+ - 产品数量为「按客户需求」或空 → 不拦数量
+ - 安排成功之后提醒:本次 + 累计已安排(无「剩余」)
+
+
成功后提醒,不阻断安排
+
+
+
+
+
+
+
+
+
+
+
+
+
安排运输 · 绑定有数量合同
+
+ 销售合同
+
+
+
+
+
+
装货合同
HT-2026-0318 · 硫酸销售合同
+
+
+
+
+
本次装货产品 vs 合同用量
+
+
+
+ | 产品 |
+ 合同数量 |
+ 已安排合计 |
+ 本次安排 |
+ 安排后合计 |
+ 剩余可安排 |
+ 结果 |
+
+
+
+
+ | 98% 硫酸 |
+ 100.000 |
+ 80.000 |
+ 30.000 |
+ 110.000 |
+ -10.000 |
+ 超量 |
+
+
+ | 液碱 32% |
+ 50.000 |
+ 20.000 |
+ 10.000 |
+ 30.000 |
+ 20.000 |
+ 正常 |
+
+
+
+
+ 校验提示:产品「98% 硫酸」安排后合计 110 超过合同数量 100(超出 10)。请调减本次数量或更换合同后再安排。
+
+
+
+
+
+
+
+
安排运输 · 框架销售合同
+
+ 框架销售合同
+
+
+
+
+
+
送货合同
HT-KJ-2026-008 · 年度框架销售
+
+
+
+
+
本次产品安排(框架无总量上限)
+
+
+
+ | 产品 |
+ 合同数量 |
+ 已安排合计 |
+ 本次安排 |
+ 安排后已安排 |
+ 结果 |
+
+
+
+
+ | 工业盐酸 |
+ 按客户需求 |
+ 126.500 |
+ 28.000 |
+ 154.500 |
+ 提醒 |
+
+
+ | 片碱 |
+ 按客户需求 |
+ 40.000 |
+ 12.000 |
+ 52.000 |
+ 提醒 |
+
+
+
+
+ 框架合同提醒(安排成功后):无固定数量上限。工业盐酸累计已安排 154.500,片碱累计已安排 52.000。
+
+
+
+
+
+
+
+
安排运输 · 有数量且未超限
+
+ 采购合同
+
+
+
+
+
+
装货合同
HT-CG-2026-102 · 液碱采购
+
+
+
+
+
本次产品安排
+
+
+
+ | 产品 |
+ 合同数量 |
+ 已安排合计 |
+ 本次安排 |
+ 安排后合计 |
+ 安排后剩余 |
+ 结果 |
+
+
+
+
+ | 液碱 32% |
+ 200.000 |
+ 150.000 |
+ 40.000 |
+ 190.000 |
+ 10.000 |
+ 成功后提醒 |
+
+
+
+
+ 未超限:先完成安排;成功后再弹窗告知「剩余可安排量」(知悉即可,非二次确认)。
+
+
+
+
+
+ 已确认:超量事前硬拦;未超限 / 框架 → 安排成功后弹窗提醒;校验范围 = 有绑合同的段,已安排合计口径对齐合同详情三列。点击「安排运输」预览弹窗。
+
+
+
+
+