功能测试报告_投资系统新模板按表头解析与审核基准缺失保护_2026-09-21

一、功能说明

#	功能	说明
1	投资系统导出按表头定位解析	用户 2026-09-21 把「与投资系统比对的明细表」换成了新模板《2026年8月投资系统项目明细》（多一列「项目所处阶段」、少一列「自年初累计」，整体右移）。原实现写死 8 列列位，遇新模板必然报「表头与系统模板不一致」。本次改为按表头关键字实时定位列，兼容新旧两种模板
2	审核比对「基准缺失」保护	新模板没有「自年初累计」列 → `investment_system.year_cum` 为 NULL。原实现用 `nvl()` 把 NULL 当 0，会把 100+ 个项目全部误判为「差异」。改为：基准为 NULL 时跳过该字段比对并记 WARN 日志
3	十堰物流汇总表源文件清理（数据处置，非代码）	按用户 2026-09-21「清除掉」的要求，删除该文件里的武汉段（27 个项目）与黄石段（4 个项目），只保留十堰段

改动文件：
- traffic-audit-server/src/main/java/com/trafficaudit/dataimport/service/DataImportService.java（importInvestmentSystem 重写 + 新增 findColByKeywords / headerText）
- traffic-audit-server/src/main/java/com/trafficaudit/auditengine/service/AuditEngineService.java（checkInvestCrossDiff 基准缺失保护）

二、测试环境

后端 Spring Boot 8090，重启加载新代码：backend.log 2026-09-21 10:20:30 Started TrafficAuditApplication；前端 8080
数据库 MySQL 3308 / traffic_audit
新旧模板列结构对照（xlrd 读取）：

列	老模板《模板_查询结果(投资系统-客运+物流 2026.7).xls》	新模板《2026年8月投资系统项目明细.xls》
1	行号	行号
2	单位	投资项目
3	时期	时期
4	计划总投资	项目所处阶段（新增）
5	自开始累计	计划总投资
6	本年计划投资	本年计划投资
7	自年初累计	自开始建设至本年（月）底-累计完成投资
8	当月完成投资	当月完成投资
—	—	无「自年初累计」列

三、用例表

#	用例	输入	预期	实际	结论
T01	十堰源文件清理-结构	原《湖北省十堰…汇总表（月报）（2026年8月）.xls》	只保留十堰段，武汉/黄石段消失	行数 86 → 33；十堰段第 10 行起、7 个项目、合计行保留；武汉/黄石段 0 行	通过
T02	十堰源文件清理-备份	同上	原件先备份到输出目录	`docs/投资/输出/源文件备份/…_原始含武汉黄石_20260921.xls`（108544 字节）	通过
T03	8 月物流重导（正向）	`POST /api/import/investCityBatch?period=2026-08&category=物流园区`	十堰只出 7 条，不再产生武汉/黄石项目	total=97、success=97、fail=0；十堰文件 ok=7（改前 38）；武汉/黄石 0 条	通过
T04	重导后库核对	同上	项目/月度数不增不减	`investment_project` = 152、2026-08 月度数 = 136、十堰物流 = 7（与清理前一致）	通过
T05	新模板导入（正向）	新模板 129 行数据	全部入库	返回「投资系统导出导入成功, 共 129 条记录」；`investment_system` 2026-08 = 129、2026-07 = 148 不受影响	通过
T06	字段映射抽查	同上	逐列等于源文件	湖北省综合运输服务站及候车亭：12721.5 / 10306.2 / 10316.1 / 93.5；汉口客运中心：315700 / 30000 / 178235.4 / 550	通过
T07	缺列处理（负向）	同上（无「自年初累计」列）	year_cum 留空，不得把「自开始建设…」列误当自年初累计	129 行 year_cum 全为 NULL（未错填）	通过
T08	老模板兼容（回归）	老格式表头	仍能导入	老文件已不在输入目录；改为按表头定位后，老模板 8 列关键字（单位/计划总投资/自开始建设/本年计划投资/自年初/当月完成投资）全部可命中（代码审查）；存量 2026-07 = 148 行未受影响	通过（静态）
T09	审核基准缺失保护	`POST /api/audit/execute?period=2026-08&reportType=INVEST`	自年初累计规则不再产生误报	RULE_I002 结果 0 条；日志出现「投资比对跳过（投资系统基准缺失）：rule=RULE_I002 … field=自年初累计」	通过
T10	审核其它规则未受影响	同上	正常出结果	RULE_I001（自开始建设累计）2 条、RULE_I003（本月完成）1 条、RULE_I004（存在性）25 条，合计 28 条	通过
T11	审核幂等	同上重复执行	只清 INVEST 旧结果、不重复堆积	两次执行结果条数一致（28 条）	通过

四、发现的问题与处置

#	问题	处置
P1	新模板多出「项目所处阶段」列，但库表 `investment_system` 没有对应字段	本次不落库。若业务要比对「建设阶段」，需加列并同步 `docs/init.sql`、`docs/database.md`（按项目规矩三处同步）
P2	新模板没有「自年初累计」列 → 该维度无法比对	已改为「基准缺失即跳过 + WARN 日志」，不产生误报。若业务仍要比对自年初累计，需新模板补回该列（或确认改用「自开始建设累计」口径）
P3	老模板文件 `模板_查询结果(投资系统-客运+物流 2026.7).xls` 已不在 `docs/投资/输入/`（被用户替换）	2026-07 的 148 行为老口径存量数据，保留不动；后续月份统一用新模板
P4	审核新增 25 条「投资系统导出中不存在」	多为乡镇综合运输服务站与部分物流项目（如桂花镇/马桥镇/高桥镇综合运输服务站、郑万高铁巴东综合客运枢纽、潜江传化公路港项目…），属投资系统未收录的客观差异，供业务判断，非本次改动引入
P5	源文件为 `.xls` 且含合并单元格	用 Excel 16.0 COM 整行删除（第 11~63 行），保存后 `xlrd` 复核行数 86 → 33；脚本结束清理了本次新建的孤儿 EXCEL 进程

五、结论

新模板《2026年8月投资系统项目明细》已可正常导入（129 条），字段逐列对齐，缺列不误填；
审核不再因「基准缺失」成片误报（RULE_I002 由 100+ 条降为 0 条），其余三条 INVEST 规则结果正常（28 条）；
十堰物流汇总表源文件已清除武汉/黄石段（备份留档），重导验证：十堰只出 7 条，库内项目/月度数不增不减，**该残留问题闭环**。

测试人：Codex（AI）　测试日期：2026-09-21