# 保质期接口集成测试报告（2026-03-04）

## 范围
- 登录获取 Token（`/api/v1/auth/login`）
- 物品接口：创建、列表、汇总、更新、状态标记、删除
- 设置接口：获取与更新

## 测试资产
- Postman Collection: `docs/expiry/tests/postman/expiry.postman_collection.json`
- Postman Environment: `docs/expiry/tests/postman/expiry.postman_environment.json`
- 一键脚本: `scripts/expiry/run_integration_tests.sh`

## 执行方式
```bash
# 方式一：已有 token
BASE_URL=http://127.0.0.1:8080 TOKEN=<session_key> scripts/expiry/run_integration_tests.sh

# 方式二：通过 wx.login 的 code 登录
BASE_URL=http://127.0.0.1:8080 MINI_PROGRAM_ID=1 WX_CODE=<wx_code> scripts/expiry/run_integration_tests.sh
```

## 断言规则
- 登录接口：`HTTP 200 && code == 200`
- 业务接口：`HTTP 200 && code == 0`
- 错误接口：预期返回 4xx/5xx 与对应 message

## 性能测试建议
脚本内置 `hey` 调用（若系统已安装）：
```bash
hey -n 100 -c 20 -H "Authorization: Bearer <token>" http://127.0.0.1:8080/api/expiry/summary
```

目标：平均响应时间 < 200ms（开发环境仅作参考，生产环境需复测）。