农资商城 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.5
1.5 商家端（店铺后台）
2. 跨模块定稿要点
| 要点 |
规则编号（示例） |
| 商家链不考虑会员（经营账号≠会员） |
商户/店铺/商品/分类 v1.3 |
| C 端买家会员（用户链） |
会员管理功能需求 v1.0.1 |
| 单商户 不设 开店数量上限 |
商户 R1 v1.3.1；店铺 S2 |
| C 端入驻：完整字段 + 审核→公示→建档 |
入驻审核 v1.1 |
| 平台添加商户：免审；须绑管理员/会员；主体字段精简 |
商户管理 v1.5 §6 |
| 开店可选商户：正常 + 经营信息完整 |
商户 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.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. 业务链（文档协作顺序）
【组织】商户 → 店铺（+经营账号）→ 店铺设置（全局）
【入驻】内容管理·入驻协议 → 入驻审核（审核→公示→首店）→ 商户/店铺
【供给链】商品服务 → 商品分类 → 商品管理 → 商品审核 → 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.5 店铺管理 v1.4：列表评分/主账号列、更换主账号换绑；文档 v1.4～v1.5 |
| 2026-05 |
v3.2 商家端《店铺设置》v1.1 后端已实现；店铺管理技术方案 v1.2.6 同步 employeeStats |
| 2026-05 |
v3.1 商户 v1.5、入驻审核 v1.1（公示流程）；入驻 API 路径 /agri/merchantEntryApply |
索引版本：v3.5
