日期: 2026-07-31
状态: 已确认待实现
关联: 修订 docs/superpowers/specs/2026-07-31-pl-feedback-brand-qty-design.md 中 required「仅指定品牌可选」硬锁语义
选定方案: 方案 1 — 回填侧统一按 any 规则校验与交互;计划侧仍保留 brandMode=required + brandId/brandName 作偏好展示
运输计划产品行可选「指定品牌」(brandMode=required)。原设计在司机链接、现场链接、归档弹窗等回填路径上硬锁为:只能填写该品牌一行,且数量必须等于实际数量。
实际业务中,计划指定品牌仅表示偏好/提示;回填时常需按多品牌拆分实装量,且不必强制包含计划指定品牌。
本变更取消回填硬限制,保留计划侧偏好语义与默认预选。
| 项 | 决策 |
|---|---|
| 指定品牌含义 | 计划侧提示/偏好;回填不必包含该品牌 |
| 回填交互 | 与「不限品牌」相同:多选芯片、可取消 |
| 默认选中 | 打开回填时预选计划指定品牌(数量可改、可取消),仍可再选其他品牌 |
| 存库语义 | 不改计划创建:选品牌仍为 required+id/name;清空仍为 any |
| 校验 | required 与 any 共用:至少一正数量行,合计 = 实际数量 |
| 范围外 | 不改表结构、不迁历史、不做「必须包含指定品牌」 |
brandMode=required + 快照;清空 → anybrandMode 为空:回填不展示品牌区,只填总量brandMode(any / required):至少 1 个品牌 qty > 0,且各品牌合计等于该产品实际数量适用范围:司机公开页、现场入/出库公开页、运输计划归档弹窗、管理端司机回传补录、计划详情内现场回传编辑等所有品牌填量入口。
| 计划约定 | 芯片交互 | 默认选中 | 是否必须包含指定品牌 |
|---|---|---|---|
required + 某品牌 |
与 any 相同:多选可取消 |
预选该偏好品牌(已有已保存明细则优先回显) | 否 |
any |
多选 | 仅产品仅有一个启用品牌时预填(现状) | 不适用 |
无 brandMode |
不展示品牌区 | — | — |
BrandQtyChipsField 标题统一为「选择品牌并填量」,不再使用「指定品牌填量」以免暗示单品牌锁定backend/app/services/pl_brand_archive.py → validate_brand_qty_rows:删除 required 分支中「只能填写该品牌」「单行数量必须等于实际数量」的校验;required 与 any 均校验正数量合计等于 actual_qtypl_plan_service、pl_feedback_brand_qty.require_brand_qtys_if_needed 等)签名可保持;required_brand_id 不再用于硬锁校验(可保留参数以免大范围改签名,或后续清理)BrandQtyChipsField:required 不再渲染锁定芯片(chip--locked);统一走多选芯片;requiredBrandId 仅供父级默认预选,组件内不禁止取消pl-plan-archive-dialogviews/public/pl/transport/index.vueviews/public/pl/_shared/PublicIoOrderPage.vuepl-plan-driver-feedback-dialogpl-plan-view-tabs 内现场品牌编辑required 初始化:brandOptions 加载产品全部启用品牌(与 any 相同);无已保存明细时 brandQtyRows 预填指定品牌一行syncRequiredBrandQty:不再把实际数量强制同步到唯一指定品牌行;有品牌时实际数量由品牌合计驱动(与现 any 一致)docs/demos/pl-site-driver-brand-qty-demo.html 中「指定品牌时仅允许该品牌一行」说明2026-07-31-pl-feedback-brand-qty-design.md 中 required 硬锁描述以本文件为准覆盖required + 多品牌合计等于实际数量 → 通过required + 仅非指定品牌且合计正确 → 通过required + 合计 ≠ 实际数量 → 失败required + 完成态无正数量行 → 失败any 原有用例行为不变any / 无品牌产品行为与现网一致brandMode=required 命名与回填行为不完全同义:文档与 UI 提示须写清「仅偏好」