Product PRD

产品需求文档：商品管理（按用户流程）

当前版本按生产页面 https://cofeplus.pages.dev 的商品管理实现口径整理，用于开发、测试和验收对齐。

截图标准： PRD 截图和页面状态以后统一以生产域名 https://cofeplus.pages.dev 为准；不得使用与生产 UI 不一致的示意图替代。

1. 范围说明

商品管理当前只覆盖商品列表维护、商品编辑、分类维护、设备语言与币种配置、印花图片设置、批量改价和批量上下架。

商品运营标识本期只支持 是否热销 一个布尔能力。点单屏、商品卡片和商品详情页都以商品字段 featured 作为唯一来源。

业务标签功能本期不实现。已完成的业务标签方案保留在独立恢复分支 codex/business-tags-archive，后续需要恢复时从该分支重新评估合并。

2. 用户流程

UF001：查看商品管理工作区 实现

  1. 用户进入商品管理页，默认打开 菜单管理。
  2. 页面展示当前设备、分类导航、商品搜索、商品总数和在售商品数。
  3. 商品卡片展示图片、名称、售价、原价展示文案、上下架状态和编辑入口。

UF002：编辑商品基础信息 实现

  1. 用户点击商品进入详情页。
  2. 用户可编辑多语言名称、描述、售价、原价展示文案、上下架状态和是否热销。
  3. 保存后商品列表和点单屏预览同步展示最新信息。

UF003：设置是否热销 实现

  1. 用户在商品详情页切换 是否热销。
  2. 系统保存 featured 字段。
  3. 点单屏和商品管理卡片只在 featured = true 时展示“热销”。

UF004：配置设备语言和币种 实现

  1. 用户进入 基本设置。
  2. 用户维护当前设备可见语言、隐藏语言恢复、默认语言和币种。
  3. 保存后点单屏和相关后台页面按当前设备配置展示。

UF005：复制商品 实现，范围收敛

  1. 用户在商品管理页点击复制商品。
  2. 本期只支持复制到一台机器上。
  3. 用户选择目标分类和模板商品后进入商品详情复制流程，确认后生成新商品。

UF006：批量改价与批量上下架 实现

  1. 用户进入 批量改价。
  2. 用户按当前筛选范围勾选商品。
  3. 用户可批量固定改价、仅改原价展示文案，或批量上下架。

UF007：分类排序和商品分类调整 本期不实现

本期不实现分类排序调整，也不实现商品所属分类调整。界面、测试用例和验收报告中都应标记为未实现，不作为本次提测通过项。

3. 关键业务规则

能力当前规则
热销标识只读取并保存 featured。旧数据中已有的标签字段仅可用于兼容读取，不再作为编辑和保存对象。
原价展示文案字段含义是点单屏价格旁的展示文案，可能是划线原价，也可能是“X折”等文案。后台文案不应限定为只能表达原价。
业务标签本期不提供标签库、标签绑定、隐藏、恢复、新建、编辑和排序能力。
复制商品本期只支持复制到一台机器，不支持一次复制到多台机器。
设备作用域语言、币种、印花图片和商品复制都以当前设备为操作上下文。

4. 本期不实现项

  • 业务标签管理、商品业务标签绑定、业务标签隐藏与恢复。
  • 分类排序调整。
  • 商品所属分类调整。
  • 复制商品到多台机器。

5. 验收标准

  • 商品详情页存在 是否热销 开关，并保存到 featured。
  • 商品管理卡片和点单屏预览仅根据 featured 展示“热销”。
  • 页面不出现业务标签管理入口、业务标签编辑区或标签库配置流程。
  • UF007 明确标记为本期不实现。
  • 复制商品流程只允许单目标机器。
  • PRD 中不出现面向开发实现细节的浏览器传输变量名，避免开发和测试误解。