商品管理 — 功能需求说明
本文档在《商品管理功能需求-草稿》基础上整理，并关联《农资商城web》目录下 商户管理 v1.3.1、店铺管理 v1.3.2、商品分类 v1.3.1、商品服务管理 v1.0.1 等需求做边界与流程对齐。
范围：商品在全生命周期的 状态管理、平台审核与下架、平台检索与详情；商家端 发布与上架 规则一并描述以便闭环。不涉及数据库结构、接口定义及技术实现细节。
说明： 草稿第 1 条为分类列表字段误贴，本文档以第 2 条及以后为准。
v1.1： 未上架、商品编号系统生成、待审核编辑不自动通过、库存为 0 禁止下单已产品定稿。
v1.3： 不考虑会员体系；商家端使用 店铺经营账号 登录（店铺管理配置）。
v1.3.1： 首期单规格（一个商品一条售价/库存）；状态 仅 能通过「提交上架 / 平台审核 / 下架」流转，不可改回未上架。
v1.3.3： 增补 商品服务勾选 与 展示快照 规则（P18～P21），与《商品服务管理功能需求》v1.0.1 对齐。
1. 模块定位
1.1 业务目标
- 平台管理端： 全平台商品监管 — 列表检索、查看详情、审核商家上架申请、执行下架。
- 店铺经营管理端（商家）： 在本店发布/维护商品，提交上架，受店铺「默认审核通过」策略约束。
- C 端： 仅在满足条件时展示并可购（受商品状态、店铺开业/停业、分类显示等约束）。
1.2 在业务链中的位置
商户管理（平台）── 主体入驻
└── 店铺管理（平台）── 配置店铺经营账号、营业状态、默认审核策略
└── 商品服务管理（平台）── 全平台服务目录
└── 商品分类（商家端）── 二级分类
└── 商品管理（本模块）── 勾选服务项
└── 订单等（下游）
| 关联模块 |
关系 |
边界说明 |
| 商户管理 v1.3.1 |
间接 |
商户冻结/注销 不自动 改商品状态 |
| 店铺管理 v1.3.2 |
上游 |
商品 归属店铺；「默认审核通过」、停业禁止下单等；商家端用 店铺经营账号 登录 |
| 商品分类 v1.3.1 |
上游 |
商品 仅可关联本店二级分类；检索按分类全路径展示 |
| 商品服务管理 v1.0.1 |
上游（主数据） |
平台维护服务目录；商家发品 多选；不维护 服务目录 |
| 订单管理 v1.0.1 |
下游 |
支付成功扣库存（§12.2）；未完成订单 O10 与删店/删商户一致 |
1.3 使用端与角色
| 端 |
角色 |
能力概要 |
| 平台管理端 |
平台管理员 |
全平台商品列表、检索、详情、审核、下架 |
| 店铺经营管理端 |
店铺经营账号（平台在店铺管理配置）及 子管理员（数量上限见店铺设置） |
本店商品发布、编辑、提交上架、商家下架 |
| C 端 |
用户 |
浏览与下单（受状态与店铺规则约束） |
说明： 商家端登录账号 = 店铺经营账号（与会员模块无关）。同一商户下多店 登录名相同，须 切换当前店铺 后操作本店商品。
2. 业务概念
| 概念 |
说明 |
| 商品 |
归属 唯一店铺，关联 唯一二级分类 |
| 商品编号 |
由 系统自动生成，全平台唯一，创建成功后展示，商家不可修改 |
| 商品状态 |
未上架、待审核、出售中、审核失败、已下架（见第 4 节） |
| 未上架 |
商家已保存商品但未提交上架（亦称 草稿）；仅商家端可见 |
| 提交上架 |
商家将 未上架 / 审核失败 / 已下架 等可售前状态的商品提交销售申请，触发状态流转 |
| 平台审核 |
平台对 待审核 商品通过或驳回 |
| 下架 |
平台或商家将 出售中 商品变为 已下架 |
| 默认审核通过 |
店铺级开关（店铺管理 v1.3.2），影响 提交上架 后的初始状态 |
| 规格（首期） |
单规格：一个商品对应 一个销售价、一个可售库存；不做多 SKU/规格矩阵（后续版本可扩展） |
| 商品服务项 |
平台配置的服务承诺/标签；商家发品时 多选；保存商品时生成 展示快照（见第 10.6、11.1 节） |
3. 功能结构
3.1 平台管理端
商品管理（平台）
├── 商品列表（含高级检索）
├── 查看详情
├── 审核商品（单独 / 批量）
└── 下架商品（单独 / 批量）
3.2 商家端（与状态闭环相关）
商品管理（商家 · 当前店铺）
├── 商品列表
├── 发布 / 编辑商品
├── 提交上架
└── 下架（商家）
商家端商品 增删改字段 的完整表单以产品/原型为准；本文档规定 状态、分类、店铺、审核与下架 规则。
4. 商品状态（定稿）
4.1 状态枚举
| 状态 |
含义 |
平台列表 |
C 端可售（还须店铺开业等） |
| 未上架 |
商家保存商品，尚未提交上架（草稿） |
✗ |
否 |
| 待审核 |
商家已提交上架，等待平台审核 |
✓ |
否 |
| 出售中 |
审核通过或免审通过，在售 |
✓ |
是（且库存＞0 等，见第 11 节） |
| 审核失败 |
平台审核驳回 |
✓ |
否 |
| 已下架 |
平台或商家主动下架 |
✓ |
否 |
4.2 状态流转总图
商家：保存商品
│
▼
【未上架】 ── 仅商家端可见，不进平台商品列表
│
商家：提交上架
│
┌───────────────┴───────────────┐
│ 店铺「默认审核通过」= 关闭 │ 店铺「默认审核通过」= 开启
▼ ▼
【待审核】 【出售中】
│ │
平台审核 │
├─通过──►【出售中】 │
└─驳回──►【审核失败】 │
│
商家编辑（待审核）→ 仍为【待审核】，不自动通过
│ │
商家重新提交上架 │
（同提交上架规则） │
│ │
└───────────┬───────────────────┘
│ 平台/商家：下架（仅出售中）
▼
【已下架】
│
商家：重新提交上架
（同提交上架规则）
│
┌───────────┴───────────┐
▼ ▼
【待审核】或【出售中】 （由店铺审核开关决定）
4.3 提交上架后的初始状态（与店铺管理对齐）
| 店铺「商品是否默认审核通过」 |
商家提交上架后商品状态 |
| 关闭（默认） |
待审核 |
| 开启 |
出售中（跳过待审核） |
- 策略变更 不追溯 已存在商品；仅对 此后 的提交上架生效。
4.4 平台审核（待审核 → 出售中 / 审核失败）
| 操作 |
前置状态 |
结果状态 |
操作角色 |
| 审核通过 |
待审核 |
出售中 |
平台管理员 |
| 审核不通过 |
待审核 |
审核失败 |
平台管理员 |
- 审核不通过时须填写 驳回原因（必填，展示给商家）。
- 仅「待审核」 可执行审核；其他状态选中审核时 阻断 并提示。
4.5 下架（出售中 → 已下架）
| 操作 |
前置状态 |
结果状态 |
操作角色 |
| 下架 |
出售中 |
已下架 |
平台管理员 或 商家 |
- 待审核、审核失败、已下架 不可执行「下架」操作（待审核应走审核驳回）。
- 下架 不删除 商品档案；商家可编辑后 重新提交上架（见 4.2）。
4.6 重新提交上架
| 原状态 |
商家操作 |
新状态（同 4.3） |
| 审核失败 |
修改后提交上架 |
待审核 或 出售中 |
| 已下架 |
提交上架 |
待审核 或 出售中 |
- 重新提交前须满足商品必填项、库存、分类等校验（与首次一致）。
- 未上架 商品 仅能通过「提交上架」 进入待审核/出售中，不可直接变为出售中（免审店亦须先提交）。
4.7 待审核期间商家编辑（v1.1 定稿）
| 规则 |
说明 |
| 可编辑 |
商家可修改商品信息并保存 |
| 保存后状态 |
仍为 待审核，不自动通过 为出售中 |
| 平台侧 |
商品仍在平台待审列表中；不因商家编辑而移除或自动通过 |
| 审核顺序 |
不重置 审核排队规则（若存在「先提交先审」，以首次提交上架时间为准；商家编辑不视为新提交） |
4.8 外部事件联动（定稿）
| 事件 |
商品状态 |
| 商户认证冻结/注销 |
不变 |
| 店铺开业→停业 |
不变；C 端 禁止下单（店铺 v1.3.2） |
| 店铺停业→开业 |
不变 |
| 分类「是否显示」改为否 |
不变；C 端分类入口不展示 |
| 店铺逻辑删除 |
本店商品 不可再经营；平台列表可按规则隐藏或只读历史 |
| 平台增删改/删除商品服务项 |
商品 上下架状态不变；对外展示以 快照 为准（P18～P21） |
5. 平台 — 商品列表
5.1 列表字段（对应草稿第 2 条，修正第 1 条误贴）
| 字段 |
说明 |
| 店铺名称 |
所属店铺 |
| 商品编号 |
全平台唯一编号 |
| 商品主图 |
缩略图 |
| 商品名称 |
— |
| 售价 |
展示 销售价（首期 单规格，即该商品唯一售价；不做「最低价」等多规格展示） |
| 库存 |
可售库存 |
| 销量 |
累计销量 |
| 商品状态 |
未上架 / 待审核 / 出售中 / 审核失败 / 已下架（平台列表 不含未上架） |
| 操作 |
查看详情、审核（待审核时）、下架（出售中时） |
可选列（建议）：商品分类（展示「一级 > 二级」）、商户名称。
5.2 列表行为
- 分页；默认按 提交上架时间或更新时间倒序（与平台列表规范一致）。
- 不展示 状态为 未上架 的商品（仅商家端可见）。
- 默认展示 未删除店铺 下、且已提交过上架流程的商品；已逻辑删除店铺的商品 不展示 或归入历史（与平台规范一致）。
- 支持按 商品状态 Tab 或筛选项快速筛选。
- 全部状态 的商品均可 查看详情（草稿第 5 条）。
6. 平台 — 高级检索
| 检索项 |
规则 |
| 商品编号 |
精确或模糊（与平台统一） |
| 商品名称 |
模糊匹配 |
| 商品分类 |
选择 二级分类 或按店铺先选店再选类；展示全路径 |
| 店铺名称 |
模糊匹配 |
| 商品状态 |
可选：待审核 / 出售中 / 已下架 / 审核失败（不含未上架） |
清空条件恢复默认列表。
7. 平台 — 查看详情
7.1 范围
7.2 展示内容（功能层）
| 类别 |
内容 |
| 基础信息 |
商品编号、名称、主图及详情图、售价、库存、销量等 |
| 归属 |
店铺名称、商户名称、商品分类（一级 > 二级） |
| 状态 |
当前商品状态；待审核/审核失败时展示审核时间、驳回原因 |
| 操作入口 |
待审核：审核通过/不通过；出售中：下架 |
7.3 与列表操作关系
- 详情页操作与列表行操作 能力一致，避免仅列表可审、详情不可审的分歧。
8. 平台 — 审核商品
8.1 方式
- 单独审核：行操作或详情页；
- 批量审核：勾选多条 均为待审核 的商品，统一 通过 或 不通过。
8.2 批量审核规则（定稿）
| 规则 |
说明 |
| 可选范围 |
仅 待审核 状态 |
| 失败策略 |
勾选条目中 存在非待审核 时，整批失败，不变更任何一条，并提示「所选商品含非待审核状态，请重新选择」 |
| 不通过 |
批量不通过时共用同一驳回原因 或 要求逐条填写 — 定稿：批量不通过须填写统一驳回原因 |
8.3 审核流程
选择商品 → 审核通过 / 不通过
→ 校验均为待审核
├── 否 → 整批失败提示
└── 是 → 不通过时填写原因 → 保存
→ 通过：待审核 → 出售中
→ 不通过：待审核 → 审核失败
9. 平台 — 下架商品
9.1 方式
9.2 规则
| 规则 |
说明 |
| 前置状态 |
仅 出售中 |
| 结果状态 |
已下架 |
| 批量失败策略 |
含非出售中商品时 整批失败，提示「所选商品含不可下架状态」 |
| 确认 |
建议二次确认：「下架后 C 端不可购买」 |
9.3 下架流程
选择出售中商品 → 下架
→ 校验状态
├── 不通过 → 整批/单条提示
└── 通过 → 确认 → 已下架
10. 商家端 — 商品发布与维护
10.1 店铺上下文
- 商家使用 店铺经营账号 登录 店铺经营管理端 后，须先选定 当前店铺（同一商户可多店、经营账号登录名相同，须切换店铺，见店铺管理 v1.3.2）；此后商品数据 仅作用于当前店铺。
- 仅在 当前店铺 下发布商品；商品 不可更换店铺。
- 店铺 停业 时：商家 可维护 商品信息；已出售中 商品在 C 端 禁止下单。
10.2 发布 / 编辑 — 关键字段（功能层）
| 字段 |
规则 |
| 商品分类 |
必选 本店 二级分类（商品分类 v1.1 C5） |
| 商品编号 |
系统自动生成，全平台唯一；创建成功后展示，商家不可填写或修改 |
| 商品名称 |
必填 |
| 商品主图 |
必填 |
| 商品详情 |
必填项以原型为准（富文本/详情图） |
| 销售价 |
必填；首期 单规格 唯一价格 |
| 可售库存 |
必填；非负整数；为 0 时 C 端不可下单（见第 11 节） |
| 所属店铺 |
当前店铺，只读 |
| 商品服务 |
多选，见第 10.6 节；非必填（允许不勾选任何服务项） |
10.3 商家上架与下架
| 操作 |
说明 |
| 提交上架 |
未上架、审核失败、已下架等可发起；校验通过后按 4.3 进入 待审核 或 出售中 |
| 保存 |
未上架 状态下保存资料，不进入平台列表 |
| 下架 |
仅对本店 出售中 商品；变为 已下架 |
| 编辑 |
各状态下是否可编辑见 10.4 |
10.4 商家编辑权限（定稿）
| 商品状态 |
可编辑 |
可提交上架 |
可下架 |
| 未上架 |
✓ |
✓ |
— |
| 待审核 |
✓（见 4.7：仍为待审核，不自动通过） |
— |
— |
| 出售中 |
✓ |
— |
✓ |
| 审核失败 |
✓ |
✓（重新提交） |
— |
| 已下架 |
✓ |
✓（重新提交） |
— |
- 商家 不可 将商品直接改为「出售中」；免审店铺亦须 提交上架 后进入出售中。
- 不可 将出售中/待审核/审核失败/已下架等状态 改回 未上架（无「撤回草稿」类操作）。
- 状态变更入口（定稿）： 仅 提交上架、平台审核（通过/驳回）、平台或商家下架；编辑保存 不得 直接修改商品状态字段。
| 补充 | 出售中状态下可编辑名称、价格、库存等资料，商品状态仍为出售中；是否影响已下单订单由订单模块规则约束（本期商品需求不展开）。 |
10.5 商家端列表（概要）
- 展示本店 全部 商品（含 未上架）：编号、名称、主图、售价、库存、销量、状态、操作（编辑、提交上架、下架等按状态显示）。
- 未上架 商品 仅在本列表出现，不进平台商品管理列表。
10.6 商品服务勾选（定稿 · v1.3.3）
与《商品服务管理功能需求》v1.0.1 衔接；平台 商品服务管理 维护全平台目录，本模块负责 勾选与快照。
10.6.1 商家发品 / 编辑
| 规则 |
说明 |
| 可选范围 |
平台全部 未逻辑删除 的服务项，按平台配置的 排序 展示 |
| 选择方式 |
多选；可不选（零项） |
| 默认勾选 |
「默认显示 = 是」的项进入表单时 默认勾选，商家可 取消 |
| 非默认项 |
「默认显示 = 否」的项 不默认勾选，可手动勾选 |
| 保存时机 |
保存商品（含未上架保存、各状态编辑保存）时，以当前勾选结果写入商品档案，并 生成/更新展示快照（P18） |
| 提交上架 |
不单独 重算服务快照；以 保存时 已写入的快照为准（若先勾选后未保存即提交，须先通过保存落库） |
10.6.2 平台改服务目录后的影响
| 平台操作 |
商品状态 |
商品已存快照 |
商家编辑页可选列表 |
| 编辑服务名称/简介/图标 |
不变 |
不变（P19） |
展示 最新 目录项供勾选 |
| 逻辑删除某服务项 |
不变 |
C 端 不展示 该快照（P20） |
不出现 已删项 |
| 商家再次保存商品 |
不变 |
按当前勾选 重写快照；已删项 自动剔除（P21） |
— |
10.6.3 平台商品详情
- 只读 展示该商品 展示快照 中的服务项（名称、图标；简介是否展示与列表一致）。
- 审核通过/驳回、下架 不因 服务目录变更而自动变化。
11. C 端可售条件（定稿）
用户 可下单 须同时满足：
| 序号 |
条件 |
| 1 |
商品状态 = 出售中 |
| 2 |
所属店铺 = 开业（停业则 禁止下单，店铺 v1.3.2） |
| 3 |
商品分类 是否显示 = 是（分类 v1.1；不显示时无分类入口，商品是否可从其他路径购买以前台为准） |
| 4 |
库存 ＞ 0（定稿：库存为 0 不可下单） |
用户加购 / 结算
→ 校验商品出售中、店铺开业、库存＞0 等
├── 店铺停业 → 拦截，提示店铺已停业
├── 库存为 0 → 拦截，提示库存不足（或同等文案）
└── 通过 → 允许下单（订单模块接续）
11.1 C 端 — 商品服务展示（定稿 · v1.3.3）
| 规则 |
说明 |
| 展示位置 |
商品详情等区域（具体 UI 以前台为准） |
| 展示内容 |
该商品 展示快照 中的服务项：至少 名称、图标；简介是否展示以前台为准 |
| 展示条件 |
商品 出售中 且满足第 11 节可购条件时，与商品一并展示；服务项不参与 下单校验 |
| 快照与目录 |
展示 快照 文案，不随 平台事后修改服务目录自动变更（P19） |
| 服务项已逻辑删除 |
不展示（P20），即使商品档案曾勾选 |
| 店铺停业 |
可浏览详情时是否展示服务以前台为准；禁止下单 规则不变 |
12. 与删店、删分类的衔接
12.1 删除店铺（店铺管理 v1.3.2）
平台删店前置：该店无 出售中、无 待审核 商品。
| 商品状态 |
平台/商家建议操作 |
| 出售中 |
先 下架 或平台下架 |
| 待审核 |
审核处理完毕（通过/驳回）或运营驳回 |
| 已下架、审核失败 |
不阻塞删店 |
12.2 删除分类（商品分类 v1.1）
- 二级分类下 存在未删除商品 时 不可删分类；须先改商品分类或处理商品。
13. 业务规则汇总
| 编号 |
规则 |
| P1 |
商品归属 一个店铺，关联 一个二级分类 |
| P2 |
商品编号 全平台唯一 |
| P3 |
状态五种：未上架、待审核、出售中、审核失败、已下架 |
| P12 |
未上架 仅商家端可见，不进 平台商品列表 |
| P13 |
商品编号 系统生成，商家不可改 |
| P14 |
待审核 期间商家编辑：仍为待审核，不自动通过 |
| P15 |
库存 为 0 时 C 端 禁止下单 |
| P4 |
提交上架后：店铺免审开 → 出售中，否则 → 待审核 |
| P5 |
仅 待审核 可平台审核；仅 出售中 可下架 |
| P6 |
平台/商家下架 → 已下架；可重新提交上架 |
| P7 |
批量审核、批量下架：含不符合状态则整批失败 |
| P8 |
商户/店铺状态变更 不自动 改商品状态 |
| P9 |
店铺 停业 时 C 端 禁止下单 |
| P10 |
审核不通过 须填写原因 |
| P11 |
平台列表以 商品 字段为准（非分类列表） |
| P16 |
首期单规格：一商品一价一库存；列表/详情不展示多规格 |
| P17 |
商品状态 仅 经提交上架、审核、下架流转；不可 改回未上架 |
| P18 |
保存商品时，对已勾选服务项保存 展示快照（名称、简介、图标） |
| P19 |
C 端、平台/商家商品详情展示服务时，以 快照 为准；平台改服务目录 不自动 更新已售商品展示 |
| P20 |
平台 逻辑删除 的服务项：C 端 不展示 对应快照 |
| P21 |
商家 再次保存 商品时，已逻辑删除的服务项从勾选与快照中 自动剔除 |
14. 与关联模块的协作流程
14.1 商家发品 → 平台审核 → C 端售卖
平台（可与开店并行）：商品服务管理 → 配置服务目录
↓
商家：维护分类 → 发布商品 → 保存为【未上架】→ 选二级分类 → 勾选商品服务（可选）→ 提交上架
↓
店铺免审关：待审核 ──平台审核──► 出售中 / 审核失败
店铺免审开：直接出售中
↓
C 端：出售中 + 店铺开业 + 库存等 → 可下单；详情展示服务 **快照**
14.2 店铺停业
平台：店铺编辑 → 停业（二次确认）
↓
商品：仍为出售中（不变）
↓
C 端：该店商品禁止下单
14.3 平台下架
平台：商品列表 → 下架出售中商品
↓
状态：已下架
↓
C 端：不可购买
14.4 商户/店铺前置（经营商品前）
商户管理：添加商户（仅主体资质）→ 正常
↓
商户管理：编辑 → 补全经营与结算信息
↓
店铺管理：添加店铺 → 选商户 + 配置店铺经营账号（登录名、密码）
↓
商品服务管理（可选，建议先发品前配置）：维护全平台服务目录
↓
商家端：以经营账号登录 → 切换当前店铺 → 商品分类 / 商品管理（勾选服务）
| 要点 |
对商品管理的影响 |
| 不考虑会员 |
商家登录仅用 店铺经营账号，无会员模块校验 |
| 开店前经营信息完整 |
无店则无法发品 |
| 同商户多店 |
同一登录名，商品按 当前店铺 隔离 |
15. 页面与交互要点（平台端）
| 场景 |
要求 |
| 列表 |
状态筛选；待审核突出；操作按状态显隐 |
| 批量审核/下架 |
不符合状态时整批失败并说明 |
| 审核不通过 |
原因必填 |
| 详情 |
展示分类路径、店铺、驳回原因、商品服务快照（只读） |
16. 草稿对照与修订说明
| 草稿条目 |
本文档处理 |
| 第 1 条（分类列表） |
误贴，以第 2 条商品列表为准（P11） |
| 商品列表、检索、状态、详情 |
结构化展开 |
| 审核、下架（批量/单独） |
补充状态前置、批量整批失败、驳回原因 |
| 商家上架、平台/商家下架 |
补充商家端规则与状态机 |
| 异常返回、技术栈 |
不纳入 |
| 未写：店铺审核开关、分类二级、停业下单、删店衔接 |
已与关联模块对齐 |
| v1.1 商品域 |
未上架、编号系统生成、待审核编辑、库存为 0 |
| v1.3 |
不考虑会员；店铺经营账号登录 |
| v1.3.1 |
首期单规格；商家 当前店铺 上下文；状态流转入口定稿（P16、P17）；出售中可编辑资料 |
| v1.3.2 |
同步取消单商户 3 店 上限表述 |
| v1.3.3 |
商品服务勾选、展示快照 P18～P21；§10.6、§11.1；关联《商品服务管理功能需求》v1.0.1 |
文档版本：v1.3.3（定稿）· 商品规则同 v1.1 · 关联《商户管理功能需求.md》v1.3.1、《店铺管理功能需求.md》v1.3.2、《商品分类功能需求.md》v1.3.1、《商品服务管理功能需求.md》v1.0.1、《订单管理功能需求.md》v1.0.1、《商品管理技术方案.md》v1.2、《商品管理测试用例.md》v1.0 · 草稿保持不变。
