产品需求文档：商品详情页配方与标签配置

本文件用于定义商品详情页中 “修改配方” 与 “标签配置” 两个入口的产品定位、操作边界、保存规则与联动范围，适用于 正常编辑商品 场景。

1. 介绍 / 概述

在商品详情页的“配方配置”页签中，页面右上角同时提供“修改配方”和“标签配置”两个入口。两者服务于同一组商品选项，但解决的问题并不相同：

• “标签配置”负责客户在点单端看到什么、默认选什么、选中后是否需要加价。
• “修改配方”负责设备实际怎么做、配方如何组成、是否需要同步到关联商品。

当前页面已经具备这两套能力，但如果没有统一的产品定义，使用者容易把“显示规则”和“制作规则”混在一起使用，导致误改商品、误同步其他商品，或者不清楚保存后会影响哪些商品。

本文件只覆盖“正常编辑商品”场景下的商品详情页，不包含复制商品流程中的特殊规则。

2. 目标

• 帮助运营人员快速判断“修改配方”和“标签配置”分别该在什么场景下使用。
• 将“客户可见信息”和“机器制作规则”拆分管理，降低误操作。
• 明确保存后的影响范围，让运营人员在保存前就能预判结果。
• 让多语言、附加价格、默认选项、配方结构、关联商品同步等规则在同一页面中形成统一心智。

3. 适用范围

• 页面路径：菜单管理 > 商品管理 > 编辑商品 > 配方配置
• 适用对象：运营人员、商品管理员、配置维护人员
• 适用场景：对已存在商品进行日常维护与调整

不在本文件范围内的内容：

• 复制商品流程中的“只更新当前草稿商品”特殊逻辑
• 点单端前台页面的展示样式设计
• 设备底层制作参数体系的技术实现

4. 页面入口与交互原则

4.1 页面入口

进入商品详情页后，切换到“配方配置”页签，页面右上角展示两个并列按钮：

• 修改配方
• 标签配置

这两个按钮面向同一商品、同一页面，但负责不同配置层级。

4.2 交互原则

• 页面应先让运营人员明确自己正在处理哪一个选项组，例如咖啡豆、温度、浓度、糖浆等。
• 运营人员在修改前，应能明确区分“这是改客户看到的内容”还是“这是改机器制作逻辑”。
• 当前商品始终是本次编辑的主对象；涉及其他商品时，页面必须在保存前给出清晰确认。
• 所有保存反馈都应使用业务语言说明结果，例如“当前商品已更新”“已同步 X 个商品”“未勾选的商品不跟随本次配方调整”。

5. 用户故事

US-001：识别正确的配置入口

描述： 作为运营人员，我希望在商品详情页中能快速判断“修改配方”和“标签配置”分别负责什么，这样我不会把展示内容和制作规则改混。

验收标准：

• □ 在“配方配置”页签中，同时展示“修改配方”和“标签配置”两个入口。
• □ 页面说明或交互结果应能让运营人员理解二者职责不同。
• □ 运营人员可以基于当前任务判断应该进入哪一个入口。

参考截图：

US-002：通过标签配置维护客户可见内容

描述： 作为运营人员，我希望在一个入口里完成标签文案、多语言、附加价格和默认选项的维护，这样我可以统一管理客户看到和选择的内容。

验收标准：

• □ 标签配置支持查看和编辑各语言下的标签文案。
• □ 标签配置支持设置附加价格，未设置时默认按 0 处理。
• □ 标签配置支持设置客户购买时的默认选项。
• □ 标签配置支持在不同标签组之间切换，而不是只修改单一标签。
• □ 保存后，当前商品的标签信息立即更新。

参考截图：

US-003：通过修改配方维护制作规则

描述： 作为运营人员，我希望在一个入口里完成配方结构、顺序和比例调整，这样我可以直接维护商品的实际制作规则。

验收标准：

• □ 修改配方支持针对当前选项打开独立编辑界面。
• □ 支持调整配方分组顺序。
• □ 支持调整分组比例，例如 -10%、+10% 等常用操作。
• □ 支持查看各配方分组内容。
• □ 在修改配方中，名称类内容不作为主要编辑对象；如需改标签名称，应进入标签配置。
• □ 保存后，当前商品的配方立即进入本次保存流程。

参考截图：

US-004：导入基底配方或恢复出厂设置

描述： 作为运营人员，我希望在修改配方时可以快速导入基底咖啡配方，或者恢复为出厂版本，这样我可以提高维护效率并降低手工调整成本。

验收标准：

• □ 修改配方中提供上传基底咖啡配方文件的入口。
• □ 上传弹窗中提供样例文件下载能力。
• □ 导入成功后，当前选项的基底咖啡液配方被更新，并继续进入保存流程。
• □ 修改配方中提供“恢复出厂设置”入口。
• □ 执行恢复出厂前，页面要求用户再次确认。
• □ 恢复后，当前选项回到预设基准，并继续进入保存流程。

参考截图：

US-005：标签配置保存后按需同步同标签商品

描述： 作为运营人员，我希望在保存标签配置时看到有哪些商品使用了同样标签，并按需勾选是否同步，这样我可以控制影响范围。

验收标准：

• □ 当前商品的标签内容始终先完成更新。
• □ 当系统识别到其他商品使用了相同标签时，弹出同步确认列表。
• □ 列表中展示可同步的商品，运营人员可逐个勾选。
• □ 默认情况下，不强制同步其他商品。
• □ 未勾选的商品不发生变化。
• □ 保存完成后，反馈文案明确说明是否同步了其他商品，以及同步数量。

参考截图：

US-006：配方保存后确认关联商品范围

描述： 作为运营人员，我希望在保存配方时看到当前有多少关联商品会受到影响，并决定哪些商品继续跟随当前配方，这样我可以控制关联关系。

验收标准：

• □ 当前商品始终直接更新，不需要额外勾选。
• □ 弹窗中展示受影响的关联商品列表，且不包含当前商品。
• □ 关联商品默认全选，表示默认继续跟随本次新配方。
• □ 运营人员可以一键全选或清空关联。
• □ 不勾选的商品不跟随本次新配方，同时取消与当前商品的配方关联。
• □ 保存完成后，反馈文案明确说明“当前商品 + X 个关联商品”已更新。

参考截图：

6. 功能要求

6.1 页面结构要求

• FR-1：在商品详情页的“配方配置”页签中，必须同时提供“修改配方”和“标签配置”两个入口。
• FR-2：两个入口应并列展示，避免被误认为同一功能的不同按钮状态。
• FR-3：页面应让用户识别当前正在处理的选项组。

6.2 标签配置要求

• FR-4：标签配置负责管理标签名称及其多语言内容。
• FR-5：标签配置负责管理标签附加价格。
• FR-6：标签配置负责管理客户购买时的默认选项。
• FR-7：附加价格默认为 0，不要求用户必须手动填写。
• FR-8：标签配置中的多语言内容应与当前设备支持语言保持一致。
• FR-9：标签配置保存后，当前商品立即更新。
• FR-10：如存在使用同标签的其他商品，页面应在保存后展示可同步商品列表。
• FR-11：标签同步列表默认不强制选中其他商品，由运营人员自行决定是否同步。
• FR-12：运营人员勾选后，同步仅作用于被勾选商品；未勾选商品保持原状。
• FR-13：保存结果文案应明确告知“当前商品已更新”以及“已同步多少个商品”。

6.3 修改配方要求

• FR-14：修改配方负责管理当前选项的配方结构与制作逻辑。
• FR-15：修改配方支持调整配方分组顺序。
• FR-16：修改配方支持调整分组比例。
• FR-17：修改配方应支持拖拽调整分组顺序，并兼顾桌面端和移动端操作。
• FR-18：修改配方中，名称类信息以查看为主；若用户要修改选项展示名称，应引导至标签配置。
• FR-19：修改配方提供“上传基底咖啡配方文件”能力。
• FR-20：上传弹窗中提供样例文件下载入口。
• FR-21：修改配方提供“恢复出厂设置”能力。
• FR-22：恢复出厂前必须进行二次确认。

6.4 配方保存联动要求

• FR-23：保存配方时，当前商品始终直接更新。
• FR-24：如存在关联商品，页面应在保存前弹出确认列表。
• FR-25：关联商品列表不得包含当前商品自身。
• FR-26：关联商品默认全选，表示默认继续跟随当前商品的新配方。
• FR-27：页面需支持“全选关联”和“清空关联”两种快捷操作。
• FR-28：不勾选的商品不跟随本次新配方，同时与当前商品解除该配方关联关系。
• FR-29：保存完成后，反馈文案应明确说明更新范围，例如“已更新当前商品 + X 个关联商品”。

7. 保存结果说明矩阵

8. 非目标

• 不在本文件中定义复制商品流程下的特殊保存逻辑。
• 不在本文件中定义点单端页面的视觉样式。
• 不在本文件中定义设备底层制作参数的技术字段。
• 不要求在“修改配方”中直接编辑标签文案。
• 不要求在“标签配置”中直接编辑配方结构。

9. 设计注意事项

• 页面文案应优先使用运营人员能直接理解的表达，例如“客户默认选中”“同步到其他商品”“取消关联”。
• 两个入口虽然并列，但要让用户一眼看出：一个是改“展示和选择”，一个是改“制作和同步”。
• 当页面会影响其他商品时，必须先告诉用户“为什么会影响”“默认怎么处理”“不勾选会怎样”。
• 保存反馈要避免技术描述，改用结果导向的表达。

10. 成功标准

• 运营人员能清楚区分何时使用“标签配置”，何时使用“修改配方”。
• 运营人员在保存前能够理解本次修改是否会影响其他商品。
• 多语言、附加价格、默认选项、配方结构、关联同步等能力可以在同一页面中被稳定使用。
• 页面在日常维护场景中减少误同步、误改名、误改配方的问题。