# 农资商城 Web — 文档索引

> 统一版本对照表（2026-05 对齐）。实现与测试以各模块 **功能需求（定稿）** + **技术方案** 为准；测试用例 **依据** 字段须与下表一致。  
> **v3.0：** 文档按 **组织管理 / 商品管理 / 内容管理** 分组目录；旧版扁平路径（如 `商户管理/`）已废止。

---

## 0. 目录结构

```text
doc/农资商城web/
├── 文档索引.md
├── 关联需求分析.md
├── 组织管理/
│   ├── 商户管理/
│   ├── 店铺管理/
│   ├── 店铺设置/
│   └── 入驻审核/
├── 商品管理/
│   ├── 商品管理功能需求.md          # 主模块（根目录）
│   ├── 商品管理技术方案.md
│   ├── 商品管理测试用例.md
│   ├── 商品分类/
│   ├── 商品服务/
│   └── 商品审核/
├── 内容管理/
│   ├── 商城入驻协议/
│   ├── 商城服务协议/
│   └── 首页banner设置/
├── 会员管理/
└── 订单管理/
```

草稿（各模块 `*-草稿.md`）仅作历史参考，**不以草稿为准**（会员/订单功能需求 v1.0 定稿除外）。

---

## 1. 模块文档一览

### 1.1 组织管理

| 模块 | 功能需求 | 技术方案 | 前端技术方案 | 测试用例 | 说明 |
|------|----------|----------|--------------|----------|------|
| 商户管理 | [v1.5](组织管理/商户管理/商户管理功能需求.md) | [v1.5](组织管理/商户管理/商户管理技术方案.md) | [v1.0](组织管理/商户管理/商户管理前端技术方案.md) | [v1.2](组织管理/商户管理/商户管理测试用例.md) | 平台端；C 端入驻见入驻审核 |
| 店铺管理 | [v1.3.5](组织管理/店铺管理/店铺管理功能需求.md) | [v1.2.6](组织管理/店铺管理/店铺管理技术方案.md) | [v1.1](组织管理/店铺管理/店铺管理前端技术方案.md) | [v1.1](组织管理/店铺管理/店铺管理测试用例.md) | 平台 + 商家端店资料 |
| 店铺设置 | [v1.1](组织管理/店铺设置/店铺设置功能需求.md) | [v1.1.1](组织管理/店铺设置/店铺设置技术方案.md) | [v1.0](组织管理/店铺设置/店铺设置前端技术方案.md) | [v1.1](组织管理/店铺设置/店铺设置测试用例.md) | 全平台全局策略 |
| 入驻审核 | [v1.1](组织管理/入驻审核/商户入驻审核功能需求.md) | [v1.1](组织管理/入驻审核/商户入驻审核技术方案.md) | [v1.0](组织管理/入驻审核/商户入驻审核前端技术方案.md) | [v1.1](组织管理/入驻审核/商户入驻审核测试用例.md) | C 端完整填报 + 审核→公示→入驻 |

### 1.2 商品管理

| 模块 | 功能需求 | 技术方案 | 前端技术方案 | 测试用例 | 说明 |
|------|----------|----------|--------------|----------|------|
| 商品管理 | [v1.3.3](商品管理/商品管理功能需求.md) | [v1.3](商品管理/商品管理技术方案.md) | — | [v1.0](商品管理/商品管理测试用例.md) | 平台 + 商家端；P18～P21 |
| 商品分类 | [v1.4](商品管理/商品分类/商品分类功能需求.md) | [v1.2](商品管理/商品分类/商品分类技术方案.md) | [v1.0](商品管理/商品分类/商品分类前端技术方案.md) | [v1.0](商品管理/商品分类/商品分类测试用例.md) | **平台 + 商家** |
| 商品服务 | [v1.0.1](商品管理/商品服务/商品服务管理功能需求.md) | [v1.0.1](商品管理/商品服务/商品服务管理技术方案.md) | [v1.0](商品管理/商品服务/商品服务管理前端技术方案.md) | [v1.0](商品管理/商品服务/商品服务管理测试用例.md) | **平台端**；`biz_goods_service` |
| 商品审核 | [v1.0](商品管理/商品审核/商品审核功能需求.md) | [v1.0](商品管理/商品审核/商品审核技术方案.md) | [v1.0](商品管理/商品审核/商品审核前端技术方案.md) | [v1.0](商品管理/商品审核/商品审核测试用例.md) | 平台审核/下架专册 |

### 1.3 内容管理

| 模块 | 功能需求 | 技术方案 | 前端技术方案 | 测试用例 | 说明 |
|------|----------|----------|--------------|----------|------|
| 商城入驻协议 | [v1.0](内容管理/商城入驻协议/商城入驻协议功能需求.md) | [v1.0](内容管理/商城入驻协议/商城入驻协议技术方案.md) | [v1.0](内容管理/商城入驻协议/商城入驻协议前端技术方案.md) | [v1.0](内容管理/商城入驻协议/商城入驻协议测试用例.md) | 入驻勾选协议 |
| 商城服务协议 | [v1.0](内容管理/商城服务协议/商城服务协议功能需求.md) | [v1.0](内容管理/商城服务协议/商城服务协议技术方案.md) | [v1.0](内容管理/商城服务协议/商城服务协议前端技术方案.md) | [v1.0](内容管理/商城服务协议/商城服务协议测试用例.md) | 注册/登录协议 |
| 首页 Banner | [v1.0.1](内容管理/首页banner设置/首页banner设置功能需求.md) | [v1.0](内容管理/首页banner设置/首页banner设置技术方案.md) | [v1.0](内容管理/首页banner设置/首页banner设置前端技术方案.md) | [v1.0](内容管理/首页banner设置/首页banner设置测试用例.md) | C 端 Banner |

### 1.4 用户与交易

| 模块 | 功能需求 | 技术方案 | 前端技术方案 | 测试用例 | 说明 |
|------|----------|----------|--------------|----------|------|
| 会员管理 | [v1.0.1](会员管理/会员管理功能需求.md) | [v1.0.1](会员管理/会员管理技术方案.md) | [v1.0](会员管理/会员管理前端技术方案.md) | [v1.0](会员管理/会员管理测试用例.md) | `biz_member` |
| 订单管理 | [v1.0.1](订单管理/订单管理功能需求.md) | [v1.0.2](订单管理/订单管理技术方案.md) | — | [v1.0](订单管理/订单管理测试用例.md) | [`sql/biz_order.sql`](../../sql/biz_order.sql)；代码 `com.ruoyi.web.modules.order`（**待实现**） |

**跨模块（仅功能、无库表/接口）：** [关联需求分析.md](关联需求分析.md) v1.5

### 1.5 商家端（店铺后台）

| 模块 | 功能需求 | 技术方案 | 测试用例 | 说明 |
|------|----------|----------|----------|------|
| 店铺设置 | [v1.0](../店铺后台/店铺设置/店铺设置功能需求.md) | [v1.1](../店铺后台/店铺设置/店铺设置技术方案.md) | [v1.1](../店铺后台/店铺设置/店铺设置测试用例.md) | 当前店资料 + 员工概览；**非** 平台全局策略 |
| 全部订单 | [v1.0](../店铺后台/订单管理/全部订单/全部订单功能需求.md) | [v1.0.2](../店铺后台/订单管理/全部订单/全部订单技术方案.md) | [v1.0](../店铺后台/订单管理/全部订单/全部订单测试用例.md) | 本店订单履约；同源 [`biz_order`](../../sql/biz_order.sql)；代码 **待实现** |
| 员工管理 | [v1.2](../店铺后台/账号管理/员工管理/员工管理功能需求.md) | [v1.2](../店铺后台/账号管理/员工管理/员工管理技术方案.md) | [v1.2](../店铺后台/账号管理/员工管理/员工管理测试用例.md) | 员工 CRUD；配额与店铺设置概览同源 |

---

## 2. 跨模块定稿要点

| 要点 | 规则编号（示例） |
|------|------------------|
| 商家链不考虑会员（经营账号≠会员） | 商户/店铺/商品/分类 v1.3 |
| C 端买家会员（用户链） | [会员管理功能需求](会员管理/会员管理功能需求.md) v1.0.1 |
| 单商户 **不设** 开店数量上限 | 商户 R1 v1.3.1；店铺 S2 |
| C 端入驻：完整字段 + 审核→公示→建档 | [入驻审核](组织管理/入驻审核/商户入驻审核功能需求.md) v1.1 |
| 平台添加商户：免审；须绑管理员/会员；主体字段精简 | [商户管理](组织管理/商户管理/商户管理功能需求.md) v1.5 §6 |
| 开店可选商户：正常 + 经营信息完整 | 商户 R6；店铺 S1 |
| 商户经营账号 `biz_merchant_account`；同商户多店同登录名 | 店铺 S4/S5 |
| 店铺策略（免审、子管理员）**全平台全局** | [店铺设置](组织管理/店铺设置/店铺设置功能需求.md) v1.1 |
| 分类仅两级；商品仅挂二级 | 分类 C1/C5；商品 P1 |
| 商品五态；未上架不进平台审核列表 | 商品 P3；[商品审核](商品管理/商品审核/商品审核功能需求.md) GR1 |
| 状态仅 submit / audit / offShelf | 商品 P17 |
| 批量审核/下架/删类：**整批失败** | 商品 P7；分类 G9 |
| 删店：无出售中、待审核商品 | 店铺 11.2 |
| 商品服务全平台一份；商家只勾选 | 商品服务 GS1/GS2 |
| 订单 O8/O10/O11 | 订单技术方案 v1.0.2；删店/会员消费；`com.ruoyi.web.modules.order` **待实现** |

---

## 3. 接口路径速查

| 端 | 模块 | 基路径 |
|----|------|--------|
| 平台 | 商户 | `/agri/merchant` |
| 平台 | 店铺 | `/agri/shop` |
| 平台 | 店铺设置（全局） | `/agri/shopSetting` |
| 平台 | 商品 | `/agri/goods` |
| 平台 | 商品服务 | `/agri/goodsService` |
| 平台 | 入驻审核 | `/agri/merchantEntryApply` |
| 平台 | 订单 | `/agri/order` |
| 商家 | 分类 | `/agri/seller/category` |
| 商家 | 商品 | `/agri/seller/goods` |
| 商家 | 店铺资料 | `/agri/seller/shop`（含 `GET /employeeStats`） |
| 商家 | 全部订单 | `/agri/seller/order` |
| 商家 | 员工管理 | `/agri/seller/employee` |

商家端须 **当前店铺** 上下文（`X-Shop-Id` 或 Session）。

---

## 4. 业务链（文档协作顺序）

```text
【组织】商户 → 店铺（+经营账号）→ 店铺设置（全局）
【入驻】内容管理·入驻协议 → 入驻审核（审核→公示→首店）→ 商户/店铺
【供给链】商品服务 → 商品分类 → 商品管理 → 商品审核 → C 端
【用户链】会员注册 → 下单 → 订单管理
【内容】Banner / 服务协议 / 入驻协议（与交易链弱耦合）
```

---

## 5. 修订记录

| 日期 | 说明 |
|------|------|
| 2026-05 | **v3.0** 目录重组：`组织管理/`、`商品管理/`子模块、`内容管理/`；修正 `商品管理/商品审核/` 文档归属 |
| 2026-05 | 内容管理三模块补充 **前端技术方案**（ruoyi-ui 页面路径、API、菜单权限） |
| 2026-05 | 组织管理四模块补充 **前端技术方案**（商户/店铺/店铺设置/入驻审核） |
| 2026-05 | 商品管理三子模块补充 **前端技术方案**（分类/服务/审核） |
| 2026-05 | 会员管理补充 **前端技术方案**（列表/详情/订单只读） |
| 2026-05 | **v3.4** 订单后端落位定稿 `com.ruoyi.web.modules.order`（**暂不实现**）；平台/商家订单技术方案 v1.0.2 |
| 2026-05 | **v3.3** 订单 DDL `sql/biz_order.sql`（全字段 COMMENT）；平台订单技术方案 v1.0.1；商家《全部订单技术方案》v1.0.1 |
| 2026-05 | **v3.2** 商家端《店铺设置》v1.1 后端已实现；店铺管理技术方案 v1.2.6 同步 employeeStats |
| 2026-05 | **v3.1** 商户 v1.5、入驻审核 v1.1（公示流程）；入驻 API 路径 `/agri/merchantEntryApply` |

---

*索引版本：v3.4*
