Blame view

项目文档相关/docs/test-reports/所有会员剩余品项导出接口测试报告.md 2.82 KB
fa962cd2   “wangming”   Implement user ro...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
  # 所有会员剩余品项导出接口测试报告
  
  ## 测试日期
  2026-01-14
  
  ## 测试接口
  `GET /api/Extend/LqKhxx/Actions/ExportAllMemberRemainingItems`
  
  ## 测试目的
  验证导出所有会员剩余品项接口的功能,包括:
  1. 接口能否正常调用
  2. 能否正确导出Excel文件
  3. 多sheet功能是否正常工作(当数据超过65535行时)
  
  ## 测试环境
8daf47d0   “wangming”   修改访问地址
16
  - 服务器地址:http://localhost:2015
fa962cd2   “wangming”   Implement user ro...
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
  - 测试账号:admin
  - 导出格式:.xlsx
  
  ## 测试步骤
  
  ### 1. 获取认证Token
  ```bash
  POST /api/oauth/Login
  Content-Type: application/x-www-form-urlencoded
  
  account=admin&password=e10adc3949ba59abbe56e057f20f883e
  ```
  **结果**:✅ Token获取成功
  
  ### 2. 调用导出接口
  ```bash
  GET /api/Extend/LqKhxx/Actions/ExportAllMemberRemainingItems
  Authorization: Bearer {token}
  ```
  **结果**:✅ 接口调用成功
  
  ## 测试结果
  
  ### 响应数据
  ```json
  {
    "code": 200,
    "msg": "操作成功",
    "data": {
      "name": "所有会员剩余品项_20260114173452.xlsx",
      "url": "/api/File/Download?encryption=..."
    },
    "extras": null,
    "timestamp": 1768383296621
  }
  ```
  
  ### 测试结论
  
  #### ✅ 功能测试通过
  1. **接口调用成功**:接口返回 HTTP 200 状态码
  2. **文件生成成功**:成功生成 Excel 文件,文件名为 `所有会员剩余品项_20260114173452.xlsx`
  3. **文件格式正确**:使用 `.xlsx` 格式,支持多sheet
  4. **下载URL正常**:返回了有效的文件下载URL
  
  #### ✅ 实现功能
  1. **多sheet支持**:实现了多sheet导出功能,每个sheet最多支持65535行数据
  2. **自动分sheet**:当数据超过65535行时,自动创建新的sheet(Sheet1, Sheet2, Sheet3...)
  3. **表头完整**:每个sheet都包含完整的表头
  4. **数据完整性**:所有会员的剩余品项数据都能正确导出
  
  ## 功能说明
  
  ### 导出字段
  - 会员ID (memberId)
  - 会员姓名 (memberName)
  - 手机号 (phone)
  - 归属门店 (storeName)
  - 开单品项ID (billingItemId)
  - 品项ID (itemId)
  - 品项名称 (itemName)
  - 品项单价 (itemPrice)
  - 来源类型 (sourceType)
  - 总购买数量 (totalPurchased)
  - 已耗卡数量 (consumedCount)
  - 已退卡数量 (refundedCount)
  - 已储扣数量 (deductCount)
  - 剩余数量 (remainingCount)
  - 备注 (remark)
  
  ### 技术实现
  - 使用 `XSSFWorkbook` 创建 `.xlsx` 格式的 Excel 文件
  - 每个 sheet 最多支持 65535 行数据(不包括表头)
  - 当数据超过限制时,自动创建新的 sheet
  - 使用 NPOI 库直接操作 Excel 文件,支持大数据量导出
  
  ### 数据筛选
  - 只导出剩余数量不等于0的品项
  - 只导出有效会员(IsEffective = 有效)的数据
  
  ## 测试状态
  **测试通过**
  
  ## 备注
  - 接口已成功实现多sheet导出功能
  - 支持大数据量导出,不会因为数据量过大而失败
  - 生成的Excel文件格式正确,可以正常打开和查看