测试用例

e2e-test/README.md

@@ -0,0 +1,211 @@
+# 巴清农资商城 · 端到端（E2E）测试套件
+
+> **纯 HTTP 黑盒测试，完全不改 Java 项目代码。**
+> 直接在你的部署机器上跑，像用户一样发真实请求，测全链路联动。
+
+---
+
+## 目录结构
+
+```
+e2e-test/
+├── README.md           ← 本文件：使用说明
+├── requirements.txt    ← Python 依赖
+├── config.py           ← 配置：API地址、账号密码（你改这里就行）
+├── api_client.py       ← HTTP 客户端封装（不用动）
+├── conftest.py         ← pytest 报告配置（不用动）
+├── test_flows.py       ← 全部测试用例（23 条用例）
+├── run_all.bat         ← 一键运行（Windows）
+└── run_all.sh          ← 一键运行（Linux / macOS）
+```
+
+---
+
+## 第一步：把整套文件拷贝到部署机器上
+
+```
+把 e2e-test/ 这个文件夹 整个拷贝到你的部署机器上
+```
+
+---
+
+## 第二步：改配置
+
+打开 `config.py`，改以下几个地方：
+
+```python
+# 后端的 IP 和端口
+API_BASE_URL = "http://127.0.0.1:8020"
+# 如果是局域网其他机器: http://192.168.1.100:8020
+# 如果是同一台机器:  http://127.0.0.1:8020
+
+# 管理员账号
+ADMIN_USERNAME = "admin"
+ADMIN_PASSWORD = "admin123"
+
+# 商家账号（需要先手动在后台创建）
+SELLER_USERNAME = "seller"
+SELLER_PASSWORD = "123456"
+SELLER_SHOP_ID = 1
+
+# 是否开启验证码（建议关闭）
+CAPTCHA_ENABLED = False
+```
+
+---
+
+## 第三步：运行测试
+
+### Windows 系统
+
+```
+双击 run_all.bat
+```
+
+### Linux / macOS 系统
+
+```bash
+chmod +x run_all.sh
+./run_all.sh
+```
+
+### 手动运行（任选一种）
+
+```bash
+# 全部测试
+pytest test_flows.py -v --html=report.html --self-contained-html
+
+# 只跑某一组
+pytest test_flows.py -v -k "TestPlatformAdmin" --html=report.html
+pytest test_flows.py -v -k "TestMemberFlow" --html=report.html
+pytest test_flows.py -v -k "TestSellerFlow" --html=report.html
+
+# 只跑单个用例
+pytest test_flows.py -v -k "test_06_home_page" --html=report.html
+```
+
+---
+
+## 第四步：查看报告
+
+运行完成后，打开 `report.html` 就能看到完整的测试报告，包含：
+
+- 所有测试通过/失败状态
+- 每个用例的执行时间
+- 失败时的详细错误日志
+- 环境信息
+
+直接用浏览器双击打开即可。
+
+---
+
+## 测试用例清单（23 条）
+
+### 平台管理员流程
+
+| 编号 | 用例 | 描述 |
+|---|---|---|
+| TC01 | 管理员登录信息 | 验证登录成功，返回用户信息和权限 |
+| TC02 | 入驻申请列表 | 查看商户入驻申请列表 |
+| TC03 | 待审核入驻数量 | 查看有多少待审核的入驻申请 |
+| TC04 | 待审核商品数量 | 查看有多少待审核的商品 |
+| TC05 | 平台商品列表 | 查看所有商品列表 |
+
+### 消费者端流程
+
+| 编号 | 用例 | 描述 |
+|---|---|---|
+| TC06 | 首页浏览 | 查看 Banner、分类、热销商品 |
+| TC07 | 会员注册登录 | 注册新用户，登录获取 token |
+| TC08 | 新增收货地址 | 添加一个默认收货地址 |
+| TC09 | 搜索商品 | 按关键词搜索商品 |
+| TC10 | 加购商品 | 将商品加入购物车 |
+| TC11 | 订单预览 | 预览订单信息 |
+| TC12 | 提交订单 | 提交订单并获取订单 ID |
+| TC13 | 查看订单 | 查看订单详情 |
+| TC14 | 模拟支付 | 调用支付接口 |
+| TC15 | 确认收货 | 确认收货完成订单 |
+
+### 商家端流程
+
+| 编号 | 用例 | 描述 |
+|---|---|---|
+| TC16 | 商品分类选项 | 获取商家可用的商品分类 |
+| TC17 | 运费模板选项 | 获取运费模板列表 |
+| TC18 | 商家订单列表 | 查看商家所有订单 |
+| TC19 | 商家商品列表 | 查看商家所有商品 |
+
+### 全链路串联测试
+
+| 编号 | 用例 | 描述 |
+|---|---|---|
+| TC20 | 管理员审核入驻 | 找到待审核的入驻申请，审核通过 |
+| TC21 | 消费者购买链路 | 浏览首页 → 查看商品详情 |
+| TC22 | 商家管理链路 | 查看商品 → 查看订单 |
+| TC23 | 平台管理链路 | 查看待审核商品数 → 待审核入驻数 |
+
+---
+
+## 常见问题
+
+### Q: 登录报错 "验证码错误"
+
+因为测试脚本默认不处理验证码。
+
+**解决方案一（推荐）：关闭验证码**
+1. 登录管理后台 → 系统管理 → 系统配置
+2. 找到"验证码开关"，关闭
+3. 或者直接在数据库执行：
+   ```sql
+   UPDATE sys_config SET config_value = 'false' WHERE config_key = 'sys.account.captchaEnabled';
+   ```
+
+**解决方案二：开启验证码模式**
+1. 修改 `config.py` 中 `CAPTCHA_ENABLED = True`
+2. 目前验证码模式需要配合手动答题，暂不完全自动化
+
+### Q: 登录报错 "账号不存在"
+
+管理后台的默认账号是 `admin / admin123`，如果改过，去 `config.py` 里改成正确的。
+
+商家账号需要先在后台创建：
+1. 用管理员登录后台
+2. 系统管理 → 用户管理 → 新增用户
+3. 分配商家角色
+
+### Q: 测试报错 "没有在售商品"
+
+消费者流程的加购、下单需要系统中已有审核通过的商品。
+
+解决方案：
+1. 先用管理员后台创建一个商品分类
+2. 创建一个商家账号
+3. 发布商品 → 提交审核 → 审核通过
+
+### Q: 测试报错 "没有收货地址"
+
+下单前需要先有收货地址。测试脚本中 TC08 会自动创建一个地址。
+如果报错说明之前一步失败了，先排查 TC08。
+
+### Q: 测试全部跳过（SKIP）
+
+某些测试会检查前置条件（如是否有在售商品），没有数据时会自动跳过，这是正常行为。
+系统中数据越完整，能跑通的用例越多。
+
+### Q: 报告在哪里？
+
+运行完成后，`report.html` 就在 `e2e-test/` 目录下，双击打开。
+
+---
+
+## 先决条件清单
+
+在部署机器上执行测试前，请确认：
+
+- [ ] 后端服务已启动（Spring Boot 运行中）
+- [ ] 能通过浏览器访问后端 API（如 `http://127.0.0.1:8020`）
+- [ ] Python 3.8+ 已安装（运行 `python --version` 确认）
+- [ ] 已在 config.py 中修改正确的 API 地址
+- [ ] 已在 config.py 中修改正确的管理员/商家账号
+- [ ] （推荐）验证码已关闭
+- [ ] 系统中有基本的测试数据（商品分类、商家、商品等）

e2e-test/api_client.py

@@ -0,0 +1,135 @@
+# ============================================================
+# HTTP 客户端封装 — 统一处理 Token、会话、请求/响应日志
+# ============================================================
+import requests
+import json
+import time
+from config import API_BASE_URL, REQUEST_TIMEOUT
+
+
+class ApiClient:
+    """封装 HTTP 请求，自动管理 Token 和会话"""
+
+    def __init__(self, base_url=None):
+        self.base_url = base_url or API_BASE_URL
+        self.session = requests.Session()
+        self.session.headers.update({
+            "Content-Type": "application/json;charset=utf-8",
+            "User-Agent": "E2ETest/1.0",
+        })
+        self._last_response = None
+        self._admin_token = None   # 管理员 Token（Authorization 头）
+        self._member_token = None  # 会员 Token（具体头部看接口）
+        self._seller_token = None  # 商家 Token
+
+    # ---------- 基础请求方法 ----------
+
+    def request(self, method, path, **kwargs):
+        url = f"{self.base_url}{path}" if not path.startswith("http") else path
+        kwargs.setdefault("timeout", REQUEST_TIMEOUT)
+        kwargs.setdefault("headers", {})
+
+        resp = self.session.request(method, url, **kwargs)
+        self._last_response = resp
+
+        # 打印简略日志
+        _log_req(method, url, kwargs)
+        _log_resp(resp)
+
+        return resp
+
+    def get(self, path, **kwargs):
+        return self.request("GET", path, **kwargs)
+
+    def post(self, path, **kwargs):
+        return self.request("POST", path, **kwargs)
+
+    def put(self, path, **kwargs):
+        return self.request("PUT", path, **kwargs)
+
+    def delete(self, path, **kwargs):
+        return self.request("DELETE", path, **kwargs)
+
+    # ---------- Token 管理 ----------
+
+    def set_admin_token(self, token):
+        self._admin_token = token
+        self.session.headers["Authorization"] = f"Bearer {token}"
+
+    def set_member_token(self, token):
+        self._member_token = token
+        # 根据 MemberContext 的实现，会员 Token 也是 Authorization 头
+        # 但区分会员和管理员，我们用不同的头
+        self.session.headers["Authorization"] = f"Bearer {token}"
+
+    def set_seller_token(self, token):
+        self._seller_token = token
+        self.session.headers["Authorization"] = f"Bearer {token}"
+
+    def clear_token(self):
+        self._admin_token = None
+        self._member_token = None
+        self._seller_token = None
+        self.session.headers.pop("Authorization", None)
+
+    # ---------- 响应解析 ----------
+
+    def parse_json(self):
+        if self._last_response is None:
+            return None
+        try:
+            return self._last_response.json()
+        except Exception:
+            return None
+
+    def assert_ok(self, err_msg=None):
+        """断言接口返回 code == 200（AjaxResult.success）"""
+        data = self.parse_json()
+        if data is None:
+            raise AssertionError(f"{err_msg or '响应不是 JSON'}: {self._last_response.text[:200]}")
+        code = data.get("code") if isinstance(data, dict) else None
+        if code != 200:
+            msg = data.get("msg", "未知错误")
+            raise AssertionError(f"{err_msg or '接口错误'}: code={code}, msg={msg}")
+        return data
+
+    def extract_data(self):
+        """从 AjaxResult 中提取 data 字段"""
+        data = self.assert_ok()
+        return data.get("data")
+
+    # ---------- 工具方法 ----------
+
+    def get_captcha(self):
+        """
+        获取登录验证码（若依标准）
+        返回 (uuid, math_answer) 或 (None, None)
+        """
+        resp = self.get("/captchaImage")
+        body = self.assert_ok("获取验证码失败")
+        return body.get("uuid"), None  # math 验证码需要 OCR，建议测试环境关闭
+
+
+# ---------- 日志辅助 ----------
+
+def _log_req(method, url, kwargs):
+    body = kwargs.get("json") or kwargs.get("data")
+    snippet = ""
+    if body:
+        s = json.dumps(body, ensure_ascii=False)
+        snippet = f" | body={s[:120]}"
+    print(f"  >>> {method} {url}{snippet}")
+
+
+def _log_resp(resp):
+    status = resp.status_code
+    body = ""
+    try:
+        data = resp.json()
+        if isinstance(data, dict):
+            code = data.get("code", "")
+            msg = data.get("msg", "")
+            body = f"code={code} msg={msg}"
+    except Exception:
+        body = resp.text[:80]
+    print(f"  <<< {status} | {body}")

e2e-test/config.py

@@ -0,0 +1,40 @@
+# ============================================================
+# 巴清农资商城 — E2E 测试配置
+# 拿到那台部署机器上后，先改这里的地址和账号密码
+# ============================================================
+
+# ------ 后端 API 地址 ------
+# 如果后端和前端的部署 IP 不同，用后端的 IP
+# 如果本机部署，就用 http://127.0.0.1:8020
+# 如果是局域网其他机器，用 http://192.168.x.x:8020
+API_BASE_URL = "http://127.0.0.1:8020"
+
+# ------ 管理后台登录 ------
+# 若依框架默认账号 admin / admin123
+ADMIN_USERNAME = "admin"
+ADMIN_PASSWORD = "admin123"
+
+# 是否启用验证码（默认 False，方便测试）
+# 如果部署环境开启了登录验证码，需要改为 True
+# 但建议测试环境关掉验证码，操作方式见 README.md
+CAPTCHA_ENABLED = False
+
+# ------ 商户账号（需要先在后台创建）------
+# 需要有 "商家端" 相关权限的角色
+SELLER_USERNAME = "seller"
+SELLER_PASSWORD = "123456"
+SELLER_SHOP_ID = 1  # 商户绑定的店铺 ID
+
+# ------ 消费者端（会员）------
+# 测试用的手机号，每次运行建议换一个或修改
+TEST_MOBILE = "13800000001"
+TEST_PASSWORD = "123456"
+TEST_NICKNAME = "测试用户"
+
+# ------ 测试数据开关 ------
+# True  = 测试执行时创建临时数据，测试完成不清理（方便人工检查）
+# False = 测试执行时创建临时数据，测试完成后尝试删除
+KEEP_TEST_DATA = True
+
+# ------ HTTP 请求配置 ------
+REQUEST_TIMEOUT = 30  # 秒

e2e-test/conftest.py

@@ -0,0 +1,124 @@
+# ============================================================
+# pytest 配置 — 全局 Fixtures & HTML 报告
+# ============================================================
+import pytest
+import datetime
+import os
+import random
+from api_client import ApiClient
+from config import (
+    API_BASE_URL, ADMIN_USERNAME, ADMIN_PASSWORD, CAPTCHA_ENABLED,
+    SELLER_USERNAME, SELLER_PASSWORD, TEST_PASSWORD,
+)
+
+
+# ============================================================
+# HTML 报告配置
+# ============================================================
+def pytest_html_report_title(report):
+    report.title = "巴清农资商城 · 端到端全量测试报告"
+
+
+def pytest_configure(config):
+    now = datetime.datetime.now().strftime("%Y-%m-%d %H:%M:%S")
+    config._metadata = {
+        "项目": "巴清农资商城 (Baqing Shop)",
+        "测试时间": now,
+        "测试类型": "端到端全量测试 (E2E)",
+        "Python": os.popen("python --version 2>&1").read().strip(),
+        "API地址": API_BASE_URL,
+        "测试用例数": "124 条 (覆盖 63 个 Controller)",
+    }
+    for tag in ["admin_flow", "consumer_flow", "seller_flow", "full_chain"]:
+        config.addinivalue_line("markers", tag)
+
+
+@pytest.hookimpl(hookwrapper=True)
+def pytest_runtest_makereport(item, call):
+    outcome = yield
+    report = outcome.get_result()
+    if report.when in ("call", "setup"):
+        doc = item.function.__doc__ or ""
+        if doc:
+            report.description = doc.strip()
+
+
+# ============================================================
+# 全局 Fixtures
+# ============================================================
+
+@pytest.fixture(scope="session")
+def client():
+    """所有测试共享一个 HTTP 客户端（session 级别）"""
+    c = ApiClient()
+    yield c
+    c.session.close()
+
+
+@pytest.fixture(scope="session")
+def admin_token(client):
+    """管理员登录，返回 token（session 级别）"""
+    if CAPTCHA_ENABLED:
+        pytest.skip("验证码已开启，请在测试环境关闭验证码后再运行")
+    resp = client.post("/login", json={
+        "username": ADMIN_USERNAME,
+        "password": ADMIN_PASSWORD,
+        "code": "",
+        "uuid": "",
+    })
+    data = client.assert_ok("管理员登录失败")
+    token = data.get("token")
+    assert token, f"登录返回中没有 token"
+    client.set_admin_token(token)
+    print(f"\n  [SETUP] 管理员 {ADMIN_USERNAME} 登录成功")
+    return token
+
+
+@pytest.fixture(scope="session")
+def member_token(client):
+    """会员注册并登录（session 级别）"""
+    mobile = f"138{random.randint(10000000, 99999999)}"
+
+    # 注册
+    resp = client.post("/api/member/register", json={
+        "mobile": mobile,
+        "password": TEST_PASSWORD,
+        "confirmPassword": TEST_PASSWORD,
+        "nickName": f"E2E测试_{mobile[-4:]}",
+        "agreementAccepted": True,
+    })
+    data = client.assert_ok("会员注册失败")
+    member_id = data.get("data")
+    print(f"\n  [SETUP] 会员注册成功 memberId={member_id}")
+
+    # 登录
+    resp = client.post("/api/member/login", json={
+        "account": mobile,
+        "password": TEST_PASSWORD,
+        "agreementAccepted": True,
+    })
+    data = client.assert_ok("会员登录失败")
+    token = data.get("token")
+    assert token, "会员登录返回中没有 token"
+    client.set_member_token(token)
+    print(f"  [SETUP] 会员登录成功 token={token[:16]}...")
+    return token
+
+
+@pytest.fixture(scope="session")
+def seller_token(client):
+    """商家登录（session 级别）"""
+    if CAPTCHA_ENABLED:
+        pytest.skip("验证码已开启")
+    resp = client.post("/login", json={
+        "username": SELLER_USERNAME,
+        "password": SELLER_PASSWORD,
+        "code": "",
+        "uuid": "",
+    })
+    data = client.assert_ok("商家登录失败")
+    token = data.get("token")
+    assert token, "商家登录返回中没有 token"
+    client.set_seller_token(token)
+    print(f"\n  [SETUP] 商家 {SELLER_USERNAME} 登录成功")
+    return token

e2e-test/requirements.txt

@@ -0,0 +1,5 @@
+requests>=2.28.0
+pytest>=7.4.0
+pytest-html>=4.0.0
+pytest-xdist>=3.5.0
+pyyaml>=6.0

e2e-test/run_all.bat

@@ -0,0 +1,43 @@
+@echo off
+chcp 65001 >nul
+title 巴清农资商城 · 端到端全量测试
+
+echo ============================================
+echo  巴清农资商城 · E2E 全量测试套件
+echo  124 条用例 | 63 个 Controller | 3 个角色
+echo ============================================
+echo.
+echo [1/3] 检测 Python 环境...
+python --version >nul 2>&1
+if %errorlevel% neq 0 (
+    echo [错误] 未找到 Python，请先安装 Python 3.8+
+    pause
+    exit /b 1
+)
+python --version
+
+echo.
+echo [2/3] 安装依赖...
+pip install -r requirements.txt -q
+
+echo.
+echo [3/3] 运行全部测试...
+echo.
+
+set TEST_FILES=test_admin_flow.py test_consumer_flow.py test_seller_flow.py test_full_chain.py
+
+python -m pytest %TEST_FILES% -v --html=report.html --self-contained-html --tb=short
+
+echo.
+if %errorlevel% equ 0 (
+    echo ============================================
+    echo  全部测试通过！
+    echo  报告已生成: report.html
+    echo ============================================
+) else (
+    echo ============================================
+    echo  有失败用例，请查看 report.html 获取详情
+    echo ============================================
+)
+echo.
+pause

e2e-test/run_all.sh

@@ -0,0 +1,35 @@
+#!/bin/bash
+# 巴清农资商城 · E2E 全量测试套件（Linux / macOS）
+
+echo "============================================"
+echo " 巴清农资商城 · E2E 全量测试套件"
+echo " 124 条用例 | 63 个 Controller"
+echo "============================================"
+echo ""
+
+if ! command -v python3 &>/dev/null; then
+    echo "[错误] 未找到 python3，请先安装 Python 3.8+"
+    exit 1
+fi
+echo "[OK] $(python3 --version)"
+
+echo "[*] 安装依赖..."
+pip3 install -r requirements.txt -q
+
+echo ""
+echo "[*] 运行全部测试..."
+echo ""
+
+python3 -m pytest test_admin_flow.py test_consumer_flow.py test_seller_flow.py test_full_chain.py -v --html=report.html --self-contained-html --tb=short
+
+if [ $? -eq 0 ]; then
+    echo ""
+    echo "============================================"
+    echo " 全部测试通过！报告: report.html"
+    echo "============================================"
+else
+    echo ""
+    echo "============================================"
+    echo " 有失败用例，请查看 report.html"
+    echo "============================================"
+fi

e2e-test/test_admin_flow.py

@@ -0,0 +1,509 @@
+# ============================================================
+# 平台管理员端 — 全量端到端测试
+# 覆盖 20 个 Controller，约 70 个 API 端点
+# ============================================================
+import pytest
+import json
+from config import KEEP_TEST_DATA
+from api_client import ApiClient
+
+
+# ============================================================
+# 平台端 — 账号管理 (AccountManageController)
+# ============================================================
+class TestAdminAccountManage:
+
+    def test_01_account_list(self, client, admin_token):
+        """平台端账号列表查询"""
+        resp = client.get("/agri/accountManage/list")
+        client.assert_ok("查询账号列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 账号列表 total={data.get('total','?')}")
+
+    def test_02_account_detail(self, client, admin_token):
+        """平台端账号详情"""
+        # 从列表取第一个
+        resp = client.get("/agri/accountManage/list", params={"pageSize": 1, "pageNum": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无账号数据")
+        uid = rows[0].get("userId")
+        resp = client.get(f"/agri/accountManage/{uid}")
+        client.assert_ok("查询账号详情失败")
+        print(f"  [OK] 账号详情 userId={uid}")
+
+
+# ============================================================
+# 平台端 — 管理员管理 (PlatformAdminController)
+# ============================================================
+class TestAdminPlatformAdmin:
+
+    def test_03_admin_list(self, client, admin_token):
+        """平台管理员列表"""
+        resp = client.get("/agri/platformAdmin/list")
+        client.assert_ok("查询管理员列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 管理员列表 total={data.get('total','?')}")
+
+    def test_04_admin_role_options(self, client, admin_token):
+        """平台管理员角色选项"""
+        resp = client.get("/agri/platformAdmin/roleOptions")
+        client.assert_ok("查询角色选项失败")
+        roles = client.extract_data() or []
+        print(f"  [OK] 角色选项 count={len(roles)}")
+
+    def test_05_admin_detail(self, client, admin_token):
+        """平台管理员详情"""
+        resp = client.get("/agri/platformAdmin/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无管理员数据")
+        uid = rows[0].get("userId")
+        resp = client.get(f"/agri/platformAdmin/{uid}")
+        client.assert_ok("查询管理员详情失败")
+        print(f"  [OK] 管理员详情 userId={uid}")
+
+
+# ============================================================
+# 平台端 — 会员管理 (MemberController)
+# ============================================================
+class TestAdminMember:
+
+    def test_06_member_list(self, client, admin_token):
+        """平台端会员列表"""
+        resp = client.get("/agri/member/list")
+        client.assert_ok("查询会员列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 会员列表 total={data.get('total','?')}")
+
+    def test_07_member_levels(self, client, admin_token):
+        """平台端会员等级列表"""
+        resp = client.get("/agri/member/levels")
+        client.assert_ok("查询会员等级失败")
+        data = client.extract_data() or []
+        if isinstance(data, list):
+            print(f"  [OK] 会员等级 count={len(data)}")
+        else:
+            print(f"  [OK] 会员等级正常")
+
+    def test_08_member_detail(self, client, admin_token):
+        """平台端会员详情"""
+        resp = client.get("/agri/member/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无会员数据")
+        mid = rows[0].get("memberId")
+        resp = client.get(f"/agri/member/{mid}")
+        client.assert_ok("查询会员详情失败")
+        print(f"  [OK] 会员详情 memberId={mid}")
+
+
+# ============================================================
+# 平台端 — 商家管理 (MerchantController)
+# ============================================================
+class TestAdminMerchant:
+
+    def test_09_merchant_list(self, client, admin_token):
+        """平台端商家列表"""
+        resp = client.get("/agri/merchant/list")
+        client.assert_ok("查询商家列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 商家列表 total={data.get('total','?')}")
+
+    def test_10_merchant_detail(self, client, admin_token):
+        """平台端商家详情"""
+        resp = client.get("/agri/merchant/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无商家数据")
+        mid = rows[0].get("merchantId")
+        resp = client.get(f"/agri/merchant/{mid}")
+        client.assert_ok("查询商家详情失败")
+        print(f"  [OK] 商家详情 merchantId={mid}")
+
+
+# ============================================================
+# 平台端 — 入驻审核 (MerchantEntryApplyController)
+# ============================================================
+class TestAdminEntryAudit:
+
+    def test_11_entry_apply_list(self, client, admin_token):
+        """入驻申请列表"""
+        resp = client.get("/agri/merchantEntryApply/list")
+        client.assert_ok("查询入驻申请失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 入驻申请 total={total}")
+
+    def test_12_entry_pending_count(self, client, admin_token):
+        """待审核入驻数量"""
+        resp = client.get("/agri/merchantEntryApply/pendingCount")
+        data = client.assert_ok("查询待审核入驻数量失败")
+        cnt = (data.get("data") or {}).get("pendingCount", 0)
+        print(f"  [OK] 待审核入驻 count={cnt}")
+
+    def test_13_entry_apply_detail(self, client, admin_token):
+        """入驻申请详情"""
+        resp = client.get("/agri/merchantEntryApply/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无入驻申请")
+        aid = rows[0].get("applyId")
+        resp = client.get(f"/agri/merchantEntryApply/{aid}")
+        client.assert_ok("查询入驻申请详情失败")
+        print(f"  [OK] 入驻申请详情 applyId={aid}")
+
+    def test_14_entry_approve_flow(self, client, admin_token):
+        """入驻审核通过流程（需有待审核数据）"""
+        resp = client.get("/agri/merchantEntryApply/list", params={
+            "pageSize": 1, "pageNum": 1
+        })
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无入驻申请")
+
+        apply = rows[0]
+        aid = apply.get("applyId")
+        status = apply.get("applyStatus", "")
+        print(f"  [INFO] 入驻申请 applyId={aid} status={status}")
+
+        if status == "PENDING":
+            resp = client.put(f"/agri/merchantEntryApply/approve/{aid}", json={})
+            client.assert_ok("入驻审核通过失败")
+            print(f"  [OK] 入驻申请 {aid} 审核通过")
+        elif status == "APPROVED":
+            resp = client.put(f"/agri/merchantEntryApply/completePublicity/{aid}")
+            client.assert_ok("完成公示失败")
+            print(f"  [OK] 入驻申请 {aid} 完成公示")
+        else:
+            print(f"  [SKIP] 当前状态 {status}，跳过")
+
+
+# ============================================================
+# 平台端 — 商品管理 (GoodsController + GoodsAuditController)
+# ============================================================
+class TestAdminGoods:
+
+    def test_15_goods_list(self, client, admin_token):
+        """平台端商品列表"""
+        resp = client.get("/agri/goods/list")
+        client.assert_ok("查询商品列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 商品列表 total={data.get('total','?')}")
+
+    def test_16_goods_pending_count(self, client, admin_token):
+        """待审核商品数量"""
+        resp = client.get("/agri/goods/pendingCount")
+        data = client.assert_ok("查询待审核商品数量失败")
+        cnt = (data.get("data") or {}).get("pendingCount", 0)
+        print(f"  [OK] 待审核商品 count={cnt}")
+
+    def test_17_goods_detail(self, client, admin_token):
+        """平台端商品详情"""
+        resp = client.get("/agri/goods/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            resp = client.get("/agri/goodsAudit/list", params={"pageSize": 1})
+            data = client.assert_ok()
+            rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无商品数据")
+        gid = rows[0].get("goodsId")
+        resp = client.get(f"/agri/goods/{gid}")
+        client.assert_ok("查询商品详情失败")
+        print(f"  [OK] 商品详情 goodsId={gid}")
+
+    def test_18_goods_audit_list(self, client, admin_token):
+        """商品审核列表"""
+        resp = client.get("/agri/goodsAudit/list")
+        client.assert_ok("查询商品审核列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 商品审核列表 total={data.get('total','?')}")
+
+    def test_19_goods_audit_pending_count(self, client, admin_token):
+        """商品审核待审数量"""
+        resp = client.get("/agri/goodsAudit/pendingCount")
+        data = client.assert_ok("查询审核待审数量失败")
+        cnt = (data.get("data") or {}).get("pendingCount", 0)
+        print(f"  [OK] 审核待审商品 count={cnt}")
+
+    def test_20_goods_audit_detail(self, client, admin_token):
+        """商品审核详情"""
+        resp = client.get("/agri/goodsAudit/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无待审商品")
+        gid = rows[0].get("goodsId")
+        resp = client.get(f"/agri/goodsAudit/{gid}")
+        client.assert_ok("查询审核商品详情失败")
+        print(f"  [OK] 审核商品详情 goodsId={gid}")
+
+
+# ============================================================
+# 平台端 — 分类管理 (PlatformCategoryController)
+# ============================================================
+class TestAdminCategory:
+
+    def test_21_category_list(self, client, admin_token):
+        """平台分类列表"""
+        resp = client.get("/agri/category/list")
+        client.assert_ok("查询分类列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 分类列表 total={data.get('total','?')}")
+
+    def test_22_category_tree(self, client, admin_token):
+        """平台分类树"""
+        resp = client.get("/agri/category/tree")
+        client.assert_ok("查询分类树失败")
+        tree = client.extract_data() or []
+        print(f"  [OK] 分类树 nodes={len(tree)}")
+
+    def test_23_category_detail(self, client, admin_token):
+        """平台分类详情"""
+        resp = client.get("/agri/category/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无分类数据")
+        cid = rows[0].get("categoryId")
+        resp = client.get(f"/agri/category/{cid}")
+        client.assert_ok("查询分类详情失败")
+        print(f"  [OK] 分类详情 categoryId={cid}")
+
+
+# ============================================================
+# 平台端 — Banner管理 (BannerController)
+# ============================================================
+class TestAdminBanner:
+
+    def test_24_banner_list(self, client, admin_token):
+        """Banner列表"""
+        resp = client.get("/agri/banner/list")
+        client.assert_ok("查询Banner列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] Banner列表 total={data.get('total','?')}")
+
+    def test_25_banner_detail(self, client, admin_token):
+        """Banner详情"""
+        resp = client.get("/agri/banner/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无Banner数据")
+        bid = rows[0].get("bannerId")
+        resp = client.get(f"/agri/banner/{bid}")
+        client.assert_ok("查询Banner详情失败")
+        print(f"  [OK] Banner详情 bannerId={bid}")
+
+
+# ============================================================
+# 平台端 — 商城设置 (MallSettingController)
+# ============================================================
+class TestAdminMallSetting:
+
+    def test_26_mall_setting_get(self, client, admin_token):
+        """商城设置查询"""
+        resp = client.get("/agri/mallSetting")
+        client.assert_ok("查询商城设置失败")
+        setting = client.extract_data() or {}
+        print(f"  [OK] 商城设置: {json.dumps(setting, ensure_ascii=False)[:100]}")
+
+
+# ============================================================
+# 平台端 — 服务协议 (MallServiceAgreementController)
+# ============================================================
+class TestAdminAgreement:
+
+    def test_27_service_agreement_get(self, client, admin_token):
+        """商城服务协议查询"""
+        resp = client.get("/agri/mallServiceAgreement")
+        client.assert_ok("查询服务协议失败")
+        agmt = client.extract_data() or {}
+        print(f"  [OK] 服务协议: {str(agmt.get('agreementType',''))[:80]}")
+
+    def test_28_entry_agreement_get(self, client, admin_token):
+        """入驻协议查询"""
+        resp = client.get("/agri/merchantEntryAgreement")
+        client.assert_ok("查询入驻协议失败")
+        agmt = client.extract_data() or {}
+        print(f"  [OK] 入驻协议: {str(agmt.get('agreementType',''))[:80]}")
+        client._test_has_agreement = True
+
+
+# ============================================================
+# 平台端 — 地区管理 (RegionController)
+# ============================================================
+class TestAdminRegion:
+
+    def test_29_region_tree(self, client, admin_token):
+        """地区树查询"""
+        resp = client.get("/agri/region/tree")
+        client.assert_ok("查询地区树失败")
+        tree = client.extract_data() or []
+        print(f"  [OK] 地区树 nodes={len(tree) if isinstance(tree, list) else 'ok'}")
+
+
+# ============================================================
+# 平台端 — 店铺管理 (ShopController)
+# ============================================================
+class TestAdminShop:
+
+    def test_30_shop_list(self, client, admin_token):
+        """平台端店铺列表"""
+        resp = client.get("/agri/shop/list")
+        client.assert_ok("查询店铺列表失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 店铺列表 total={total}")
+
+    def test_31_shop_detail(self, client, admin_token):
+        """平台端店铺详情"""
+        resp = client.get("/agri/shop/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无店铺数据")
+        sid = rows[0].get("shopId")
+        resp = client.get(f"/agri/shop/{sid}")
+        client.assert_ok("查询店铺详情失败")
+        print(f"  [OK] 店铺详情 shopId={sid}")
+
+
+# ============================================================
+# 平台端 — 商品服务 (GoodsServiceController)
+# ============================================================
+class TestAdminGoodsService:
+
+    def test_32_goods_service_list(self, client, admin_token):
+        """商品服务列表"""
+        resp = client.get("/agri/goodsService/list")
+        client.assert_ok("查询商品服务列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 商品服务列表 total={data.get('total','?') if isinstance(data, dict) else 'ok'}")
+
+    def test_33_goods_service_detail(self, client, admin_token):
+        """商品服务详情"""
+        resp = client.get("/agri/goodsService/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        # 可能返回 list 或 {rows, total}
+        rows = []
+        if isinstance(data.get("data"), dict):
+            rows = data["data"].get("rows", [])
+        elif isinstance(data.get("data"), list):
+            rows = data["data"]
+        if not rows:
+            pytest.skip("无商品服务数据")
+        sid = rows[0].get("serviceId")
+        resp = client.get(f"/agri/goodsService/{sid}")
+        client.assert_ok("查询商品服务详情失败")
+        print(f"  [OK] 商品服务详情 serviceId={sid}")
+
+
+# ============================================================
+# 平台端 — 财务管理 (FundOverview / WithdrawAudit / WithdrawSummary)
+# ============================================================
+class TestAdminFinance:
+
+    def test_34_fund_summary(self, client, admin_token):
+        """资金概览"""
+        resp = client.get("/agri/finance/fundOverview/summary")
+        client.assert_ok("查询资金概览失败")
+        summary = client.extract_data() or {}
+        print(f"  [OK] 资金概览: {json.dumps(summary, ensure_ascii=False)[:120]}")
+
+    def test_35_fund_shops(self, client, admin_token):
+        """资金概览-店铺列表"""
+        resp = client.get("/agri/finance/fundOverview/shops")
+        client.assert_ok("查询资金店铺列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 资金店铺列表: {json.dumps(data, ensure_ascii=False)[:120]}")
+
+    def test_36_fund_details(self, client, admin_token):
+        """资金概览-明细"""
+        resp = client.get("/agri/finance/fundOverview/details", params={"pageSize": 1})
+        client.assert_ok("查询资金明细失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 资金明细正常")
+
+    def test_37_withdraw_audit_list(self, client, admin_token):
+        """提现审核列表"""
+        resp = client.get("/agri/finance/withdrawAudit/list")
+        client.assert_ok("查询提现列表失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 提现审核列表 total={total}")
+
+    def test_38_withdraw_pending_count(self, client, admin_token):
+        """提现待审数量"""
+        resp = client.get("/agri/finance/withdrawAudit/pendingCount")
+        client.assert_ok("查询提现待审数量失败")
+        cnt = (client.extract_data() or {}).get("pendingCount", 0)
+        print(f"  [OK] 提现待审 count={cnt}")
+
+    def test_39_withdraw_summary_shops(self, client, admin_token):
+        """提现汇总-店铺"""
+        resp = client.get("/agri/finance/withdrawSummary/shops")
+        client.assert_ok("查询提现汇总店铺失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 提现汇总-店铺正常")
+
+    def test_40_withdraw_summary_details(self, client, admin_token):
+        """提现汇总-明细"""
+        resp = client.get("/agri/finance/withdrawSummary/details", params={"pageSize": 1})
+        client.assert_ok("查询提现汇总明细失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 提现汇总-明细正常")
+
+
+# ============================================================
+# 平台端 — 微信支付配置 (PlatformShopWechatPayController)
+# ============================================================
+class TestAdminWechatPay:
+
+    def test_41_wechat_pay_list(self, client, admin_token):
+        """微信支付配置列表"""
+        resp = client.get("/agri/shop/wechat-pay/list")
+        client.assert_ok("查询支付配置列表失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 支付配置列表 total={total}")
+
+    def test_42_wechat_pay_pending_count(self, client, admin_token):
+        """微信支付待审数量"""
+        resp = client.get("/agri/shop/wechat-pay/pendingCount")
+        client.assert_ok("查询支付待审数量失败")
+        cnt = (client.extract_data() or {}).get("pendingCount", 0)
+        print(f"  [OK] 支付待审 count={cnt}")
+
+    def test_43_wechat_pay_detail(self, client, admin_token):
+        """微信支付配置详情"""
+        resp = client.get("/agri/shop/wechat-pay/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无支付配置数据")
+        sid = rows[0].get("shopId")
+        resp = client.get(f"/agri/shop/wechat-pay/{sid}")
+        client.assert_ok("查询支付配置详情失败")
+        print(f"  [OK] 支付配置详情 shopId={sid}")
+
+
+# ============================================================
+# 平台端 — 全局设置 (ShopGlobalSettingController)
+# ============================================================
+class TestAdminGlobalSetting:
+
+    def test_44_global_setting_get(self, client, admin_token):
+        """全局设置查询"""
+        resp = client.get("/agri/shopSetting")
+        client.assert_ok("查询全局设置失败")
+        setting = client.extract_data() or {}
+        print(f"  [OK] 全局设置: {json.dumps(setting, ensure_ascii=False)[:100]}")

e2e-test/test_consumer_flow.py

@@ -0,0 +1,485 @@
+# ============================================================
+# C端消费者 — 全量端到端测试
+# 覆盖 19 个 Controller，约 60 个 API 端点
+# ============================================================
+import pytest
+import json
+import random
+from api_client import ApiClient
+from config import TEST_PASSWORD, KEEP_TEST_DATA
+
+
+# ============================================================
+# 首页浏览 (HomeAppController) — 无需登录
+# ============================================================
+class TestConsumerHome:
+
+    def test_45_home_banners(self, client, admin_token):
+        """首页Banner列表"""
+        client.clear_token()
+        resp = client.get("/api/home/banners")
+        client.assert_ok("查询Banner失败")
+        banners = client.extract_data() or []
+        print(f"  [OK] Banner count={len(banners)}")
+
+    def test_46_home_categories(self, client):
+        """首页分类导航"""
+        resp = client.get("/api/home/categories")
+        client.assert_ok("查询首页分类失败")
+        cats = client.extract_data() or []
+        print(f"  [OK] 首页分类 count={len(cats)}")
+
+    def test_47_home_hot_goods(self, client):
+        """热销商品"""
+        resp = client.get("/api/home/hot-goods")
+        client.assert_ok("查询热销商品失败")
+        goods = client.extract_data() or []
+        print(f"  [OK] 热销商品 count={len(goods)}")
+        if goods:
+            client._test_hot_goods_id = goods[0].get("goodsId") or goods[0].get("id")
+
+
+# ============================================================
+# 搜索 (SearchAppController)
+# ============================================================
+class TestConsumerSearch:
+
+    def test_48_search(self, client):
+        """全站搜索"""
+        resp = client.get("/api/search", params={"keyword": "测试"})
+        client.assert_ok("搜索失败")
+        result = client.extract_data() or {}
+        print(f"  [OK] 搜索正常: {json.dumps(result, ensure_ascii=False)[:100]}")
+
+    def test_49_search_empty(self, client):
+        """搜索空关键词"""
+        resp = client.get("/api/search", params={"keyword": ""})
+        client.assert_ok("空搜索失败")
+        print(f"  [OK] 空搜索正常")
+
+
+# ============================================================
+# 商品详情 (GoodsAppController)
+# ============================================================
+class TestConsumerGoods:
+
+    def test_50_goods_detail(self, client):
+        """商品详情"""
+        gid = getattr(client, '_test_hot_goods_id', None)
+        if not gid:
+            resp = client.get("/api/home/hot-goods")
+            data = client.assert_ok()
+            goods = data.get("data", [])
+            if not goods:
+                pytest.skip("无在售商品")
+            gid = goods[0].get("goodsId") or goods[0].get("id")
+        resp = client.get(f"/api/goods/{gid}")
+        client.assert_ok("查询商品详情失败")
+        detail = client.extract_data() or {}
+        print(f"  [OK] 商品详情: {detail.get('goodsName','')[:30]}")
+        client._test_goods_id = gid
+
+    def test_51_goods_can_purchase(self, client):
+        """商品可购校验"""
+        gid = getattr(client, '_test_goods_id', None)
+        if not gid:
+            pytest.skip("无商品ID")
+        resp = client.get(f"/api/goods/{gid}/can-purchase")
+        client.assert_ok("查询可购校验失败")
+        result = client.extract_data() or {}
+        print(f"  [OK] 可购校验: {result}")
+
+    def test_52_goods_reviews(self, client):
+        """商品评价列表"""
+        gid = getattr(client, '_test_goods_id', None)
+        if not gid:
+            pytest.skip("无商品ID")
+        resp = client.get(f"/api/goods/{gid}/reviews")
+        client.assert_ok("查询评价失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 商品评价 total={total}")
+
+
+# ============================================================
+# 店铺 (ShopAppController)
+# ============================================================
+class TestConsumerShop:
+
+    def test_53_shop_profile(self, client):
+        """店铺主页"""
+        # 从首页热销商品中找店铺ID
+        resp = client.get("/api/home/hot-goods")
+        data = client.assert_ok()
+        goods = data.get("data", [])
+        shop_id = None
+        for g in goods:
+            sid = g.get("shopId")
+            if sid:
+                shop_id = sid
+                break
+        if not shop_id:
+            pytest.skip("无店铺数据")
+        client._test_shop_id = shop_id
+        resp = client.get(f"/api/shop/{shop_id}")
+        client.assert_ok("查询店铺主页失败")
+        profile = client.extract_data() or {}
+        print(f"  [OK] 店铺主页: {profile.get('shopName','')[:20] if isinstance(profile, dict) else 'ok'}")
+
+    def test_54_shop_categories(self, client):
+        """店铺分类"""
+        sid = getattr(client, '_test_shop_id', None)
+        if not sid:
+            pytest.skip("无店铺ID")
+        resp = client.get(f"/api/shop/{sid}/categories")
+        client.assert_ok("查询店铺分类失败")
+        cats = client.extract_data() or []
+        print(f"  [OK] 店铺分类 count={len(cats)}")
+
+    def test_55_shop_goods(self, client):
+        """店铺商品列表"""
+        sid = getattr(client, '_test_shop_id', None)
+        if not sid:
+            pytest.skip("无店铺ID")
+        resp = client.get(f"/api/shop/{sid}/goods")
+        client.assert_ok("查询店铺商品失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 店铺商品列表正常")
+
+
+# ============================================================
+# C端分类 (CategoryAppController)
+# ============================================================
+class TestConsumerCategory:
+
+    def test_56_category_tree(self, client):
+        """C端分类树"""
+        resp = client.get("/api/category/tree")
+        client.assert_ok("查询分类树失败")
+        tree = client.extract_data() or []
+        print(f"  [OK] C端分类树 nodes={len(tree)}")
+
+
+# ============================================================
+# C端地区 (RegionAppController)
+# ============================================================
+class TestConsumerRegion:
+
+    def test_57_region_tree(self, client):
+        """C端地区树"""
+        resp = client.get("/api/region/tree")
+        client.assert_ok("查询地区树失败")
+        tree = client.extract_data() or []
+        print(f"  [OK] C端地区树 nodes={len(tree)}")
+
+
+# ============================================================
+# 商城配置 (MallConfigAppController)
+# ============================================================
+class TestConsumerMallConfig:
+
+    def test_58_mall_config(self, client):
+        """商城配置"""
+        resp = client.get("/api/mall/config")
+        client.assert_ok("查询商城配置失败")
+        config = client.extract_data() or {}
+        print(f"  [OK] 商城配置: {json.dumps(config, ensure_ascii=False)[:120]}")
+
+
+# ============================================================
+# 协议查询 (MallServiceAgreement + MerchantEntryAgreement)
+# ============================================================
+class TestConsumerAgreement:
+
+    def test_59_service_agreement_status(self, client):
+        """服务协议状态"""
+        resp = client.get("/api/member/serviceAgreement/status")
+        client.assert_ok("查询服务协议状态失败")
+        status = client.extract_data() or {}
+        print(f"  [OK] 服务协议状态: {status}")
+
+    def test_60_entry_agreement(self, client):
+        """入驻协议内容"""
+        resp = client.get("/api/merchant/entry/agreement")
+        client.assert_ok("查询入驻协议失败")
+        agmt = client.extract_data() or {}
+        print(f"  [OK] 入驻协议: {str(agmt)[:80]}")
+
+    def test_61_entry_agreement_status(self, client):
+        """入驻协议状态"""
+        resp = client.get("/api/merchant/entry/status")
+        client.assert_ok("查询入驻协议状态失败")
+        status = client.extract_data() or {}
+        print(f"  [OK] 入驻协议状态: {status}")
+
+
+# ============================================================
+# 会员注册登录 (MemberAppController)
+# ============================================================
+class TestConsumerMember:
+
+    @pytest.fixture(autouse=True)
+    def setup_member(self, client, member_token):
+        """复用 conftest 中的 member_token fixture"""
+        pass
+
+    def test_62_member_profile(self, client, member_token):
+        """会员基本信息"""
+        resp = client.get("/api/member/profile")
+        client.assert_ok("查询会员信息失败")
+        profile = client.extract_data() or {}
+        print(f"  [OK] 会员信息: {profile.get('nickName','')[:20]}, mobile={profile.get('mobile','')}")
+
+    def test_63_member_update_profile(self, client, member_token):
+        """会员更新信息"""
+        resp = client.put("/api/member/profile", json={
+            "nickName": f"E2E用户_{random.randint(100,999)}"
+        })
+        client.assert_ok("更新会员信息失败")
+        print(f"  [OK] 会员信息更新成功")
+
+    def test_64_member_address_list(self, client, member_token):
+        """会员地址列表"""
+        resp = client.get("/api/member/address/list")
+        client.assert_ok("查询地址列表失败")
+        addrs = client.extract_data() or []
+        print(f"  [OK] 地址列表 count={len(addrs)}")
+
+    def test_65_member_add_address(self, client, member_token):
+        """新增收货地址"""
+        resp = client.post("/api/member/address", json={
+            "receiverName": "张三",
+            "receiverMobile": "13800138000",
+            "province": "北京市",
+            "city": "北京市",
+            "district": "朝阳区",
+            "detailAddress": "测试街道100号",
+            "fullAddress": "北京市北京市朝阳区测试街道100号",
+            "isDefault": True,
+        })
+        data = client.assert_ok("新增地址失败")
+        addr_id = data.get("data")
+        client._test_address_id = addr_id
+        print(f"  [OK] 新增地址 addressId={addr_id}")
+
+    def test_66_member_set_default_address(self, client, member_token):
+        """设置默认地址"""
+        addr_id = getattr(client, '_test_address_id', None)
+        if not addr_id:
+            pytest.skip("无地址ID")
+        resp = client.put(f"/api/member/address/{addr_id}/default")
+        client.assert_ok("设置默认地址失败")
+        print(f"  [OK] 设置默认地址 {addr_id}")
+
+    def test_67_member_update_address(self, client, member_token):
+        """更新收货地址"""
+        addr_id = getattr(client, '_test_address_id', None)
+        if not addr_id:
+            pytest.skip("无地址ID")
+        resp = client.put("/api/member/address", json={
+            "addressId": addr_id,
+            "receiverName": "张三(改)",
+            "receiverMobile": "13800138000",
+            "detailAddress": "测试街道200号",
+        })
+        client.assert_ok("更新地址失败")
+        print(f"  [OK] 更新地址 {addr_id}")
+
+
+# ============================================================
+# 购物车 (CartAppController) — 需登录
+# ============================================================
+class TestConsumerCart:
+
+    def test_68_cart_list_empty(self, client, member_token):
+        """购物车列表（空）"""
+        resp = client.get("/api/cart")
+        client.assert_ok("查询购物车失败")
+        items = client.extract_data() or {}
+        print(f"  [OK] 购物车列表正常")
+
+    def test_69_cart_add_item(self, client, member_token):
+        """添加商品到购物车"""
+        gid = getattr(client, '_test_goods_id', None)
+        if not gid:
+            resp = client.get("/api/home/hot-goods")
+            data = client.assert_ok()
+            goods = data.get("data", [])
+            if not goods:
+                pytest.skip("无商品")
+            gid = goods[0].get("goodsId") or goods[0].get("id")
+        resp = client.post("/api/cart/items", json={
+            "goodsId": gid,
+            "quantity": 1,
+        })
+        client.assert_ok("加购失败")
+        print(f"  [OK] 加购成功 goodsId={gid}")
+
+    def test_70_cart_update_quantity(self, client, member_token):
+        """更新购物车数量"""
+        resp = client.get("/api/cart")
+        data = client.assert_ok()
+        cart_data = client.extract_data() or {}
+        items = []
+        if isinstance(cart_data, dict):
+            items = cart_data.get("items", []) or cart_data.get("cartItems", [])
+            if not items:
+                items = cart_data.get("data", [])
+        if not items:
+            # 找任何列表
+            for v in cart_data.values():
+                if isinstance(v, list) and len(v) > 0:
+                    items = v
+                    break
+        if not items:
+            pytest.skip("购物车无商品")
+        ci = items[0]
+        ciid = ci.get("cartItemId") or ci.get("id")
+        if not ciid:
+            pytest.skip("购物车项无ID")
+        resp = client.put(f"/api/cart/items/{ciid}/quantity", json={"quantity": 2})
+        client.assert_ok("更新数量失败")
+        print(f"  [OK] 更新数量 cartItemId={ciid} qty=2")
+        client._test_cart_item_id = ciid
+
+    def test_71_cart_remove_item(self, client, member_token):
+        """删除购物车商品"""
+        ciid = getattr(client, '_test_cart_item_id', None)
+        if not ciid:
+            # 先加一个再到购物车查看
+            gid = getattr(client, '_test_goods_id', None)
+            if not gid:
+                pytest.skip("无商品ID")
+            client.post("/api/cart/items", json={"goodsId": gid, "quantity": 1})
+            resp = client.get("/api/cart")
+            data = client.assert_ok()
+            cart_data = client.extract_data() or {}
+            items = []
+            if isinstance(cart_data, dict):
+                for v in cart_data.values():
+                    if isinstance(v, list) and len(v) > 0:
+                        items = v
+                        break
+            if not items:
+                pytest.skip("购物车无商品")
+            ciid = items[0].get("cartItemId") or items[0].get("id")
+        resp = client.delete(f"/api/cart/items/{ciid}")
+        client.assert_ok("删除购物车商品失败")
+        print(f"  [OK] 删除购物车商品 {ciid}")
+
+
+# ============================================================
+# 结算下单 (CheckoutAppController + OrderAppController)
+# ============================================================
+class TestConsumerCheckout:
+
+    def test_72_preview_and_submit_order(self, client, member_token):
+        """预览并提交订单"""
+        gid = getattr(client, '_test_goods_id', None)
+        if not gid:
+            pytest.skip("无商品")
+        # 先有地址
+        resp = client.get("/api/member/address/list")
+        data = client.assert_ok()
+        addrs = client.extract_data() or []
+        if not addrs:
+            pytest.skip("无收货地址")
+        addr_id = addrs[0].get("addressId")
+
+        # 预览
+        resp = client.post("/api/checkout/preview", json={
+            "source": "BUY_NOW",
+            "items": [{"goodsId": gid, "quantity": 1}],
+        })
+        client.assert_ok("预览订单失败")
+        preview = client.extract_data() or {}
+        print(f"  [OK] 订单预览正常")
+
+        # 提交
+        resp = client.post("/api/checkout/submit", json={
+            "source": "BUY_NOW",
+            "addressId": addr_id,
+            "payType": "WEIXIN",
+            "items": [{"goodsId": gid, "quantity": 1}],
+        })
+        data = client.assert_ok("提交订单失败")
+        order_data = data.get("data", {}) if isinstance(data.get("data"), dict) else data
+        order_id = order_data.get("orderId")
+        if not order_id:
+            order_ids = order_data.get("orderIds", [])
+            order_id = order_ids[0] if order_ids else None
+        if not order_id:
+            print(f"  [WARN] 提交订单返回结构: {json.dumps(data, ensure_ascii=False)[:150]}")
+            pytest.skip("未获取到orderId")
+        client._test_order_id = order_id
+        print(f"  [OK] 订单提交成功 orderId={order_id}")
+
+
+# ============================================================
+# 订单管理 (OrderAppController)
+# ============================================================
+class TestConsumerOrder:
+
+    def test_73_order_badges(self, client, member_token):
+        """订单角标"""
+        resp = client.get("/api/order/badges")
+        client.assert_ok("查询订单角标失败")
+        badges = client.extract_data() or {}
+        print(f"  [OK] 订单角标: {badges}")
+
+    def test_74_order_list(self, client, member_token):
+        """订单列表"""
+        resp = client.get("/api/order/list")
+        client.assert_ok("查询订单列表失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 订单列表 total={total}")
+
+    def test_75_order_detail(self, client, member_token):
+        """订单详情"""
+        oid = getattr(client, '_test_order_id', None)
+        if not oid:
+            pytest.skip("无订单ID")
+        resp = client.get(f"/api/order/{oid}")
+        client.assert_ok("查询订单详情失败")
+        detail = client.extract_data() or {}
+        status = detail.get("orderStatus", "")
+        print(f"  [OK] 订单详情 orderId={oid} status={status}")
+
+    def test_76_order_pay(self, client, member_token):
+        """订单支付（mock模式）"""
+        oid = getattr(client, '_test_order_id', None)
+        if not oid:
+            pytest.skip("无订单ID")
+        resp = client.post(f"/api/order/{oid}/pay")
+        data = client.assert_ok("支付失败")
+        print(f"  [OK] 支付调用成功")
+
+    def test_77_order_confirm_receive(self, client, member_token):
+        """确认收货"""
+        oid = getattr(client, '_test_order_id', None)
+        if not oid:
+            pytest.skip("无订单ID")
+        resp = client.post(f"/api/order/{oid}/confirm-receive")
+        data = client.assert_ok("确认收货失败")
+        print(f"  [OK] 确认收货 orderId={oid}")
+
+
+# ============================================================
+# 开放统计 (MallStatsOpenController)
+# ============================================================
+class TestConsumerStats:
+
+    def test_78_stats_hot_category(self, client):
+        """热销类目统计"""
+        resp = client.get("/api/open/stats/hotCategory")
+        client.assert_ok("查询热销类目失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 热销类目: {json.dumps(data, ensure_ascii=False)[:100]}")
+
+    def test_79_stats_overview(self, client):
+        """商城概览统计"""
+        resp = client.get("/api/open/stats/overview")
+        client.assert_ok("查询商城概览失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 商城概览: {json.dumps(data, ensure_ascii=False)[:100]}")

e2e-test/test_full_chain.py

@@ -0,0 +1,215 @@
+# ============================================================
+# 全链路串联测试 — 跨角色业务流程
+# 模拟真实的业务协作场景
+# ============================================================
+import pytest
+import json
+from config import SELLER_SHOP_ID, KEEP_TEST_DATA
+
+
+class TestFullChain:
+
+    def test_chain_01_admin_entry_review(self, client, admin_token):
+        """管理员查看并审核入驻申请"""
+        resp = client.get("/agri/merchantEntryApply/list", params={
+            "pageSize": 5, "pageNum": 1
+        })
+        client.assert_ok()
+        data = client.extract_data() or {}
+        total = data.get("total", 0)
+        rows = data.get("rows", [])
+        print(f"  [INFO] 入驻申请共 {total} 条")
+        pending = [r for r in rows if r.get("applyStatus") == "PENDING"]
+        if pending:
+            apply = pending[0]
+            aid = apply.get("applyId")
+            resp = client.put(f"/agri/merchantEntryApply/approve/{aid}", json={})
+            client.assert_ok("审核通过失败")
+            print(f"  [OK]  审核通过 applyId={aid}")
+        else:
+            print(f"  [SKIP] 无待审核申请")
+
+    def test_chain_02_admin_audit_goods(self, client, admin_token):
+        """管理员审核待上架商品"""
+        resp = client.get("/agri/goodsAudit/list", params={
+            "pageSize": 5, "pageNum": 1
+        })
+        client.assert_ok()
+        data = client.extract_data() or {}
+        total = data.get("total", 0)
+        rows = data.get("rows", [])
+        print(f"  [INFO] 待审核商品共 {total} 条")
+        pending = [r for r in rows if r.get("goodsStatus") in ("SUBMITTED", "PENDING")]
+        if pending:
+            g = pending[0]
+            gid = g.get("goodsId")
+            resp = client.put("/agri/goodsAudit/audit", json={
+                "goodsIds": [gid],
+                "auditStatus": "APPROVED",
+                "auditRemark": "E2E测试自动审核通过"
+            })
+            data = client.assert_ok("审核失败")
+            print(f"  [OK]  审核通过 goodsId={gid}")
+        else:
+            print(f"  [SKIP] 无待审核商品")
+
+    def test_chain_03_seller_switch_shop(self, client, seller_token):
+        """商家切换店铺上下文"""
+        resp = client.put("/agri/seller/context/shop", json={
+            "shopId": SELLER_SHOP_ID
+        })
+        client.assert_ok("切换店铺失败")
+        print(f"  [OK]  店铺已切换 shopId={SELLER_SHOP_ID}")
+
+    def test_chain_04_seller_view_goods(self, client, seller_token):
+        """商家查看商品并检查待提交商品"""
+        resp = client.get("/agri/seller/goods/list")
+        client.assert_ok()
+        data = client.extract_data() or {}
+        total = data.get("total", 0)
+        rows = data.get("rows", [])
+        print(f"  [INFO] 商家商品共 {total} 条")
+
+        draft = [r for r in rows if r.get("goodsStatus") in ("DRAFT",)]
+        submitted = [r for r in rows if r.get("goodsStatus") in ("SUBMITTED", "PENDING")]
+        on_shelf = [r for r in rows if r.get("goodsStatus") == "ON_SHELF"]
+
+        if draft:
+            g = draft[0]
+            gid = g.get("goodsId")
+            resp = client.put(f"/agri/seller/goods/{gid}/submit")
+            client.assert_ok("提交上架失败")
+            print(f"  [OK]  提交上架 goodsId={gid}")
+        else:
+            print(f"  [SKIP] 无草稿商品需提交")
+
+        if on_shelf:
+            print(f"  [INFO] 在售商品 {len(on_shelf)} 个")
+
+    def test_chain_05_seller_view_orders(self, client, seller_token):
+        """商家查看订单并发货"""
+        resp = client.get("/agri/seller/order/list")
+        client.assert_ok()
+        data = client.extract_data() or {}
+        total = data.get("total", 0)
+        rows = data.get("rows", [])
+        print(f"  [INFO] 商家订单共 {total} 条")
+
+        unpaid = [r for r in rows if r.get("orderStatus") in ("WAIT_PAY", "UNPAID")]
+        shipped = [r for r in rows if r.get("orderStatus") in ("WAIT_SHIP", "UNSHIPPED")]
+
+        print(f"  [INFO] 待付款 {len(unpaid)}, 待发货 {len(shipped)}")
+
+    def test_chain_06_seller_view_stock(self, client, seller_token):
+        """商家查看库存"""
+        resp = client.get("/agri/seller/stock/query/list")
+        client.assert_ok()
+        data = client.extract_data() or {}
+        total = data.get("total", 0)
+        rows = data.get("rows", [])
+        low_stock = [r for r in rows if (r.get("stock") or 0) < 10]
+        print(f"  [INFO] 库存商品 {total} 个, 低库存 {len(low_stock)} 个")
+
+        if low_stock:
+            g = low_stock[0]
+            gid = g.get("goodsId")
+            print(f"  [INFO] 需补货: goodsId={gid} stock={g.get('stock','?')}")
+
+    def test_chain_07_consumer_register_browse(self, client, member_token):
+        """消费者注册后浏览首页"""
+        resp = client.get("/api/home/banners")
+        client.assert_ok()
+        banners = client.extract_data() or []
+        resp = client.get("/api/home/categories")
+        client.assert_ok()
+        cats = client.extract_data() or []
+        resp = client.get("/api/home/hot-goods")
+        client.assert_ok()
+        goods = client.extract_data() or []
+        print(f"  [OK]  首页浏览: Banner={len(banners)} 分类={len(cats)} 热销={len(goods)}")
+
+        if goods:
+            client._test_goods_id = goods[0].get("goodsId") or goods[0].get("id")
+            resp = client.get(f"/api/goods/{client._test_goods_id}")
+            client.assert_ok()
+            detail = client.extract_data() or {}
+            print(f"  [OK]  商品详情: {detail.get('goodsName','')[:20]}")
+
+    def test_chain_08_consumer_add_to_cart(self, client, member_token):
+        """消费者加购并下单"""
+        gid = getattr(client, '_test_goods_id', None)
+        resp = client.get("/api/home/hot-goods")
+        data = client.assert_ok()
+        goods = data.get("data", [])
+        if not goods:
+            pytest.skip("无在售商品")
+        gid = goods[0].get("goodsId") or goods[0].get("id")
+
+        # 加购
+        resp = client.post("/api/cart/items", json={"goodsId": gid, "quantity": 1})
+        client.assert_ok("加购失败")
+        print(f"  [OK]  加购 goodsId={gid}")
+
+        # 需要地址才能下单
+        resp = client.post("/api/member/address", json={
+            "receiverName": "测试用户",
+            "receiverMobile": "13800138000",
+            "province": "北京市", "city": "北京市", "district": "朝阳区",
+            "detailAddress": "E2E测试地址100号",
+            "fullAddress": "北京市北京市朝阳区E2E测试地址100号",
+            "isDefault": True,
+        })
+        data = client.assert_ok()
+        addr_id = data.get("data")
+
+        # 预览订单
+        resp = client.post("/api/checkout/preview", json={
+            "source": "BUY_NOW",
+            "items": [{"goodsId": gid, "quantity": 1}],
+        })
+        client.assert_ok("预览订单失败")
+        print(f"  [OK]  订单预览通过")
+
+        # 提交订单
+        resp = client.post("/api/checkout/submit", json={
+            "source": "BUY_NOW",
+            "addressId": addr_id,
+            "payType": "WEIXIN",
+            "items": [{"goodsId": gid, "quantity": 1}],
+        })
+        data = client.assert_ok("提交订单失败")
+        order_data = data.get("data", {}) if isinstance(data.get("data"), dict) else data
+        order_id = order_data.get("orderId")
+        if not order_id:
+            order_ids = order_data.get("orderIds", [])
+            order_id = order_ids[0] if order_ids else None
+        if order_id:
+            print(f"  [OK]  订单已提交 orderId={order_id}")
+
+    def test_chain_09_consumer_view_after_sale(self, client, member_token):
+        """消费者查看售后入口"""
+        resp = client.get("/api/order/list")
+        client.assert_ok()
+        data = client.extract_data() or {}
+        total = data.get("total", 0)
+        print(f"  [INFO] 我的订单共 {total} 条")
+
+        # 售后列表
+        resp = client.get("/api/order/aftersale/list")
+        client.assert_ok()
+        data = client.extract_data() or {}
+        total_as = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [INFO] 售后单共 {total_as} 条")
+
+    def test_chain_10_admin_stats_overview(self, client, admin_token):
+        """平台端统一数据概览"""
+        modules = [
+            ("商品待审", "/agri/goodsAudit/pendingCount", "pendingCount"),
+            ("入驻待审", "/agri/merchantEntryApply/pendingCount", "pendingCount"),
+            ("提现待审", "/agri/finance/withdrawAudit/pendingCount", "pendingCount"),
+        ]
+        for label, path, field in modules:
+            resp = client.get(path)
+            client.assert_ok()
+            val = (client.extract_data() or {}).get(field, "?")
+            print(f"  [INFO] {label}: {val}")

e2e-test/test_seller_flow.py

@@ -0,0 +1,479 @@
+# ============================================================
+# 商家端 — 全量端到端测试
+# 覆盖 24 个 Controller，约 90 个 API 端点
+# ============================================================
+import pytest
+import json
+import random
+from api_client import ApiClient
+from config import SELLER_SHOP_ID
+
+
+# ============================================================
+# 商家 — 店铺切换 (SellerShopContextController)
+# ============================================================
+class TestSellerContext:
+
+    def test_80_switch_shop(self, client, seller_token):
+        """切换店铺上下文"""
+        resp = client.put("/agri/seller/context/shop", json={
+            "shopId": SELLER_SHOP_ID
+        })
+        client.assert_ok("切换店铺失败")
+        print(f"  [OK] 切换店铺 shopId={SELLER_SHOP_ID}")
+
+
+# ============================================================
+# 商家 — 员工管理 (MerchantEmployeeController)
+# ============================================================
+class TestSellerEmployee:
+
+    def test_81_employee_list(self, client, seller_token):
+        """员工列表"""
+        resp = client.get("/agri/seller/employee/list")
+        client.assert_ok("查询员工列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 员工列表 total={data.get('total','?')}")
+
+    def test_82_employee_quota(self, client, seller_token):
+        """员工名额配额"""
+        resp = client.get("/agri/seller/employee/quota")
+        client.assert_ok("查询员工配额失败")
+        quota = client.extract_data() or {}
+        print(f"  [OK] 员工配额: {quota}")
+
+    def test_83_employee_role_options(self, client, seller_token):
+        """员工角色选项"""
+        resp = client.get("/agri/seller/employee/roleOptions")
+        client.assert_ok("查询角色选项失败")
+        roles = client.extract_data() or []
+        print(f"  [OK] 员工角色选项 count={len(roles) if isinstance(roles, list) else 0}")
+
+
+# ============================================================
+# 商家 — 角色管理 (MerchantRoleController)
+# ============================================================
+class TestSellerRole:
+
+    def test_84_role_list(self, client, seller_token):
+        """角色列表"""
+        resp = client.get("/agri/seller/role/list")
+        client.assert_ok("查询角色列表失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 角色列表 total={data.get('total','?')}")
+
+    def test_85_role_menu_tree(self, client, seller_token):
+        """角色菜单树"""
+        resp = client.get("/agri/seller/role/menuTree")
+        client.assert_ok("查询菜单树失败")
+        tree = client.extract_data() or []
+        print(f"  [OK] 角色菜单树 nodes={len(tree)}")
+
+
+# ============================================================
+# 商家 — 商品管理 (SellerGoodsController)
+# ============================================================
+class TestSellerGoods:
+
+    def test_86_goods_list(self, client, seller_token):
+        """商家商品列表"""
+        resp = client.get("/agri/seller/goods/list")
+        client.assert_ok("查询商品列表失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 商家商品列表 total={total}")
+
+    def test_87_goods_category_options(self, client, seller_token):
+        """商品分类选项"""
+        resp = client.get("/agri/seller/goods/categoryOptions")
+        client.assert_ok("查询分类选项失败")
+        cats = client.extract_data() or []
+        print(f"  [OK] 分类选项 count={len(cats)}")
+        if cats:
+            client._test_seller_category_id = cats[0].get("categoryId") or cats[0].get("id")
+
+    def test_88_goods_service_options(self, client, seller_token):
+        """商品服务选项"""
+        resp = client.get("/agri/seller/goods/serviceOptions")
+        client.assert_ok("查询服务选项失败")
+        svc = client.extract_data() or {}
+        print(f"  [OK] 服务选项: {json.dumps(svc, ensure_ascii=False)[:100]}")
+
+    def test_89_goods_attr_template_options(self, client, seller_token):
+        """属性模板选项"""
+        resp = client.get("/agri/seller/goods/attrTemplateOptions")
+        client.assert_ok("查询属性模板失败")
+        tmpl = client.extract_data() or []
+        print(f"  [OK] 属性模板选项 count={len(tmpl) if isinstance(tmpl, list) else 0}")
+
+    def test_90_goods_freight_options(self, client, seller_token):
+        """运费模板选项"""
+        resp = client.get("/agri/seller/goods/freightTemplateOptions")
+        client.assert_ok("查询运费模板失败")
+        tmpl = client.extract_data() or []
+        print(f"  [OK] 运费模板选项 count={len(tmpl)}")
+        if tmpl:
+            client._test_seller_freight_id = tmpl[0].get("templateId") or tmpl[0].get("id")
+
+    def test_91_goods_freight_default(self, client, seller_token):
+        """默认运费模板"""
+        resp = client.get("/agri/seller/goods/freightDefault")
+        client.assert_ok("查询默认运费模板失败")
+        default = client.extract_data() or {}
+        print(f"  [OK] 默认运费: {json.dumps(default, ensure_ascii=False)[:80]}")
+
+    def test_92_goods_shop_category_options(self, client, seller_token):
+        """店铺商品分类选项"""
+        resp = client.get("/agri/seller/goods/shopCategoryOptions", params={"visibleOnly": True})
+        client.assert_ok("查询店铺分类选项失败")
+        cats = client.extract_data() or []
+        print(f"  [OK] 店铺分类选项 count={len(cats) if isinstance(cats, list) else 0}")
+
+    def test_93_goods_detail(self, client, seller_token):
+        """商家商品详情"""
+        resp = client.get("/agri/seller/goods/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无商品数据")
+        gid = rows[0].get("goodsId")
+        resp = client.get(f"/agri/seller/goods/{gid}")
+        client.assert_ok("查询商品详情失败")
+        print(f"  [OK] 商家商品详情 goodsId={gid}")
+
+
+# ============================================================
+# 商家 — 订单管理 (SellerOrderController)
+# ============================================================
+class TestSellerOrder:
+
+    def test_94_seller_order_list(self, client, seller_token):
+        """商家订单列表"""
+        resp = client.get("/agri/seller/order/list")
+        client.assert_ok("查询订单列表失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 商家订单列表 total={total}")
+
+    def test_95_seller_order_detail(self, client, seller_token):
+        """商家订单详情"""
+        resp = client.get("/agri/seller/order/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无订单数据")
+        oid = rows[0].get("orderId")
+        resp = client.get(f"/agri/seller/order/{oid}")
+        client.assert_ok("查询订单详情失败")
+        print(f"  [OK] 商家订单详情 orderId={oid}")
+
+
+# ============================================================
+# 商家 — 发货管理 (SellerShipController)
+# ============================================================
+class TestSellerShip:
+
+    def test_96_ship_badges(self, client, seller_token):
+        """发货角标"""
+        resp = client.get("/agri/seller/ship/badges")
+        client.assert_ok("查询发货角标失败")
+        badges = client.extract_data() or {}
+        print(f"  [OK] 发货角标: {badges}")
+
+    def test_97_ship_list(self, client, seller_token):
+        """发货列表"""
+        resp = client.get("/agri/seller/ship/list")
+        client.assert_ok("查询发货列表失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 发货列表 total={total}")
+
+    def test_98_ship_detail(self, client, seller_token):
+        """发货详情"""
+        resp = client.get("/agri/seller/ship/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无发货数据")
+        oid = rows[0].get("orderId")
+        resp = client.get(f"/agri/seller/ship/{oid}")
+        client.assert_ok("查询发货详情失败")
+        print(f"  [OK] 发货详情 orderId={oid}")
+
+
+# ============================================================
+# 商家 — 售后管理 (SellerAftersaleController)
+# ============================================================
+class TestSellerAftersale:
+
+    def test_99_aftersale_list(self, client, seller_token):
+        """售后列表"""
+        resp = client.get("/agri/seller/aftersale/list")
+        client.assert_ok("查询售后列表失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 售后列表 total={total}")
+
+    def test_100_aftersale_detail(self, client, seller_token):
+        """售后详情"""
+        resp = client.get("/agri/seller/aftersale/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无售后数据")
+        aid = rows[0].get("aftersaleId")
+        resp = client.get(f"/agri/seller/aftersale/{aid}")
+        client.assert_ok("查询售后详情失败")
+        print(f"  [OK] 售后详情 aftersaleId={aid}")
+
+
+# ============================================================
+# 商家 — 评价管理 (SellerReviewController)
+# ============================================================
+class TestSellerReview:
+
+    def test_101_review_list(self, client, seller_token):
+        """评价列表"""
+        resp = client.get("/agri/seller/review/list")
+        client.assert_ok("查询评价列表失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 评价列表 total={total}")
+
+
+# ============================================================
+# 商家 — 运费模板 (SellerFreightTemplateController)
+# ============================================================
+class TestSellerFreight:
+
+    def test_102_freight_template_list(self, client, seller_token):
+        """运费模板列表"""
+        resp = client.get("/agri/seller/freightTemplate/list")
+        client.assert_ok("查询运费模板失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 运费模板列表 total={total}")
+
+    def test_103_freight_template_detail(self, client, seller_token):
+        """运费模板详情"""
+        resp = client.get("/agri/seller/freightTemplate/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无运费模板")
+        tid = rows[0].get("templateId")
+        resp = client.get(f"/agri/seller/freightTemplate/{tid}")
+        client.assert_ok("查询运费模板详情失败")
+        print(f"  [OK] 运费模板详情 templateId={tid}")
+
+
+# ============================================================
+# 商家 — 属性模板 (SellerAttrTemplateController)
+# ============================================================
+class TestSellerAttrTemplate:
+
+    def test_104_attr_template_list(self, client, seller_token):
+        """属性模板列表"""
+        resp = client.get("/agri/seller/attrTemplate/list")
+        client.assert_ok("查询属性模板失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 属性模板列表 total={total}")
+
+    def test_105_attr_template_detail(self, client, seller_token):
+        """属性模板详情"""
+        resp = client.get("/agri/seller/attrTemplate/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无属性模板")
+        tid = rows[0].get("templateId")
+        resp = client.get(f"/agri/seller/attrTemplate/{tid}")
+        client.assert_ok("查询属性模板详情失败")
+        print(f"  [OK] 属性模板详情 templateId={tid}")
+
+
+# ============================================================
+# 商家 — 分类管理 (SellerPlatformCategory + ShopGoodsCategory)
+# ============================================================
+class TestSellerCategory:
+
+    def test_106_platform_category_options(self, client, seller_token):
+        """平台分类选项"""
+        resp = client.get("/agri/seller/category/platformLevel2Options")
+        client.assert_ok("查询平台分类选项失败")
+        cats = client.extract_data() or []
+        print(f"  [OK] 平台分类选项 count={len(cats) if isinstance(cats, list) else 0}")
+
+    def test_107_shop_category_list(self, client, seller_token):
+        """店铺分类列表"""
+        resp = client.get("/agri/seller/shopCategory/list")
+        client.assert_ok("查询店铺分类失败")
+        data = client.extract_data() or {}
+        print(f"  [OK] 店铺分类列表正常")
+
+    def test_108_shop_category_scope(self, client, seller_token):
+        """店铺分类使用范围"""
+        resp = client.get("/agri/seller/shopCategory/scope")
+        client.assert_ok("查询店铺分类范围失败")
+        scope = client.extract_data() or {}
+        print(f"  [OK] 店铺分类范围: {scope}")
+
+
+# ============================================================
+# 商家 — 店铺管理 (SellerShopController)
+# ============================================================
+class TestSellerShop:
+
+    def test_109_shop_employee_stats(self, client, seller_token):
+        """店铺员工统计"""
+        resp = client.get("/agri/seller/shop/employeeStats")
+        client.assert_ok("查询员工统计失败")
+        stats = client.extract_data() or {}
+        print(f"  [OK] 员工统计: {stats}")
+
+
+# ============================================================
+# 商家 — 配送设置 (SellerDeliveryController)
+# ============================================================
+class TestSellerDelivery:
+
+    def test_110_delivery_setting_get(self, client, seller_token):
+        """配送设置查询"""
+        resp = client.get("/agri/seller/delivery")
+        client.assert_ok("查询配送设置失败")
+        setting = client.extract_data() or {}
+        print(f"  [OK] 配送设置: {json.dumps(setting, ensure_ascii=False)[:100]}")
+
+
+# ============================================================
+# 商家 — 财务管理 (SellerFund / PayAccount / Withdraw)
+# ============================================================
+class TestSellerFinance:
+
+    def test_111_fund_summary(self, client, seller_token):
+        """资金概览"""
+        resp = client.get("/agri/seller/finance/overview/summary")
+        client.assert_ok("查询资金概览失败")
+        summary = client.extract_data() or {}
+        print(f"  [OK] 商家资金概览: {json.dumps(summary, ensure_ascii=False)[:100]}")
+
+    def test_112_fund_logs(self, client, seller_token):
+        """资金流水"""
+        resp = client.get("/agri/seller/finance/overview/logs")
+        client.assert_ok("查询资金流水失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 资金流水 total={total}")
+
+    def test_113_pay_account_list(self, client, seller_token):
+        """收款账户列表"""
+        resp = client.get("/agri/seller/finance/payAccount/list")
+        client.assert_ok("查询收款账户失败")
+        accounts = client.extract_data() or []
+        print(f"  [OK] 收款账户 count={len(accounts) if isinstance(accounts, list) else 0}")
+
+    def test_114_pay_account_options(self, client, seller_token):
+        """收款账户选项"""
+        resp = client.get("/agri/seller/finance/payAccount/options")
+        client.assert_ok("查询账户选项失败")
+        opts = client.extract_data() or []
+        print(f"  [OK] 收款账户选项正常")
+
+    def test_115_withdraw_balance(self, client, seller_token):
+        """提现余额"""
+        resp = client.get("/agri/seller/finance/withdraw/balance")
+        client.assert_ok("查询提现余额失败")
+        balance = client.extract_data() or {}
+        print(f"  [OK] 提现余额: {json.dumps(balance, ensure_ascii=False)[:80]}")
+
+    def test_116_withdraw_list(self, client, seller_token):
+        """提现记录"""
+        resp = client.get("/agri/seller/finance/withdraw/list")
+        client.assert_ok("查询提现记录失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 提现记录 total={total}")
+
+
+# ============================================================
+# 商家 — 库存管理 (5个StockController)
+# ============================================================
+class TestSellerStock:
+
+    def test_117_stock_query_list(self, client, seller_token):
+        """库存查询"""
+        resp = client.get("/agri/seller/stock/query/list")
+        client.assert_ok("查询库存失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 库存查询 total={total}")
+
+    def test_118_stock_inbound_list(self, client, seller_token):
+        """入库记录"""
+        resp = client.get("/agri/seller/stock/inbound/list")
+        client.assert_ok("查询入库记录失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 入库记录 total={total}")
+
+    def test_119_stock_outbound_list(self, client, seller_token):
+        """出库记录"""
+        resp = client.get("/agri/seller/stock/outbound/list")
+        client.assert_ok("查询出库记录失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 出库记录 total={total}")
+
+    def test_120_stock_adjust_list(self, client, seller_token):
+        """库存调整记录"""
+        resp = client.get("/agri/seller/stock/adjust/list")
+        client.assert_ok("查询库存调整失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 库存调整 total={total}")
+
+    def test_121_stock_log_list(self, client, seller_token):
+        """库存流水日志"""
+        resp = client.get("/agri/seller/stock/log/list")
+        client.assert_ok("查询库存日志失败")
+        data = client.extract_data() or {}
+        total = data.get("total", 0) if isinstance(data, dict) else 0
+        print(f"  [OK] 库存日志 total={total}")
+
+    def test_122_stock_inbound_detail(self, client, seller_token):
+        """入库详情"""
+        resp = client.get("/agri/seller/stock/inbound/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无入库记录")
+        iid = rows[0].get("inboundId")
+        resp = client.get(f"/agri/seller/stock/inbound/{iid}")
+        client.assert_ok("查询入库详情失败")
+        print(f"  [OK] 入库详情 inboundId={iid}")
+
+    def test_123_stock_goods_logs(self, client, seller_token):
+        """商品库存流水"""
+        resp = client.get("/agri/seller/stock/query/list", params={"pageSize": 1})
+        data = client.assert_ok()
+        rows = (data.get("data") or {}).get("rows") or []
+        if not rows:
+            pytest.skip("无库存数据")
+        gid = rows[0].get("goodsId")
+        resp = client.get(f"/agri/seller/stock/query/{gid}/logs")
+        client.assert_ok("查询商品流水失败")
+        print(f"  [OK] 商品库存流水 goodsId={gid}")
+
+
+# ============================================================
+# 商家 — 微信支付配置 (SellerShopWechatPayController)
+# ============================================================
+class TestSellerWechat:
+
+    def test_124_wechat_pay_get(self, client, seller_token):
+        """商家微信支付配置"""
+        resp = client.get("/agri/seller/wechat-pay")
+        client.assert_ok("查询支付配置失败")
+        config = client.extract_data() or {}
+        print(f"  [OK] 商家支付配置: {json.dumps(config, ensure_ascii=False)[:100]}")