农资商城 Web — 文档索引
统一版本对照表(2026-05 对齐)。实现与测试以各模块 功能需求(定稿) + 技术方案 为准;测试用例 依据 字段须与下表一致。
v3.0: 文档按 组织管理 / 商品管理 / 内容管理 分组目录;旧版扁平路径(如 商户管理/)已废止。
0. 目录结构
doc/农资商城web/
├── 文档索引.md
├── 关联需求分析.md
├── 组织管理/
│ ├── 商户管理/
│ ├── 店铺管理/
│ ├── 店铺设置/
│ └── 入驻审核/
├── 商品管理/
│ ├── 商品管理功能需求.md # 主模块(根目录)
│ ├── 商品管理技术方案.md
│ ├── 商品管理测试用例.md
│ ├── 商品分类/
│ ├── 商品服务/
│ └── 商品审核/
├── 内容管理/
│ ├── 商城入驻协议/
│ ├── 商城服务协议/
│ └── 首页banner设置/
├── 会员管理/
└── 订单管理/
草稿(各模块 *-草稿.md)仅作历史参考,不以草稿为准(会员/订单功能需求 v1.0 定稿除外)。
1. 模块文档一览
1.1 组织管理
1.2 商品管理
1.3 内容管理
1.4 用户与交易
跨模块(仅功能、无库表/接口): 关联需求分析.md v1.3
2. 跨模块定稿要点
| 要点 |
规则编号(示例) |
| 商家链不考虑会员(经营账号≠会员) |
商户/店铺/商品/分类 v1.3 |
| C 端买家会员(用户链) |
会员管理功能需求 v1.0.1 |
| 单商户 不设 开店数量上限 |
商户 R1 v1.3.1;店铺 S2 |
| 开店可选商户:正常 + 经营信息完整 |
商户 R6;店铺 S1 |
商户经营账号 biz_merchant_account;同商户多店同登录名 |
店铺 S4/S5 |
| 店铺策略(免审、子管理员)全平台全局 |
店铺设置 v1.1 |
| 分类仅两级;商品仅挂二级 |
分类 C1/C5;商品 P1 |
| 商品五态;未上架不进平台审核列表 |
商品 P3;商品审核 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. 业务链(文档协作顺序)
【组织】商户 → 店铺(+经营账号)→ 店铺设置(全局)
【入驻】内容管理·入驻协议 → 入驻审核 → 首店
【供给链】商品服务 → 商品分类 → 商品管理 → 商品审核 → C 端
【用户链】会员注册 → 下单 → 订单管理
【内容】Banner / 服务协议 / 入驻协议(与交易链弱耦合)
5. 修订记录
| 日期 |
说明 |
| 2026-05 |
v3.0 目录重组:组织管理/、商品管理/子模块、内容管理/;修正 商品管理/商品审核/ 文档归属 |
| 2026-05 |
v2.4 及以前:扁平模块路径、经营账号表名统一等(见历史条目) |
索引版本:v3.0