# 商品审核 — 功能需求说明

> 本文档在《商品审核功能需求-草稿》基础上整理，并关联《农资商城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 在业务链中的位置

```text
商户管理 → 店铺管理（默认审核策略、营业状态）
    → 商品服务管理（服务目录）
    → 商品分类（商家 · 二级分类）
    → 商品管理（商家 · 发品/提交上架）
            ↓
    【本模块 · 平台】商品审核
            ├── 待审核 → 审核通过 → 出售中
            ├── 待审核 → 审核驳回 → 审核失败
            └── 出售中 → 下架 → 已下架
            ↓
    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。下图仅突出 **本模块操作点**。

```text
【商家】提交上架
    │
    ├── 店铺「默认审核通过」= 开启 ──►【出售中】（不进入待审核队列，本模块可检索但无需审核）
    │
    └── 店铺「默认审核通过」= 关闭 ──►【待审核】
                │
                ├── 本模块：审核通过 ──►【出售中】
                └── 本模块：审核驳回 ──►【审核失败】（须驳回原因）

【出售中】── 本模块/商家：下架 ──►【已下架】

【审核失败】【已下架】── 商家：修改后再次提交上架 ──►【待审核】或【出售中】（仍受店铺免审策略影响）

【待审核】期间商家编辑保存 ──► 仍为【待审核】，不自动通过（商品管理 P14）
```

| 本模块操作 | 前置状态 | 结果状态 | 执行方 |
|------------|----------|----------|--------|
| 审核通过 | 待审核 | 出售中 | 平台 |
| 审核驳回 | 待审核 | 审核失败 | 平台 |
| 下架 | 出售中 | 已下架 | 平台（本模块）；商家在商家端亦可下架 |

**不可执行：**

| 误操作 | 处理 |
|--------|------|
| 对非待审核执行审核 | **阻断**并提示 |
| 对非出售中执行下架 | **阻断**并提示（待审核应走驳回） |

---

## 4. 功能结构

```text
商品审核（平台）
├── 商品列表（含状态 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 审核流程

```text
运营进入列表（建议默认「待审核」）
    → 查看详情（可选）
    → 选择一条或多条「待审核」
    → 点击「审核通过」或「审核驳回」
        ├── 校验状态
        │     └── 含非法状态 → 整批失败，不变更任何一条
        └── 通过
              ├── 通过 → 全部变「出售中」
              └── 驳回 → 填写原因 → 全部变「审核失败」
```

### 8.6 待审核期间商家编辑（定稿 · 商品管理 P14）

| 规则 | 说明 |
|------|------|
| 商家修改商品资料 | **允许** |
| 保存后状态 | 仍为 **待审核**，**不自动** 变为出售中 |
| 对本模块 | 运营仍按 **待审核** 处理；以 **最新** 详情内容为准判审 |

---

## 9. 下架商品

> 对齐草稿第 4 条（2）。

### 9.1 方式

| 方式 | 说明 |
|------|------|
| 单独下架 | 列表行或详情 |
| 批量下架 | 勾选多条 **出售中** |

### 9.2 规则

| 规则 | 说明 |
|------|------|
| 前置状态 | 仅 **出售中** |
| 结果状态 | **已下架** |
| 批量含非法状态 | **整批失败**；提示「所选商品含不可下架状态」 |
| 确认 | 建议二次确认：「下架后 C 端不可购买」 |
| 与审核关系 | **待审核** 应 **驳回**，不可直接下架 |

### 9.3 下架后

| 项 | 说明 |
|----|------|
| 商家 | 可编辑后 **重新提交上架**（商品管理 §4.6） |
| 已有订单 | **不自动** 关闭（订单模块规则） |
| 店铺停业 | 店铺停业本身已禁止 C 端下单；下架为商品级操作，**独立** |

### 9.4 下架流程

```text
选择「出售中」商品 → 下架
    → 校验状态
    ├── 含非出售中 → 整批失败
    └── 通过 → 二次确认 → 已下架
```

---

## 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》保持不变。*
