# 2026-04-22 招投标导入页面测试与 AGENTS 规范补充实施记录

## 1. 本次变更

- 更新 `AGENTS.md`，补充“导入页面测试规范”
- 基于真实页面下载模板，生成招投标信息维护导入测试样本并完成页面实测

## 2. 文档落点确认

- 规范更新文件：`/Users/wkc/Desktop/ccdi/ccdi/AGENTS.md`
- 实施记录文件：`/Users/wkc/Desktop/ccdi/ccdi/docs/reports/implementation/2026-04-22-bidding-import-browser-test-and-agents-update-implementation.md`

## 3. 页面测试方式沉淀

- 先启动真实前端页面并进入 `招投标信息维护` 页面，在页面内下载当前导入模板
- 基于页面下载的双 Sheet 模板生成测试文件，不手工重建表头
- 将测试样本按校验维度拆分成多个工作簿，避免多个互斥错误互相覆盖
- 每个测试样本都通过页面“导入”弹窗上传，不走原型页、不绕过页面直接调用导入服务完成主验证
- 每次上传后同时核对页面提示、导入状态、失败记录弹窗、列表总数变化，以及后端日志中的导入任务结果
- 对成功导入的测试数据在测试结束前执行删除回滚，保证列表数据恢复到测试前状态

## 4. 本次覆盖的导入场景

- 空模板上传
- 主信息必填校验
- 主信息工号/金额格式校验
- 主从关系异常：已存在采购事项 ID、供应商有数据但主信息缺失、主信息重复、供应商 Sheet 中采购事项 ID 为空
- 供应商校验：多条中标、重复供应商、供应商名称为空、名称超长、联系人超长、银行账户超长、联系电话非法、统一信用代码非法、是否中标枚举非法
- 缺少供应商 Sheet
- 成功导入
- 成功导入与异常主信息混合
- 页面内查看导入失败记录

## 5. 关键测试结论

- 主信息必填、主信息格式/金额、主从关系异常、供应商校验等页面导入链路均已通过真实页面验证
- “重复供应商”场景单独补充了专用样本后已命中 `采购事项ID[...]存在重复供应商`
- “缺少供应商 Sheet” 当前实现不会报错，而是允许主信息成功导入，导入记录中供应商信息为空
- “成功导入 + 空采购事项ID主信息” 场景中，后端按 `总数 1 / 成功 1 / 失败 0` 处理，说明空采购事项 ID 的主信息行被实现层静默过滤，未触发 `采购事项ID不能为空`
- 因此，`采购事项ID不能为空` 这条校验目前无法通过真实页面导入样本直接命中，需要结合实现修正后再补测

## 6. 生成的测试文件

- 测试文件统一放在 `output/spreadsheet/` 与 `output/playwright/` 下，未纳入 git
- 本次使用的样本包括：
- `bidding_import_empty_template.xlsx`
- `bidding_import_main_required.xlsx`
- `bidding_import_main_numeric.xlsx`
- `bidding_import_structure.xlsx`
- `bidding_import_supplier_validation.xlsx`
- `bidding_import_supplier_duplicate.xlsx`
- `bidding_import_missing_supplier_sheet.xlsx`
- `bidding_import_success_and_gap.xlsx`

## 7. 环境与清理

- 页面测试期间使用真实浏览器会话完成导入、失败记录查看与状态确认
- 本轮成功写入的测试数据 `IMPCOV20260422154511SUP02`、`IMPCOV20260422154511MS01`、`IMPCOV20260422154511OK01` 已全部删除
- 页面本地导入任务缓存已清理
- 刷新真实页面后，列表总数已恢复到 `2004`

## 8. 风险备注

- 测试过程中后端日志出现过 Redis 超时与应用重启记录，个别导入提交存在等待时间偏长现象
- 虽然最终所有目标场景都已完成验证，但后续若继续执行批量页面导入测试，建议优先关注 Redis 连接稳定性
