巴青农资商城

文档索引.md 7.3KB

农资商城 Web — 文档索引

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


0. 目录结构

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

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


1. 模块文档一览

1.1 组织管理

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

1.2 商品管理

模块 功能需求 技术方案 测试用例 说明
商品管理 v1.3.3 v1.2 v1.0 平台 + 商家端;P18~P21
商品分类 v1.3.1 v1.1 v1.0 商家端
商品服务 v1.0.1 v1.0.1 v1.0 平台端biz_goods_service
商品审核 v1.0 v1.0 v1.0 平台审核/下架专册

1.3 内容管理

模块 功能需求 技术方案 测试用例 说明
商城入驻协议 v1.0 v1.0 v1.0 入驻勾选协议
商城服务协议 v1.0 v1.0 v1.0 注册/登录协议
首页 Banner v1.0.1 v1.0 v1.0 C 端 Banner

1.4 用户与交易

模块 功能需求 技术方案 测试用例 说明
会员管理 v1.0.1 v1.0.1 v1.0 biz_member
订单管理 v1.0.1 v1.0 v1.0 biz_order

跨模块(仅功能、无库表/接口): 关联需求分析.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