商品审核 — 功能需求说明
本文档在《商品审核功能需求-草稿》基础上整理，并关联《农资商城web》目录下 商品管理功能需求》v1.3.3、店铺管理功能需求》v1.3.2、商户管理功能需求》v1.4、商品分类功能需求》v1.3.1、商品服务管理功能需求》v1.0.1、订单管理功能需求》v1.0.1、《关联需求分析.md》v1.2 做边界与流程对齐。
范围：平台管理端 对全平台商品的 列表监管、高级检索、查看详情、审核上架申请、执行下架；商家发品与字段维护规则 引用 商品管理，本文不重复展开表单细节。
说明： 商品 状态枚举、状态机、C 端可售条件 与《商品管理功能需求》一致；本模块为平台 审核/下架 能力的专册（可独立菜单「商品审核」，或与「商品管理」同一入口实现）。
v1.0： 列表/检索/详情；单独与批量审核；单独与批量下架；驳回原因必填；批量含非法状态整批失败。
1. 模块定位
1.1 业务目标
在农资商城 平台管理端（Web） 为运营/审核人员提供 商品监管工作台，使：
- 集中查看已进入上架流程的商品（不含 商家端「未上架」草稿）；
- 按编号、名称、分类、店铺等 检索 待处理与在架商品；
- 对 待审核 商品 通过或驳回（单独/批量）；
- 对 出售中 商品执行 下架（单独/批量）；
- 任意状态 均可 查看详情 以辅助判审与客诉处理。
不包含（本模块菜单内）： 商家端发品/编辑表单、商品分类维护、商品服务目录维护、订单发货、会员操作。
1.2 与《商品管理》的关系（定稿）
| 维度 |
商品审核（本模块） |
商品管理 v1.3.3 |
| 定位 |
平台 审核 + 下架 + 监管列表 专册 |
全生命周期（含商家端、C 端规则） |
| 数据 |
同一商品 对象与状态机 |
同源 |
| 状态规则 |
引用 商品管理第 4 节，不另立状态 |
权威定义 |
| 产品形态 |
可 独立菜单「商品审核」；亦可与商品管理 合一菜单 |
商家端仅在商品管理（商家） |
定稿： 实现层只允许 一套 商品状态流转逻辑；本模块与商品管理 不得 出现冲突规则。
1.3 在业务链中的位置
商户管理 → 店铺管理（默认审核策略、营业状态）
→ 商品服务管理（服务目录）
→ 商品分类（商家 · 二级分类）
→ 商品管理（商家 · 发品/提交上架）
↓
【本模块 · 平台】商品审核
├── 待审核 → 审核通过 → 出售中
├── 待审核 → 审核驳回 → 审核失败
└── 出售中 → 下架 → 已下架
↓
C 端可购（须出售中 + 库存等 + 店铺开业等）
↓
订单管理（下单扣库存）
| 关联模块 |
关系 |
边界说明 |
| 商品管理 v1.3.3 |
同源 |
状态机、商家提交上架、待审核编辑规则 以商品管理为准 |
| 店铺管理 v1.3.2 |
上游策略 |
「商品是否默认审核通过」决定新提交是否进入 待审核 队列 |
| 商户管理 v1.4 |
间接 |
商户冻结/注销 不自动 改商品状态 |
| 商品分类 v1.3.1 |
检索 |
按 二级分类 筛选；平台 不维护 分类 |
| 商品服务管理 v1.0.1 |
详情只读 |
详情展示 服务快照；改目录 不自动 改商品状态 |
| 订单管理 v1.0.1 |
下游 |
审核/下架 不自动 关闭已有订单 |
| 会员管理 v1.0.1 |
无 |
买家会员与审核 无耦合 |
1.4 与《关联需求分析》的对应
| 关联分析要点 |
本模块 |
| 供给链：平台监管商品 |
本模块即 平台审核/下架 环节的产品表述 |
| 店铺默认审核策略 |
决定 待审核队列 是否有新条目（免审店直达出售中） |
| 状态不级联 |
商户/店铺/服务目录变更 不自动 批量改商品审核结果 |
| 删店前置 |
无 出售中、待审核 商品（见 §11） |
1.5 使用端与角色
| 端 |
角色 |
能力 |
| 平台管理端 |
平台管理员（及被授予商品审核权限的角色） |
列表、检索、详情、审核、下架 |
| 店铺经营管理端 |
商家 |
不使用 本模块；在商家端商品管理提交上架、查看驳回原因 |
| C 端 |
买家/访客 |
不参与 审核；仅消费 出售中 等可售结果 |
2. 业务概念
| 概念 |
说明 |
| 商品审核 |
平台对商家 提交上架 后处于 待审核 的商品进行 通过/驳回 的操作 |
| 待审核 |
商家已提交、等待平台处理；仅本状态 可执行审核 |
| 审核通过 |
待审核 → 出售中（C 端在满足其他条件时可售） |
| 审核不通过（驳回） |
待审核 → 审核失败；须填写 驳回原因 供商家查看 |
| 下架 |
出售中 → 已下架；平台或商家均可发起（本模块含 平台下架） |
| 默认审核通过 |
店铺设置（店铺管理）；开启 时商家提交后 跳过待审核 直接出售中 |
| 商品编号 |
系统生成、全平台唯一；列表与检索主键之一 |
2.1 平台列表可见范围（定稿）
| 商品状态 |
是否出现在本模块列表 |
| 未上架 |
否（仅商家端可见） |
| 待审核 |
是 |
| 出售中 |
是 |
| 审核失败 |
是 |
| 已下架 |
是 |
3. 商品状态与流转（引用定稿）
完整状态机见《商品管理功能需求》§4。下图仅突出 本模块操作点。
【商家】提交上架
│
├── 店铺「默认审核通过」= 开启 ──►【出售中】（不进入待审核队列，本模块可检索但无需审核）
│
└── 店铺「默认审核通过」= 关闭 ──►【待审核】
│
├── 本模块：审核通过 ──►【出售中】
└── 本模块：审核驳回 ──►【审核失败】（须驳回原因）
【出售中】── 本模块/商家：下架 ──►【已下架】
【审核失败】【已下架】── 商家：修改后再次提交上架 ──►【待审核】或【出售中】（仍受店铺免审策略影响）
【待审核】期间商家编辑保存 ──► 仍为【待审核】，不自动通过（商品管理 P14）
| 本模块操作 |
前置状态 |
结果状态 |
执行方 |
| 审核通过 |
待审核 |
出售中 |
平台 |
| 审核驳回 |
待审核 |
审核失败 |
平台 |
| 下架 |
出售中 |
已下架 |
平台（本模块）；商家在商家端亦可下架 |
不可执行：
| 误操作 |
处理 |
| 对非待审核执行审核 |
阻断并提示 |
| 对非出售中执行下架 |
阻断并提示（待审核应走驳回） |
4. 功能结构
商品审核（平台）
├── 商品列表（含状态 Tab/筛选）
├── 高级检索
├── 查看详情（全状态）
├── 审核商品（单独 / 批量）
└── 下架商品（单独 / 批量）
建议默认进入或提供快捷 Tab：待审核，便于审核人员工作台场景。
5. 商品列表
5.1 列表字段（定稿 · 对齐草稿第 1 条）
| 字段 |
说明 |
| 店铺名称 |
所属店铺 |
| 商品编号 |
全平台唯一 |
| 商品主图 |
缩略图 |
| 商品名称 |
— |
| 售价 |
首期 单规格 销售价 |
| 销量 |
累计销量 |
| 商品状态 |
待审核 / 出售中 / 审核失败 / 已下架 |
| 操作 |
见 §5.3 |
建议扩展列（非草稿必列）： 库存、商品分类（一级 > 二级）、提交上架时间。
5.2 列表行为
| 规则 |
说明 |
| 分页 |
支持 |
| 默认排序 |
建议 待审核 按提交上架时间 升序（先报先审）；其他状态按更新时间 降序（可配置） |
| 数据范围 |
未逻辑删除店铺下的商品；不展示未上架 |
| 免审直达出售中 |
仍可在列表中检索，无 待审核操作按钮 |
5.3 行操作（按状态）
| 商品状态 |
可用操作 |
| 待审核 |
查看详情、审核（通过/驳回） |
| 出售中 |
查看详情、下架 |
| 审核失败 |
查看详情 |
| 已下架 |
查看详情 |
支持 多选 以触发批量审核（待审核）或批量下架（出售中）。
6. 高级检索
对齐草稿第 2 条；与商品管理平台检索 规则一致。
| 检索项 |
规则 |
| 商品编号 |
精确或模糊（与平台统一） |
| 商品名称 |
模糊匹配 |
| 商品分类 |
选择 二级分类 或展示「一级 > 二级」路径 |
| 店铺名称 |
模糊匹配 |
| 商品状态 |
待审核 / 出售中 / 已下架 / 审核失败（不含未上架） |
| 行为 |
说明 |
| 查询 |
条件 与 组合；结果分页 |
| 重置 |
清空条件并恢复默认列表 |
7. 查看详情
对齐草稿：全部商品均可查看详情。
7.1 展示内容
| 类别 |
内容 |
| 基础信息 |
编号、名称、主图/详情图、售价、库存、销量等 |
| 归属 |
店铺名称、商户名称、商品分类（一级 > 二级） |
| 服务快照 |
发品时勾选的服务项 快照（只读，与商品服务管理目录变更解耦） |
| 状态信息 |
当前状态；待审核/审核失败 展示提交时间、审核时间（若有）、驳回原因 |
| 操作区 |
与列表行操作 一致（待审核可审、出售中可下架） |
7.2 边界
- 详情 不提供 商家端式全字段编辑（属商家端商品管理）。
- 详情 不修改 商品服务目录主数据。
8. 审核商品
对齐草稿第 4 条（1）；核心能力。
8.1 方式
| 方式 |
说明 |
| 单独审核 |
列表行或详情页 |
| 批量审核 |
勾选多条，统一 通过 或 不通过 |
8.2 前置与校验
| 校验 |
失败提示（示例） |
| 所选含非 待审核 |
所选商品含非待审核状态，请重新选择（整批失败） |
| 驳回未填原因 |
请填写驳回原因 |
| 未勾选任何行 |
请选择要审核的商品 |
8.3 审核通过
| 项 |
说明 |
| 状态变更 |
待审核 → 出售中 |
| 驳回原因 |
不适用 |
| C 端 |
还须店铺 开业、库存＞0 等（商品管理 §11）方可下单 |
| 记录 |
记录审核人、审核时间（实现层，需求层要求 可审计） |
8.4 审核驳回
| 项 |
说明 |
| 状态变更 |
待审核 → 审核失败 |
| 驳回原因 |
必填；商家端可见，便于修改后重提 |
| 批量驳回 |
定稿： 批量不通过共用 一条 驳回原因 |
8.5 审核流程
运营进入列表（建议默认「待审核」）
→ 查看详情（可选）
→ 选择一条或多条「待审核」
→ 点击「审核通过」或「审核驳回」
├── 校验状态
│ └── 含非法状态 → 整批失败，不变更任何一条
└── 通过
├── 通过 → 全部变「出售中」
└── 驳回 → 填写原因 → 全部变「审核失败」
8.6 待审核期间商家编辑（定稿 · 商品管理 P14）
| 规则 |
说明 |
| 商家修改商品资料 |
允许 |
| 保存后状态 |
仍为 待审核，不自动 变为出售中 |
| 对本模块 |
运营仍按 待审核 处理；以 最新 详情内容为准判审 |
9. 下架商品
对齐草稿第 4 条（2）。
9.1 方式
| 方式 |
说明 |
| 单独下架 |
列表行或详情 |
| 批量下架 |
勾选多条 出售中 |
9.2 规则
| 规则 |
说明 |
| 前置状态 |
仅 出售中 |
| 结果状态 |
已下架 |
| 批量含非法状态 |
整批失败；提示「所选商品含不可下架状态」 |
| 确认 |
建议二次确认：「下架后 C 端不可购买」 |
| 与审核关系 |
待审核 应 驳回，不可直接下架 |
9.3 下架后
| 项 |
说明 |
| 商家 |
可编辑后 重新提交上架（商品管理 §4.6） |
| 已有订单 |
不自动 关闭（订单模块规则） |
| 店铺停业 |
店铺停业本身已禁止 C 端下单；下架为商品级操作，独立 |
9.4 下架流程
选择「出售中」商品 → 下架
→ 校验状态
├── 含非出售中 → 整批失败
└── 通过 → 二次确认 → 已下架
10. 店铺「默认审核通过」协作
| 店铺设置（店铺管理 §10.3） |
商家提交上架后 |
本模块 |
| 关闭（默认） |
待审核 |
进入待审核队列，须审核 |
| 开启 |
直接 出售中 |
一般 无 待审核项；列表仍可查出售中并下架 |
| 规则 |
说明 |
| 修改店铺开关 |
不追溯 已上架商品状态；仅 此后新提交 生效 |
| 免审店新商品 |
运营仍可通过本模块 下架 监管 |
11. 与关联模块的协作
11.1 商户 / 店铺状态
| 事件 |
商品状态 |
本模块 |
| 商户冻结/注销 |
不变 |
仍可检索；按状态操作 |
| 店铺停业 |
不变 |
仍可检索；C 端该店不可下单（店铺管理） |
| 店铺删除 |
见下 |
删店前须处理待审/出售中 |
11.2 删店前置（店铺管理 · 定稿）
| 条件 |
说明 |
| 阻塞删店 |
存在 出售中 或 待审核 商品 |
| 不阻塞 |
已下架、审核失败 可不挡删店 |
| 对本模块 |
运营须先 驳回/通过 待审核，或 下架 出售中商品 |
11.3 商品服务 / 分类
| 事件 |
对本模块 |
| 平台改服务目录文案 |
商品状态 不变；详情仍显示 快照 |
| 商家改分类名称 |
检索展示新名称；不改变 审核状态 |
11.4 订单与会员
| 项 |
定稿 |
| 审核通过 |
不自动 创建订单 |
| 下架 |
不自动 取消进行中订单 |
| 会员禁用 |
不影响 平台审核操作 |
12. 业务规则汇总
| 编号 |
规则 |
| GR1 |
平台列表 不展示 未上架商品 |
| GR2 |
仅待审核 可执行审核（通过/驳回） |
| GR3 |
仅出售中 可执行下架（平台） |
| GR4 |
审核驳回 须填写 驳回原因；批量驳回 共用一条 原因 |
| GR5 |
批量审核/下架：含不符合状态 → 整批失败，不变更任一条 |
| GR6 |
审核通过：待审核 → 出售中；驳回：待审核 → 审核失败 |
| GR7 |
下架：出售中 → 已下架 |
| GR8 |
任意 列表内状态均可查看详情 |
| GR9 |
详情页与列表 操作能力一致 |
| GR10 |
待审核期间商家编辑：仍为待审核，不自动通过 |
| GR11 |
店铺「默认审核通过」= 开启时，新提交 不进 待审核队列 |
| GR12 |
状态 仅 经提交上架、审核、下架流转（与商品管理 P17 一致） |
| GR13 |
商户/店铺/服务目录变更 不自动 改商品审核状态 |
| GR14 |
删店前须无 出售中、待审核 商品 |
| GR15 |
本模块规则与《商品管理》状态机 不得冲突 |
13. 页面与交互要点
| 场景 |
要求 |
| 待审核 Tab |
建议突出数量角标（待审条数） |
| 批量操作栏 |
勾选后显示「批量通过」「批量驳回」「批量下架」（按状态启用） |
| 驳回弹窗 |
原因必填、字数上限（如 200 字，以原型为准） |
| 下架确认 |
二次确认文案明确 C 端不可购 |
| 权限 |
无审核权限的角色 不可 执行通过/驳回/下架 |
| 空态 |
待审核为空时提示「暂无待审核商品」 |
14. 非本期范围
| 项 |
说明 |
| 商家端发品/编辑完整表单 |
商品管理（商家） |
| 平台代商家创建商品 |
非草稿 |
| 审核工作流（多级审批、派单） |
— |
| 审核时效 SLA、自动通过超时 |
— |
| 修改商品售价/库存（平台代改） |
单独立项或归商品管理 |
| 未上架商品平台可见 |
否 |
| 会员价、多规格 SKU |
商品管理非本期 |
15. 草稿对照与修订说明
| 草稿条目 |
本文档处理 |
| 列表字段 |
§5.1（补状态列；库存等为建议列） |
| 高级检索四项 |
§6 |
| 商品状态四种 |
§2.1、§3（不含未上架） |
| 查看详情 |
§7 |
| 批量/单独审核 |
§8 |
| 批量/单独下架 |
§9 |
| 异常返回 code/msg/data |
不纳入 |
| 技术栈 RuoYi/MySQL |
不纳入 |
| 未写：店铺免审、待审核编辑、删店 |
§3、§8.6、§11 |
| 未写：与商品管理边界 |
§1.2 |
16. 修订记录
| 版本 |
说明 |
| v1.0 |
首版定稿：平台列表/检索/详情/审核/下架；对齐商品管理状态机；关联店铺审核策略与供给链 |
文档版本：v1.0（定稿）· 关联《商品管理功能需求.md》v1.3.3、《店铺管理功能需求.md》v1.3.2、《商户管理功能需求.md》v1.4、《商品分类功能需求.md》v1.3.1、《商品服务管理功能需求.md》v1.0.1、《订单管理功能需求.md》v1.0.1、《关联需求分析.md》v1.2 · 草稿《商品审核功能需求-草稿.md》保持不变。
