# Excel 标准导入功能验收记录

验收日期：2026-07-22  
验收数据库：`cnc_relia_eval_db`  
数据库迁移：`20260722_02 (head)`

## 1. 自动验收结果

|项目|期望|实际结果|结论|
|---|---|---|---|
|14 个分项正确样例|全部零错误|14/14 零错误|通过|
|14 个分项错误样例|每份至少发现一个错误|14/14 均发现错误|通过|
|全量正确样例预检|状态 `validated`，错误 0|14 张表、14 行、错误 0|通过|
|全量正确样例写入|整批可写入|写入 14、跳过 0|通过|
|全量错误样例预检|状态 `validation_failed`|发现 39 个错误、1 个非阻断提示|通过|
|错误样例业务写入|不得写入|导入数 0|通过|
|事务回滚验证|验收数据不污染正式数据库|测试事务整体回滚|通过|
|前端单元测试|全部通过|2/2 通过|通过|
|前端生产构建|构建成功|Vite 构建成功|通过|
|新增后端代码检查|无 Ruff/编译错误|通过|通过|

## 2. 典型错误覆盖

错误样例覆盖：必填为空、代码含空格、非法设备状态、引用不存在、设备类型不匹配、设备/子系统/部件从属错误、占位符、正整数错误、时间格式错误、时间倒序、非法“是/否”、实验项目不属于对象、更换件主从不一致、故障外部编号重复风险等。

## 3. 数据安全说明

验收使用真实数据库结构执行了完整预检和写入逻辑，但所有测试写入都处于独立事务中，验证完成后执行整体回滚。测试设备、字典、实验项目和故障记录未保留在正式业务数据中；新增的数据库表结构迁移正常保留。

## 4. 人工界面验收步骤

1. 使用管理员账户进入“Excel 导入”。
2. 下载标准模板，确认含“填写说明”和 14 张空白数据工作表。
3. 上传 `04_全量正确验收样例.xlsx`，应显示零错误并启用“确认整批导入”。如不希望正式写入验收数据，不点击提交。
4. 上传 `05_全量错误验收样例.xlsx`，应禁用提交按钮并显示逐格问题。
5. 下载问题报告，检查每项均包含工作表、行号、列名、错误代码、问题说明和原始值。
6. 分别抽查 `验收样例` 中任意一对正确/错误文件，确认正确文件通过、错误文件被阻断。
