# 农资商城 Web — 文档索引

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

---

## 0. 目录结构

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

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

---

## 1. 模块文档一览

### 1.1 组织管理

| 模块 | 功能需求 | 技术方案 | 测试用例 | 说明 |
|------|----------|----------|----------|------|
| 商户管理 | [v1.4](组织管理/商户管理/商户管理功能需求.md) | [v1.4](组织管理/商户管理/商户管理技术方案.md) | [v1.2](组织管理/商户管理/商户管理测试用例.md) | 平台端 |
| 店铺管理 | [v1.3.4](组织管理/店铺管理/店铺管理功能需求.md) | [v1.2.3](组织管理/店铺管理/店铺管理技术方案.md) | [v1.0](组织管理/店铺管理/店铺管理测试用例.md) | 平台 + 商家端店资料 |
| 店铺设置 | [v1.1](组织管理/店铺设置/店铺设置功能需求.md) | [v1.1.1](组织管理/店铺设置/店铺设置技术方案.md) | [v1.1](组织管理/店铺设置/店铺设置测试用例.md) | 全平台全局策略 |
| 入驻审核 | [v1.0.2](组织管理/入驻审核/商户入驻审核功能需求.md) | [v1.0.2](组织管理/入驻审核/商户入驻审核技术方案.md) | [v1.0.2](组织管理/入驻审核/商户入驻审核测试用例.md) | C 端入驻 + 平台审核 |

### 1.2 商品管理

| 模块 | 功能需求 | 技术方案 | 测试用例 | 说明 |
|------|----------|----------|----------|------|
| 商品管理 | [v1.3.3](商品管理/商品管理功能需求.md) | [v1.2](商品管理/商品管理技术方案.md) | [v1.0](商品管理/商品管理测试用例.md) | 平台 + 商家端；P18～P21 |
| 商品分类 | [v1.3.1](商品管理/商品分类/商品分类功能需求.md) | [v1.1](商品管理/商品分类/商品分类技术方案.md) | [v1.0](商品管理/商品分类/商品分类测试用例.md) | **商家端** |
| 商品服务 | [v1.0.1](商品管理/商品服务/商品服务管理功能需求.md) | [v1.0.1](商品管理/商品服务/商品服务管理技术方案.md) | [v1.0](商品管理/商品服务/商品服务管理测试用例.md) | **平台端**；`biz_goods_service` |
| 商品审核 | [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) | 注册/登录协议 |
| 首页 Banner | [v1.0.1](内容管理/首页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) | `biz_member` |
| 订单管理 | [v1.0.1](订单管理/订单管理功能需求.md) | [v1.0](订单管理/订单管理技术方案.md) | [v1.0](订单管理/订单管理测试用例.md) | `biz_order` |

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

---

## 2. 跨模块定稿要点

| 要点 | 规则编号（示例） |
|------|------------------|
| 商家链不考虑会员（经营账号≠会员） | 商户/店铺/商品/分类 v1.3 |
| C 端买家会员（用户链） | [会员管理功能需求](会员管理/会员管理功能需求.md) v1.0.1 |
| 单商户 **不设** 开店数量上限 | 商户 R1 v1.3.1；店铺 S2 |
| 开店可选商户：正常 + 经营信息完整 | 商户 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.1；删店/会员消费 |

---

## 3. 接口路径速查

| 端 | 模块 | 基路径 |
|----|------|--------|
| 平台 | 商户 | `/agri/merchant` |
| 平台 | 店铺 | `/agri/shop` |
| 平台 | 店铺设置（全局） | `/agri/shopSetting` |
| 平台 | 商品 | `/agri/goods` |
| 平台 | 商品服务 | `/agri/goodsService` |
| 平台 | 入驻审核 | `/agri/entry` |
| 商家 | 分类 | `/agri/seller/category` |
| 商家 | 商品 | `/agri/seller/goods` |
| 商家 | 店铺资料 | `/agri/seller/shop` |

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

---

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

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

---

## 5. 修订记录

| 日期 | 说明 |
|------|------|
| 2026-05 | **v3.0** 目录重组：`组织管理/`、`商品管理/`子模块、`内容管理/`；修正 `商品管理/商品审核/` 文档归属 |
| 2026-05 | v2.4 及以前：扁平模块路径、经营账号表名统一等（见历史条目） |

---

*索引版本：v3.0*