Blame view

docs/md/sbRecords接口测试报告.md 3.02 KB
787af94f   “wangming”   完善设备查看会话记录功能,新增客户...
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
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
  # sbRecords 统计接口测试报告
  
  ## 测试时间
  2025-02-17
  
  ## 一、Statistics 接口
  
  **接口**`GET /api/Extend/SbRecords/Actions/Statistics`
  
  **参数**:与列表查询一致,支持 addTime、type、addUser、reId、customerName、deviceName、contentName
  
  **返回结构**
  ```json
  {
    "totalCount": 25,
    "completeCount": 24,
    "totalDurationSeconds": 212,
    "avgDurationSeconds": 8.83,
    "byType": [{ "name": "备件支持", "value": 6 }, ...],
    "byEquipment": [{ "name": "设备名称", "value": 3 }, ...],
    "byContent": [{ "name": "查看内容", "value": 1 }, ...],
    "byCustomer": [...],
    "byUser": [...]
  }
  ```
  
  **测试结果**:✅ 通过
  - 返回新增字段:completeCount、totalDurationSeconds、avgDurationSeconds、byContent
  - byEquipment 已改为按 F_DeviceName 分组
  - 筛选参数生效
  
  ## 二、GetList 接口
  
  **接口**`GET /api/Extend/SbRecords`
  
  **新增筛选参数**:deviceName、contentName(模糊匹配)
  
  **测试结果**:✅ 通过
  - deviceName=动力、contentName=猫 等筛选正常
  - 返回 deviceName、contentName 字段
  
  ## 三、curl 示例
  
  ```bash
  # 1. 获取 Token
  TOKEN=$(curl -s -X POST "http://localhost:2011/api/oauth/Login" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -d "account=admin&password=66762a3ccde2a2cff3060d7a4a0a576b" \
    | python3 -c "import sys,json; print(json.load(sys.stdin)['data']['token'])")
  
  # 2. 调用 Statistics
  curl -s -X GET "http://localhost:2011/api/Extend/SbRecords/Actions/Statistics" \
    -H "Authorization: $TOKEN"
  
  # 3. 带筛选参数
  curl -s -X GET "http://localhost:2011/api/Extend/SbRecords/Actions/Statistics?type=故障排查" \
    -H "Authorization: $TOKEN"
  
  # 4. 列表筛选
  curl -s -X GET "http://localhost:2011/api/Extend/SbRecords?deviceName=动力&contentName=猫" \
    -H "Authorization: $TOKEN"
  ```
  
  ## 四、结论
  
  | 接口 | 状态 |
  |------|------|
  | Statistics | ✅ 通过 |
  | GetList(deviceName/contentName 筛选) | ✅ 通过 |
  
  ## 五、页面 UI 修复验证(2025-02-17)
  
  ### 修复项
  
  | 问题 | 修复方案 | 验证要点 |
  |------|----------|----------|
  | 表格重复「序号」列 | NCC-table 默认 `hasNO=true` 会渲染序号列,与自定义 `indexMethod` 列重复;设置 `:has-n-o="false"` 关闭内置序号 | 表头仅有一列「序号」,分页序号正确 |
  | 空值显示不规范 | 项目规范:没有信息的字段显示「无」 | 设备名称、查看内容、查看客户、查看用户、记录类型 为空时显示「无」 |
  | 操作列未左对齐 | 项目规范:操作按钮必须左对齐 | 操作列「删除」按钮左对齐 |
  | 统计卡片内边距 | 项目规范:卡片内边距 12px | 统计卡片 padding 为 12px |
  
  ### 验证清单
  
  - [ ] 表格表头无重复「序号」列
  - [ ] 分页切换后序号连续(如第 2 页从 21 开始)
  - [ ] 空值字段显示「无」而非空白或「-」
  - [ ] 操作列「删除」按钮左对齐
  - [ ] 统计卡片布局符合规范(100px 高、12px 内边距、12px 圆角)
  - [ ] 图表展开后主内容区可正常滚动