客户资料导出接口字段调整测试报告.md 4.38 KB

Edit Raw Blame History


客户资料导出接口字段调整测试报告
测试日期
2025-01-13
测试接口

接口路径: /api/Extend/LqKhxx/Actions/ExportOptimized
请求方式: GET
接口描述: 客户资料导出（优化版）

修改内容
1. DTO字段修改
文件: netcore/src/Modularity/Extend/NCC.Extend.Entitys/Dto/LqKhxx/LqKhxxExportOutput.cs
删除的字段

khmqgsName (客户目前归属名称)
khjd (客户阶段)
khxf (客户消费)
xfpc (消费频次)

新增的字段

mainHealthUserName (主健康师名称)
subHealthUserName (副健康师名称)
expandUserName (拓客人员名称)
consumeLevelName (消费等级名称，格式：D、C、B、A、A+、A++)

保留的字段

khlxName (客户类型名称) - 保留并继续使用

2. 接口逻辑修改
文件: netcore/src/Modularity/Extend/NCC.Extend/LqKhxxService.cs
修改点1: 批量查询主健康师信息

从 BASE_USER 表批量查询主健康师的真实姓名
使用字典缓存查询结果，提高性能

修改点2: 批量查询副健康师信息

从 BASE_USER 表批量查询副健康师的真实姓名
使用字典缓存查询结果，提高性能

修改点3: 批量查询拓客人员信息

从 BASE_USER 表批量查询拓客人员的真实姓名
使用字典缓存查询结果，提高性能

修改点4: 消费等级转换

使用 MemberInfoUpdateConfig.ConsumeLevelNames 将消费等级编号转换为名称
转换规则：


0 → D
1 → C
2 → B
3 → A
4 → A+
5 → A++


修改点5: 导出字段列表更新

删除字段映射：khmqgsName、khjd、khxf、xfpc
新增字段映射：mainHealthUserName、subHealthUserName、expandUserName、consumeLevelName
字段标题调整：


客户类型名称 → 客户类型
新增：主健康师、副健康师、拓客人员、消费等级


测试结果
测试环境

测试时间: 2025-01-13 12:28:46
服务地址: http://localhost:2011
测试用户: admin

接口调用测试
测试用例1: 基本导出功能

请求: GET /api/Extend/LqKhxx/Actions/ExportOptimized?currentPage=1&pageSize=10
状态码: 200
响应结果: ✅ 成功
返回数据:
json
{
"code": 200,
"msg": "操作成功",
"data": {
  "name": "客户资料导出_20260113122846.xls",
  "url": "/api/File/Download?encryption=..."
}
}


功能验证
✅ 接口调用成功: 接口可以正常调用并生成导出文件
✅ 文件生成成功: Excel文件已成功生成
✅ 代码编译通过: 无编译错误
✅ 运行时正常: 服务运行正常，无运行时错误
待验证项
由于无法直接查看Excel文件内容，以下项目需要手动验证：


字段正确性验证


[ ] 确认导出的Excel包含新增字段：客户类型、主健康师、副健康师、拓客人员、消费等级
[ ] 确认导出的Excel不包含删除字段：客户目前归属名称、客户阶段、客户消费、消费频次
[ ] 确认字段顺序正确

数据正确性验证


[ ] 确认客户类型显示正确（显示中文名称，如"普通会员"）
[ ] 确认主健康师显示正确（显示真实姓名）
[ ] 确认副健康师显示正确（显示真实姓名）
[ ] 确认拓客人员显示正确（显示真实姓名）
[ ] 确认消费等级显示正确（显示D、C、B、A、A+、A++格式）

边界情况验证


[ ] 测试主健康师为空的情况
[ ] 测试副健康师为空的情况
[ ] 测试拓客人员为空的情况
[ ] 测试消费等级为0的情况（应显示"D"）


测试脚本
测试脚本位置: scripts/test/test_customer_export_api.sh

使用方法:
./scripts/test/test_customer_export_api.sh

总结
✅ 代码修改完成: 所有代码修改已完成
✅ 编译通过: 代码编译无错误
✅ 接口测试通过: 接口可以正常调用并生成文件
⏳ 数据验证待完成: 需要手动下载Excel文件验证字段和数据正确性
建议

建议下载生成的Excel文件，手动验证字段和数据是否正确
建议测试不同数据场景（有/无健康师、不同消费等级等）
建议验证字段顺序是否符合业务需求