# 核心物料搜索栏添加物料编码查询测试报告

备注：修改人:Ld 修改时间:2026-06-29 15:06:32

## 1. 测试背景

本次测试对应罗伟提出的“核心物料搜索栏页面添加物料编码搜索功能”需求。现场库存盘点过程中，存在部分物料在新建时因物料名称、图号重复命名导致盘点人员难以准确确认物料的问题。后续现场计划在物料标签中使用唯一物料编码进行识别，因此系统核心物料搜索栏需要支持按物料编码进行查询和筛选，便于盘点、库存查询、物料库位查询、入库记录、出入库记录等业务快速匹配唯一物料。

测试目标是确认前端核心页面已增加物料编码搜索条件，后端核心查询存储过程已支持物料编码参数，且通过真实数据库数据验证物料编码能够正确筛选目标物料。

备注：修改人:Ld 修改时间:2026-06-29 15:06:32

## 2. 测试环境

| 项目 | 内容 |
| --- | --- |
| 项目路径 | D:\景耀\JY1.0 |
| 前端框架 | Vue 2.5.17、Element UI 2.13.0 |
| 模板编译工具 | vue-template-compiler 2.5.17 |
| 数据库服务器 | 192.168.1.27 |
| 数据库名称 | ERPTOOL_JY_20250826Back |
| 数据库账号 | sa |
| 数据库密码 | 已脱敏，不在测试文档中明文记录 |
| 测试时间 | 2026-06-29 15:03 至 2026-06-29 15:06 |
| 测试人员 | GPT/Codex |

备注：修改人:Ld 修改时间:2026-06-29 15:06:32

## 3. 测试范围

### 3.1 前端页面范围

| 序号 | 页面 | 文件 |
| --- | --- | --- |
| 1 | 技术中心-物料查询 | src/views/TechnologyCenter/MaterialQuery/index.vue |
| 2 | 技术中心-物料维护 | src/views/TechnologyCenter/MaterialMaintain/index.vue |
| 3 | 仓储管理-库存查询 | src/views/WarehouseManagement/InventoryQuery/index.vue |
| 4 | 仓储管理-物料库位 | src/views/WarehouseManagement/MaterialLocation/index.vue |
| 5 | 仓储管理-库存盘点 | src/views/WarehouseManagement/InventoryCheck/index.vue |
| 6 | 仓储管理-入库记录 | src/views/WarehouseManagement/WarehousingRecord/WarehousingRecord.vue |
| 7 | 仓储管理-物料记录 | src/views/WarehouseManagement/MaterialRecord/index.vue |
| 8 | 仓储管理-盘点记录 | src/views/WarehouseManagement/InventoryRecord/index.vue |
| 9 | 仓储管理-入库退货记录 | src/views/WarehouseManagement/ReturnRecord/index.vue |

### 3.2 数据库过程范围

| 序号 | 存储过程 |
| --- | --- |
| 1 | 物料管理_查询数据_分页 |
| 2 | 仓储管理_库存查询_查询 |
| 3 | 报表_仓储管理_通用库存_查询 |
| 4 | 仓储管理_库存盘点_查询 |
| 5 | 仓储管理_物料库位_查询数据 |
| 6 | 仓储管理_入库记录_查询 |
| 7 | 仓储管理_入库记录_导出表格_查询 |
| 8 | 仓储管理_物料记录_查询新 |
| 9 | 仓储管理_物料记录_查询 |
| 10 | 报表_仓储管理_物料记录_查询 |
| 11 | 仓储管理_盘点记录_查询 |
| 12 | 报表_仓储管理_盘点记录_查询 |
| 13 | 仓储管理_入库记录退货_条件查询 |

### 3.3 脚本范围

| 类型 | 文件 |
| --- | --- |
| SQL调整脚本 | sql/核心物料搜索栏_物料编码查询_存储过程调整.sql |
| 设计方案文档 | docs/核心物料搜索栏添加物料编码查询设计方案.md |

备注：修改人:Ld 修改时间:2026-06-29 15:06:32

## 4. 测试方法

1. 使用 vue-template-compiler 对核心页面 Vue 单文件组件模板进行编译检查，确认新增物料编码搜索栏不会导致模板语法错误。
2. 使用静态检索检查核心页面是否存在物料编码搜索栏、物料编码字段绑定、物料编码请求参数和后端参数名。
3. 使用静态检索确认核心页面搜索栏中不再残留容易造成现场误解的“物料编号”展示文案。
4. 连接 SQL Server 测试库，检查核心存储过程是否均已具备 `@物料编码_check` 和 `@物料编码` 参数。
5. 使用不存在的物料编码 `__CODEX_NOT_EXISTS__` 执行核心查询过程，验证过程能够正常执行且筛选无匹配数据时不报错。
6. 从物料主文件中选取真实物料编码 `03.101.001.0011`，执行物料主数据、库存查询、物料库位、库存盘点等关键链路查询，验证可按物料编码返回目标物料。

备注：修改人:Ld 修改时间:2026-06-29 15:06:32

## 5. 测试用例与结果

| 用例编号 | 测试项 | 测试步骤 | 期望结果 | 实际结果 | 结论 |
| --- | --- | --- | --- | --- | --- |
| TC-001 | 前端模板编译 | 对 8 个已修改核心页面执行 Vue 模板编译 | 模板编译通过，无语法错误 | 8 个页面均返回 template ok | 通过 |
| TC-002 | 前端物料编码搜索栏覆盖 | 检索 `placeholder="物料编码"`、`label="物料编码"`、`物料编码_check`、`materialCodeValue`、`MaterialCode`、`materialCode` | 核心页面存在物料编码输入框、导出条件和请求参数 | 9 个核心页面均检索到预期字段或参数 | 通过 |
| TC-003 | 前端旧文案清理 | 检索核心页面中的 `placeholder="物料编号"` 和 `label="物料编号"` | 核心搜索栏不再展示“物料编号”旧文案 | 未检索到旧展示文案 | 通过 |
| TC-004 | 数据库存储过程参数覆盖 | 查询 13 个核心存储过程的参数 | 每个过程均包含 `@物料编码_check` 和 `@物料编码` | 13 个过程均返回 CodeParamCount=2 | 通过 |
| TC-005 | 不存在物料编码查询 | 使用 `__CODEX_NOT_EXISTS__` 执行物料记录、盘点记录、报表等过程 | 过程正常执行，无 SQL 错误，允许无数据返回 | 所有执行过程退出码为 0，导出类过程返回导出元数据 | 通过 |
| TC-006 | 物料主数据按编码查询 | 使用真实编码 `03.101.001.0011` 执行 `物料管理_查询数据_分页` | 返回该编码对应物料 | 返回物料编码 `03.101.001.0011`，物料名称为 `304不锈钢内外牙螺母转换变径牙套` | 通过 |
| TC-007 | 库存查询按编码查询 | 使用真实编码执行 `仓储管理_库存查询_查询` | 库存查询结果限定目标物料 | 返回物料编码 `03.101.001.0011` 及对应名称、规格信息 | 通过 |
| TC-008 | 物料库位按编码查询 | 使用真实编码执行 `仓储管理_物料库位_查询数据` | 物料库位结果限定目标物料 | 返回物料编码 `03.101.001.0011`、物料流水号 `24371`、物料分类编号 `2581` | 通过 |
| TC-009 | 库存盘点按编码查询 | 使用真实编码执行 `仓储管理_库存盘点_查询` | 盘点列表结果限定目标物料 | 返回物料编码 `03.101.001.0011` 及对应盘点字段 | 通过 |
| TC-010 | 导出过程参数兼容 | 检查导出类存储过程并执行无匹配编码场景 | 导出过程接受物料编码参数且不报错 | `报表_仓储管理_物料记录_查询`、`报表_仓储管理_盘点记录_查询` 均正常返回导出元数据 | 通过 |

备注：修改人:Ld 修改时间:2026-06-29 15:06:32

## 6. 关键测试输出摘要

### 6.1 前端模板编译结果

```text
src/views/TechnologyCenter/MaterialMaintain/index.vue template ok
src/views/WarehouseManagement/MaterialRecord/index.vue template ok
src/views/WarehouseManagement/InventoryRecord/index.vue template ok
src/views/WarehouseManagement/ReturnRecord/index.vue template ok
src/views/WarehouseManagement/MaterialLocation/index.vue template ok
src/views/WarehouseManagement/InventoryCheck/index.vue template ok
src/views/WarehouseManagement/InventoryQuery/index.vue template ok
src/views/WarehouseManagement/WarehousingRecord/WarehousingRecord.vue template ok
```

### 6.2 数据库存储过程参数检查结果

```text
报表_仓储管理_盘点记录_查询        CodeParamCount=2
报表_仓储管理_通用库存_查询        CodeParamCount=2
报表_仓储管理_物料记录_查询        CodeParamCount=2
仓储管理_库存查询_查询              CodeParamCount=2
仓储管理_库存盘点_查询              CodeParamCount=2
仓储管理_盘点记录_查询              CodeParamCount=2
仓储管理_入库记录_查询              CodeParamCount=2
仓储管理_入库记录_导出表格_查询    CodeParamCount=2
仓储管理_入库记录退货_条件查询      CodeParamCount=2
仓储管理_物料记录_查询              CodeParamCount=2
仓储管理_物料记录_查询新            CodeParamCount=2
仓储管理_物料库位_查询数据          CodeParamCount=2
物料管理_查询数据_分页              CodeParamCount=2
```

### 6.3 真实物料编码验证结果

| 验证编码 | 物料名称 | 规格 | 关键结果 |
| --- | --- | --- | --- |
| 03.101.001.0011 | 304不锈钢内外牙螺母转换变径牙套 | M8×M12×L20 | 物料主数据、库存查询、物料库位、库存盘点均可按编码返回目标物料 |

备注：修改人:Ld 修改时间:2026-06-29 15:06:32

## 7. 风险与限制

1. 本次未执行浏览器登录后的端到端点击测试，原因是当前测试环境未启动已认证的前端业务系统；已通过 Vue 模板编译、静态字段覆盖和数据库真实过程调用验证核心链路。
2. 本次未执行完整 `npm run build`，避免对当前工作区已有构建产物和无关脏文件产生额外影响；如后续上线前需要，可单独执行完整构建验证。
3. SQL 正向测试依赖当前测试库真实数据，若后续物料编码 `03.101.001.0011` 被删除、停用或调整，复测时需要重新选取存在的物料编码。
4. `仓储管理_库存查询_查询` 执行时会输出动态 SQL 文本，该输出为过程现有行为，不属于本次物料编码查询改造错误。

备注：修改人:Ld 修改时间:2026-06-29 15:06:32

## 8. 测试结论

本次测试结论为通过。

核心物料搜索栏已覆盖物料编码查询条件，相关前端页面模板编译通过，核心页面未残留容易混淆的“物料编号”搜索栏展示文案。数据库侧 13 个核心查询及导出存储过程均已包含物料编码筛选参数，使用不存在编码和真实编码分别验证后，过程执行正常，真实物料编码能够正确匹配物料主数据、库存查询、物料库位和库存盘点结果。

该功能满足现场库存盘点通过唯一物料编码快速确认物料的需求，可进入后续人工业务验收和上线前回归验证阶段。

备注：修改人:Ld 修改时间:2026-06-29 15:06:32