更新装配、精工车间、技术中心、仓储模块，新增工序工价、生产审核、三楼仓库可视化等功能及文档SQL

2026-07-06 11:21:59 +08:00
parent be0ff91e24
commit 9c1f52078d
43 changed files with 8566 additions and 233 deletions
--- a/docs/零件改制/03-推进台账.md
+++ b/docs/零件改制/03-推进台账.md
@@ -19,11 +19,15 @@
 | 15 | 2026-06-27 | 执行不污染数据的测试并生成测试报告 | `零件改制功能测试报告.md` | eslint 通过；显示不一致数为 0；重复关联数为 0 | 补历史数据或做真实流程验收 |
 | 16 | 2026-06-29 | 修复生产任务查询动态 SQL 别名绑定问题 | `精工车间_生成任务_查询数据` | 将动态条件统一改为 `P.字段名` | 执行数据库过程更新并页面验证 |
 | 17 | 2026-06-29 | 拆分标准化推进文档 | `docs/零件改制/README.md`、`01-06` 文档 | 文档结构完成 | 后续按任务矩阵继续推进 |
+| 18 | 2026-07-01 | 按推荐方案落地改制物料替换显示 | `技术中心_改制订单_发起改制`、`车间生产管理_零件工艺计划_视图`、`PartModificationOrder/index.vue` | 数据库结构验证通过，前端 eslint 通过 | 使用已维护新物料的测试订单做真实发起和入库验证 |
+| 19 | 2026-07-01 | 修复发起改制后零件列表未按改制目标替换显示 | `技术中心_改制订单_零件_查询`、`技术中心_改制订单_发起改制`、`src/views/TechnologyCenter/PartModificationOrder/index.vue`、`sql/零件改制_发起改制_精确基本件.sql` | SQL 抽样验证：组件 4283 已显示 `XT40-205MF-01.02-G`，组件 2652 不再被串件覆盖；前端 eslint 通过 | 页面刷新后由接口回显最新改制目标，继续做真实发起与生产入库闭环验收 |

 ## 当前下一步

-1. 将 `精工车间_生成任务_查询数据` 最新完整 SQL 应用到数据库。
-2. 使用图号 `XT40-07.01` 再次执行查询，确认不再出现 4104 错误。
-3. 使用一条业务允许的测试订单发起真实改制。
-4. 验证生产任务查询、车间派工、MES 待加工显示。
-5. 补齐 3 条历史未回写 `工艺计划流水号` 的改制记录，或确认无需处理。
+1. 使用页面真实发起一条带 `原基本件流水号` 的改制订单。
+2. 验证改制发起页面刷新后只替换被点击的零件行。
+3. 验证生产任务查询、车间派工、MES 待加工显示。
+4. 验证自制件入库是否使用改制物料流水号。
+5. 补齐历史改制记录的 `改制物料流水号` 或确认无需处理。
+
+修改人:Ld 修改时间:2026-07-01 14:46:30;
--- a/docs/零件改制/04-任务矩阵.md
+++ b/docs/零件改制/04-任务矩阵.md
@@ -22,6 +22,8 @@
 | GZ-018 | 改制记录查询页面 | 待开发 | 可按改制订单号、原订单、零件图号查询记录 | 后续新增 |
 | GZ-019 | 历史记录回写处理 | 待确认 | 未回写工艺计划流水号的历史记录明确处理方式 | 当前有 3 条未回写 |
 | GZ-020 | 完整业务流验收 | 待验收 | 使用测试订单完成发起、生产任务、派工、MES、入库验证 | 需业务允许测试数据 |
+| GZ-021 | 改制任务入库链路验证 | 部分通过 | 完成生产后能进入自制件入库查询，且库存入到正确改制物料 | 当前仅验证可进入入库查询，库存物料流水号仍有风险 |
+| GZ-022 | 改制物料流水号支持 | 已完成 | 改制记录保存目标物料流水号，入库使用改制目标物料 | 已加字段、改发起过程、改生产任务视图；历史数据未匹配到新物料 |

 ## 状态说明

@@ -41,4 +43,5 @@
 2. `GZ-020`：选择测试订单跑完整流程。
 3. `GZ-016`、`GZ-017`：验证 MES 和车间派工显示。
 4. `GZ-019`：确认历史未回写记录是否需要补数据。
-5. `GZ-018`：开发改制记录查询页面。
+5. 处理历史改制记录未维护改制物料流水号的问题。
+6. `GZ-018`：开发改制记录查询页面。
--- a/docs/零件改制/05-验收证据.md
+++ b/docs/零件改制/05-验收证据.md
@@ -147,3 +147,170 @@ AND P.操作日期 <= @结束时间
 | MES 待加工页面截图 | 待补充 | 需现场终端或模拟终端截图 |
 | 真实发起改制 job_id/report_id | 暂无 | 当前未通过自动化任务创建真实业务数据 |
 | 完整流程测试报告 | 待补充 | 需业务允许测试数据后生成 |
+
+## 8. 入库链路测试证据
+
+测试报告：
+
+```text
+docs/零件改制/零件改制入库链路测试报告.md
+```
+
+测试方式：
+
+- 使用事务临时将一条改制任务完成数量设置为批次数量。
+- 调用 `仓储管理_自制件入库_查询`。
+- 查询结束后立即 `ROLLBACK TRAN`，未保留业务数据改动。
+
+测试结果：
+
+| 工艺计划流水号 | 订单号 | 零件名称 | 零件图号 | 物料流水号 | 批次数量 | 完成数量 | 入库数量 | 本次入库 | 类型 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| 6591 | BHGZ-202607010011 | 300封油板 | URS3042Z-07-01 | 741 | 1 | 1 | 0 | 1 | 自制件 |
+
+结论：
+
+- 改制任务完成生产后可以进入现有自制件入库查询。
+- 但当前库存入库仍使用原基本件物料流水号，存在入到原物料而非改制目标物料的风险。
+
+后续验收要求：
+
+- 增加并维护 `改制物料流水号` 后，再验证库存是否入到正确改制物料。
+
+## 9. 改制物料流水号修改证据
+
+### 9.1 已完成修改
+
+新增字段：
+
+```sql
+ALTER TABLE dbo.技术中心_改制订单记录
+ADD 改制物料流水号 int NULL;
+```
+
+已修改过程：
+
+```text
+dbo.技术中心_改制订单_发起改制
+```
+
+发起改制时新增逻辑：
+
+```sql
+SELECT TOP 1
+    @改制物料流水号 = 物料流水号
+FROM dbo.库存管理_物料主文件_基本
+WHERE LTRIM(RTRIM(名称)) = LTRIM(RTRIM(@改制零件名称))
+  AND LTRIM(RTRIM(代号)) = LTRIM(RTRIM(@改制零件图号))
+  AND ISNULL(是否禁用, 0) = 0
+ORDER BY 物料流水号 DESC;
+
+IF @改制物料流水号 IS NULL
+BEGIN
+    SELECT '0' AS result, '未找到改制零件对应的新物料，请先维护物料信息' AS msg;
+    RETURN;
+END;
+```
+
+已修改视图：
+
+```text
+dbo.车间生产管理_零件工艺计划_视图
+```
+
+视图已关联：
+
+```sql
+LEFT OUTER JOIN dbo.库存管理_物料主文件_基本 AS 改制物料
+    ON dbo.技术中心_改制订单记录.改制物料流水号 = 改制物料.物料流水号
+```
+
+并让以下字段优先使用改制物料：
+
+```text
+零件名称
+零件图号
+物料流水号
+物料编码
+代号
+货位流水号
+单位
+```
+
+### 9.2 结构验证
+
+执行结果：
+
+| 检查项 | 结果 |
+| --- | --- |
+| 改制物料字段存在 | 1 |
+| 发起过程已包含改制物料 | 1 |
+| 生产任务视图已关联改制物料 | 1 |
+| 发起过程会写入改制物料 | 1 |
+
+### 9.2.1 前端验证
+
+修改文件：
+
+```text
+src/views/TechnologyCenter/PartModificationOrder/index.vue
+```
+
+调整内容：
+
+- 发起改制弹窗打开后，改制零件名称和改制零件图号不再默认填原零件信息。
+- 提交前要求填写已维护的新物料名称和图号。
+- 保留原零件图号和改制零件图号不能相同的校验。
+
+执行命令：
+
+```bash
+npx eslint --ext .vue D:\景耀\JY1.0\src\views\TechnologyCenter\PartModificationOrder\index.vue
+```
+
+结果：
+
+```text
+通过
+```
+
+### 9.3 历史数据验证
+
+执行结果：
+
+| 未删除改制记录数 | 未维护改制物料数 | 已维护改制物料数 |
+| --- | --- | --- |
+| 11 | 11 | 0 |
+
+结论：
+
+- 当前历史改制记录没有回填到 `改制物料流水号`。
+- 原因是现有物料主文件中没有与历史改制记录的“改制零件名称 + 改制零件图号”完全匹配的可用物料。
+- 新流程已经阻止继续产生这类数据：后续发起改制时，如果没有先维护物料信息，会返回失败提示。
+
+## 10. 改制发起页面零件列表替换显示验证
+
+执行命令：
+
+```powershell
+sqlcmd -S 192.168.1.27 -d ERPTOOL_JY_20250826Back -U sa -P ****** -b -W -s "|" -Q "EXEC dbo.技术中心_改制订单_零件_查询 @组件流水号=4283; EXEC dbo.技术中心_改制订单_零件_查询 @组件流水号=2652;"
+sqlcmd -S 192.168.1.27 -d ERPTOOL_JY_20250826Back -U sa -P ****** -b -f 65001 -i "sql\零件改制_发起改制_精确基本件.sql"
+sqlcmd -S 192.168.1.27 -d ERPTOOL_JY_20250826Back -U sa -P ****** -b -W -s "|" -Q "SELECT PARAMETER_NAME, DATA_TYPE FROM INFORMATION_SCHEMA.PARAMETERS WHERE SPECIFIC_NAME=N'技术中心_改制订单_发起改制' ORDER BY ORDINAL_POSITION;"
+npx eslint "src/views/TechnologyCenter/PartModificationOrder/index.vue"
+```
+
+验证结果：
+
+| 验证项 | 结果 |
+| --- | --- |
+| 组件 4283 改制行 | `205伺服电机挂板 / XT40-205MF-01.02-G`，`是否改制=1` |
+| 组件 2652 同流水号历史行 | 保持 `打刀缸 / NPM35T63x13BL-TZ1179C`，`是否改制=0` |
+| 发起过程参数 | 已包含 `@原基本件流水号 int` |
+| 前端 lint | 通过 |
+
+结论：
+
+- `技术中心_改制订单_零件_查询` 已按订单、组件、基本件三条件关联改制记录，避免只按基本件流水号导致串件。
+- 发起弹窗保留 `原零件名称`、`原零件图号`，列表展示可按最新改制目标替换。
+
+修改人:Ld 修改时间:2026-07-01 14:46:30;
--- a/docs/零件改制/06-决策记录.md
+++ b/docs/零件改制/06-决策记录.md
@@ -79,3 +79,73 @@ FROM 车间生产管理_零件工艺计划_视图 AS P
 ## DR-012：为什么保留历史设计方案和测试报告

 本次拆分出的 `01-06` 文档用于后续推进和任务管理，原设计方案、开发说明、测试报告保留作为上下文证据，避免历史决策丢失。
+
+## DR-013：为什么发起改制前必须先维护新物料
+
+入库流程最终按 `物料流水号` 写入库存。如果只修改显示用的零件名称和图号，而不切换物料流水号，库存会入到原物料，造成库存台账错误。
+
+因此最终规则调整为：
+
+```text
+发起改制前，必须先在物料主文件维护改制后的新物料。
+发起改制时，系统使用改制零件名称 + 改制零件图号查询新物料流水号。
+查不到新物料时，禁止发起改制。
+```
+
+对应查询条件：
+
+```sql
+库存管理_物料主文件_基本.名称 = @改制零件名称
+库存管理_物料主文件_基本.代号 = @改制零件图号
+是否禁用 = 0
+```
+
+## DR-014：为什么视图中的物料字段也要优先使用改制物料
+
+现有入库查询、生产任务、派工和 MES 多处依赖 `车间生产管理_零件工艺计划_视图`。如果只在改制记录里保存改制物料流水号，但视图仍返回原物料流水号，入库仍会写错库存。
+
+因此视图中以下字段统一优先取改制物料：
+
+```text
+零件名称
+零件图号
+物料流水号
+物料编码
+代号
+货位流水号
+单位
+```
+
+这样后续 `仓储管理_自制件入库_查询` 和 `仓储管理_自制件入库_循环执行` 不需要大改，就能按新物料入库。
+
+## DR-015：为什么发起弹窗不再默认填入原零件名称和图号
+
+如果弹窗默认把原零件名称、原零件图号带入改制目标，用户容易直接提交，虽然有“图号不能相同”的校验，但体验上仍然容易误解为可以在原零件基础上简单修改。
+
+最终决定：
+
+```text
+原零件信息只读展示。
+改制零件名称和改制零件图号默认置空。
+用户必须填写已经在物料信息中维护好的新物料名称和图号。
+后端根据名称 + 图号查找改制物料流水号。
+```
+
+这样可以强化业务规则：改制目标必须先存在于物料主文件，后续入库才能入到正确物料。
+
+## DR-016：为什么零件列表替换显示不直接修改原 BOM
+
+发起改制后，技术中心页面需要让用户看到“这条零件已经改制到哪个目标”，但原 BOM 仍然是订单原始技术数据，直接修改原 BOM 会影响历史追溯和未改制流程。
+
+最终决定：
+
+```text
+不修改原 BOM。
+零件列表查询时按最新未删除改制记录覆盖显示零件名称和图号。
+接口额外返回原零件名称、原零件图号，弹窗继续用于原件校验。
+关联条件必须包含原订单流水号、原组件流水号、原基本件流水号，避免同流水号跨组件串件。
+```
+
+这样既满足页面可见性，也保证改制记录、生产任务、入库物料各自有清晰依据。
+
+修改人:Ld 修改时间:2026-07-01 14:46:30;
--- a/docs/零件改制/零件改制入库链路测试报告.md
+++ b/docs/零件改制/零件改制入库链路测试报告.md
@@ -0,0 +1,299 @@
+# 零件改制入库链路测试报告
+
+## 1. 测试目的
+
+验证零件改制任务在完成生产后，是否能够进入现有“自制件入库”流程，并判断是否存在入库数据风险。
+
+## 2. 测试方式
+
+本次采用只读查询和事务内回滚模拟方式测试。
+
+- 未保留任何业务数据改动。
+- 未真实新增库存。
+- 未真实执行入库提交。
+- 使用事务临时修改完成数量，调用现有自制件入库查询过程后立即回滚。
+
+## 3. 涉及对象
+
+### 3.1 前端页面
+
+```text
+src/views/WarehouseManagement/PurchasePartsStorage/index.vue
+```
+
+自制件入库页签使用接口：
+
+```text
+仓储管理_自制件入库_查询
+仓储管理_自制件入库_循环执行
+物料入库_自制件入库_零件图号_查询数据
+```
+
+### 3.2 数据库对象
+
+```text
+技术中心_改制订单记录
+车间生产管理_零件工艺计划_视图
+车间生产管理工艺_零件工艺计划
+仓储管理_自制件入库_查询
+仓储管理_自制件入库_循环执行
+库存管理_物料与货位对照表
+库存管理_外购件累计库存
+库存管理_自制件_入库记录
+```
+
+## 4. 当前改制任务状态检查
+
+执行 SQL：
+
+```sql
+SELECT
+    COUNT(*) AS 改制任务数,
+    SUM(CASE WHEN ISNULL(V.完成数量,0) > ISNULL(V.入库数量,0) THEN 1 ELSE 0 END) AS 当前可入库数,
+    SUM(CASE WHEN ISNULL(V.完成数量,0) >= ISNULL(V.批次数量,0) AND ISNULL(V.批次数量,0) > 0 THEN 1 ELSE 0 END) AS 已完成生产数,
+    SUM(CASE WHEN V.工艺计划流水号 IS NULL THEN 1 ELSE 0 END) AS 未关联生产任务数
+FROM dbo.技术中心_改制订单记录 GZ
+LEFT JOIN dbo.车间生产管理_零件工艺计划_视图 V
+    ON GZ.工艺计划流水号 = V.工艺计划流水号
+WHERE ISNULL(GZ.是否删除,0)=0;
+```
+
+结果：
+
+| 改制任务数 | 当前可入库数 | 已完成生产数 | 未关联生产任务数 |
+| --- | --- | --- | --- |
+| 11 | 0 | 0 | 3 |
+
+结论：
+
+- 当前没有已经完成生产并可入库的改制任务。
+- 有 3 条历史改制记录未关联到生产任务，原因是未回写 `工艺计划流水号`。
+
+## 5. 入库查询模拟测试
+
+### 5.1 测试 SQL
+
+以下 SQL 在事务中临时将一条改制任务的 `完成数量` 设置为 `批次数量`，调用现有自制件入库查询后立即回滚。
+
+```sql
+BEGIN TRAN;
+
+DECLARE @工艺计划流水号 int;
+DECLARE @订单流水号 int;
+DECLARE @批次数量 int;
+DECLARE @图号 nvarchar(50);
+
+SELECT TOP 1
+    @工艺计划流水号 = V.工艺计划流水号,
+    @订单流水号 = V.订单流水号,
+    @批次数量 = V.批次数量,
+    @图号 = V.零件图号
+FROM dbo.技术中心_改制订单记录 GZ
+INNER JOIN dbo.车间生产管理_零件工艺计划_视图 V
+    ON GZ.工艺计划流水号 = V.工艺计划流水号
+WHERE ISNULL(GZ.是否删除,0)=0
+  AND V.工艺计划流水号 IS NOT NULL
+ORDER BY GZ.改制订单流水号 DESC;
+
+UPDATE dbo.车间生产管理工艺_零件工艺计划
+SET 完成数量 = @批次数量
+WHERE 工艺计划流水号 = @工艺计划流水号;
+
+EXEC dbo.仓储管理_自制件入库_查询
+    @排序名称 = 0,
+    @排序方式 = 0,
+    @订单号_check = 1,
+    @订单号 = @订单流水号,
+    @零件图号_check = 1,
+    @零件图号 = @图号;
+
+ROLLBACK TRAN;
+```
+
+### 5.2 查询结果
+
+| 工艺计划流水号 | 订单号 | 零件名称 | 零件图号 | 物料流水号 | 批次数量 | 完成数量 | 入库数量 | 本次入库 | 类型 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| 6591 | BHGZ-202607010011 | 300封油板 | URS3042Z-07-01 | 741 | 1 | 1 | 0 | 1 | 自制件 |
+
+结论：
+
+- 改制任务在完成生产后，可以进入现有 `仓储管理_自制件入库_查询` 查询结果。
+- 页面层面具备被选择并执行自制件入库的条件。
+
+## 6. 入库执行逻辑分析
+
+现有自制件入库提交过程：
+
+```text
+仓储管理_自制件入库_循环执行
+```
+
+关键逻辑：
+
+```sql
+INSERT INTO 库存管理_物料与货位对照表
+(
+    物料流水号,
+    货位流水号,
+    货位存量,
+    操作日期,
+    工艺计划流水号
+)
+VALUES
+(
+    @物料流水号,
+    @货位流水号,
+    @实际到货数量,
+    GETDATE(),
+    @工艺计划流水号
+);
+
+INSERT INTO 库存管理_自制件_入库记录
+(
+    工艺计划流水号,
+    实际到货数量,
+    入库人员流水号,
+    入库时间,
+    货位流水号
+)
+VALUES
+(
+    @工艺计划流水号,
+    @实际到货数量,
+    @入库人员流水号,
+    GETDATE(),
+    @货位流水号
+);
+
+UPDATE 车间生产管理工艺_零件工艺计划
+SET 入库数量 = ISNULL(入库数量,0) + @实际到货数量
+WHERE 工艺计划流水号 = @工艺计划流水号;
+```
+
+该过程会：
+
+- 增加货位库存。
+- 增加累计库存。
+- 写入自制件入库记录。
+- 回写工艺计划入库数量。
+- 入库数量达到生产数量减报废数量时，将工艺计划状态更新为入库完成。
+
+## 7. 风险发现
+
+### 7.1 入库可执行，但可能入到原物料流水号
+
+当前改制任务查询结果中，虽然视图显示了改制后的零件名称和零件图号，但 `物料流水号` 仍来自原基本件关联的物料。
+
+抽样结果：
+
+| 改制订单编号 | 改制零件图号 | 工艺计划流水号 | 物料流水号 | 当前物料代号 | 结论 |
+| --- | --- | --- | --- | --- | --- |
+| BHGZ-202607010011 | URS3042Z-07-01 | 6591 | 741 | URS2267Z-04 | 不一致 |
+| BHGZ-202606270010 | XT40-2-BT40-14.09-G | 6590 | 1716 | XT40-MF-05.08 | 不一致 |
+| BHGZ-202606260009 | XT20-02-G | 6589 | 1251 | XT20-09 | 不一致 |
+
+影响：
+
+- 如果直接使用现有入库流程，库存可能增加到原基本件物料，而不是改制后的目标零件物料。
+- 页面显示看起来是改制零件，但库存台账实际使用的是原 `物料流水号`。
+
+## 8. 测试结论
+
+### 8.1 能否正常进入入库流程
+
+可以。
+
+完成生产后，只要满足：
+
+```sql
+完成数量 > 入库数量
+```
+
+改制任务可以被 `仓储管理_自制件入库_查询` 查出，并进入现有自制件入库页面。
+
+### 8.2 能否直接认为入库完全正确
+
+不能。
+
+当前链路存在关键风险：
+
+```text
+显示字段使用改制零件信息
+库存入库仍使用原物料流水号
+```
+
+因此只能说“流程可进入入库”，但不能确认“库存入到正确改制物料”。
+
+## 9. 修复方案执行情况
+
+### 9.1 已执行方案
+
+已在 `技术中心_改制订单记录` 中增加改制目标物料流水号：
+
+```sql
+ALTER TABLE dbo.技术中心_改制订单记录
+ADD 改制物料流水号 int NULL;
+```
+
+已修改 `技术中心_改制订单_发起改制`：
+
+```sql
+SELECT TOP 1
+    @改制物料流水号 = 物料流水号
+FROM dbo.库存管理_物料主文件_基本
+WHERE LTRIM(RTRIM(名称)) = LTRIM(RTRIM(@改制零件名称))
+  AND LTRIM(RTRIM(代号)) = LTRIM(RTRIM(@改制零件图号))
+  AND ISNULL(是否禁用, 0) = 0;
+```
+
+查不到新物料时禁止发起：
+
+```sql
+SELECT '0' AS result, '未找到改制零件对应的新物料，请先维护物料信息' AS msg;
+```
+
+已修改 `车间生产管理_零件工艺计划_视图`，让以下字段优先使用改制物料：
+
+```text
+物料流水号
+物料编码
+代号
+货位流水号
+货位名称
+单位
+```
+
+同时保留改制订单编号、改制零件名称、改制零件图号的优先显示。
+
+### 9.2 当前验证结果
+
+结构验证：
+
+| 检查项 | 结果 |
+| --- | --- |
+| 改制物料字段存在 | 1 |
+| 发起过程已包含改制物料 | 1 |
+| 生产任务视图已关联改制物料 | 1 |
+
+历史数据：
+
+| 未删除改制记录数 | 未维护改制物料数 | 已维护改制物料数 |
+| --- | --- | --- |
+| 11 | 11 | 0 |
+
+说明：
+
+- 历史改制记录没有匹配到新物料流水号。
+- 原因是物料主文件中没有与历史记录的“改制零件名称 + 改制零件图号”完全匹配的可用物料。
+- 新流程已阻止继续产生该问题。
+
+## 10. 后续验收项
+
+| 验收项 | 状态 | 标准 |
+| --- | --- | --- |
+| 改制任务完成后可进入自制件入库查询 | 通过 | 事务回滚模拟已验证 |
+| 改制任务入库后库存写入正确物料 | 待新数据验证 | 新流程已支持改制物料流水号，需用新发起改制订单验证 |
+| 入库后工艺计划入库数量增加 | 待真实流程验证 | 入库数量应增加 |
+| 入库完成后考核状态变为 4 | 待真实流程验证 | 完成数量全部入库后状态为入库 |
+| 入库记录显示改制订单编号 | 待联调 | 入库记录查询需关联改制记录 |