meswork/JY1.0
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

更新装配、销售、精工车间、技术中心、仓储多个模块，整理文档和SQL脚本

Browse Source
This commit is contained in:
Developer
2026-06-29 13:36:34 +08:00
parent 137e276340
commit be0ff91e24
54 changed files with 5066 additions and 723 deletions
Download Patch File Download Diff File Expand all files Collapse all files

401
docs/JY1.0-阶段功能需求文档.md Normal file
View File

@@ -0,0 +1,401 @@
# JY1.0 阶段功能需求文档
## 01-文档说明
本文档根据当前提出的 7 项业务需求整理，作为后续前端、后端、数据库、测试联调的需求依据。需求内容覆盖默认库位设置、物料编码查询、移动端适配、库存盘点、看板优化、语音播报、质检 PDA 应急扫码能力。
本文档为初稿，后续可根据现场确认结果继续补充字段、接口、菜单权限、数据库过程和验收样例。
## 02-总体目标
1. 优化仓储相关业务流程，减少物料维护页面职责过重的问题。
2. 提升物料查询效率，在现有查询功能中统一补充物料编码查询能力。
3. 改善移动端使用体验，支持车间派工在手机或移动终端上自适应展示和操作。
4. 完善库存盘点、物料系列、库位编辑、入库库位选择等库存基础能力。
5. 优化现有看板数据展示，并新增仓库、采购等业务看板。
6. 增加新订单语音播报能力，提升部门电视机、现场广播等场景下的消息触达效率。
7. 完善质检 PDA 应急方案，在 PDA 设备故障时使用手机扫码保障生产不中断。
## 03-需求一：默认库位设置功能调整
### 3.1 需求背景
当前“设置默认库位”功能位于物料标准维护或物料标准相关页面中，导致物料基础维护页面承载了仓储业务配置职责。为降低页面复杂度，并使库位规则更贴近入库业务，需要将默认库位设置从物料标准维护中移出。
### 3.2 功能目标
1. 去除物料标准维护中的“设置默认库位”入口和相关操作。
2. 将默认库位设置功能迁移到其他更合适的仓储组件，或新建“默认库位设置”组件。
3. 物料入库选择库位时，根据该物料是否存在默认库存或库位库存显示不同的库位范围。
### 3.3 业务规则
1. 如果物料没有默认库存或没有可识别的默认库位库存，入库时显示全库位选择。
2. 如果物料已有库存库位，入库时优先显示该物料已有库存的库位选择。
3. 默认库位设置不再依赖物料标准维护页面完成。
4. 新组件需要支持按物料编码、物料名称、图号、规格型号等条件查询物料。
5. 默认库位设置后，应能被物料入库、库存盘点、库存查询等仓储业务读取。
### 3.4 前端范围
1. 移除物料标准维护页面中的默认库位设置按钮、弹窗和相关方法。
2. 新增或迁移默认库位设置组件，建议放入仓储管理模块。
3. 物料入库组件调整库位下拉数据来源：
- 无默认库存时显示全库位。
- 有库存时显示该物料已有库存库位。
4. 保持 Vue 2 Options API 和 Element UI 原有开发风格。
### 3.5 后端范围
1. 梳理现有默认库位相关存储过程、表字段和调用页面。
2. 根据新组件补充查询、保存、删除默认库位的接口。
3. 入库库位查询过程需支持按物料返回全库位或已有库存库位。
### 3.6 验收标准
1. 物料标准维护页面不再出现默认库位设置入口。
2. 新默认库位设置组件可完成查询、设置、修改、删除。
3. 物料无库存库位时，入库页面可选择全部库位。
4. 物料已有库存库位时，入库页面只显示符合规则的库位。
5. 默认库位变更后，相关仓储页面读取结果一致。
## 04-需求二：现有查询功能增加物料编码查询
### 4.1 需求背景
系统中已有多个物料查询入口，但部分页面只能按物料名称、图号、规格型号等条件查询，无法直接按物料编码定位，影响仓储、销售、技术、装配等场景的查询效率。
### 4.2 功能目标
1. 在现有涉及物料查询的组件中新增“物料编码”查询条件。
2. 物料编码查询需要与原有条件组合查询。
3. 查询结果、导出结果、选择弹窗结果保持一致。
### 4.3 覆盖范围
优先覆盖以下类型页面：
| 模块 | 页面或组件类型 | 查询入口 |
| ---- | ------------------- | ---------- |
| 仓储管理 | 库存盘点、库存查询、入库记录、物料库位 | 主列表查询、导出 |
| 仓储管理 | 领料、耗材、入库物料选择 | 物料选择弹窗 |
| 技术中心 | 物料查询、物料维护、图纸确认 | 主列表或物料选择弹窗 |
| 销售管理 | 订单管理、订单审核、订单查询 | 物料选择弹窗 |
| 装配管理 | 接收装配任务、接收滑台装配任务 | 物料选择弹窗 |
### 4.4 前端规则
1. 搜索栏新增 `物料编码` 输入框。
2. 输入框 placeholder 可使用“物料编码”或“物料编号”，但传参建议统一使用 `物料编码`。
3. 原有查询按钮、重置按钮、分页查询逻辑保持不变。
4. 导出功能应同步携带物料编码条件。
5. 不新增第三方库，不改变现有 `CreateData`、`ExecDatabase`、`getTable` 调用模式。
### 4.5 后端规则
1. 相关查询存储过程增加可选参数：
- `物料编码_check`
- `物料编码`
2. 未传物料编码时，不影响原有查询结果。
3. 传入物料编码时，应支持模糊查询或按现场确认规则查询。
4. 导出过程与页面查询过程保持条件一致。
### 4.6 验收标准
1. 用户可通过物料编码直接查询目标物料。
2. 物料编码可与物料名称、图号、规格型号等条件组合查询。
3. 查询和导出数据一致。
4. 所有改造页面无模板解析错误、无明显布局错位。
## 05-需求三：车间派工组件移动端自适应
### 5.1 需求背景
车间派工业务需要在移动设备上查看和操作，当前桌面端布局在手机或窄屏设备上可能存在表格过宽、按钮拥挤、筛选条件不易操作等问题。
### 5.2 功能目标
1. 开发车间派工组件的移动端自适应布局。
2. 保持桌面端原有操作习惯不受影响。
3. 移动端重点保证查询、查看、派工、确认等高频操作可用。
### 5.3 前端要求
1. 使用响应式样式适配手机、平板、窄屏电脑。
2. 搜索条件在移动端可折叠或纵向排列。
3. 表格在移动端可采用横向滚动、卡片式列表或核心字段列表展示。
4. 操作按钮在移动端需要保证可点击区域足够，不出现文字挤压。
5. 弹窗在移动端宽度应适配屏幕，不应超出视口。
6. 不引入 Vue 3、Composition API 或新的 UI 库。
### 5.4 重点场景
1. 手机查看待派工任务。
2. 手机按订单、物料、工序、人员等条件筛选。
3. 手机进入派工明细并提交。
4. 手机查看派工状态、数量、人员、设备等关键字段。
### 5.5 验收标准
1. 375px、414px、768px、1366px 宽度下页面可正常展示。
2. 移动端无关键按钮遮挡、重叠、不可点击问题。
3. 桌面端布局保持稳定。
4. 派工提交、查询、刷新等原有功能正常。
## 06-需求四：库存盘点及物料系列、库位编辑优化
### 6.1 需求背景
库存盘点需要更细粒度筛选物料，并支持对盘点库位进行维护。当前盘点和入库库位选择逻辑需要与物料库存库位更紧密关联。
### 6.2 功能目标
1. 新增“系列”字段，用于物料筛选和盘点筛选。
2. 在物料维护组件中支持编辑物料系列。
3. 库存盘点组件增加按系列筛选物料和库存的能力。
4. 库存盘点组件添加编辑库位功能。
5. 物料入库组件的库位选择只显示有该物料的库位。
### 6.3 物料维护要求
1. 物料维护列表展示“系列”字段。
2. 新增、编辑物料时可维护“系列”。
3. 系列字段建议使用中文字段名 `系列`。
4. 系列可根据现场数据情况使用输入框或下拉框。
### 6.4 库存盘点要求
1. 搜索栏增加“系列”筛选条件。
2. 支持按系列查询物料盘点数据。
3. 支持按系列查询库存盘点数据。
4. 表格展示需要包含系列字段，便于盘点人员核对。
5. 增加编辑库位功能，可调整物料对应盘点库位。
### 6.5 物料入库要求
1. 入库时选择库位只显示有该物料的库位。
2. 如果该物料没有任何库存库位，需要结合需求一规则显示全库位或默认库位候选。
3. 库位下拉数据需要避免显示与该物料无关且容易误选的库位。
### 6.6 后端要求
1. 物料基础表或相关视图增加 `系列` 字段。
2. 物料维护查询、新增、编辑过程支持系列字段。
3. 库存盘点查询过程支持系列筛选。
4. 库位编辑过程需要记录修改人、修改时间。
5. 入库库位查询过程按物料库存库位过滤。
### 6.7 验收标准
1. 物料维护可新增和编辑系列字段。
2. 库存盘点可按系列筛选数据。
3. 库存盘点可编辑库位，并保存成功。
4. 物料入库库位选择符合“只显示该物料相关库位”的规则。
5. 相关查询、保存后刷新数据一致。
## 07-需求五：看板优化
### 7.1 需求背景
现场看板需要更清晰地展示仓库、采购、订单、库存等业务状态。现有看板需要数据口径优化，同时新增部分业务看板。
### 7.2 功能目标
1. 新增仓库看板组件。
2. 新增或优化采购看板组件。
3. 优化现有看板的数据口径、展示字段和刷新方式。
4. 仓库看板展示入库单滚动信息。
5. 采购看板展示仍在采购中的合同。
### 7.3 仓库看板要求
1. 展示入库单滚动列表。
2. 滚动内容建议包括入库单号、供应商、物料名称、物料编码、数量、入库日期、状态。
3. 支持自动刷新，刷新频率需现场确认。
4. 大屏展示时文字清晰，不出现字段重叠。
5. 支持异常状态突出显示，例如待处理、待上架、未完成。
### 7.4 采购看板要求
1. 展示仍在采购中的合同。
2. 合同状态口径需要明确，例如未完成、采购中、部分到货、逾期未到。
3. 建议展示合同号、供应商、物料、数量、已到数量、未到数量、交期、状态。
4. 对逾期或临近交期的数据进行醒目提示。
### 7.5 现有看板优化要求
1. 梳理现有看板数据来源和字段含义。
2. 对不准确、不及时或口径不一致的数据进行调整。
3. 保持大屏自适应显示效果。
4. 对滚动、刷新、排序、状态颜色做统一规范。
### 7.6 验收标准
1. 仓库看板可滚动展示入库单数据。
2. 采购看板可展示采购中的合同。
3. 现有看板数据口径与业务确认一致。
4. 大屏展示无明显错位、遮挡、空白异常。
5. 自动刷新不影响页面稳定性。
## 08-需求六：语音播报
### 8.1 需求背景
当系统产生新的订单或重要业务消息时，需要在部门电视机或全场广播中自动播报，类似商家外卖新订单语音提醒，减少人工盯屏和漏看消息。
### 8.2 功能目标
1. 新订单产生时触发语音播报。
2. 支持部门电视机播报或全场广播播报。
3. 播报内容简洁明确，便于现场人员快速理解。
4. 后续可扩展到采购到货、异常提醒、质检任务等事件。
### 8.3 播报场景
1. 新订单生成。
2. 新订单分配到指定部门。
3. 订单状态发生关键变化。
4. 后续可扩展为库存预警、采购逾期、质检待处理等。
### 8.4 播报内容建议
新订单播报示例：
```text
您有新的生产订单，请及时处理。订单号：XXXX，客户：XXXX，数量：XXXX。
```
部门播报示例：
```text
技术中心有新的图纸确认任务，请及时处理。
```
### 8.5 技术要求
1. 前端可使用浏览器语音能力或播放预生成音频。
2. 如果用于电视机浏览器，需要确认浏览器是否允许自动播放声音。
3. 如果接入全场广播，需要确认广播设备是否支持网页音频输入、接口触发或本地客户端转发。
4. 新消息检测可采用轮询、WebSocket 或已有消息接口。
5. 需要增加播报开关、播报范围、播报频率、防重复播报规则。
### 8.6 权限和配置
1. 管理员可配置是否启用语音播报。
2. 可按部门配置播报内容和播报设备。
3. 同一订单不应重复无限播报。
4. 需要记录已播报状态或播报日志，便于追查。
### 8.7 验收标准
1. 新订单出现后，指定终端可听到语音播报。
2. 同一订单不会被重复播报造成干扰。
3. 播报开关关闭后不再播报。
4. 部门播报和全场播报范围符合配置。
5. 电视机或广播设备在生产环境中可稳定使用。
## 09-需求七：质检 PDA 手机扫码应急功能
### 9.1 需求背景
质检 PDA 已有扫码作业能力，但在 PDA 设备故障时，需要使用手机应急完成扫码和质检相关工作。当前功能已开发完成，但生产环境下由于扫码组件安全限制无法使用。
### 9.2 功能目标
1. 确保手机扫码功能在生产环境可正常使用。
2. 在 PDA 故障时，手机可以临时替代 PDA 进行扫码质检作业。
3. 解决扫码组件在生产环境下的安全限制问题。
### 9.3 问题说明
扫码组件通常依赖浏览器摄像头权限。生产环境可能存在以下限制：
1. 页面不是 HTTPS，浏览器禁止调用摄像头。
2. 访问地址使用 IP 或非受信任域名，浏览器阻止摄像头权限。
3. 手机浏览器权限未授权。
4. 扫码组件要求安全上下文，HTTP 环境不可用。
5. 内嵌浏览器或企业微信、钉钉 WebView 权限策略不同。
### 9.4 解决方向
1. 将生产环境扫码页面部署到 HTTPS。
2. 配置可信域名和证书，避免直接使用不安全 HTTP 地址调用摄像头。
3. 如果必须内网使用，需要评估内网 HTTPS 证书或受信任证书安装方案。
4. 针对手机浏览器、企业微信、钉钉等访问方式分别验证摄像头权限。
5. 保留手工输入条码的兜底方案，避免扫码不可用时业务中断。
### 9.5 功能要求
1. 手机页面可打开摄像头并扫码。
2. 扫码结果可回填到质检业务流程。
3. 扫码失败时允许手动输入条码。
4. 页面需要适配手机端显示。
5. 扫码权限异常时给出明确提示，例如“请使用 HTTPS 地址访问”或“请允许摄像头权限”。
### 9.6 验收标准
1. 生产环境手机扫码可正常调用摄像头。
2. 扫码后可完成质检业务操作。
3. PDA 故障时，手机应急流程可完整跑通。
4. 摄像头权限失败时有明确提示和手动输入兜底。
5. 不影响 PDA 原有扫码功能。
## 10-优先级建议
| 优先级 | 需求 | 原因 |
| --- | --------------- | ------------------ |
| P2 | 质检 PDA 手机扫码应急功能 | 已开发但生产不可用，影响故障应急能力 |
| P0 | 库存盘点及入库库位选择优化 | 直接影响库存准确性和入库操作 |
| P0 | 默认库位设置功能调整 | 影响仓储配置职责和入库库位逻辑 |
| P0 | 物料编码查询 | 涉及页面多，但收益明确 |
| P1 | 车间派工移动端适配 | 改善现场移动操作效率 |
| P2 | 看板优化 | 影响现场展示和管理效率 |
| P2 | 语音播报 | 需要确认硬件、浏览器和广播接入方案 |
## 11-实施拆分建议
### 第一阶段：库存与查询基础能力
1. 默认库位设置迁移。
2. 物料编码查询补充。
3. 物料系列字段和库存盘点筛选。
4. 物料入库库位过滤。
### 第二阶段：移动端与应急能力
1. 车间派工移动端适配。
2. 质检 PDA 手机扫码生产环境修复。
### 第三阶段：看板与播报能力
1. 仓库看板新增。
2. 采购看板新增或优化。
3. 现有看板数据口径调整。
4. 新订单语音播报试点。
## 12-待确认事项
1. 默认库位设置新组件归属菜单：仓储管理、基础数据，或单独配置模块。
2. “没有默认库存”与“没有库存库位”的业务定义是否一致。
3. 物料入库库位选择在无库存时是否显示全库位，还是优先显示默认库位。
4. 系列字段的数据来源：手工输入、固定字典、还是由后端基础数据维护。
5. 库存盘点编辑库位是否允许直接改变已有库存所在库位，是否需要保留调整记录。
6. 看板刷新频率和大屏分辨率。
7. 语音播报使用电视机网页播放，还是接入全场广播硬件。
8. 手机扫码生产环境访问方式：HTTPS 域名、内网 IP、企业微信、钉钉或普通浏览器。
9. 语音播报和扫码功能是否需要新增系统配置表。
## 13-风险说明
1. 默认库位、库存库位、入库库位逻辑如果口径不统一，可能导致入库误选库位。
2. 物料编码查询涉及页面多，需要避免漏改导出和弹窗查询。
3. 库存盘点编辑库位如果缺少日志，后续库存差异追溯困难。
4. 看板数据口径需与业务部门确认，否则容易出现“页面正确但业务理解不一致”的问题。
5. 浏览器语音自动播放和摄像头扫码都受 HTTPS、安全策略、设备权限影响，必须在生产环境实测。
6. 全场广播接入可能涉及硬件、网络、音频设备，不应只按前端功能估算工作量。
## 14-文档备注
本次变更为新增需求文档，未修改业务代码。
修改人:Ld 修改时间:2026-06-29 10:29:16

22
docs/preview-server.js
View File

@@ -1,22 +0,0 @@
const http = require('http');
const fs = require('fs');
const path = require('path');
const root = __dirname;
const types = { '.html': 'text/html; charset=utf-8', '.png': 'image/png', '.css': 'text/css; charset=utf-8', '.js': 'text/javascript; charset=utf-8', '.md': 'text/plain; charset=utf-8' };
const server = http.createServer((req, res) => {
try {
const url = new URL(req.url, 'http://127.0.0.1:18765');
const rel = decodeURIComponent(url.pathname).replace(/^\/+/, '');
const filePath = path.resolve(root, rel);
if (!filePath.startsWith(path.resolve(root))) {
res.writeHead(403); res.end('Forbidden'); return;
}
fs.readFile(filePath, (err, data) => {
if (err) { res.writeHead(404); res.end('Not found: ' + filePath); return; }
res.writeHead(200, { 'Content-Type': types[path.extname(filePath).toLowerCase()] || 'application/octet-stream' });
res.end(data);
});
} catch (e) { res.writeHead(500); res.end(String(e)); }
});
server.listen(18765, '127.0.0.1', () => console.log('preview server on 18765'));
setInterval(() => {}, 1000);

482
docs/warehouse-visualization-preview.html
View File

@@ -1,482 +0,0 @@
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>立库可视化功能截图预览</title>
<style>
* { box-sizing: border-box; }
body {
margin: 0;
font-family: "Microsoft YaHei", Arial, sans-serif;
background: #eef2f7;
color: #303133;
}
.app-container { padding: 20px; }
.card {
height: 850px;
background: #fff;
border: 1px solid #e4e7ed;
box-shadow: 0 2px 12px rgba(0,0,0,.06);
}
.tab {
height: 44px;
border-bottom: 1px solid #dcdfe6;
background: #f5f7fa;
display: flex;
align-items: end;
padding-left: 0;
}
.tab span {
display: inline-flex;
align-items: center;
height: 44px;
padding: 0 22px;
background: #fff;
border-right: 1px solid #dcdfe6;
border-top: 2px solid #409eff;
font-size: 14px;
color: #409eff;
}
.toolbar {
margin: 7px 0;
padding: 0 12px;
display: flex;
align-items: center;
gap: 10px;
flex-wrap: wrap;
height: 42px;
}
.toolbar label { font-size: 13px; color: #000; }
.select, .button, .switch {
height: 32px;
border-radius: 4px;
font-size: 13px;
display: inline-flex;
align-items: center;
}
.select {
width: 120px;
border: 1px solid #dcdfe6;
padding: 0 10px;
justify-content: space-between;
color: #606266;
background: #fff;
}
.select::after { content: "⌄"; color: #909399; }
.button {
border: 1px solid transparent;
padding: 0 12px;
color: #fff;
gap: 4px;
}
.primary { background: #409eff; }
.default { background: #fff; color: #606266; border-color: #dcdfe6; }
.success { background: #67c23a; }
.switch {
margin-left: 10px;
gap: 8px;
color: #606266;
}
.switch-track {
width: 42px;
height: 22px;
border-radius: 12px;
background: #409eff;
position: relative;
}
.switch-track::after {
content: "";
position: absolute;
right: 2px;
top: 2px;
width: 18px;
height: 18px;
border-radius: 50%;
background: #fff;
}
.stats {
display: grid;
grid-template-columns: repeat(6, 1fr);
gap: 10px;
margin: 10px 12px;
}
.stat {
border: 1px solid #ebeef5;
border-radius: 4px;
text-align: center;
padding: 10px 0;
box-shadow: 0 2px 8px rgba(0,0,0,.04);
}
.stat .label { color: #909399; font-size: 12px; }
.stat .value { font-size: 20px; font-weight: bold; margin-top: 4px; }
.legend {
margin-bottom: 15px;
display: flex;
align-items: center;
justify-content: center;
gap: 20px;
flex-wrap: wrap;
}
.legend-item {
display: flex;
align-items: center;
font-size: 12px;
}
.legend-color {
width: 20px;
height: 20px;
border-radius: 4px;
border: 1px solid #ddd;
margin-right: 5px;
}
.warehouse-area {
height: 600px;
overflow: auto;
border: 1px solid #e4e7ed;
border-radius: 4px;
margin: 0 12px;
padding: 15px;
background: #f5f7fa;
}
.warehouse-group {
margin-bottom: 30px;
padding: 15px;
background: white;
border-radius: 4px;
box-shadow: 0 2px 4px rgba(0,0,0,.1);
}
.group-title {
text-align: center;
margin-bottom: 10px;
color: #303133;
font-weight: bold;
background: #e8f4fd;
padding: 5px;
border-radius: 4px;
}
table {
width: 100%;
min-width: 1200px;
border-collapse: collapse;
margin: 0 auto;
table-layout: fixed;
}
th, td {
border: 1px solid #e4e7ed;
text-align: center;
height: 40px;
min-width: 40px;
font-size: 12px;
position: relative;
}
th {
background: #f5f7fa;
font-weight: bold;
color: #303133;
}
.row-layer-header, .row-layer-cell {
width: 80px;
min-width: 80px;
background: #e8f4fd;
color: #2196f3;
font-weight: bold;
}
.row-layer-cell { background: #f5f7fa; color: #303133; }
.highlight-row .row-layer-cell {
background: #bbdefb;
color: #1976d2;
}
.highlight-col { background: #bbdefb; color: #1976d2; }
.cell {
cursor: pointer;
font-size: 14px;
font-weight: bold;
transition: all .2s;
}
.cell:hover {
transform: scale(1.08);
z-index: 2;
box-shadow: 0 2px 8px rgba(0,0,0,.2);
}
.status-2 { background: #4caf50; color: #fff; }
.status-1 { background: #ff9800; color: #fff; }
.status-0 { background: #e0e0e0; color: #666; }
.status-9 { background: skyblue; color: #fff; }
.selected {
box-shadow: 0 0 0 2px #2196f3 inset;
outline: 2px solid #2196f3;
outline-offset: -2px;
}
.tooltip {
position: absolute;
bottom: calc(100% + 6px);
left: 50%;
transform: translateX(-50%);
background: rgba(0,0,0,.82);
color: white;
padding: 4px 8px;
border-radius: 4px;
font-size: 12px;
white-space: nowrap;
z-index: 4;
font-weight: normal;
}
.pagination {
text-align: center;
margin-top: 10px;
color: #606266;
font-size: 13px;
}
.page-box {
display: inline-flex;
align-items: center;
gap: 8px;
border: 1px solid #ebeef5;
padding: 6px 10px;
border-radius: 4px;
background: #fff;
}
.page-num {
min-width: 28px;
height: 28px;
border-radius: 3px;
display: inline-flex;
align-items: center;
justify-content: center;
}
.page-current { background: #409eff; color: #fff; }
.modal-backdrop {
display: none;
position: fixed;
inset: 0;
background: rgba(0,0,0,.2);
align-items: center;
justify-content: center;
z-index: 10;
}
body.show-detail #detailModal,
body.show-material #materialModal { display: flex; }
.dialog {
background: #fff;
border-radius: 2px;
box-shadow: 0 4px 18px rgba(0,0,0,.18);
overflow: hidden;
}
.detail-dialog { width: 500px; }
.material-dialog { width: 941px; }
.dialog-title {
height: 54px;
display: flex;
align-items: center;
justify-content: center;
font-size: 18px;
border-bottom: 1px solid #ebeef5;
}
.dialog-body { padding: 20px; }
.detail-box {
padding: 10px;
background: #f5f7fa;
border-radius: 4px;
line-height: 1.7;
}
.dialog-footer {
border-top: 1px solid #ebeef5;
padding: 10px 20px;
text-align: right;
}
.close-button {
height: 32px;
padding: 0 15px;
border: 1px solid #dcdfe6;
background: #fff;
border-radius: 4px;
color: #606266;
}
.material-table {
min-width: 0;
table-layout: auto;
font-size: 13px;
}
.material-table th {
color: #606266;
height: 38px;
background: #f5f7fa;
}
.material-table td { height: 46px; }
.qty { color: #67c23a; font-weight: bold; }
.lockqty { color: #e6a23c; font-weight: bold; }
.unit { font-size: 10px; color: #909399; }
.mode-icon .cell { font-size: 18px; }
.mode-icon .text-symbol { display: none; }
.mode-icon .icon-symbol { display: inline; }
.icon-symbol { display: none; }
.callout {
position: absolute;
right: 30px;
top: 105px;
background: #fffbe6;
border: 1px solid #ffe58f;
color: #6b4c00;
padding: 8px 12px;
border-radius: 4px;
font-size: 13px;
z-index: 5;
display: none;
}
body.show-filter-tip .callout { display: block; }
</style>
</head>
<body>
<div class="app-container">
<div class="card">
<div class="tab"><span>立库可视化</span></div>
<div class="toolbar">
<label>库位筛选</label>
<div class="select" id="aisleSelect">第一巷道</div>
<div class="select" id="rowSelect">03-01</div>
<div class="button primary">🔍 搜索</div>
<div class="button default">↻ 重置</div>
<div class="button success">⟲ 刷新数据</div>
<div class="switch"><span id="modeText">显示文字</span><span class="switch-track"></span></div>
</div>
<div class="callout">筛选区支持按巷道重新取数、按行-层收窄视图，并可切换文字/图标显示模式。</div>
<div class="stats">
<div class="stat"><div class="label">总库位数</div><div class="value">384</div></div>
<div class="stat"><div class="label">有物料有托盘</div><div class="value" style="color:#4caf50">138</div></div>
<div class="stat"><div class="label">有托盘无物料</div><div class="value" style="color:#ff9800">76</div></div>
<div class="stat"><div class="label">空闲库位</div><div class="value" style="color:#9e9e9e">154</div></div>
<div class="stat"><div class="label">使用率</div><div class="value" style="color:#2196f3">55.7%</div></div>
<div class="stat"><div class="label">数据行数</div><div class="value" style="color:#9c27b0">8</div></div>
</div>
<div class="legend">
<div class="legend-item"><div class="legend-color" style="background:#4caf50"></div>有物料有托盘 (物)</div>
<div class="legend-item"><div class="legend-color" style="background:#ff9800"></div>有托盘无物料 (盘)</div>
<div class="legend-item"><div class="legend-color" style="background:#e0e0e0"></div>空库位 (空)</div>
<div class="legend-item"><div class="legend-color" style="background:#bbdefb;border:2px solid #2196f3"></div>选中库位</div>
</div>
<div class="warehouse-area">
<div class="warehouse-group">
<div class="group-title">立库组</div>
<table id="warehouseTable">
<thead>
<tr id="headRow"><th class="row-layer-header">行-层</th></tr>
</thead>
<tbody id="tableBody"></tbody>
</table>
</div>
<div style="text-align:center;margin-top:20px;color:#909399;font-size:12px">显示 8 行数据</div>
</div>
<div class="pagination">
<div class="page-box">
<span>共 8 条</span>
<span>8条/页</span>
<span>‹</span>
<span class="page-num page-current">1</span>
<span>›</span>
<span>前往 1 页</span>
</div>
</div>
</div>
</div>
<div class="modal-backdrop" id="detailModal">
<div class="dialog detail-dialog">
<div class="dialog-title">库位详情 03-08-01</div>
<div class="dialog-body">
<div class="detail-box">有托盘但无物料，需补充物料。当前库位已被识别为托盘占用状态，适合仓储人员核对托盘与物料绑定情况。</div>
</div>
<div class="dialog-footer"><button class="close-button">关闭</button></div>
</div>
</div>
<div class="modal-backdrop" id="materialModal">
<div class="dialog material-dialog">
<div class="dialog-title">库位信息 03-12-01</div>
<div class="dialog-body">
<table class="material-table">
<thead>
<tr>
<th>物料编号</th>
<th>物料名称</th>
<th>图号</th>
<th>型号</th>
<th>库存数量</th>
<th>锁定库存</th>
<th>批次</th>
</tr>
</thead>
<tbody>
<tr>
<td>02.009.001.0012</td>
<td>直线导轨组件</td>
<td>LRS3056-0312-01</td>
<td>HGW25CA</td>
<td><div class="qty">14.000</div><div class="unit">台</div></td>
<td><div class="lockqty">2.000</div><div class="unit">台</div></td>
<td>BATCH031201</td>
</tr>
<tr>
<td>02.009.001.0013</td>
<td>滑块组件</td>
<td>LRS3056-0312-02</td>
<td>HGW25CC</td>
<td><div class="qty">6.000</div><div class="unit">台</div></td>
<td><div style="color:#909399">0.000</div><div class="unit">台</div></td>
<td>BATCH031202</td>
</tr>
</tbody>
</table>
</div>
<div class="dialog-footer"><button class="close-button">关闭</button></div>
</div>
</div>
<script>
const columns = 48;
const rows = ['04-04','04-03','04-02','04-01','03-04','03-03','03-02','03-01'];
const statuses = [2,0,1,2,0,0,2,1,0,2,1,2,0,9,2,0,1,0,2,2,0,1,0,2,0,0,1,2,0,2,0,1,2,0,0,9,2,1,0,2,0,1,2,0,0,2,1,0];
const head = document.getElementById('headRow');
for (let c = 1; c <= columns; c++) {
const th = document.createElement('th');
th.textContent = c;
if (c === 12) th.className = 'highlight-col';
head.appendChild(th);
}
const tbody = document.getElementById('tableBody');
rows.forEach((row, rIndex) => {
const tr = document.createElement('tr');
if (row === '03-01') tr.className = 'highlight-row';
const rowCell = document.createElement('td');
rowCell.className = 'row-layer-cell';
rowCell.textContent = row;
tr.appendChild(rowCell);
for (let c = 1; c <= columns; c++) {
const status = statuses[(c + rIndex * 5) % statuses.length];
const td = document.createElement('td');
td.className = 'cell status-' + status;
if (row === '03-01' && c === 12) td.className += ' selected';
const text = status === 2 ? '物' : status === 1 ? '盘' : status === 9 ? '锁' : '空';
const icon = status === 2 ? '▣' : status === 1 ? '▤' : status === 9 ? '🔒' : '－';
td.innerHTML = '<span class="text-symbol">' + text + '</span><span class="icon-symbol">' + icon + '</span>';
if (row === '03-01' && c === 12) {
const tip = document.createElement('span');
tip.className = 'tooltip';
tip.textContent = '有物料有托盘';
td.appendChild(tip);
}
tr.appendChild(td);
}
tbody.appendChild(tr);
});
const params = new URLSearchParams(location.search);
const shot = params.get('shot');
if (shot === 'filter') {
document.body.classList.add('show-filter-tip');
document.body.classList.add('mode-icon');
document.getElementById('modeText').textContent = '显示图标';
document.getElementById('aisleSelect').textContent = '第三巷道';
document.getElementById('rowSelect').textContent = '03-01';
}
if (shot === 'detail') document.body.classList.add('show-detail');
if (shot === 'material') document.body.classList.add('show-material');
</script>
</body>
</html>

167
docs/入库退货同步库存盘点库存设计说明.md Normal file
View File

@@ -0,0 +1,167 @@
# 入库退货同步库存盘点库存设计说明
## 01-功能内容
本次修复针对入库记录组件发起退货后，库存盘点组件中的对应库位库存未同步减少的问题。
原问题现象：
1. 用户在“入库记录”组件中对采购件、耗材或自制件执行退货。
2. 入库记录自身的退货数、入库数等数据已修改。
3. 库存盘点组件中对应物料、对应库位的库存数未同步减少。
4. 用户在库存盘点组件中点击编辑库存时，页面会重新读取未同步的盘点库存，导致库存数看起来“变回来”。
修复目标：
1. 入库记录退货成功时，同步扣减库存盘点对应库位库存。
2. 扣减对象必须精确到原入库记录的 `货位流水号`。
3. 采购件、耗材、自制件退货均支持同步扣减。
4. 如果库存盘点中找不到对应库位库存，或库存不足，应阻止退货并给出错误。
5. 保持原有入库记录、退货记录、采购合同状态更新逻辑不变。
## 02-程序开发步骤
### 前端改造
1. 在入库记录组件发起退货校验时，补传当前行的 `入库记录流水号`。
2. 后端通过 `入库记录流水号` 读取原入库记录中的 `货位流水号`。
3. 避免仅通过物料、合同、批次、入库时间等条件推断库位，防止扣错库位。
涉及前端文件：
- `src/views/WarehouseManagement/WarehousingRecord/WarehousingRecord.vue`
核心参数调整：
```js
param[6] = ['入库记录流水号', this.DeliveryNumber]
```
### 后端改造
1. 调整采购/耗材退货验证过程：
- `仓储管理_入库记录_退货入库_验证`
2. 调整采购/耗材退货执行过程：
- `仓储管理_入库记录_退货入库`
3. 调整自制件退货执行过程：
- `仓储管理_自制件入库记录_退货入库`
4. 退货时按原入库记录中的 `货位流水号` 扣减：
- `库存管理_物料与货位对照表.货位存量`
5. 采购件和耗材按外购件库存表处理。
6. 自制件按自制件入库记录中的库位处理。
7. 所有扣减、退货记录插入、入库记录回写放在事务中执行，任一步失败则回滚。
涉及 SQL 脚本：
- `sql/仓储管理_入库退货同步盘点库存.sql`
## 03-推进台账
| 轮次 | 做了什么 | 改了哪些文件/对象 | 验证了什么 | 下一步 |
| --- | --- | --- | --- | --- |
| 1 | 分析退货后库存盘点不变原因 | 入库记录组件、退货存储过程 | 确认退货未按原入库库位精确扣减盘点库存 | 设计同步扣减方案 |
| 2 | 前端退货校验补传入库记录流水号 | `WarehousingRecord.vue` | 参数可传到后端验证过程 | 改造 SQL |
| 3 | 改造采购/耗材退货验证过程 | `仓储管理_入库记录_退货入库_验证` | 可按入库记录读取原货位 | 改造退货执行 |
| 4 | 改造采购/耗材退货执行过程 | `仓储管理_入库记录_退货入库` | 退货时扣减对应库位库存 | 覆盖自制件 |
| 5 | 改造自制件退货执行过程 | `仓储管理_自制件入库记录_退货入库` | 自制件退货也同步扣减盘点库存 | 编译和执行脚本 |
| 6 | 执行 SQL 脚本并验证对象 | SQL Server 数据库 | 3 个过程已成功更新 | 形成修复文档 |
## 04-任务矩阵
| 任务编号 | 任务内容 | 状态 | 验收标准 |
| --- | --- | --- | --- |
| R-001 | 定位入库退货和库存盘点库存不同步原因 | 已完成 | 明确退货扣减未精确同步库存盘点库位库存 |
| R-002 | 前端退货验证补传 `入库记录流水号` | 已完成 | 采购/耗材退货验证参数包含入库记录流水号 |
| R-003 | 采购/耗材退货验证按原入库库位校验库存 | 已完成 | 库存不足或未找到对应库位库存时不允许退货 |
| R-004 | 采购/耗材退货执行同步扣减盘点库存 | 已完成 | `库存管理_物料与货位对照表.货位存量` 减少退货数量 |
| R-005 | 自制件退货执行同步扣减盘点库存 | 已完成 | 自制件原入库库位库存同步减少 |
| R-006 | SQL 事务保护 | 已完成 | 退货记录、入库记录、库存扣减任一步失败均回滚 |
| R-007 | 前端结构验证 | 已完成 | `WarehousingRecord.vue` 模板和脚本解析通过 |
| R-008 | SQL 对象部署验证 | 已完成 | 相关存储过程已在目标库更新 |
## 05-验收证据
### 前端验证
验证文件：
- `src/views/WarehouseManagement/WarehousingRecord/WarehousingRecord.vue`
验证内容：
1. 采购/耗材退货校验参数已补充：
```js
param[6] = ['入库记录流水号', this.DeliveryNumber]
```
2. Vue 单文件结构解析通过：
```text
template ok
script ok
```
### SQL 验证
目标数据库：
- SQL Server：`192.168.1.27`
- 数据库：`ERPTOOL_JY_20250826Back`
部署脚本：
```text
sql/仓储管理_入库退货同步盘点库存.sql
```
已更新对象：
```text
仓储管理_入库记录_退货入库
仓储管理_入库记录_退货入库_验证
仓储管理_自制件入库记录_退货入库
```
验证结果：
```text
sql compile ok
仓储管理_入库记录_退货入库 2026/6/27 9:30:02
仓储管理_入库记录_退货入库_验证 2026/6/27 9:30:02
仓储管理_自制件入库记录_退货入库 2026/6/27 9:30:02
```
## 06-决策记录
| 决策点 | 选择 | 原因 |
| --- | --- | --- |
| 库存扣减定位方式 | 使用 `入库记录流水号` 反查原 `货位流水号` | 最精确，避免同物料多库位时扣错库位 |
| 是否继续按物料、合同、批次、时间匹配 | 保留为辅助条件，但核心以原入库库位为准 | 原匹配条件无法唯一确定库位 |
| 库存不足时如何处理 | 阻止退货并回滚事务 | 避免库存盘点出现负数或账实不一致 |
| 采购/耗材和自制件是否共用逻辑 | 分别改造对应过程 | 两类入库记录来源表不同，分开更符合现有结构 |
| 是否只改前端 | 否，必须改后端存储过程 | 库存一致性应由数据库事务保证 |
| 是否影响库存调拨功能 | 不直接影响 | 退货扣减和调拨是两条库存变动路径，但都作用于库存盘点库位库存 |
## 07-业务流程
```mermaid
flowchart TD
A["入库记录组件点击退货"] --> B["前端提交退货数量、原因、入库记录流水号"]
B --> C["后端读取原入库记录"]
C --> D["取得物料流水号、批次、原货位流水号"]
D --> E{"对应库位库存是否足够"}
E -- "否" --> F["阻止退货并返回错误"]
E -- "是" --> G["插入退货记录"]
G --> H["回写入库记录退货数量"]
H --> I["扣减库存盘点对应库位货位存量"]
I --> J["更新采购合同/订单状态"]
J --> K["提交事务"]
```
## 08-后续注意事项
1. 之后所有库存减少类业务，都应明确扣减到具体 `货位流水号`。
2. 不建议再用“物料 + 批次 + 时间”推断库位，存在多库位同批次时扣错风险。
3. 若后续增加退货撤销功能，应同步反向增加对应库位库存。
4. 若库存盘点支持通用件、自制件、采购件多库存表，后续可抽出统一库存变动存储过程，减少重复逻辑。

108
docs/库存调拨/01-项目功能内容.md Normal file
View File

@@ -0,0 +1,108 @@
# 01-项目功能内容
## 功能名称
库存盘点组件库存调拨功能。
## 应用场景
本功能用于仓储管理中的库存盘点页面。现场盘点时，用户发现某个物料的库存需要从当前库位转移到另一个库位，或者目标库位尚未在系统中维护，需要在调拨时一键新建库位，并把调拨数量从原库位库存中扣减、增加到目标库位库存中。
应用页面：
```text
src/views/WarehouseManagement/InventoryCheck/index.vue
```
## 功能目标
1. 在库存盘点列表行内增加“调拨”操作。
2. 点击“调拨”打开库存调拨弹窗。
3. 弹窗自动带出物料名称、图号/型号、原库位、原库存数。
4. 支持选择已有目标库位。
5. 支持输入新库位名称并一键新建库位。
6. 新库位创建成功后自动刷新库位下拉并回填目标库位。
7. 用户输入调拨数量后，提交时从原库位库存数扣减该数量。
8. 如果目标库位已有同物料库存，则目标库位库存累加调拨数量。
9. 如果目标库位没有同物料库存，则新增目标库位的物料库存记录。
10. 调拨成功后刷新库存盘点列表。
11. 后端记录调拨流水，便于追溯操作人、原库位、目标库位、调拨前后库存。
## 功能边界
本次实现的是库存盘点组件内的轻量级库存调拨，不做完整调拨单流程。
包含：
| 功能点 | 说明 |
| --- | --- |
| 行内调拨 | 在库存盘点表格中直接对单行库存发起调拨 |
| 选择目标库位 | 从现有库位下拉中选择 |
| 一键新建库位 | 新建库位后回填为目标库位 |
| 原库位扣减 | 调拨数量从原库位库存中扣除 |
| 目标库位增加 | 已存在则累加，不存在则新增 |
| 调拨记录 | 记录调拨前后库存和操作信息 |
不包含：
| 不包含内容 | 原因 |
| --- | --- |
| 独立调拨单页面 | 当前需求聚焦盘点现场快速调整 |
| 调拨审批 | 未纳入本次业务流程 |
| 打印调拨单 | 未纳入本次验收 |
| 调出确认、调入确认 | 本次为单步原子调拨 |
| 跨仓库复杂调拨 | 当前只有库位级调拨 |
| 外协调拨 | 外协调拨已有独立业务范围 |
## 关键业务规则
| 规则编号 | 规则内容 |
| --- | --- |
| BR-001 | 调拨数量必须大于 0 |
| BR-002 | 调拨数量不能大于原库位当前库存 |
| BR-003 | 目标库位不能为空 |
| BR-004 | 目标库位不能等于原库位 |
| BR-005 | 新库位名称不能为空 |
| BR-006 | 新库位名称不能重复 |
| BR-007 | 后端必须以数据库当前库存重新校验，不能只信任前端原库存数 |
| BR-008 | 原库位扣减、目标库位增加、调拨记录写入必须在同一事务中完成 |
| BR-009 | 调拨后原库位库存为 0 时保留库存记录 |
## 涉及数据对象
| 数据对象 | 用途 |
| --- | --- |
| `库存管理_物料与货位对照表` | 普通物料库位库存 |
| `库存管理_半成品与货位对照表` | 通用件库位库存 |
| `库存管理_货位主文件` | 库位基础数据 |
| `库存盘点_调拨记录` | 库存调拨日志 |
| `库存盘点_修改记录` | 保留原库存修改记录能力 |
## 涉及接口
| 接口/过程 | 类型 | 用途 |
| --- | --- | --- |
| `仓储管理_库存盘点_查询` | 查询 | 调拨前后刷新库存盘点列表 |
| `仓储管理_库位_查询` | 查询 | 获取库位下拉 |
| `仓储管理_库位_验证是否存在` | 查询 | 新建库位前校验重复 |
| `仓储管理_库位_增加数据` | 增改 | 新增目标库位 |
| `仓储管理_库存盘点_库存调拨` | 增改 | 执行原子调拨 |
## 用户操作流程
```mermaid
flowchart TD
A["进入库存盘点页面"] --> B["选择一行库存记录"]
B --> C["点击调拨"]
C --> D["打开库存调拨弹窗"]
D --> E{"目标库位是否已存在"}
E -- "存在" --> F["选择目标库位"]
E -- "不存在" --> G["输入新库位名称并新建"]
G --> F
F --> H["输入调拨数量和备注"]
H --> I["提交调拨"]
I --> J["后端事务扣减原库位并增加目标库位"]
J --> K["写入调拨记录"]
K --> L["刷新库存盘点列表"]
```

264
docs/库存调拨/02-项目程序开发详细步骤.md Normal file
View File

@@ -0,0 +1,264 @@
# 02-项目程序开发详细步骤
## 开发入口
前端页面：
```text
src/views/WarehouseManagement/InventoryCheck/index.vue
```
SQL 脚本：
```text
sql/仓储管理_库存盘点_库存调拨.sql
```
## 第 1 步：梳理现有库存盘点页面
确认页面已有能力：
| 已有能力 | 说明 |
| --- | --- |
| 库存查询 | 调用 `仓储管理_库存盘点_查询` |
| 编辑库存 | 调用 `仓储管理_库存盘点_货位数量_编辑数据` |
| 库位下拉 | 调用 `仓储管理_库位_查询` |
| 新增物料存货 | 页面已有新增库存相关逻辑 |
确认表格已有字段：
```text
物料编码
物料流水号
物料名称
图号或型号
物料与货位流水号
类型
库存
货位流水号
货位名称
批次编号
```
## 第 2 步：增加表格调拨入口
在库存盘点表格操作列增加“调拨”按钮。
实现要求：
1. 原操作列宽度调整为可容纳“编辑”和“调拨”。
2. 行处于编辑状态时不显示调拨按钮。
3. 行不处于编辑状态时显示调拨按钮。
关键逻辑：
```html
<el-button v-if="!scope.row.edit" type="text" size="mini" @click="openTransfer(scope.row)">调拨</el-button>
```
## 第 3 步：增加调拨状态和表单对象
在 `data()` 中增加：
```js
transferDialogVisible: false,
transferLocationAdding: false,
transferSubmitting: false,
transferForm: {
物料与货位流水号: '',
物料流水号: '',
物料名称: '',
图号或型号: '',
类型: '',
原货位流水号: '',
原货位名称: '',
原库存数: 0,
目标货位流水号: '',
目标货位名称: '',
新货位名称: '',
调拨数量: 1,
调拨备注: ''
}
```
## 第 4 步：增加库存调拨弹窗
新增 `el-dialog`，标题为：
```text
库存调拨
```
弹窗内容：
| 字段 | 控件 | 是否可编辑 |
| --- | --- | --- |
| 物料名称 | 文本 | 否 |
| 图号/型号 | 文本 | 否 |
| 原库位 | 文本 | 否 |
| 原库存数 | 文本 | 否 |
| 目标库位 | `el-select` | 是 |
| 新库位 | `el-input` | 是 |
| 调拨数量 | `el-input-number` | 是 |
| 调拨备注 | `el-input` | 是 |
## 第 5 步：打开调拨弹窗
新增方法：
```js
openTransfer(row)
```
处理内容：
1. 校验当前行是否有 `物料与货位流水号`。
2. 校验当前行库存是否大于 0。
3. 将当前行物料、库位、库存信息填入 `transferForm`。
4. 清空目标库位、新库位、备注。
5. 打开调拨弹窗。
## 第 6 步：选择目标库位
新增方法：
```js
handleTransferLocationChange(value)
```
处理内容：
1. 根据选择的 `货位流水号`，从 `storageLocation` 中找到货位名称。
2. 回填 `transferForm.目标货位名称`。
## 第 7 步：一键新建库位
新增方法：
```js
addTransferLocation()
```
处理流程：
1. 校验 `transferForm.新货位名称` 不能为空。
2. 调用 `仓储管理_库位_验证是否存在`。
3. 如果库位已存在，提示并按库位名称回填已有库位。
4. 如果库位不存在，调用 `仓储管理_库位_增加数据`。
5. 新增成功后调用 `getLocateName()` 刷新库位下拉。
6. 调用 `selectTransferLocation(locationName)` 回填目标库位。
## 第 8 步：提交库存调拨
新增方法：
```js
submitTransfer()
```
前端校验：
| 校验项 | 提示 |
| --- | --- |
| 目标库位为空 | 请选择目标库位 |
| 目标库位等于原库位 | 目标库位不能与原库位相同 |
| 调拨数量小于等于 0 | 调拨数量必须大于0 |
| 调拨数量大于原库存 | 调拨数量不能大于原库存数 |
提交参数：
| 序号 | 参数名 |
| --- | --- |
| 0 | 物料与货位流水号 |
| 1 | 物料流水号 |
| 2 | 原货位流水号 |
| 3 | 目标货位流水号 |
| 4 | 调拨数量 |
| 5 | 原库存数 |
| 6 | 调拨备注 |
| 7 | 操作者 |
| 8 | 类型 |
调用接口：
```js
var Data = this.CreateData('12', '仓储管理_库存盘点_库存调拨', param)
```
成功后：
1. 提示“调拨成功”。
2. 关闭调拨弹窗。
3. 调用 `searchTable()` 刷新列表。
## 第 9 步：后端脚本设计
脚本文件：
```text
sql/仓储管理_库存盘点_库存调拨.sql
```
脚本内容：
1. 如果 `库存盘点_调拨记录` 不存在，则创建该表。
2. 删除并重建存储过程 `dbo.仓储管理_库存盘点_库存调拨`。
3. 按 `@类型` 判断库存表：
- `@类型 = N'通用件'` 使用 `库存管理_半成品与货位对照表`。
- 其他类型使用 `库存管理_物料与货位对照表`。
4. 使用事务处理扣减、增加、新增目标记录、写入日志。
5. 出错时回滚并返回失败信息。
## 第 10 步：后端事务流程
```text
BEGIN TRAN
锁定原库存记录
校验原库存记录存在
校验目标库位不等于原库位
校验当前库存 >= 调拨数量
扣减原库位库存
查询目标库位同物料库存
如果存在则增加目标库存
如果不存在则新增目标库存记录
写入库存盘点_调拨记录
COMMIT TRAN
```
失败处理：
```text
ROLLBACK TRAN
返回 result = 0 和 msg
```
## 第 11 步：数据库部署
部署目标：
```text
SQL Server: 192.168.1.27
Database: ERPTOOL_JY_20250826Back
```
部署对象：
```text
库存盘点_调拨记录
仓储管理_库存盘点_库存调拨
```
## 第 12 步：验证
验证项：
1. SQL 脚本编译通过。
2. 数据库对象存在。
3. 存储过程参数完整。
4. 前端模板解析通过。
5. 前端脚本解析通过。
6. 页面实际选择库存记录调拨。
7. 原库位库存减少。
8. 目标库位库存增加或新增。
9. 调拨记录写入。

48
docs/库存调拨/03-推进台账.md Normal file
View File

@@ -0,0 +1,48 @@
# 03-推进台账
## 台账说明
本文记录库存调拨功能每轮推进情况，包括做了什么、改了哪些文件、验证了什么、下一步是什么。后续继续开发或验收时，应优先查看本台账，避免重复分析。
## 推进台账
| 轮次 | 做了什么 | 改了哪些文件/对象 | 验证了什么 | 下一步 |
| --- | --- | --- | --- | --- |
| 1 | 生成初版库存调拨方案，偏完整调拨单流程 | `库存调拨功能设计方案.md` | 参考仓储模块已有调拨、库存查询页面 | 根据实际场景收敛设计 |
| 2 | 按用户补充场景重写方案，聚焦库存盘点组件内调拨 | `docs/库存调拨/库存调拨功能设计方案.md` | 确认目标是盘点页内一键新建库位并扣减原库位库存 | 开始开发 |
| 3 | 梳理库存盘点页面现状 | `src/views/WarehouseManagement/InventoryCheck/index.vue` | 确认已有库存、库位、物料货位字段和查询接口 | 增加前端交互 |
| 4 | 增加表格“调拨”按钮 | `src/views/WarehouseManagement/InventoryCheck/index.vue` | 操作列支持编辑和调拨两个入口 | 增加弹窗 |
| 5 | 增加库存调拨弹窗和 `transferForm` | `src/views/WarehouseManagement/InventoryCheck/index.vue` | 弹窗可展示物料、图号、原库位、原库存数等字段 | 增加库位选择 |
| 6 | 增加目标库位选择和库位名称同步 | `src/views/WarehouseManagement/InventoryCheck/index.vue` | 选择货位流水号后可同步目标货位名称 | 增加一键新建库位 |
| 7 | 增加一键新建库位逻辑 | `src/views/WarehouseManagement/InventoryCheck/index.vue` | 调用 `仓储管理_库位_验证是否存在`、`仓储管理_库位_增加数据` | 增加调拨提交 |
| 8 | 增加 `submitTransfer()` 调拨提交逻辑 | `src/views/WarehouseManagement/InventoryCheck/index.vue` | 前端校验目标库位、调拨数量、原库存限制 | 设计后端原子接口 |
| 9 | 编写 SQL 调拨脚本 | `sql/仓储管理_库存盘点_库存调拨.sql` | 脚本包含记录表和调拨存储过程 | 编译检查 |
| 10 | 执行 SQL 编译检查 | `sql/仓储管理_库存盘点_库存调拨.sql` | `SET NOEXEC ON` 编译输出 `sql compile ok` | 部署数据库对象 |
| 11 | 在 SQL Server 创建调拨对象 | 数据库对象：`库存盘点_调拨记录`、`仓储管理_库存盘点_库存调拨` | 查询 `sys.objects` 确认对象存在 | 验证参数和字段 |
| 12 | 查询存储过程参数和记录表字段 | SQL Server 元数据 | 确认 9 个存储过程参数和调拨记录表字段 | 做前端静态验证 |
| 13 | 前端模板和脚本解析 | `src/views/WarehouseManagement/InventoryCheck/index.vue` | 输出 `template ok`、`script ok` | 页面联调 |
| 14 | 生成开发说明文档 | `docs/库存调拨/库存调拨功能开发说明.md` | 汇总功能、步骤、证据、任务矩阵、决策记录 | 按用户要求拆分 7 份文档 |
| 15 | 拆分项目矩阵化文档 | `docs/库存调拨/01-项目功能内容.md` 等 7 份文档 | 文档目录可作为后续推进索引 | 后续补页面截图或实际业务数据验收 |
## 当前状态
| 类型 | 状态 |
| --- | --- |
| 前端开发 | 已完成基础开发 |
| 后端脚本 | 已完成并执行 |
| 数据库对象 | 已创建 |
| 静态验证 | 已完成 |
| 页面实测 | 待执行 |
| 真实数据调拨验收 | 待执行 |
| 截图/PDF 验收材料 | 待补充 |
## 下一步建议
1. 使用测试账号进入库存盘点页面。
2. 查询一条库存大于 0 的物料库位记录。
3. 点击“调拨”。
4. 先调拨到已有库位，验证原库位扣减、目标库位增加。
5. 再新建库位并调拨，验证目标库存记录新增。
6. 查询 `库存盘点_调拨记录`，核对调拨前后库存。
7. 对上述步骤截图，补充到 `05-验收证据.md`。

70
docs/库存调拨/04-任务矩阵.md Normal file
View File

@@ -0,0 +1,70 @@
# 04-任务矩阵
## 任务矩阵说明
本文用于记录库存调拨功能所有任务编号、状态和验收标准。后续继续推进时，先检查任务状态，避免重复开发或重复验证。
状态说明：
| 状态 | 含义 |
| --- | --- |
| 已完成 | 已开发或已验证完成 |
| 待执行 | 需要后续继续做 |
| 待补充 | 已有基础内容，但需要补充更完整证据 |
| 阻塞 | 当前缺少条件，无法推进 |
## 任务矩阵
| 任务编号 | 任务名称 | 状态 | 验收标准 |
| --- | --- | --- | --- |
| INV-TR-001 | 明确应用场景 | 已完成 | 方案明确为库存盘点组件内调拨，不做完整调拨单 |
| INV-TR-002 | 编写库存调拨设计方案 | 已完成 | `docs/库存调拨/库存调拨功能设计方案.md` 已存在 |
| INV-TR-003 | 梳理库存盘点现有字段和接口 | 已完成 | 明确 `库存`、`货位流水号`、`物料与货位流水号` 等字段 |
| INV-TR-004 | 增加表格调拨按钮 | 已完成 | `InventoryCheck/index.vue` 操作列出现“调拨”按钮 |
| INV-TR-005 | 增加调拨弹窗 | 已完成 | 弹窗展示物料、图号、原库位、原库存数、目标库位、新库位、调拨数量、备注 |
| INV-TR-006 | 增加调拨状态变量 | 已完成 | 存在 `transferDialogVisible`、`transferLocationAdding`、`transferSubmitting` |
| INV-TR-007 | 增加 `transferForm` | 已完成 | 表单包含原库存、目标库位、新库位、调拨数量、调拨备注 |
| INV-TR-008 | 打开调拨弹窗方法 | 已完成 | `openTransfer(row)` 可带出当前行库存信息 |
| INV-TR-009 | 目标库位选择联动 | 已完成 | `handleTransferLocationChange(value)` 可同步目标货位名称 |
| INV-TR-010 | 一键新建库位 | 已完成 | `addTransferLocation()` 可验证重复并新增库位 |
| INV-TR-011 | 新库位回填目标库位 | 已完成 | `selectTransferLocation(locationName)` 可按名称回填新增库位 |
| INV-TR-012 | 调拨提交前端校验 | 已完成 | 目标库位、调拨数量、原库存边界均有校验 |
| INV-TR-013 | 调拨提交接口调用 | 已完成 | 调用 `仓储管理_库存盘点_库存调拨` 并传 9 个参数 |
| INV-TR-014 | 前端传入 `类型` 参数 | 已完成 | 后端可按普通物料/通用件分支处理 |
| INV-TR-015 | 新增调拨 SQL 脚本 | 已完成 | `sql/仓储管理_库存盘点_库存调拨.sql` 已存在 |
| INV-TR-016 | 新增调拨记录表 | 已完成 | 数据库存在 `库存盘点_调拨记录` |
| INV-TR-017 | 新增调拨存储过程 | 已完成 | 数据库存在 `仓储管理_库存盘点_库存调拨` |
| INV-TR-018 | 普通物料调拨分支 | 已完成 | 使用 `库存管理_物料与货位对照表` 扣减和增加 |
| INV-TR-019 | 通用件调拨分支 | 已完成 | 使用 `库存管理_半成品与货位对照表` 扣减和增加 |
| INV-TR-020 | 原库位库存不足校验 | 已完成 | 后端当前库存不足时返回失败并回滚 |
| INV-TR-021 | 目标库位已有库存累加 | 已完成 | 目标库位存在同物料记录时累加库存 |
| INV-TR-022 | 目标库位无库存新增 | 已完成 | 目标库位不存在同物料记录时新增记录 |
| INV-TR-023 | 写入调拨记录 | 已完成 | 调拨记录包含原库位、目标库位、调拨前后库存 |
| INV-TR-024 | SQL 编译检查 | 已完成 | 编译输出 `sql compile ok` |
| INV-TR-025 | 数据库对象验证 | 已完成 | `sys.objects` 可查到表和过程 |
| INV-TR-026 | 存储过程参数验证 | 已完成 | `sys.parameters` 可查到 9 个参数 |
| INV-TR-027 | 调拨记录字段验证 | 已完成 | `INFORMATION_SCHEMA.COLUMNS` 可查到记录字段 |
| INV-TR-028 | 前端模板解析 | 已完成 | `vue-template-compiler` 输出 `template ok` |
| INV-TR-029 | 前端脚本解析 | 已完成 | Babel/脚本解析输出 `script ok` |
| INV-TR-030 | 实际页面调拨到已有库位 | 待执行 | 原库位库存减少，目标库位库存增加 |
| INV-TR-031 | 实际页面调拨到新库位 | 待执行 | 新库位创建成功，目标库存记录新增 |
| INV-TR-032 | 调拨记录业务核对 | 待执行 | `库存盘点_调拨记录` 中调拨前后库存正确 |
| INV-TR-033 | 页面截图留档 | 待补充 | 调拨前、弹窗、调拨后、数据库记录截图齐全 |
| INV-TR-034 | README 索引创建 | 已完成 | `docs/库存调拨/README.md` 指向 7 份文档 |
## 防重复规则
1. 凡状态为“已完成”的任务，后续不重复开发，只做回归验证。
2. 若发现已完成任务仍有缺陷，应新增缺陷任务编号，不直接覆盖原任务含义。
3. 页面实测类任务必须保留截图或数据库查询结果。
4. SQL 过程变更必须同步更新 `05-验收证据.md` 和 `06-决策记录.md`。
## 当前优先级
| 优先级 | 任务编号 | 原因 |
| --- | --- | --- |
| P0 | INV-TR-030 | 需要真实页面验证核心调拨能力 |
| P0 | INV-TR-031 | 需要验证一键新建库位闭环 |
| P1 | INV-TR-032 | 需要确认追溯记录可用于审计 |
| P1 | INV-TR-033 | 需要补齐交付验收材料 |

209
docs/库存调拨/05-验收证据.md Normal file
View File

@@ -0,0 +1,209 @@
# 05-验收证据
## 验收证据说明
本文记录库存调拨功能已经产生的命令、页面、数据库对象、脚本、输出结果等验收证据。后续如果补充截图、PDF、页面录屏、job_id、report_id，应继续追加到本文。
## 证据 1：文件清单
已新增或修改的关键文件：
```text
src/views/WarehouseManagement/InventoryCheck/index.vue
sql/仓储管理_库存盘点_库存调拨.sql
docs/库存调拨/库存调拨功能设计方案.md
docs/库存调拨/库存调拨功能开发说明.md
docs/库存调拨/01-项目功能内容.md
docs/库存调拨/02-项目程序开发详细步骤.md
docs/库存调拨/03-推进台账.md
docs/库存调拨/04-任务矩阵.md
docs/库存调拨/05-验收证据.md
docs/库存调拨/06-决策记录.md
docs/库存调拨/README.md
```
## 证据 2：数据库连接
数据库连接目标：
```text
SQL Server IP：192.168.1.27
数据库：ERPTOOL_JY_20250826Back
```
已验证连接结果：
```text
DatabaseName=ERPTOOL_JY_20250826Back
Version=Microsoft SQL Server 2008 (RTM) - 10.0.1600.22 (X64)
```
## 证据 3：SQL 编译检查
脚本：
```text
sql/仓储管理_库存盘点_库存调拨.sql
```
检查方式：
```sql
SET NOEXEC ON
-- 执行脚本文本做编译检查
SET NOEXEC OFF
```
输出结果：
```text
sql compile ok
```
## 证据 4：数据库对象创建
执行调拨脚本后查询 `sys.objects`，确认对象存在：
```text
仓储管理_库存盘点_库存调拨 SQL_STORED_PROCEDURE
库存盘点_调拨记录 USER_TABLE
```
验收标准：
| 对象 | 标准 | 状态 |
| --- | --- | --- |
| `仓储管理_库存盘点_库存调拨` | 存储过程存在 | 已通过 |
| `库存盘点_调拨记录` | 用户表存在 | 已通过 |
## 证据 5：存储过程参数
查询 `sys.parameters`，确认过程参数：
```text
1 @物料与货位流水号 int
2 @物料流水号 int
3 @原货位流水号 int
4 @目标货位流水号 int
5 @调拨数量 float
6 @原库存数 float
7 @调拨备注 nvarchar
8 @操作者 int
9 @类型 nvarchar
```
验收标准：
1. 参数包含原库存记录流水号。
2. 参数包含原货位和目标货位。
3. 参数包含调拨数量。
4. 参数包含操作者。
5. 参数包含类型，用于区分普通物料和通用件。
状态：已通过。
## 证据 6：调拨记录表字段
查询 `INFORMATION_SCHEMA.COLUMNS`，确认调拨记录表字段：
```text
库存调拨流水号 int
类型 nvarchar
物料流水号 int
原物料与货位流水号 int
原货位流水号 int
目标物料与货位流水号 int
目标货位流水号 int
调拨数量 float
调拨前原库存 float
调拨后原库存 float
调拨前目标库存 float
调拨后目标库存 float
调拨备注 nvarchar
操作人 int
操作时间 datetime
```
验收标准：
| 字段组 | 标准 | 状态 |
| --- | --- | --- |
| 原库位信息 | 可记录原库存流水号和原货位 | 已通过 |
| 目标库位信息 | 可记录目标库存流水号和目标货位 | 已通过 |
| 库存变化 | 可记录调拨前后库存 | 已通过 |
| 操作信息 | 可记录备注、操作人、时间 | 已通过 |
## 证据 7：前端静态检查
检查对象：
```text
src/views/WarehouseManagement/InventoryCheck/index.vue
```
检查内容：
1. Vue template 解析。
2. script 解析。
输出结果：
```text
template ok
script ok
```
说明：
命令因本机 Node 启动较慢触到超时边界，但在超时前已成功输出检查结果。
## 证据 8：页面验收待补充
当前仍需补充实际页面证据：
| 证据编号 | 页面/动作 | 状态 | 需要补充 |
| --- | --- | --- | --- |
| PAGE-001 | 库存盘点列表出现“调拨”按钮 | 待补充 | 页面截图 |
| PAGE-002 | 打开库存调拨弹窗 | 待补充 | 弹窗截图 |
| PAGE-003 | 选择已有目标库位调拨 | 待补充 | 调拨前后库存截图 |
| PAGE-004 | 新建库位并调拨 | 待补充 | 新库位回填截图 |
| PAGE-005 | 调拨记录写入 | 待补充 | SQL 查询结果截图 |
## 证据 9：建议补充的 SQL 核对语句
后续页面实测后，可用以下方向核对：
```sql
-- 查询调拨记录
SELECT TOP 20 *
FROM 库存盘点_调拨记录
ORDER BY 操作时间 DESC;
```
```sql
-- 查询普通物料库位库存
SELECT *
FROM 库存管理_物料与货位对照表
WHERE 物料流水号 = @物料流水号
AND 货位流水号 IN (@原货位流水号, @目标货位流水号);
```
```sql
-- 查询通用件库位库存
SELECT *
FROM 库存管理_半成品与货位对照表
WHERE 半成品流水号 = @物料流水号
AND 货位流水号 IN (@原货位流水号, @目标货位流水号);
```
## 当前验收结论
| 验收项 | 结论 |
| --- | --- |
| 前端基础实现 | 通过 |
| SQL 编译 | 通过 |
| 数据库对象创建 | 通过 |
| 参数和字段结构 | 通过 |
| 页面实际业务调拨 | 待补充 |
| 截图/PDF/report_id/job_id | 暂无，待页面验收时补充 |

106
docs/库存调拨/06-决策记录.md Normal file
View File

@@ -0,0 +1,106 @@
# 06-决策记录
## 决策记录说明
本文记录库存调拨功能中的关键决策。后续变更时，优先查阅本文，避免重复争论已经确定的技术和业务选择。
## ADR-001：不做完整调拨单流程
| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 库存调拨只做库存盘点组件内轻量调拨 |
| 原因 | 用户明确场景是盘点时快速把库存从原库位调到目标库位，并支持一键新建库位 |
| 影响 | 不新增独立调拨单页面、不做审批、不做打印 |
| 后续变更条件 | 如果业务要求调拨审批、打印、跨仓库流转，再新增独立调拨单模块 |
## ADR-002：使用后端原子存储过程完成调拨
| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 新增 `仓储管理_库存盘点_库存调拨`，由一个事务完成扣减和增加 |
| 原因 | 前端拆成两次请求会出现只扣不加、只加不扣、并发负库存风险 |
| 影响 | 前端只提交一次调拨请求，库存一致性由数据库保证 |
| 后续变更条件 | 如果未来迁移到后端服务层，也必须保留事务边界 |
## ADR-003：调拨数量使用 FLOAT
| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | `@调拨数量`、库存记录字段按 `float` 处理 |
| 原因 | 现有库存表 `货位存量` 使用 `float`，库存可能存在小数 |
| 影响 | 调拨支持小数库存 |
| 后续变更条件 | 若未来统一库存数量精度，应迁移为 decimal 并同步所有库存过程 |
## ADR-004：以后端当前库存为准
| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 前端传 `原库存数` 只作参考，后端必须重新查询并锁定当前库存 |
| 原因 | 多人同时操作时，前端库存可能已过期 |
| 影响 | 可以避免并发调拨造成负库存 |
| 后续变更条件 | 无。库存扣减类业务都应遵守该规则 |
## ADR-005：区分普通物料和通用件库存表
| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 根据 `@类型 = N'通用件'` 选择库存表 |
| 原因 | 现有系统中通用件使用 `库存管理_半成品与货位对照表`，普通物料使用 `库存管理_物料与货位对照表` |
| 影响 | 前端必须传 `类型` 参数 |
| 后续变更条件 | 如果后续统一库存表，可移除分支 |
## ADR-006：目标库位不存在同物料库存时新增记录
| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 目标库位已有同物料库存则累加，没有则新增库存记录 |
| 原因 | 盘点调拨常见场景是将物料拆分到新库位 |
| 影响 | 调拨过程需要同时处理 update 和 insert |
| 后续变更条件 | 如果业务规定必须先建库存记录，再调拨，可改为无记录时报错 |
## ADR-007：原库位库存为 0 时保留记录
| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 调拨后原库位库存为 0，不物理删除库存记录 |
| 原因 | 保留历史库位关系，便于追溯，也符合盘点页库存可编辑为 0 的现状 |
| 影响 | 查询页面是否显示 0 库存由查询条件控制 |
| 后续变更条件 | 如果业务要求隐藏 0 库存，优先改查询，不建议删除记录 |
## ADR-008：一键新建库位复用现有接口
| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 复用 `仓储管理_库位_验证是否存在` 和 `仓储管理_库位_增加数据` |
| 原因 | 系统已有库位校验和新增能力，不重复造接口 |
| 影响 | 新库位创建逻辑与现有库位维护规则保持一致 |
| 后续变更条件 | 如果库位维护规则变化，应统一改库位接口 |
## ADR-009：新增轻量调拨记录表
| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 新增 `库存盘点_调拨记录` |
| 原因 | 旧库存修改记录无法完整表达“从哪个库位调到哪个库位” |
| 影响 | 后续可以按记录追溯调拨数量、原库位、目标库位、操作人 |
| 后续变更条件 | 如需要调拨单，可在该记录基础上扩展主从表 |
## ADR-010：暂不生成 PDF 和截图
| 项目 | 内容 |
| --- | --- |
| 状态 | 已采纳 |
| 决策 | 当前阶段只保留 Markdown 和命令/数据库证据 |
| 原因 | 功能尚需页面真实数据联调，截图/PDF 应在最终页面验收时生成 |
| 影响 | `05-验收证据.md` 中页面截图、PDF、report_id 暂为空 |
| 后续变更条件 | 页面实测完成后补充截图或 PDF 验收材料 |

64
docs/库存调拨/README.md Normal file
View File

@@ -0,0 +1,64 @@
# 库存调拨文档索引
## 目录说明
本目录用于沉淀“库存盘点组件库存调拨功能”的设计、开发、推进、验收和决策资料。后续继续开发或验收时，优先从本 README 和任务矩阵开始，避免重复分析和重复开发。
## 标准文档
| 序号 | 文档 | 用途 |
| --- | --- | --- |
| 01 | [01-项目功能内容.md](./01-项目功能内容.md) | 说明功能范围、业务规则、数据对象和接口范围 |
| 02 | [02-项目程序开发详细步骤.md](./02-项目程序开发详细步骤.md) | 说明前端、后端、数据库的详细开发步骤 |
| 03 | [03-推进台账.md](./03-推进台账.md) | 记录每轮做了什么、改了什么、验证了什么、下一步是什么 |
| 04 | [04-任务矩阵.md](./04-任务矩阵.md) | 记录所有任务编号、状态和验收标准 |
| 05 | [05-验收证据.md](./05-验收证据.md) | 汇总命令、数据库对象、输出结果、待补截图等证据 |
| 06 | [06-决策记录.md](./06-决策记录.md) | 记录为什么这么做，后续变更时避免重复争论 |
## 历史文档
| 文档 | 用途 |
| --- | --- |
| [库存调拨功能设计方案.md](./库存调拨功能设计方案.md) | 初始设计方案，包含较完整的业务和技术说明 |
| [库存调拨功能开发说明.md](./库存调拨功能开发说明.md) | 已开发内容汇总，包含早期推进台账和验收证据 |
## 当前任务状态摘要
| 事项 | 状态 |
| --- | --- |
| 前端调拨入口 | 已完成 |
| 调拨弹窗 | 已完成 |
| 一键新建库位 | 已完成 |
| 调拨提交 | 已完成 |
| 调拨 SQL 脚本 | 已完成 |
| 数据库调拨记录表 | 已创建 |
| 数据库调拨存储过程 | 已创建 |
| 前端静态验证 | 已完成 |
| SQL 编译验证 | 已完成 |
| 页面真实数据联调 | 待执行 |
| 页面截图/PDF 验收资料 | 待补充 |
## 后续推进顺序
1. 打开 [04-任务矩阵.md](./04-任务矩阵.md)，查看 `INV-TR-030` 之后的待执行任务。
2. 按 [05-验收证据.md](./05-验收证据.md) 中的待补页面证据进行实际页面验收。
3. 页面实测完成后，将截图、SQL 查询结果、PDF 或 report_id 补充到 `05-验收证据.md`。
4. 如果新增业务规则或改变调拨流程，先更新 [06-决策记录.md](./06-决策记录.md)，再改代码。
5. 如果新增任务，追加到 [04-任务矩阵.md](./04-任务矩阵.md)，不要复用已有任务编号。
## 快速入口
实际开发文件：
```text
src/views/WarehouseManagement/InventoryCheck/index.vue
sql/仓储管理_库存盘点_库存调拨.sql
```
核心数据库对象：
```text
库存盘点_调拨记录
仓储管理_库存盘点_库存调拨
```

202
docs/库存调拨/库存调拨功能开发说明.md Normal file
View File

@@ -0,0 +1,202 @@
# 库存盘点组件库存调拨功能开发说明
## 01-功能内容
本次功能在库存盘点组件中增加轻量级“库存调拨”能力，应用页面为：
```text
src/views/WarehouseManagement/InventoryCheck/index.vue
```
功能目标：
- 在库存盘点列表每一行增加“调拨”操作。
- 点击“调拨”后弹出库存调拨窗口。
- 自动带出当前行物料名称、图号/型号、原库位、原库存数。
- 支持选择已有目标库位。
- 支持在弹窗中输入新库位名称，并一键新增库位。
- 新增库位成功后自动刷新库位下拉，并回填为目标库位。
- 输入调拨数量后，提交时从原库位库存数中扣减该数量。
- 目标库位已有同物料库存时累加库存。
- 目标库位没有同物料库存时新增物料货位库存记录。
- 调拨成功后关闭弹窗并刷新库存盘点列表。
- 后端保留调拨记录，记录调拨前后库存、原库位、目标库位、操作人和操作时间。
本次不做完整调拨单流程，不包含审批、打印、调出确认、调入确认、外协调拨和跨仓库复杂流转。
## 02-程序开发步骤
1. 梳理库存盘点页面现状：
- 查询页面现有字段：`库存`、`货位流水号`、`货位名称`、`物料与货位流水号`。
- 确认现有接口：`仓储管理_库存盘点_查询`、`仓储管理_库存盘点_货位数量_编辑数据`、`仓储管理_库存盘点_物料货位数量_增加数据`。
2. 梳理库位管理现有接口：
- 查询库位：`仓储管理_库位_查询`。
- 验证库位是否存在：`仓储管理_库位_验证是否存在`。
- 新增库位：`仓储管理_库位_增加数据`。
3. 前端开发：
- 在库存盘点表格操作列增加“调拨”按钮。
- 新增 `transferDialogVisible`、`transferLocationAdding`、`transferSubmitting` 状态。
- 新增 `transferForm` 表单对象。
- 新增库存调拨弹窗。
- 新增 `openTransfer(row)` 打开弹窗方法。
- 新增 `handleTransferLocationChange(value)` 同步目标库位名称。
- 新增 `selectTransferLocation(locationName)` 新库位新增后回填目标库位。
- 新增 `addTransferLocation()` 一键新增库位。
- 新增 `submitTransfer()` 提交调拨。
4. 后端设计：
- 新增 SQL 脚本：`sql/仓储管理_库存盘点_库存调拨.sql`。
- 新增调拨记录表：`库存盘点_调拨记录`。
- 新增存储过程：`仓储管理_库存盘点_库存调拨`。
- 存储过程使用事务，确保原库位扣减、目标库位增加、新增目标库存记录、累计库存更新、调拨记录写入同时成功或失败。
5. 数据库创建：
- 已连接 SQL Server：`192.168.1.27`。
- 已在数据库 `ERPTOOL_JY_20250826Back` 中执行脚本。
- 已确认 `库存盘点_调拨记录` 和 `仓储管理_库存盘点_库存调拨` 创建成功。
## 03-推进台账
| 轮次 | 做了什么 | 改了哪些文件 | 验证了什么 | 下一步 |
| --- | --- | --- | --- | --- |
| 1 | 生成初版库存调拨设计方案，偏完整调拨单流程 | `库存调拨功能设计方案.md` | 参考了仓储模块现有 `TransferQuery`、`InventoryQuery` | 根据实际应用场景收敛方案 |
| 2 | 按用户补充场景重写方案，聚焦库存盘点组件内调拨 | `库存调拨功能设计方案.md` | 确认 `InventoryCheck/index.vue` 已有库存、库位和新增物料货位接口 | 开始前端开发 |
| 3 | 开发前端调拨入口和弹窗 | `src/views/WarehouseManagement/InventoryCheck/index.vue` | Vue 模板解析输出 `template ok`，脚本解析输出 `script ok` | 设计后端原子调拨接口 |
| 4 | 连接 SQL Server，读取相关存储过程和表结构 | 无代码文件变更 | 成功连接 `ERPTOOL_JY_20250826Back`，确认 SQL Server 2008；读取现有盘点、库位相关过程 | 编写调拨存储过程 |
| 5 | 新增存储过程脚本，适配普通物料和通用件 | `sql/仓储管理_库存盘点_库存调拨.sql`、`src/views/WarehouseManagement/InventoryCheck/index.vue` | SQL `NOEXEC` 编译检查输出 `sql compile ok`；前端补传 `类型` 参数 | 创建数据库对象 |
| 6 | 在数据库中创建调拨记录表和调拨存储过程 | 数据库对象：`库存盘点_调拨记录`、`仓储管理_库存盘点_库存调拨` | 查询 `sys.objects` 确认对象存在；查询参数和表字段确认结构 | 做页面联调和实际数据调拨测试 |
| 7 | 按要求生成开发说明文档 | `库存调拨功能开发说明.md` | 汇总开发内容、验证证据、任务矩阵和决策记录 | 等待业务数据联调 |
## 04-任务矩阵
| 任务编号 | 任务名称 | 状态 | 验收标准 |
| --- | --- | --- | --- |
| INV-TR-001 | 明确应用场景 | 已完成 | 方案明确为库存盘点组件内调拨，不做完整调拨单 |
| INV-TR-002 | 编写设计方案 | 已完成 | `库存调拨功能设计方案.md` 已按盘点调拨场景重写 |
| INV-TR-003 | 增加表格调拨按钮 | 已完成 | `InventoryCheck/index.vue` 操作列出现“调拨”按钮 |
| INV-TR-004 | 增加调拨弹窗 | 已完成 | 弹窗展示物料、图号、原库位、原库存数、目标库位、新库位、调拨数量、备注 |
| INV-TR-005 | 支持选择目标库位 | 已完成 | 目标库位使用现有 `storageLocation` 下拉，变化时同步目标库位名称 |
| INV-TR-006 | 支持一键新建库位 | 已完成 | 调用 `仓储管理_库位_验证是否存在` 和 `仓储管理_库位_增加数据`，成功后刷新并回填 |
| INV-TR-007 | 调拨前端校验 | 已完成 | 校验库存流水号、库存大于 0、目标库位非空、目标库位不等于原库位、调拨数量合法 |
| INV-TR-008 | 提交调拨接口调用 | 已完成 | 前端调用 `仓储管理_库存盘点_库存调拨`，传入调拨数量、目标库位、操作者、类型等参数 |
| INV-TR-009 | 设计存储过程脚本 | 已完成 | `sql/仓储管理_库存盘点_库存调拨.sql` 已生成 |
| INV-TR-010 | 创建调拨记录表 | 已完成 | 数据库中存在 `库存盘点_调拨记录` |
| INV-TR-011 | 创建调拨存储过程 | 已完成 | 数据库中存在 `仓储管理_库存盘点_库存调拨` |
| INV-TR-012 | SQL 编译检查 | 已完成 | `NOEXEC` 检查输出 `sql compile ok` |
| INV-TR-013 | 前端模板和脚本基础检查 | 已完成 | 输出 `template ok`、`script ok` |
| INV-TR-014 | 页面实际联调 | 待执行 | 在系统页面选择真实库存行，完成调拨并刷新列表 |
| INV-TR-015 | 数据库调拨结果核对 | 待执行 | 原库位库存减少，目标库位库存增加或新增，累计库存保持正确，调拨记录写入 |
## 05-验收证据
### 5.1 数据库连接证据
连接 SQL Server 后返回：
```text
DatabaseName=ERPTOOL_JY_20250826Back
Version=Microsoft SQL Server 2008 (RTM) - 10.0.1600.22 (X64)
```
### 5.2 SQL 编译证据
对 `sql/仓储管理_库存盘点_库存调拨.sql` 使用 `SET NOEXEC ON` 编译检查：
```text
sql compile ok
```
### 5.3 数据库对象创建证据
执行创建脚本后查询 `sys.objects`：
```text
仓储管理_库存盘点_库存调拨 SQL_STORED_PROCEDURE
库存盘点_调拨记录 USER_TABLE
```
### 5.4 存储过程参数证据
查询 `sys.parameters`：
```text
1 @物料与货位流水号 int
2 @物料流水号 int
3 @原货位流水号 int
4 @目标货位流水号 int
5 @调拨数量 float
6 @原库存数 float
7 @调拨备注 nvarchar
8 @操作者 int
9 @类型 nvarchar
```
### 5.5 调拨记录表字段证据
查询 `INFORMATION_SCHEMA.COLUMNS`：
```text
库存调拨流水号 int
类型 nvarchar
物料流水号 int
原物料与货位流水号 int
原货位流水号 int
目标物料与货位流水号 int
目标货位流水号 int
调拨数量 float
调拨前原库存 float
调拨后原库存 float
调拨前目标库存 float
调拨后目标库存 float
调拨备注 nvarchar
操作人 int
操作时间 datetime
```
### 5.6 前端静态检查证据
使用 `vue-template-compiler` 和 Babel 对 `InventoryCheck/index.vue` 做基础解析，输出：
```text
template ok
script ok
```
说明：命令因本机 Node 启动较慢触到超时边界，但成功输出了检查结果。
### 5.7 文件证据
新增/修改文件：
```text
src/views/WarehouseManagement/InventoryCheck/index.vue
sql/仓储管理_库存盘点_库存调拨.sql
库存调拨功能设计方案.md
库存调拨功能开发说明.md
```
## 06-决策记录
| 决策编号 | 决策 | 原因 | 后续影响 |
| --- | --- | --- | --- |
| ADR-001 | 不做完整调拨单流程 | 用户明确应用场景是库存盘点组件内快速调拨 | 页面内弹窗完成，不新增调拨单页面 |
| ADR-002 | 前端不拆成两次库存编辑请求 | 两次请求可能出现只扣不加或并发负库存 | 新增后端原子存储过程 |
| ADR-003 | 调拨数量使用 `FLOAT` | 库存表 `货位存量` 是 `float`，旧编辑过程用 `int` 有丢小数风险 | 新过程支持小数库存调拨 |
| ADR-004 | 通过 `物料与货位流水号` 反查物料/产品流水号 | `外购件库存_视图` 当前不返回 `物料流水号` | 前端传空也不影响后端执行 |
| ADR-005 | 支持普通物料和通用件两套表 | 现有盘点编辑过程按 `类型 = 通用件` 区分半成品表和物料表 | 存储过程内部按 `@类型` 分支处理 |
| ADR-006 | 调拨后原库位库存为 0 时保留记录 | 便于追溯，也符合盘点页库存可为 0 的现状 | 查询是否隐藏 0 库存由查询条件控制 |
| ADR-007 | 一键新建库位复用现有库位接口 | 项目已有 `仓储管理_库位_验证是否存在` 和 `仓储管理_库位_增加数据` | 不重复新增库位存储过程 |
| ADR-008 | 新增轻量调拨记录表 | 旧 `库存盘点_修改记录` 只能记录原库存更改，不记录目标库位和调拨前后目标库存 | 后续可扩展调拨记录查询 |
| ADR-009 | 前端传 `类型` 参数 | 避免普通物料和通用件流水号存在歧义 | 后端能明确走正确库存对照表 |
| ADR-010 | 暂不做页面截图/PDF | 当前任务聚焦开发和数据库对象创建，未启动本地页面联调 | 下一步实际页面验收时补截图证据 |
## 下一步建议
1. 在测试环境登录系统，进入库存盘点页面。
2. 选择一条库存大于 0 的记录点击“调拨”。
3. 选择已有库位进行调拨，验证原库位减少、目标库位增加。
4. 输入新库位名称点击“新建”，验证库位新增后自动回填。
5. 再执行一次调拨到新库位，验证目标库位新增库存记录。
6. 查询 `库存盘点_调拨记录`，确认调拨记录写入完整。

541
docs/库存调拨/库存调拨功能设计方案.md Normal file
View File

@@ -0,0 +1,541 @@
# 库存盘点组件库存调拨功能设计方案
## 0. 需求背景
当前库存盘点页面 `src/views/WarehouseManagement/InventoryCheck/index.vue` 已支持查询物料库存、编辑库存数、选择库位，并已存在新增物料货位数量的相关接口。现场盘点时，经常会发现同一物料的实际库存需要从原库位拆分到另一个库位，例如：
- 盘点发现物料实际摆放到了新库位。
- 原库位库存数量过多，需要拆一部分到新库位。
- 系统中还没有目标库位，需要现场一键新建库位后立即调拨。
- 需要保留原库位库存，只把输入的调拨数量从原库位扣掉，并增加到目标库位。
因此本次功能不设计完整调拨单流程，而是在“库存盘点”组件内增加轻量级库存调拨能力：选择一行库存，输入调拨数量，选择或新建目标库位，提交后直接完成原库位库存扣减和目标库位库存增加。
## 1. 设计目标
本功能面向库存盘点页面，核心目标如下：
- 在库存盘点表格行上增加“调拨”操作。
- 调拨弹窗中自动带出当前物料、原库位、原库存数。
- 支持选择已有目标库位。
- 支持一键新建目标库位，并自动回填为调入库位。
- 输入调拨数量后，提交时从原库位库存数中减掉该调拨数量。
- 如果目标库位已有同物料库存，则目标库位库存数增加调拨数量。
- 如果目标库位没有同物料库存，则新增一条物料与货位数量记录。
- 调拨后刷新库存盘点列表，保持页面显示与数据库一致。
## 2. 功能范围
本次只处理库存盘点组件内的库位库存调整，不新增独立“库存调拨单”页面。
包含：
- 盘点列表行内调拨。
- 一键新增库位。
- 原库位扣减库存。
- 目标库位增加库存。
- 调拨操作记录。
不包含：
- 调拨单主表和明细表。
- 调出确认、调入确认两段式流程。
- 审批流程。
- 跨仓库复杂调拨。
- 打印调拨单。
- 外协调拨。
## 3. 页面改造位置
现有页面：
```text
src/views/WarehouseManagement/InventoryCheck/index.vue
```
当前页面已有相关字段和接口：
- 表格字段：`库存`、`货位流水号`、`货位名称`、`物料与货位流水号`
- 库位下拉查询：`仓储管理_库位_查询`
- 盘点查询：`仓储管理_库存盘点_查询`
- 库存编辑：`仓储管理_库存盘点_货位数量_编辑数据`
- 新增物料货位数量验证：`仓储管理_库存盘点_物料货位数量_增加数据_验证是否存在`
- 新增物料货位数量：`仓储管理_库存盘点_物料货位数量_增加数据`
## 4. 前端交互设计
### 4.1 表格增加操作按钮
在库存盘点表格操作列增加：
```text
调拨
```
按钮显示规则：
- 当前行 `物料与货位流水号` 存在时显示。
- 当前行 `库存 > 0` 时允许点击。
- 如果库存为 0，按钮禁用或点击提示“当前库位库存为0，不能调拨”。
建议按钮：
```html
<el-button type="text" size="mini" @click="openTransfer(scope.row)">调拨</el-button>
```
### 4.2 调拨弹窗
新增 `el-dialog`：
```text
库存调拨
```
弹窗字段：
| 字段 | 控件 | 说明 |
| --- | --- | --- |
| 物料名称 | 文本 | 当前行带出，只读 |
| 图号或型号 | 文本 | 当前行带出，只读 |
| 原库位 | 文本 | 当前行 `货位名称`，只读 |
| 原库存数 | 文本 | 当前行 `库存`，只读 |
| 目标库位 | el-select | 选择已有库位 |
| 新库位名称 | el-input | 一键新建库位时填写 |
| 调拨数量 | el-input-number | 需要从原库位调出的数量 |
| 调拨备注 | el-input | 可选 |
弹窗按钮：
- 新建库位
- 确定调拨
- 取消
### 4.3 一键新建库位
在调拨弹窗中增加“新建库位”小区域：
```text
新库位名称 + 新建按钮
```
用户输入新库位名称后点击“新建库位”：
1. 校验库位名称不能为空。
2. 调用后端新增库位接口。
3. 新增成功后重新查询库位下拉。
4. 将新库位流水号自动赋值给 `transferForm.目标货位流水号`。
5. 提示“库位新增成功”。
接口建议：
```js
var Data = this.CreateData('12', '仓储管理_库位_增加', param)
```
参数建议：
| 参数名 | 说明 |
| --- | --- |
| 货位名称 | 新库位名称 |
| UserID | 当前用户 |
| ModularID | 当前路由 |
如果后端已有通用库位新增接口，应优先复用现有接口，不重复新增存储过程。
## 5. 调拨业务规则
### 5.1 数量规则
调拨数量必须满足：
```text
0 < 调拨数量 <= 原库存数
```
前端校验：
```js
if (Number(this.transferForm.调拨数量) <= 0) {
this.$message.warning('调拨数量必须大于0')
return
}
if (Number(this.transferForm.调拨数量) > Number(this.transferForm.原库存数)) {
this.$message.warning('调拨数量不能大于原库存数')
return
}
```
后端也必须重复校验，避免多人同时操作导致库存被扣成负数。
### 5.2 库位规则
目标库位必须满足：
- 目标库位不能为空。
- 目标库位不能等于原库位。
- 新建库位名称不能与已有库位重复。
### 5.3 库存更新规则
提交调拨后，后端一次性完成两个动作：
```text
原库位库存 = 原库位库存 - 调拨数量
目标库位库存 = 目标库位库存 + 调拨数量
```
如果目标库位不存在该物料库存记录：
```text
新增 物料 + 目标库位 的库存记录，库存数 = 调拨数量
```
如果目标库位已存在该物料库存记录：
```text
更新目标库位库存数，库存数 = 原目标库位库存数 + 调拨数量
```
### 5.4 原库位库存为 0 的处理
调拨后如果原库位库存变为 0，建议保留该物料货位记录，并显示库存为 0。
原因：
- 便于追溯原库位曾经存在该物料。
- 避免删除记录影响历史盘点记录。
- 与当前盘点页面“库存数可为 0”的逻辑一致。
如果现场明确要求隐藏 0 库存，可以在查询接口中过滤，不建议物理删除。
## 6. 数据字段设计
### 6.1 前端弹窗对象
建议新增：
```js
transferForm: {
物料与货位流水号: '',
物料流水号: '',
物料名称: '',
图号或型号: '',
原货位流水号: '',
原货位名称: '',
原库存数: 0,
目标货位流水号: '',
目标货位名称: '',
新货位名称: '',
调拨数量: 1,
调拨备注: ''
}
```
### 6.2 后端调拨接口参数
建议新增一个原子接口，避免前端连续调用两个编辑接口导致只扣不加或只加不扣。
接口：
```js
var Data = this.CreateData('12', '仓储管理_库存盘点_库存调拨', param)
```
参数：
| 参数名 | 说明 |
| --- | --- |
| 物料与货位流水号 | 原库存记录流水号 |
| 物料流水号 | 当前物料流水号 |
| 原货位流水号 | 原库位流水号 |
| 目标货位流水号 | 目标库位流水号 |
| 调拨数量 | 本次调拨数量 |
| 原库存数 | 页面带出的原库存数，仅用于校验参考 |
| 调拨备注 | 调拨备注 |
| 操作人 | UserID |
后端处理必须放在同一个事务中：
1. 查询原库存记录，并锁定或重新校验当前库存。
2. 校验当前库存是否大于等于调拨数量。
3. 扣减原库位库存。
4. 查询目标库位是否已有同物料记录。
5. 有则累加目标库位库存。
6. 无则新增目标库位库存记录。
7. 写入库存调拨记录。
8. 返回成功。
## 7. 调拨记录设计
建议新增轻量级调拨记录表，便于盘点后追溯谁把多少库存从哪个库位调到哪个库位。
字段建议：
| 字段名 | 说明 |
| --- | --- |
| 库存调拨流水号 | 主键 |
| 物料流水号 | 物料流水号 |
| 物料名称 | 冗余名称，便于查询 |
| 图号或型号 | 冗余图号 |
| 原物料与货位流水号 | 原库存记录 |
| 原货位流水号 | 原库位 |
| 原货位名称 | 原库位名称 |
| 目标物料与货位流水号 | 目标库存记录 |
| 目标货位流水号 | 目标库位 |
| 目标货位名称 | 目标库位名称 |
| 调拨数量 | 调拨数量 |
| 调拨前原库存 | 扣减前原库位库存 |
| 调拨后原库存 | 扣减后原库位库存 |
| 调拨前目标库存 | 增加前目标库位库存 |
| 调拨后目标库存 | 增加后目标库位库存 |
| 调拨备注 | 备注 |
| 操作人 | UserID |
| 操作时间 | 调拨时间 |
查询接口建议：
```js
var Data = this.CreateData('11', '仓储管理_库存盘点_库存调拨记录_查询', param, this.pageSize, this.pageCurrent)
```
第一版可以不新增独立页面，只在库存盘点页面增加“调拨记录”按钮或弹窗。
## 8. API 设计
### 8.1 查询库位
沿用现有：
```js
var Data = this.CreateData('11', '仓储管理_库位_查询', param)
```
### 8.2 新增库位
建议新增或复用：
```js
var Data = this.CreateData('12', '仓储管理_库位_增加', param)
```
参数：
| 参数名 | 说明 |
| --- | --- |
| 货位名称 | 新库位名称 |
| 备注 | 可选 |
| UserID | 当前用户 |
返回：
| 字段 | 说明 |
| --- | --- |
| result | 是否成功 |
| 货位流水号 | 新增库位流水号 |
| 货位名称 | 新增库位名称 |
### 8.3 库存调拨
建议新增：
```js
var Data = this.CreateData('12', '仓储管理_库存盘点_库存调拨', param)
```
这是本功能最核心接口，必须由后端事务保证扣减和增加同时成功或同时失败。
### 8.4 调拨记录查询
建议新增：
```js
var Data = this.CreateData('11', '仓储管理_库存盘点_库存调拨记录_查询', param, this.pageSize, this.pageCurrent)
```
查询参数：
| 参数名 | 说明 |
| --- | --- |
| 物料名称_check | 是否按物料名称查询 |
| 物料名称 | 物料名称 |
| 图号或型号_check | 是否按图号查询 |
| 图号或型号 | 图号或型号 |
| 原货位流水号_check | 是否按原库位查询 |
| 原货位流水号 | 原库位 |
| 目标货位流水号_check | 是否按目标库位查询 |
| 目标货位流水号 | 目标库位 |
| 操作时间_check | 是否按时间查询 |
| 开始时间 | 开始时间 |
| 结束时间 | 结束时间 |
## 9. 前端方法设计
### 9.1 打开调拨弹窗
```js
openTransfer(row) {
if (Number(row.库存) <= 0) {
this.$message.warning('当前库位库存为0，不能调拨')
return
}
this.transferForm.物料与货位流水号 = row.物料与货位流水号
this.transferForm.物料流水号 = row.物料流水号
this.transferForm.物料名称 = row.物料名称
this.transferForm.图号或型号 = row.图号或型号
this.transferForm.原货位流水号 = row.货位流水号
this.transferForm.原货位名称 = row.货位名称
this.transferForm.原库存数 = Number(row.库存)
this.transferForm.目标货位流水号 = ''
this.transferForm.目标货位名称 = ''
this.transferForm.新货位名称 = ''
this.transferForm.调拨数量 = 1
this.transferForm.调拨备注 = ''
this.transferDialogVisible = true
}
```
### 9.2 新建库位
```js
addTransferLocation() {
if (!this.transferForm.新货位名称) {
this.$message.warning('请输入新库位名称')
return
}
var param = []
param[0] = ['货位名称', this.transferForm.新货位名称]
var Data = this.CreateData('12', '仓储管理_库位_增加', param)
this.ExecDatabase(Data).then(response => {
if (response.data && response.data.length > 0) {
this.getStorageLocation()
this.transferForm.目标货位流水号 = response.data[0].货位流水号
this.$message.success('库位新增成功')
}
})
}
```
说明：具体返回结构以现有后端为准，若只返回成功标识，则新增后通过库位名称重新查询并回填。
### 9.3 提交调拨
```js
submitTransfer() {
if (!this.transferForm.目标货位流水号) {
this.$message.warning('请选择目标库位')
return
}
if (this.transferForm.目标货位流水号 === this.transferForm.原货位流水号) {
this.$message.warning('目标库位不能与原库位相同')
return
}
if (Number(this.transferForm.调拨数量) <= 0) {
this.$message.warning('调拨数量必须大于0')
return
}
if (Number(this.transferForm.调拨数量) > Number(this.transferForm.原库存数)) {
this.$message.warning('调拨数量不能大于原库存数')
return
}
var param = []
param[0] = ['物料与货位流水号', this.transferForm.物料与货位流水号]
param[1] = ['物料流水号', this.transferForm.物料流水号]
param[2] = ['原货位流水号', this.transferForm.原货位流水号]
param[3] = ['目标货位流水号', this.transferForm.目标货位流水号]
param[4] = ['调拨数量', this.transferForm.调拨数量]
param[5] = ['原库存数', this.transferForm.原库存数]
param[6] = ['调拨备注', this.transferForm.调拨备注]
var Data = this.CreateData('12', '仓储管理_库存盘点_库存调拨', param)
this.ExecDatabase(Data).then(response => {
this.$message.success('调拨成功')
this.transferDialogVisible = false
this.searchTable()
})
}
```
## 10. 后端事务逻辑
后端存储过程建议逻辑：
```text
开始事务
查询原物料货位库存记录
如果不存在，返回“原库存记录不存在”
如果当前库存 < 调拨数量，返回“库存不足”
如果原货位流水号 = 目标货位流水号，返回“目标库位不能与原库位相同”
更新原库位库存 = 当前库存 - 调拨数量
查询目标货位是否存在同物料库存记录
如果存在：
更新目标库位库存 = 当前目标库存 + 调拨数量
如果不存在：
新增目标货位库存记录，库存 = 调拨数量
写入库存调拨记录
提交事务
```
任何一步失败必须回滚，避免库存只扣不加。
## 11. 与现有编辑库存功能的关系
当前库存盘点页面已有“编辑库存数”和“编辑库位”的能力：
```js
var Data = this.CreateData('12', '仓储管理_库存盘点_货位数量_编辑数据', param)
```
新调拨功能不建议复用前端两次调用该接口来完成扣减和增加，因为：
- 两次请求中间失败会造成库存不一致。
- 多人并发时容易出现负库存。
- 目标库位不存在同物料记录时还需要新增记录。
因此建议新增一个后端原子接口：
```text
仓储管理_库存盘点_库存调拨
```
该接口内部统一完成扣减、增加、新增目标记录、写调拨记录。
## 12. 实施步骤
1. 后端新增或确认库位新增接口：`仓储管理_库位_增加`。
2. 后端新增库存调拨接口：`仓储管理_库存盘点_库存调拨`。
3. 后端新增库存调拨记录表。
4. 后端新增库存调拨记录查询接口。
5. 前端 `InventoryCheck/index.vue` 增加“调拨”按钮。
6. 前端增加调拨弹窗和 `transferForm`。
7. 前端增加“一键新建库位”方法。
8. 前端增加“确定调拨”方法。
9. 调拨成功后调用 `searchTable()` 刷新盘点列表。
10. 联调库存扣减、目标库位增加、目标库位不存在时新增记录。
## 13. 风险点
### 13.1 并发扣减风险
盘点期间多人可能同时调拨同一库位库存。后端必须以数据库当前库存为准，不能只相信前端传入的 `原库存数`。
### 13.2 目标库位重复风险
一键新建库位时需要校验 `货位名称` 是否已存在。若已存在，应直接提示或返回已有库位，不应重复新增同名库位。
### 13.3 只扣不加风险
调拨不能由前端拆成“编辑原库存”和“新增目标库存”两个独立请求。必须由一个后端事务接口完成。
### 13.4 数据追溯风险
虽然不做完整调拨单，也必须保留调拨记录，记录调拨前后库存、原库位、目标库位、操作人和时间。
## 14. 总结
本方案将库存调拨限定在库存盘点组件内，采用“行内调拨弹窗 + 一键新建库位 + 后端事务扣减/增加库存”的轻量设计。用户在盘点时选择一行库存，输入调拨数量和目标库位，系统直接将调拨数量从原库位库存中减掉，并增加到目标库位库存中。
关键点是新增一个原子后端接口 `仓储管理_库存盘点_库存调拨`，避免前端多次请求造成库存不一致。同时保留调拨记录，满足后续盘点追溯。

399
docs/核心物料搜索栏添加物料编码查询设计方案.md Normal file
View File

@@ -0,0 +1,399 @@
# 核心物料搜索栏添加物料编码查询设计方案
## 1. 需求背景
本需求由罗伟提出，主要服务于现场库存盘点业务。
当前现场正在进行库存盘点。盘点过程中发现，系统内部分物料在新建物料信息时，由于历史录入习惯、命名规则不统一、同类物料复用名称、图号或型号描述不完整等原因，存在物料名称重复、图号或型号重复、名称与图号组合仍无法准确区分物料的情况。
在盘点现场，仓库人员需要快速确认实物标签对应的系统物料。如果仅依赖物料名称、规格型号、图号等字段进行搜索，当多个物料名称或图号相近甚至重复时，页面会返回多条近似记录，盘点人员需要逐条比对，容易出现以下问题：
1. 盘点确认速度慢，影响现场盘点效率。
2. 同名或同图号物料难以区分，增加误选风险。
3. 实物标签与系统数据匹配不稳定，后续盘点差异复核成本高。
4. 现场人员对物料主数据命名差异不熟悉时，更难快速定位唯一物料。
为解决上述问题，现场计划后续物料标签统一使用唯一的物料编码作为识别依据。同时，系统内最核心的物料搜索栏页面需要增加“物料编码”查询筛选能力，使盘点人员可以直接根据标签上的唯一物料编码定位系统物料，避免因物料名称、图号或型号重复导致的识别困难。
<br />
## 2. 建设目标
本次设计目标是在项目中最核心、最常用于物料查询和盘点确认的页面搜索栏中增加“物料编码”查询功能。
具体目标如下：
1. 在核心物料搜索栏页面增加独立的“物料编码”输入条件。
2. 支持用户输入物料编码后直接查询并筛选唯一或近似匹配物料。
3. 保留原有物料名称、图号或型号、物料类型、库位、仓库等查询条件，保证历史操作习惯不受影响。
4. 支持物料编码与原有查询条件组合筛选。
5. 后端查询过程增加物料编码可选参数，未输入物料编码时保持原查询结果不变。
6. 涉及导出、分页、排序等功能的页面，应保持查询结果与导出结果一致。
7. 为后续物料标签使用唯一物料编码提供系统查询支撑。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 3. 设计范围
本次范围以“页面搜索栏”为主，不包含新增物料、选择物料、查看库存等弹窗中的临时查询入口。
优先改造以下最核心页面：
| 模块 | 页面名称 | 文件路径 | 当前查询特点 | 本次调整 |
| ---- | ----- | ----------------------------------------------------------------------- | ------------------------------- | ------------------- |
| 技术中心 | 物料查询 | `src/views/TechnologyCenter/MaterialQuery/index.vue` | 物料主数据查询，已有物料编码、物料名称、图号/型号等条件 | 统一确认物料编码条件传参和后端过滤能力 |
| 技术中心 | 物料维护 | `src/views/TechnologyCenter/MaterialMaintain/index.vue` | 物料主数据维护，已有物料编码、物料名称、图号/型号等条件 | 统一确认物料编码条件传参和后端过滤能力 |
| 仓储管理 | 库存查询 | `src/views/WarehouseManagement/InventoryQuery/index.vue` | 库存主查询，包含物料编号、物料名称、图号型号、类型、库位等条件 | 增强物料编码精确定位能力 |
| 仓储管理 | 物料库位 | `src/views/WarehouseManagement/MaterialLocation/index.vue` | 按物料、图号、库位查询物料所在库位 | 增强按物料编码定位库位能力 |
| 仓储管理 | 库存盘点 | `src/views/WarehouseManagement/InventoryCheck/index.vue` | 盘点现场高频页面，涉及物料、图号、编码等查询条件 | 重点支持标签物料编码查询 |
| 仓储管理 | 入库记录 | `src/views/WarehouseManagement/WarehousingRecord/WarehousingRecord.vue` | 入库记录中可按物料名称、物料编码等条件筛选 | 确认搜索栏编码条件与导出条件一致 |
| 仓储管理 | 退货记录 | `src/views/WarehouseManagement/ReturnRecord/index.vue` | 当前输入框偏综合条件，按物料名称/编号/规格/型号查询 | 明确拆分或补充物料编码查询能力 |
| 仓储管理 | 物料记录 | `src/views/WarehouseManagement/MaterialRecord/index.vue` | 物料出入库记录查询，当前主要按物料名称筛选 | 增加物料编码条件 |
| 仓储管理 | 库存记录 | `src/views/WarehouseManagement/InventoryRecord/index.vue` | 库存历史记录查询，当前主要按物料名称筛选 | 增加物料编码条件 |
| 仓储管理 | 采购件入库 | `src/views/WarehouseManagement/PurchasePartsStorage/index.vue` | 入库相关查询涉及物料名称、图号或型号 | 增加或统一物料编码条件 |
后续可根据现场使用频率扩展至采购、精工车间、销售、装配等更多页面，但第一阶段应优先保证仓储盘点和物料主数据查询链路完整。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 4. 现状问题分析
### 4.1 物料名称不是唯一识别字段
物料名称用于业务人员理解物料含义，但并不适合作为唯一识别依据。现场存在同类物料使用相同或近似名称的情况，例如名称相同但规格、批次、厂家、图号或内部编码不同。
仅按物料名称查询时，系统可能返回多条记录，盘点人员需要再人工判断，效率低且容易误选。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 4.2 图号或型号也可能重复或不完整
图号或型号通常来源于技术资料、采购资料或历史录入。由于历史数据存在命名不统一、字段填写不完整、图号简称和完整图号混用等情况，图号或型号同样无法稳定保证唯一。
盘点人员如果只扫描或输入图号，仍可能出现多条记录，无法快速确认实物对应的系统物料。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 4.3 现场标签需要与系统查询方式统一
现场后续计划使用唯一物料编码作为标签识别字段。如果系统页面没有物料编码搜索能力，即使实物标签已经规范，人员仍需要通过名称或图号间接查找，标签规范化的价值无法充分发挥。
因此，系统查询方式必须与标签识别方式保持一致。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 5. 总体方案
本次方案采用“前端增加独立查询条件、后端存储过程增加可选参数、查询和导出同步支持”的方式实施。
### 5.1 前端搜索栏调整
在核心页面搜索栏中增加或确认“物料编码”输入框。
推荐展示方式：
```html
<el-input
v-model="materialCodeValue"
style="width: 160px"
placeholder="物料编码"
size="small"
clearable
@keyup.enter.native="pageCurrent=1;searchTable()"/>
```
如果页面已有“物料编号”输入框，应统一确认其实际传参字段是否对应数据库中的 `物料编码`。如果只是综合搜索字段，应调整为独立字段，避免和物料名称、规格型号混在同一个条件中。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 5.2 前端参数拼接规则
在 `searchTable()` 或对应主查询方法中增加物料编码条件。
推荐参数格式：
```js
this.materialCodeValue ? materialCodeValue_check = 1 : materialCodeValue_check = 0
param[n] = ['物料编码_check', materialCodeValue_check]
param[n + 1] = ['物料编码', this.materialCodeValue]
```
如果后端存储过程使用字段名 `物料编码`，前端统一传 `物料编码_check` 和 `物料编码`。如果历史过程使用 `物料码`、`物料编号`、`物料流水号` 等字段，需要在后端过程内做兼容或在本页面保持原过程约定，但文档和页面显示统一为“物料编码”。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 5.3 后端查询过程调整
涉及页面对应的存储过程需要增加物料编码可选参数。
推荐参数：
```sql
@物料编码_check int = 0,
@物料编码 nvarchar(100) = null
```
推荐过滤逻辑：
```sql
if @物料编码_check = 1
begin
set @sql = @sql + ' and 物料编码 like ''%'' + @物料编码 + ''%'' '
end
```
如果业务上要求扫码后精确定位，可在库存盘点页面优先使用精确匹配：
```sql
and 物料编码 = @物料编码
```
考虑到目前系统搜索习惯多为模糊查询，第一阶段建议使用模糊查询；后续如果标签扫码稳定，可在盘点页面增加“精确匹配”策略或自动识别完整编码时使用精确匹配。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 5.4 查询与导出一致
凡是页面支持 Excel 导出的，导出参数必须同步增加物料编码条件。
要求：
1. 页面查询传入 `物料编码_check` 和 `物料编码`。
2. 导出方法传入同样的 `物料编码_check` 和 `物料编码`。
3. 同一组搜索条件下，页面列表与导出文件数据范围一致。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 6. 页面设计细节
### 6.1 物料查询页面
文件：`src/views/TechnologyCenter/MaterialQuery/index.vue`
设计要求：
1. 搜索栏保留物料编码、物料名称、图号/型号、物料类型、修改时间。
2. 查询方法 `searchTable()` 中确认 `物料编码_check`、`物料编码` 参数可传入后端。
3. 表格中建议保留或增加物料编码列，便于和搜索条件互相验证。
4. 物料编码为空时，查询结果与原逻辑一致。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 6.2 物料维护页面
文件：`src/views/TechnologyCenter/MaterialMaintain/index.vue`
设计要求：
1. 与物料查询页面保持搜索条件一致。
2. 维护人员可通过物料编码快速定位需要修改的物料。
3. 如果物料名称或图号重复，编码搜索结果应能明确定位到具体记录。
4. 修改物料基础信息时，不允许随意修改唯一物料编码；如确需修改，应由权限或后端规则控制。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 6.3 库存查询页面
文件：`src/views/WarehouseManagement/InventoryQuery/index.vue`
设计要求：
1. 搜索栏保留物料编号、物料名称、图号型号、类型、库位或仓库等条件。
2. 页面显示文案建议统一为“物料编码”，避免“物料编号”和“物料编码”混用造成理解偏差。
3. 查询时支持按物料编码过滤当前库存。
4. 如果用户同时输入物料编码和库位，应返回该编码在指定库位下的库存记录。
5. 导出库存数据时同步带入物料编码条件。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 6.4 物料库位页面
文件：`src/views/WarehouseManagement/MaterialLocation/index.vue`
设计要求：
1. 搜索栏保留物料编码、物料名称/规格、图号/型号、库位。
2. 现场可输入标签物料编码，快速确认该物料当前绑定或存放库位。
3. 物料编码与库位组合查询时，应可用于检查实物库位与系统库位是否一致。
4. 若未查到数据，应提示用户确认物料编码是否存在或是否已维护库位。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 6.5 库存盘点页面
文件：`src/views/WarehouseManagement/InventoryCheck/index.vue`
设计要求：
1. 作为本次需求的重点页面，搜索栏必须支持物料编码。
2. 现场盘点时，人员可根据物料标签输入或扫码物料编码，快速筛选盘点记录。
3. 如果物料编码唯一匹配一条库存记录，应减少人工在多条同名物料中判断的成本。
4. 如果同一物料编码在多个库位有库存，应按库位分行展示，便于盘点人员逐库位确认。
5. 盘点导入、盘点导出、盘点明细查询如使用同一查询条件，应同步支持物料编码。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 6.6 入库记录和退货记录页面
涉及文件：
- `src/views/WarehouseManagement/WarehousingRecord/WarehousingRecord.vue`
- `src/views/WarehouseManagement/ReturnRecord/index.vue`
设计要求：
1. 入库记录应可按物料编码追溯某一物料的入库历史。
2. 退货记录应可按物料编码追溯某一物料的退货历史。
3. 如果当前页面只有“物料名称/编号/规格/型号”综合输入框，建议拆分出独立“物料编码”输入框。
4. 页面查询与导出保持一致。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 7. 接口和存储过程影响
本项目业务请求统一通过 `MESCommonBase.ashx`，前端通过 `CreateData(type, name, data, pageSize, pageList)` 构建请求。新增物料编码查询不改变请求端点，不新增前端请求封装方式。
可能涉及的后端过程包括但不限于：
| 页面 | 可能涉及接口或过程 | 调整内容 |
| ---- | ------------------------ | -------- |
| 物料查询 | `物料管理_查询数据_分页` | 增加物料编码过滤 |
| 物料维护 | `物料管理_查询数据_分页` 或对应维护查询过程 | 增加物料编码过滤 |
| 库存查询 | 仓储库存查询相关过程 | 增加物料编码过滤 |
| 物料库位 | 仓储管理物料库位查询相关过程 | 增加物料编码过滤 |
| 库存盘点 | 仓储管理库存盘点查询相关过程 | 增加物料编码过滤 |
| 入库记录 | 仓储管理入库记录查询和导出过程 | 增加物料编码过滤 |
| 退货记录 | 仓储管理退货记录查询过程 | 增加物料编码过滤 |
后端调整原则：
1. 新增参数必须为可选参数，避免影响未改造页面。
2. 原有查询条件保持不变，物料编码作为新增条件叠加。
3. SQL 字段命名优先使用数据库现有字段，常见字段为 `物料编码`。
4. 如果查询主表没有物料编码字段，应通过物料流水号关联物料主文件取得编码后过滤。
5. 对大数据页面应确认物料编码字段有索引或可使用已有索引，避免新增条件后查询变慢。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 8. 数据规则
### 8.1 物料编码唯一性
物料编码应作为系统内识别物料的唯一业务编码。后续标签打印、库存盘点、入库、出库、库位维护等环节，应优先使用物料编码进行识别和核对。
如果历史数据中存在物料编码为空或重复，应先由主数据维护人员进行清理，并形成异常清单。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 8.2 物料名称和图号保留辅助识别
新增物料编码搜索后，物料名称、图号或型号仍然保留，用于人工理解和辅助筛选。系统不应因为新增物料编码而删除或弱化原有查询字段。
推荐使用方式：
1. 盘点现场优先输入或扫码物料编码。
2. 不清楚编码时，可使用物料名称或图号模糊查询。
3. 编码、名称、图号可组合使用，进一步缩小范围。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 9. 前端开发步骤
1. 梳理核心页面现有搜索栏，确认是否已有物料编码输入框。
2. 对没有独立物料编码输入框的页面，新增 `el-input`。
3. 在 `data()` 中新增或确认变量，例如 `materialCodeValue`、`MaterialCode`。
4. 在 `searchTable()` 中增加编码输入值判断，生成 `物料编码_check`。
5. 在 `param` 数组中追加 `物料编码_check` 和 `物料编码`。
6. 同步调整导出方法中的查询参数。
7. 确认分页重置逻辑：点击查询或回车查询时，`pageCurrent` 应重置为 `1`。
8. 检查表格是否显示物料编码列；若不显示，应评估是否需要补充。
9. 按项目要求在变更代码处追加备注：`修改人:Ld 修改时间:当时的时间`。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 10. 后端开发步骤
1. 确认各页面 `CreateData` 中的 `name` 对应后端存储过程。
2. 在存储过程参数中增加 `物料编码_check` 和 `物料编码`。
3. 在查询条件中增加物料编码过滤逻辑。
4. 如果过程使用动态 SQL，同步补充 `sp_executesql` 参数定义和参数传值。
5. 如果导出使用独立过程，导出过程同步增加物料编码过滤。
6. 对库存盘点、库存查询等大数据过程执行查询计划检查。
7. 使用实际物料编码测试单条件查询、组合条件查询、空条件查询。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 11. 验收标准
### 11.1 功能验收
1. 在核心物料搜索栏页面可以看到“物料编码”查询条件。
2. 输入完整物料编码后，可以查询到对应物料或库存记录。
3. 输入不存在的物料编码时，页面返回空结果，不报错。
4. 物料编码与物料名称组合查询时，结果同时满足两个条件。
5. 物料编码与图号或型号组合查询时，结果同时满足两个条件。
6. 清空物料编码后，查询结果恢复为原有条件下的结果。
7. 页面分页、排序、刷新后查询逻辑正常。
8. 导出文件与页面查询结果范围一致。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
### 11.2 现场验收
1. 使用现场物料标签上的唯一物料编码进行查询。
2. 同名物料、同图号物料场景下，能通过物料编码准确区分。
3. 盘点人员可以根据物料编码快速定位物料及库位。
4. 现场不再需要仅依赖物料名称或图号人工判断同名物料。
5. 盘点差异复核时，可以通过物料编码追溯库存记录、入库记录或退货记录。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 12. 测试用例
| 用例编号 | 测试场景 | 操作步骤 | 预期结果 |
| ------ | --------- | ---------------- | ---------------- |
| TC-001 | 按完整物料编码查询 | 输入完整物料编码，点击查询 | 返回对应物料记录 |
| TC-002 | 按部分物料编码查询 | 输入物料编码前几位，点击查询 | 返回编码包含输入内容的记录 |
| TC-003 | 编码不存在 | 输入不存在的编码，点击查询 | 返回空列表，页面不报错 |
| TC-004 | 编码加名称组合查询 | 输入物料编码和物料名称，点击查询 | 结果同时满足编码和名称条件 |
| TC-005 | 编码加图号组合查询 | 输入物料编码和图号，点击查询 | 结果同时满足编码和图号条件 |
| TC-006 | 清空编码查询 | 清空物料编码，仅保留原条件查询 | 结果与原逻辑一致 |
| TC-007 | 盘点页面标签验证 | 使用现场标签编码查询库存盘点页面 | 能快速定位对应物料或对应库位库存 |
| TC-008 | 导出一致性 | 输入物料编码查询后导出 | 导出数据与页面筛选范围一致 |
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 13. 风险与控制
| 风险 | 影响 | 控制措施 |
| ---------------------- | ------------- | ------------------------- |
| 历史物料编码为空 | 无法通过编码定位部分旧物料 | 输出异常清单，先补齐主数据 |
| 历史物料编码重复 | 查询结果仍可能多条 | 主数据维护阶段校验唯一性 |
| 前端显示“物料编号”、后端字段为“物料编码” | 用户理解和开发传参不一致 | 页面文案统一为“物料编码”，后端字段按实际字段兼容 |
| 大表增加模糊查询后变慢 | 查询性能下降 | 对物料编码字段建立索引，必要时完整编码使用精确匹配 |
| 查询和导出条件不一致 | 用户导出数据与页面不一致 | 导出方法同步加入物料编码参数 |
| 弹窗查询未同步改造 | 部分业务入口仍无法按编码查 | 第一阶段聚焦页面搜索栏，第二阶段再扩展弹窗 |
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 14. 推进计划
| 阶段 | 工作内容 | 产出 |
| ---- | --------------------------- | -------------- |
| 第一阶段 | 确认核心页面和对应存储过程 | 页面与接口清单 |
| 第二阶段 | 改造库存盘点、库存查询、物料库位、物料查询、物料维护 | 核心页面支持物料编码查询 |
| 第三阶段 | 改造入库记录、退货记录、物料记录、库存记录、采购件入库 | 相关追溯页面支持物料编码查询 |
| 第四阶段 | 调整导出、分页、排序、后端过程性能 | 查询与导出一致 |
| 第五阶段 | 使用现场标签数据验收 | 验收记录和问题清单 |
备注：修改人:Ld 修改时间:2026-06-29 13:26:44
## 15. 结论
本次“核心物料搜索栏添加物料编码查询功能”是库存盘点现场提出的实际业务需求。需求核心不是简单增加一个输入框，而是将现场实物标签识别方式与系统查询方式统一起来。
通过在核心物料搜索栏页面增加物料编码查询能力，系统可以减少因物料名称、图号或型号重复导致的盘点确认困难，帮助现场人员以唯一物料编码快速定位物料、库存和库位记录，提高盘点效率和数据准确性。
第一阶段建议优先完成仓储盘点和物料主数据相关页面，确保现场库存盘点可用；第二阶段再逐步扩展到采购、生产、装配、销售等模块中更多物料相关查询入口。
备注：修改人:Ld 修改时间:2026-06-29 13:26:44

324
docs/物料库位设置/物料库位功能调整设计方案.md Normal file
View File

@@ -0,0 +1,324 @@
# 物料库位功能调整设计方案
## 一、背景
当前系统在新建、编辑物料时会维护物料的默认库位，并在数据库中写入物料与货位的初始关系。该机制会导致物料主档承担库存库位职责，也会在无真实库存的情况下生成 `货位存量 = 0` 的物料货位记录。
本次需求由仓库主管提出。现场正在进行库存盘点，盘点人员需要依据系统库存数据到对应库位核对物料实物数量、批次和状态。但当前系统内的库存库位设置并非由仓库人员在实际入库、上架或盘点业务中选择确认，而是在物料基础资料维护阶段预先设置，导致系统记录的库位与现场实际存放库位不匹配。该问题会直接影响盘点人员按系统数据查找物料，容易出现找不到物料、盘点库位错误、盘点差异无法快速定位等情况，进而影响库存准确性和仓库现场作业效率。
因此，本次功能调整的核心诉求不是单纯修改一个库位字段，而是将“物料标准库位”从物料主档维护中剥离，把库位确认权回归到仓库实际业务动作中，由仓库人员在入库、上架、调拨、盘点等场景按现场真实情况选择和确认库位，确保系统库存库位能够反映实际库存位置，为当前及后续库存盘点提供可靠的数据依据。
<br />
本次调整目标是：
1. 物料主档不再设置库位。
2. 物料标准维护组件不再编辑物料库位。
3. 入库时根据真实库存情况选择库位。
4. 有现有库存库位时优先显示已有库存库位；没有库存库位时显示全库位。
5. 盘点人员后续依据系统库存查询结果进行盘点时，系统库位应尽可能来源于仓库真实业务记录，减少基础资料预设库位造成的现场偏差。
## 二、现状核对
### 2.1 前端现状
物料维护入口：
- `src/views/TechnologyCenter/MaterialMaintain/index.vue`
- `src/views/TechnologyCenter/MaterialQuery/index.vue`
原逻辑：
- 新增/编辑物料弹窗中存在“库位”下拉。
- 新增物料默认设置 `form.库位 = 2514`。
- 表单规则要求库位必填。
- 新增/编辑提交时传递 `货位流水号`。
物料库位维护入口：
- `src/views/WarehouseManagement/MaterialLocation/index.vue`
原逻辑：
- 页面查询物料主档库位。
- 行内可编辑 `货位流水号`。
- 点击确定后调用 `仓储管理_物料库位_编辑数据`。
入库入口：
- `src/views/WarehouseManagement/PurchasePartsStorage/index.vue`
原逻辑：
- 采购入库、自制件入库行内可选择库位。
- 已有 `getInventoryLocateName(row)` 方法，可按物料查询库存库位。
- 但无库存库位时没有完整 fallback 到全库位的闭环。
### 2.2 数据库现状
已核对相关存储过程：
- `物料管理_增加`
- `物料管理_增加新`
- `物料管理_编辑`
- `仓储管理_物料库位_编辑数据`
- `仓储管理_库存盘点_查询`
- `仓储管理_库位_查询`
当前数据库行为：
- `物料管理_增加`、`物料管理_增加新` 会把 `@货位流水号` 写入 `库存管理_物料主文件_基本.货位流水号`。
- 新增物料后会向 `库存管理_物料与货位对照表` 插入一条 `货位存量 = 0` 的记录。
- `物料管理_编辑` 会更新 `库存管理_物料主文件_基本.货位流水号`，并同步更新 `库存管理_物料与货位对照表.货位流水号`。
- `仓储管理_物料库位_编辑数据` 会同时更新物料主文件和物料货位对照表。
## 三、设计原则
1. 物料主档只维护物料基础属性，不再维护库存库位。
2. 库位选择只发生在入库、调拨、盘点等库存业务动作中。
3. 入库库位选择以真实库存记录优先。
4. 保留旧接口参数兼容，降低前后端发布顺序风险。
5. 不删除历史库位数据，避免影响历史库存、出入库记录和查询报表。
6. 仓库库位数据应以仓库人员实际作业确认结果为准，避免由技术、基础资料维护环节提前指定库位。
7. 当前库存盘点期间，优先保障盘点人员能够通过系统库存数据定位真实库位；对历史不准确库位数据不做批量自动修正，防止误改真实库存，需要结合盘点结果逐步校正。
备注：修改人:Ld 修改时间:2026-06-29 13:11:25
## 四、前端改造方案
### 4.1 物料维护页面
涉及文件：
- `src/views/TechnologyCenter/MaterialMaintain/index.vue`
- `src/views/TechnologyCenter/MaterialQuery/index.vue`
改造内容：
- 删除新增/编辑弹窗中的“库位”下拉控件。
- 删除 `form.库位` 字段。
- 删除 `库位` 必填校验。
- 删除 `inventoryLocation` 数据源。
- 删除 `getInventoryLocation()` 方法及页面初始化调用。
- 删除新增时默认 `form.库位 = 2514`。
- 编辑物料时不再从行数据读取 `货位流水号` 回填到表单。
- 新增/编辑提交时保留 `货位流水号 = null` 参数，用于兼容旧存储过程参数要求。
说明：
前端不再提供物料库位维护入口。保留 `货位流水号 = null` 是为了在数据库脚本未执行或前后端不同步发布时，减少接口缺参风险。
该调整可以避免非仓库人员在维护物料基础资料时预先指定库位，减少后续库存盘点时系统库位与实物库位不一致的问题。
备注：修改人:Ld 修改时间:2026-06-29 13:11:25
### 4.2 物料库位维护页面
涉及文件：
- `src/views/WarehouseManagement/MaterialLocation/index.vue`
改造内容：
- 删除行内库位下拉编辑。
- 删除编辑、确定、取消按钮。
- 删除双击行切换编辑状态。
- 删除 `storageLocation` 数据源。
- 删除 `getLocateName()`。
- 删除 `confirmEdit()`，不再调用 `仓储管理_物料库位_编辑数据`。
- 删除页面中不可达的“增加库位”弹窗和新增库位方法。
- 页面保留查询能力，用于查看历史物料库位数据。
说明：
该页面调整为只读查询页。后续如果确认不再需要查看历史标准库位，可在菜单侧隐藏该页面。
只读保留的目的，是在盘点期间为仓库主管和盘点人员提供历史库位追溯依据，便于判断差异来源是历史标准库位错误、实际移库未更新，还是入库时选择库位不准确。该页面不再允许直接修改库位，避免绕过真实库存业务动作造成新的库位偏差。
备注：修改人:Ld 修改时间:2026-06-29 13:11:25
### 4.3 入库库位选择
涉及文件：
- `src/views/WarehouseManagement/PurchasePartsStorage/index.vue`
改造内容：
- 页面创建时加载全库位列表。
- `getLocateName()` 返回 Promise，并统一生成 `{ label, name, value }` 结构。
- `getInventoryLocateName(row)` 按当前物料名称、图号或型号查询 `仓储管理_库存盘点_查询`。
- 查询结果中只保留库存大于 0 的库位。
- 如果存在库存库位：
- 当前行 `locateName` 使用库存库位列表。
- 下拉显示格式为 `货位名称（库存：数量）`。
- 设置 `locateSource = 'inventory'`。
- 如果不存在库存库位：
- 当前行 `locateName` 使用全库位列表。
- 设置 `locateSource = 'all'`。
- 入库提交逻辑保持不变，继续校验并提交 `货位流水号组`。
业务要求：
- 仓库人员办理采购入库、自制件入库时，必须根据现场实际上架库位选择系统库位。
- 系统存在该物料真实库存库位时，优先引导仓库人员选择已有库存库位，便于同物料集中存放和后续盘点。
- 系统不存在该物料真实库存库位时，允许从全库位中选择本次实际上架库位，形成后续库存查询和盘点依据。
- 盘点发现实物库位与系统库位不一致时，应通过盘点调整、移库或后续明确的库存业务流程修正，不再通过物料基础资料维护直接改库位。
备注：修改人:Ld 修改时间:2026-06-29 13:11:25
## 五、后端改造方案
新增 SQL 脚本：
- `sql/移除物料标准库位维护.sql`
脚本调整对象：
- `物料管理_增加`
- `物料管理_增加新`
- `物料管理_编辑`
调整内容：
- 保留 `@货位流水号` 参数，兼容旧调用。
- 新增物料时不再写入 `库存管理_物料主文件_基本.货位流水号`。
- 新增物料时不再向 `库存管理_物料与货位对照表` 插入 `货位存量 = 0` 的初始记录。
- 编辑物料时不再更新 `库存管理_物料主文件_基本.货位流水号`。
- 编辑物料时不再更新 `库存管理_物料与货位对照表.货位流水号`。
不调整内容：
- 入库过程仍继续接收 `货位流水号组`。
- 历史物料主档中的 `货位流水号` 暂不清理。
- 历史 `库存管理_物料与货位对照表` 中的 0 库存记录暂不清理。
后端调整边界：
- 本次不批量重算历史库存库位，避免在盘点期间引入新的数据扰动。
- 对已产生实际库存的物料库位关系，以库存业务单据和库存现存量记录为准。
- 后续若仓库主管确认需要清理历史 `货位存量 = 0` 的无效库位记录，应另行制定数据清理脚本，并在盘点结束或盘点数据确认后执行。
备注：修改人:Ld 修改时间:2026-06-29 13:11:25
## 六、入库库位选择流程
```mermaid
flowchart TD
A["用户点击入库行的库位按钮"] --> B["按物料名称和图号查询库存盘点"]
B --> C{"是否存在库存大于 0 的库位"}
C -->|是| D["显示已有库存库位"]
C -->|否| E["显示全库位"]
D --> F["用户选择库位"]
E --> F
F --> G["写回行数据: 货位流水号、货位名称"]
G --> H["入库提交"]
H --> I["提交货位流水号组"]
```
## 七、影响范围
### 7.1 受影响页面
- 技术中心物料维护
- 技术中心物料查询
- 仓储管理物料库位
- 仓储管理采购入库
- 仓储管理自制件入库
- 库存盘点人员使用的库存查询和盘点核对结果会间接受益于本次调整，后续新增库存的系统库位将更贴近现场真实库位。
备注：修改人:Ld 修改时间:2026-06-29 13:11:25
### 7.2 受影响数据库对象
- `库存管理_物料主文件_基本`
- `库存管理_物料与货位对照表`
- `库存管理_外购件累计库存`
- `物料管理_增加`
- `物料管理_增加新`
- `物料管理_编辑`
### 7.3 不受影响业务
- 已有库存查询。
- 已有入库记录查询。
- 已有出库、领料、调拨中基于真实库存记录的库位逻辑。
- 库位基础资料维护页面 `LocationManagement`。
- 当前历史库存数量不因本次调整自动变化。
- 当前盘点差异数据不因本次调整自动生成或自动消除。
备注：修改人:Ld 修改时间:2026-06-29 13:11:25
## 八、发布步骤
1. 发布前端代码。
2. 执行 `sql/移除物料标准库位维护.sql`。
3. 清浏览器缓存后进入系统验证。
4. 验证物料新增、编辑不再出现库位字段。
5. 验证物料库位维护页不可编辑。
6. 验证采购入库和自制件入库的库位选择逻辑。
7. 由仓库主管或指定仓库人员抽取正在盘点的物料进行核对，确认系统库存库位、入库选择库位和现场实际库位的对应关系。
8. 对盘点期间发现的历史库位不一致数据，记录物料名称、图号、系统库位、实际库位和差异原因，作为后续数据清理或库存调整依据。
备注：修改人:Ld 修改时间:2026-06-29 13:11:25
推荐前后端同时发布。若不能同时发布，先发布后端脚本更稳妥。
## 九、验证清单
### 9.1 物料新增
- 新增弹窗不显示库位。
- 新增物料可正常保存。
- 新增后 `库存管理_物料主文件_基本.货位流水号` 不写入新默认库位。
- 新增后不生成 `货位存量 = 0` 的物料货位对照记录。
### 9.2 物料编辑
- 编辑弹窗不显示库位。
- 修改名称、图号、单位、材料、类型、物料库等字段可正常保存。
- 编辑时不改变物料已有真实库存库位。
### 9.3 物料库位查询
- 页面可正常按物料名称、图号、库位查询。
- 页面不显示编辑按钮。
- 双击行不进入编辑状态。
- 不再调用 `仓储管理_物料库位_编辑数据`。
### 9.4 入库库位选择
- 物料已有库存库位时，下拉只显示已有库存库位。
- 下拉显示库存数量。
- 物料没有库存库位时，下拉显示全库位。
- 未选择库位时不允许入库。
- 选择库位后采购入库可正常提交。
- 选择库位后自制件入库可正常提交。
### 9.5 盘点业务核对
- 盘点人员按系统库存查询结果查看物料库位时，可以明确区分历史库位数据和后续真实入库库位数据。
- 仓库人员新办理入库后，库存查询或盘点查询中的库位应与入库时选择的实际库位一致。
- 对无真实库存的物料，不应因为物料新增自动生成 `货位存量 = 0` 的库位记录干扰盘点查询。
- 对现场已发现系统库位与实际库位不一致的物料，应形成差异记录，不通过物料主档编辑直接修正。
备注：修改人:Ld 修改时间:2026-06-29 13:11:25
## 十、风险与回退
### 10.1 风险
- 若后端脚本未执行，前端传 `货位流水号 = null` 时，旧过程仍可能向物料主档或对照表写入空库位记录。
- 历史 0 库存物料货位记录仍存在，若库存盘点视图没有过滤库存数量，可能仍被查询出来。
- 部分报表如依赖物料主档默认库位，展示结果会从“标准库位”转为“历史库位”或空值。
- 当前盘点期间已经暴露的历史库位不匹配问题，不会因本次功能调整自动修复，需要仓库结合盘点结果进行后续校正。
- 若仓库人员入库时未按实际上架位置选择库位，仍可能继续产生新的系统库位与实际库位不一致问题，因此需要同步明确仓库操作要求。
备注：修改人:Ld 修改时间:2026-06-29 13:11:25
### 10.2 回退方式
- 前端回退相关 Vue 文件。
- 数据库可用脚本备份中的原存储过程定义恢复。
- 回退后重新构建并发布前端。

155
docs/物料编号搜索功能设计说明.md Normal file
View File

@@ -0,0 +1,155 @@
# 物料编号搜索功能设计说明
## 01-功能内容
本次功能是在项目中涉及物料搜索的页面和弹窗中，新增“物料编号/物料编码”独立搜索条件。
目标效果：
1. 用户可以直接输入物料编号定位物料。
2. 原有物料名称、图号/型号、库位、类型等搜索条件保持不变。
3. 新增编号搜索与原有条件可以组合查询。
4. 后端存储过程新增可选参数，未传物料编号时不影响原查询结果。
5. 导出场景同步支持物料编号条件，避免页面查询和导出数据不一致。
覆盖范围：
| 模块 | 页面/组件 | 查询入口 |
| --- | --- | --- |
| 仓储管理 | 库存盘点 | 主列表查询、导出 |
| 仓储管理 | 库存查询 | 主列表查询、导出 |
| 仓储管理 | 入库记录 | 主列表查询、导出 |
| 仓储管理 | 物料库位 | 主列表查询 |
| 仓储管理 | 领料/耗材 | 耗材物料选择查询 |
| 技术中心 | 物料查询 | 主列表查询 |
| 技术中心 | 物料维护 | 主列表查询 |
| 技术中心 | 图纸确认 | 物料选择弹窗 |
| 技术中心 | 图纸确认分配 | 物料选择弹窗 |
| 销售管理 | 订单管理 | 物料选择弹窗 |
| 销售管理 | 订单审核 | 物料选择弹窗 |
| 销售管理 | 订单查询 | 物料选择弹窗 |
| 装配管理 | 接收装配任务 | 物料选择弹窗 |
| 装配管理 | 接收滑台装配任务 | 物料选择弹窗 |
## 02-程序开发步骤
### 前端改造
1. 定位所有已有物料搜索入口，重点筛选包含 `物料名称_check`、`物料名称规格型号`、`仓储管理_通用库存_查询`、`物料管理_查询数据_分页` 的组件。
2. 在搜索栏或物料选择弹窗中新增输入框：
- `placeholder="物料编号"` 或 `placeholder="物料编码"`
- 使用 Vue 2 Options API 的 `data()` 字段维护输入值。
3. 在查询方法中新增判断变量：
- `物料编码_check = 1/0`
- `物料编码 = 输入值`
4. 将新增参数追加到原有 `param` 数组中。
5. 导出方法同步追加相同参数，保证查询和导出一致。
6. 保持原有 `CreateData`、`ExecDatabase` 调用方式，不新增请求封装。
### 后端改造
1. 对相关 SQL Server 存储过程增加可选参数：
- `@物料编码_check bit = null`
- `@物料编码 nvarchar(50) = null`
2. 在动态 SQL WHERE 条件中追加：
- 当 `@物料编码_check = 1` 时，按物料编码模糊查询。
3. 对 `sp_executesql` 同步补充参数声明和值传递。
4. 保持兼容性：未传编号条件时，原查询逻辑不变。
## 03-推进台账
| 轮次 | 做了什么 | 改了哪些文件/对象 | 验证了什么 | 下一步 |
| --- | --- | --- | --- | --- |
| 1 | 全局扫描物料搜索入口 | `src/views/**` | 找到物料名称搜索、物料选择弹窗、库存类查询入口 | 确定改造范围 |
| 2 | 仓储核心页面新增编号搜索 | 库存盘点、库存查询、入库记录 | 前端参数可生成 `物料编码_check/物料编码` | 补后端过程 |
| 3 | 共用物料选择弹窗新增编号搜索 | 销售、装配、技术确认相关页面 | 统一覆盖 `仓储管理_通用库存_查询` | 补共用查询过程 |
| 4 | 剩余物料主数据类入口新增编号搜索 | 物料查询、物料维护、物料库位、耗材领料 | 页面输入框与参数完整 | 补对应过程 |
| 5 | 执行 SQL Server 存储过程改造 | 9 个存储过程 | 直接调用过程验证编号条件不报错 | 前端解析验证 |
| 6 | 前端结构验证 | 14 个 `.vue` 文件 | `vue-template-compiler` 模板解析通过 | 形成文档 |
## 04-任务矩阵
| 任务编号 | 任务内容 | 状态 | 验收标准 |
| --- | --- | --- | --- |
| M-001 | 库存盘点增加物料编号搜索 | 已完成 | 页面可输入物料编号查询，导出同条件 |
| M-002 | 库存查询增加物料编号搜索 | 已完成 | 主查询和导出均带编号条件 |
| M-003 | 入库记录增加物料编号搜索 | 已完成 | 主查询和导出均带编号条件 |
| M-004 | 物料库位增加物料编号搜索 | 已完成 | 可按物料编号定位库位记录 |
| M-005 | 耗材领料增加物料编号搜索 | 已完成 | 耗材列表可按编号查询 |
| M-006 | 物料查询增加物料编码搜索 | 已完成 | 物料主文件查询可按编码过滤 |
| M-007 | 物料维护增加物料编码搜索 | 已完成 | 维护列表可按编码过滤 |
| M-008 | 共用库存物料选择弹窗增加编号搜索 | 已完成 | 销售、装配、技术确认弹窗可按编号查 |
| M-009 | 后端查询过程增加编号参数 | 已完成 | 存储过程直接传编号参数执行成功 |
| M-010 | 前端模板结构验证 | 已完成 | 改动 `.vue` 模板解析全部通过 |
## 05-验收证据
### 前端解析验证
验证命令：
```powershell
node -e "使用 vue-template-compiler 解析改动的 .vue 文件"
```
验证范围：
- `src/views/WarehouseManagement/InventoryCheck/index.vue`
- `src/views/WarehouseManagement/InventoryQuery/index.vue`
- `src/views/WarehouseManagement/WarehousingRecord/WarehousingRecord.vue`
- `src/views/WarehouseManagement/MaterialLocation/index.vue`
- `src/views/WarehouseManagement/MaterialRequisition/index.vue`
- `src/views/TechnologyCenter/MaterialQuery/index.vue`
- `src/views/TechnologyCenter/MaterialMaintain/index.vue`
- `src/views/AssemblyManagement/ReceiveAssemblyTask/index.vue`
- `src/views/AssemblyManagement/ReceiveAssemblyTaskSliding/index.vue`
- `src/views/SalesManagement/OrderExamine/index.vue`
- `src/views/SalesManagement/OrderManagement/index.vue`
- `src/views/SalesManagement/OrderInquiry/index.vue`
- `src/views/TechnologyCenter/DrawingConfirmation/index.vue`
- `src/views/TechnologyCenter/DrawingConfirmationDistribution/index.vue`
结果：全部 `ok`。
### SQL 执行验证
验证数据库：
- SQL Server：`192.168.1.27`
- 数据库：`ERPTOOL_JY_20250826Back`
验证方式：直接调用相关存储过程并传入 `@物料编码_check=1,@物料编码=N'0'`。
验证通过的过程：
- `物料管理_查询数据_分页`
- `仓储管理_物料库位_查询数据`
- `仓储管理_耗材出库_查询`
- `仓储管理_库存盘点_查询`
- `仓储管理_库存查询_查询`
- `仓储管理_通用库存_查询`
- `报表_仓储管理_通用库存_查询`
- `仓储管理_入库记录_查询`
- `仓储管理_入库记录_导出表格_查询`
结果：`all sql execution ok`。
## 06-决策记录
| 决策点 | 选择 | 原因 |
| --- | --- | --- |
| 搜索字段命名 | 前端显示“物料编号/物料编码”，后端参数使用 `物料编码` | 数据库字段主要为 `物料编码`，页面展示常称为物料编号 |
| 是否复用物料名称输入框 | 不复用，新增独立输入框 | 用户明确要求“添加物料编号搜索功能”，独立条件更清晰 |
| 后端参数是否必传 | 可选参数 | 保持旧页面、旧查询兼容 |
| 查询方式 | 模糊查询 | 与项目内物料名称、图号搜索习惯一致 |
| 共用弹窗处理 | 统一改 `仓储管理_通用库存_查询` 调用方 | 多个页面共用同一库存物料选择过程，统一补能避免重复逻辑 |
| 导出是否同步 | 同步 | 防止页面筛选结果和导出结果不一致 |
| 是否完整构建 | 未执行完整 build | 当前工作区已有 `dist.7z` 等既有脏文件，避免构建重写产物 |
## 07-后续注意事项
1. 新增物料搜索页面时，如表格展示 `物料编码`，搜索栏应同步提供物料编号输入框。
2. 新增后端查询过程时，建议统一支持：
- `@物料编码_check`
- `@物料编码`
3. 如果后续改为统一物料选择组件，可将物料编号、物料名称、图号/型号三个搜索项抽成共用弹窗，减少重复页面维护。

521
docs/移动端适配/车间派工移动端自适应设计方案.md Normal file
View File

@@ -0,0 +1,521 @@
# 车间派工移动端自适应设计方案
## 1. 需求目标
需求:车间需求一个车间派工组件的移动端功能,车间内及时操作
本次方案包含两部分：
1. 将现有车间派工组件复制并改造为移动端自适应页面。
2. 移动端用户登录系统后，首页只显示该自适应派工页面，不显示桌面端首页、侧边栏、顶部导航和标签栏。
总体原则：
- 不影响现有 PC 端车间派工页面。
- 不修改后端接口和参数格式。
- 移动端只改交互和布局，业务逻辑尽量复用现有页面。
- 保持 Vue 2 + Element UI + Options API 写法。
## 2. 当前代码基础
现有车间派工页面：
```text
src/views/SeikoWorkshop/WorkshopAssignment/index.vue
```
现有登录后首页：
```text
src/views/dashboard/index.vue
```
现有主布局：
```text
src/views/layout/Layout.vue
src/views/layout/components/AppMain.vue
```
现有动态路由生成：
```text
src/router/getRouter.js
src/permission.js
```
现有设备判断逻辑：
```text
src/views/layout/mixin/ResizeHandler.js
src/store/modules/app.js
```
项目中已有类似移动端/滑动版页面命名示例：
```text
src/views/AssemblyManagement/AssemblyExecutionSliding/index.vue
src/views/AssemblyManagement/ReceiveAssemblyTaskSliding/index.vue
src/views/AssemblyManagement/ReplenishmentOrdersSliding/index.vue
```
因此本次建议采用“新增独立移动端页面”的方式，而不是直接改造现有 PC 页面。
## 3. 总体设计
新增移动端页面：
```text
src/views/SeikoWorkshop/WorkshopAssignmentMobile/index.vue
```
新增移动端空布局：
```text
src/views/layout/MobileLayout.vue
```
新增设备判断工具：
```text
src/utils/device.js
```
修改路由配置：
```text
src/router/index.js
```
修改登录后跳转逻辑：
```text
src/permission.js
```
移动端访问路径建议为：
```text
/mobile/workshop-assignment
```
PC 端继续使用现有动态菜单路径：
```text
/SeikoWorkshop/WorkshopAssignment
```
## 4. 移动端页面结构设计
现有 PC 页面是左右两栏布局：
- 左侧：订单/零件待派工列表。
- 右侧：选中零件后的工序派工列表。
移动端不适合继续使用左右两栏和大表格，建议改为纵向流程。
### 4.1 顶部筛选区
移动端顶部展示查询条件：
- 订单号
- 产品/零件名称
- 名称或图号
- 查询按钮
- 查看图纸按钮
- 加急/取消加急按钮
- 手动报废结单按钮，按原权限控制
布局方式：
- 筛选项纵向排列。
- 输入框、下拉框宽度 `100%`。
- 操作按钮使用两列或满宽布局。
- 顶部筛选区可固定，也可随页面滚动。第一版建议随页面滚动，避免遮挡内容。
### 4.2 待派工零件列表
将 PC 端左侧 `el-table` 改为卡片列表。
每张卡片展示核心字段：
- 订单号
- 产品名称
- 零件图号
- 零件名称
- 数量
- 毛坯库存
- 下达日期
- 完工期限
- 订单备注
- 技术备注
交互：
- 点击卡片后调用现有行点击逻辑，加载该零件的工序列表。
- 当前选中卡片需要有明显选中态。
- 列表底部保留分页，移动端分页建议简化为“上一页 / 下一页 / 当前页”。
### 4.3 工序派工列表
将 PC 端右侧工序表格改为工序卡片列表。
每张工序卡片展示：
- 工序顺序
- 工序名称
- 投产数
- 完成数
- 操作者
- 报废数量
- 加工设备
- 派工状态
卡片操作按钮：
- 编辑
- 派工
- 取消派工
按钮禁用条件沿用现有 PC 页面判断逻辑。
### 4.4 派工编辑区
移动端保留人员和设备选择：
- 操作者
- 设备
- 派工数量
- 计划完成日期
建议使用 `el-dialog` 或底部弹层形式。
Element UI 项目中现有弹窗较多，第一版建议继续使用 `el-dialog`，移动端适配如下：
```vue
<el-dialog :visible.sync="dialogVisible" width="94%" top="5vh">
```
表单布局：
- `el-form-item` 纵向排列。
- `el-select`、`el-input`、`el-date-picker`、`el-input-number` 宽度统一 `100%`。
- 底部按钮固定为“取消 / 确定”。
### 4.5 文件和图纸查看
现有页面中图纸、文件查看逻辑继续保留。
移动端展示方式：
- 文件使用纵向列表。
- 每个文件展示图标、文件名。
- 点击后沿用现有下载/预览地址。
- 弹窗宽度 `94%`。
## 5. 业务接口复用
移动端页面不新增后端接口，复用现有车间派工页面中的请求。
主要请求包括：
```text
精工车间_车间派工_查询
车间生产管理工艺_零件工序_已派工查询
车间生产管理工艺_零件工序_派工_工序查询
车间生产管理工艺_零件工序_派工
车间生产管理工艺_零件工序_取消派工
车间生产管理工艺_零件工序_派工_修改数量
车间生产管理工艺_零件工序_派工_设置计划完成日期
人事档案管理_人员_部门与人员_派工_查询数据_根据部门编号
车间派工_手动报废结单_查询信息
车间派工_手动报废结单
```
请求规范继续遵守项目约定：
- 统一 POST 到 `MESCommonBase.ashx`。
- `url` 字段留空。
- 使用 `CreateData` 构建请求。
- 使用 `ExecDatabase` 或现有全局工具方法发送请求。
- 参数继续使用 `key=value&key2=value2` 字符串。
- 字段名继续使用后端返回的中文字段。
## 6. 路由设计
### 6.1 新增移动端空布局
新增文件：
```text
src/views/layout/MobileLayout.vue
```
职责：
- 不显示侧边栏。
- 不显示顶部导航。
- 不显示标签栏。
- 只渲染当前移动端页面。
结构示例：
```vue
<template>
<section class="mobile-main">
<router-view/>
</section>
</template>
<script>
export default {
name: 'MobileLayout'
}
</script>
<style scoped>
.mobile-main {
min-height: 100vh;
width: 100%;
background: #f5f7fa;
overflow-x: hidden;
}
</style>
```
### 6.2 新增静态隐藏路由
修改：
```text
src/router/index.js
```
新增：
```js
import MobileLayout from '../views/layout/MobileLayout'
```
在 `constantRouterMap` 中增加：
```js
{
path: '/mobile',
component: MobileLayout,
hidden: true,
children: [{
path: 'workshop-assignment',
component: () => import('@/views/SeikoWorkshop/WorkshopAssignmentMobile/index'),
meta: { title: '车间派工' }
}]
}
```
最终移动端首页路径：
```text
/mobile/workshop-assignment
```
## 7. 移动端登录后首页跳转设计
新增工具：
```text
src/utils/device.js
```
内容：
```js
export function isMobileDevice() {
if (!document || !document.body) {
return false
}
return document.body.getBoundingClientRect().width < 1024
}
```
修改：
```text
src/permission.js
```
在已登录逻辑中增加判断：
- 用户已登录。
- 当前目标路径是 `/` 或 `/dashboard`。
- 当前设备为移动端。
- 自动跳转 `/mobile/workshop-assignment`。
设计示例：
```js
import { isMobileDevice } from '@/utils/device'
// beforeEach 内部，已登录分支中
if ((to.path === '/' || to.path === '/dashboard') && isMobileDevice()) {
next({ path: '/mobile/workshop-assignment', replace: true })
NProgress.done()
return
}
```
这样移动端登录后不会进入桌面首页，而是直接进入移动端派工页。
## 8. 样式设计
移动端页面样式建议：
- 根节点使用 `.mobile-assignment-page`。
- 页面最小高度 `100vh`。
- 主背景使用浅灰色。
- 卡片使用白底、细边框、轻阴影。
- 卡片圆角控制在 `6px` 或 `8px`。
- 字号保持可读，不使用随视口缩放的字体。
- 所有按钮、输入框高度适合触摸操作。
- 避免横向滚动。
建议结构：
```scss
.mobile-assignment-page {
min-height: 100vh;
padding: 10px;
background: #f5f7fa;
}
.mobile-filter {
background: #fff;
border-radius: 6px;
padding: 10px;
margin-bottom: 10px;
}
.assignment-card {
background: #fff;
border: 1px solid #ebeef5;
border-radius: 6px;
padding: 10px;
margin-bottom: 10px;
}
.assignment-card.is-active {
border-color: #409EFF;
}
.card-title {
font-size: 15px;
font-weight: bold;
color: #303133;
}
.card-row {
display: flex;
justify-content: space-between;
line-height: 24px;
font-size: 13px;
}
.card-label {
color: #909399;
}
.card-value {
color: #303133;
text-align: right;
}
```
## 9. 实施步骤
1. 新建 `src/views/SeikoWorkshop/WorkshopAssignmentMobile/index.vue`。
2. 从 `WorkshopAssignment/index.vue` 复制业务数据、方法和接口调用。
3. 将模板改为移动端筛选区、零件卡片列表、工序卡片列表。
4. 将弹窗宽度、表单布局和按钮布局改为移动端适配。
5. 新建 `src/views/layout/MobileLayout.vue`。
6. 新建 `src/utils/device.js`。
7. 修改 `src/router/index.js`，增加 `/mobile/workshop-assignment` 静态隐藏路由。
8. 修改 `src/permission.js`，移动端登录后访问 `/` 或 `/dashboard` 时跳转移动端派工页。
9. 本地运行项目，分别验证 PC 和移动端宽度。
## 10. 验收标准
PC 端：
- 原车间派工页面正常访问。
- 原首页正常显示。
- 原动态菜单不受影响。
移动端：
- 登录后自动进入 `/mobile/workshop-assignment`。
- 页面不显示侧边栏、顶部导航、标签栏。
- 页面只显示移动端车间派工自适应页面。
- 查询条件可正常使用。
- 零件列表可正常加载和分页。
- 点击零件后可加载工序列表。
- 派工、取消派工、编辑数量、设置计划完成日期功能正常。
- 查看图纸和文件功能正常。
- 权限按钮显示逻辑与 PC 端一致。
- 页面无明显横向滚动、文字重叠、按钮遮挡。
## 11. 风险与控制
### 11.1 现有页面体量较大
风险：
- 直接抽公共逻辑可能引入 PC 页面回归问题。
控制：
- 第一版复制现有页面业务逻辑，只重写移动端模板。
- 待移动端稳定后，再考虑抽公共 mixin。
### 11.2 移动端首页跳转时机
风险：
- `Layout` 中的设备判断发生较晚，登录跳转时可能还未写入 Vuex。
控制：
- 在 `permission.js` 中直接使用 DOM 宽度判断，不依赖 Vuex 中的 `device`。
### 11.3 动态菜单权限
风险：
- 移动端隐藏路由如果依赖后端菜单，可能因为菜单未配置导致无法访问。
控制：
- 将移动端派工路由注册为静态隐藏路由。
- 登录后仍经过 token 校验，但不依赖菜单显示。
### 11.4 手机端表格不可用
风险：
- 继续使用大表格会产生横向滚动，操作困难。
控制：
- 移动端核心列表统一改为卡片式展示。
- 表格只在确实需要多列批量选择时使用，并控制宽度。
## 12. 推荐结论
建议第一版采用“独立移动端页面 + 移动端空布局 + 登录后设备重定向”的实现方式。
该方案改动边界清晰：
- PC 端页面不动。
- 后端接口不动。
- 权限体系基本不动。
- 移动端首页可直接进入派工工作流。
后续如果移动端使用稳定，再将 PC 和移动端共用的派工请求、字段处理、校验逻辑抽成公共 mixin，减少长期维护成本。

0
docs/JY1.0-立库详细界面功能说明书.html → docs/立库/JY1.0-立库详细界面功能说明书.html
View File

0
docs/JY1.0-立库详细界面功能说明书.md → docs/立库/JY1.0-立库详细界面功能说明书.md
View File

0
docs/JY1.0-立库详细界面功能说明书.pdf → docs/立库/JY1.0-立库详细界面功能说明书.pdf
View File

90
docs/零件改制/01-项目功能内容.md Normal file
View File

@@ -0,0 +1,90 @@
# 01-项目功能内容
## 1. 需求来源
因现场计件、派工生产、完工入库和后续追溯需要，将零件改制流程接入系统。该需求由罗总牵头，组织技术中心、精工车间、仓储等相关部门讨论后提出。
## 2. 应用场景
- 技术中心根据现场或订单需求发起零件改制订单。
- 改制订单进入精工车间生产任务流程。
- 精工车间在生产任务查询中查看改制任务。
- 车间派工组件查看改制任务并派工。
- MES 加工端按改制订单显示待加工任务。
- 改制加工完成后按现有流程办理入库。
- 改制记录用于查询原零件、改制零件、生产任务和加工状态。
## 3. 功能范围
### 3.1 技术中心
- 新增零件改制订单发起组件。
- 左侧显示订单/产品列表。
- 右侧显示所选产品下的所有零件。
- 零件操作列提供“改制”按钮。
- 点击“改制”后填写改制零件名称、改制零件图号、改制数量、精工期限。
- 原零件图号和改制零件图号相同则禁止发起。
### 3.2 后端记录
- 新增或维护 `技术中心_改制订单记录`。
- 记录原订单、原组件、原基本件、原零件名称、原零件图号。
- 记录改制零件名称、改制零件图号、改制数量、精工期限。
- 记录改制订单编号、发起人、发起时间、状态、是否删除。
- 回写新生成的 `工艺计划流水号`。
### 3.3 精工车间
- 发起改制后自动生成精工车间生产任务。
- 自动生成默认工艺 `改制`。
- 工艺计划进入“工艺完成”状态，后续可进入派工。
- 生产任务查询中优先显示改制订单编号、改制零件名称、改制零件图号。
### 3.4 MES 加工端
- MES 待加工显示关联改制记录。
- 有改制订单时，订单号优先显示改制订单编号。
- 通过 `工艺计划流水号` 关联改制记录，避免重复显示。
## 4. 编号规则
改制订单编号规则：
```text
BHGZ + 年月日 + 4位顺序号
```
示例：
```text
BHGZ202606250001
BHGZ-202606270010
```
实际格式以数据库发起过程最终生成逻辑为准，但业务前缀固定为 `BHGZ`。
## 5. 核心流程
```text
技术中心选择订单/产品
-> 查询产品零件
-> 点击零件改制
-> 校验原图号与改制图号不同
-> 生成改制订单记录
-> 生成精工车间工艺计划
-> 回写工艺计划流水号
-> 自动添加默认工艺“改制”
-> 生产任务查询显示改制任务
-> 车间派工
-> MES 加工
-> 完工入库
```
## 6. 不在当前范围内的内容
- 非毛坯物料改制自动生成领料单。
- 仓库出库状态限制派工。
- 改制订单取消、退料、异常处理。
- 改制记录独立查询页面的完整开发。
这些内容作为后续扩展任务维护在任务矩阵中。

258
docs/零件改制/02-项目程序开发详细步骤.md Normal file
View File

@@ -0,0 +1,258 @@
# 02-项目程序开发详细步骤
## 1. 前端开发步骤
### 1.1 新增组件
路径：
```text
src/views/TechnologyCenter/PartModificationOrder/index.vue
```
页面结构：
```text
app-container
-> el-card
-> 左侧订单/产品表格
-> 右侧零件表格
-> 发起改制弹窗
-> 图纸查看弹窗
```
### 1.2 左侧订单/产品查询
订单下拉接口：
```text
订单信息_列表_查询数据_bak
```
要求：
- 不需要传订单编号时也可加载订单列表。
- `label` 使用订单编号。
- `value` 使用订单流水号。
订单/产品查询接口：
```text
技术中心_改制订单_订单_查询
```
要求：
- 传入下拉选择的订单流水号。
- 显示订单编号、产品名称。
- 相同数据去重显示由后端查询保证。
### 1.3 右侧零件查询
接口：
```text
技术中心_改制订单_零件_查询
```
要求：
- 点击左侧产品后查询对应零件。
- 显示零件名称、零件图号、数量。
- 操作列包含“查看图纸”和“改制”。
### 1.4 发起改制弹窗
弹窗字段：
```text
原订单编号
原零件名称
原零件图号
原数量
改制零件名称
改制零件图号
改制数量
精工期限
```
提交前校验：
```js
var oldDrawingNo = (this.form.原零件图号 || '').toString().trim()
var newDrawingNo = (this.form.改制零件图号 || '').toString().trim()
if (oldDrawingNo && newDrawingNo && oldDrawingNo === newDrawingNo) {
this.$message.warning('改制零件图号不能与原零件图号相同')
return
}
```
提交接口：
```text
技术中心_改制订单_发起改制
```
## 2. 数据库开发步骤
### 2.1 改制记录表
表：
```text
技术中心_改制订单记录
```
关键字段：
```text
改制订单流水号
改制订单编号
原订单流水号
原组件流水号
原基本件流水号
原零件名称
原零件图号
改制零件名称
改制零件图号
改制数量
精工期限
工艺计划流水号
状态
发起人
发起时间
是否删除
```
字段补充 SQL：
```sql
IF COL_LENGTH('dbo.技术中心_改制订单记录', '原零件名称') IS NULL
BEGIN
ALTER TABLE dbo.技术中心_改制订单记录
ADD 原零件名称 nvarchar(50) NULL;
END;
IF COL_LENGTH('dbo.技术中心_改制订单记录', '原零件图号') IS NULL
BEGIN
ALTER TABLE dbo.技术中心_改制订单记录
ADD 原零件图号 nvarchar(50) NULL;
END;
IF COL_LENGTH('dbo.技术中心_改制订单记录', '工艺计划流水号') IS NULL
BEGIN
ALTER TABLE dbo.技术中心_改制订单记录
ADD 工艺计划流水号 int NULL;
END;
```
### 2.2 改制订单排序表
表：
```text
技术中心_改制订单排序
```
用途：
- 按年份记录改制订单顺序号。
- 支持生成 `BHGZ + 年月日 + 4位顺序号`。
### 2.3 发起改制存储过程
过程：
```text
技术中心_改制订单_发起改制
```
主要步骤：
1. 校验参数。
2. 后端校验原零件图号和改制零件图号不同。
3. 查询原基本件流水号。
4. 生成改制订单编号。
5. 插入 `技术中心_改制订单记录`。
6. 插入 `车间生产管理工艺_零件工艺计划`。
7. 回写 `技术中心_改制订单记录.工艺计划流水号`。
8. 查找或创建基础工艺 `改制`。
9. 更新或插入 `车间生产管理工艺_零件工序`。
10. 调用 `精工车间_工艺保存_派工`。
11. 更新组件和订单为精工车间承接。
### 2.4 生产任务视图
视图：
```text
车间生产管理_零件工艺计划_视图
```
已调整：
```sql
ISNULL(dbo.技术中心_改制订单记录.改制零件名称, dbo.库存管理_物料主文件_基本.名称) AS 零件名称
ISNULL(dbo.技术中心_改制订单记录.改制零件图号, dbo.车间生产管理工艺_零件工艺计划.零件图号) AS 零件图号
ISNULL(dbo.技术中心_改制订单记录.改制订单编号, dbo.合同管理_订单信息_基础表.订单编号) AS 订单号
```
关联：
```sql
LEFT JOIN dbo.技术中心_改制订单记录
ON dbo.车间生产管理工艺_零件工艺计划.工艺计划流水号 = dbo.技术中心_改制订单记录.工艺计划流水号
AND ISNULL(dbo.技术中心_改制订单记录.是否删除, 0) = 0
```
### 2.5 生产任务查询过程
过程：
```text
精工车间_生成任务_查询数据
```
注意事项：
- 主表已使用别名 `P`。
- 动态筛选必须使用 `P.字段名`。
- 不得再使用 `车间生产管理_零件工艺计划_视图.字段名`，否则会出现无法绑定多部分标识符错误。
正确示例：
```sql
AND P.零件图号 LIKE '%' + @图号 + '%'
AND P.操作日期 >= @开始时间
AND P.操作日期 <= @结束时间
```
### 2.6 MES 待加工显示
过程：
```text
MES_机加工MES_零件待加工显示
```
建议关联：
```sql
LEFT JOIN 技术中心_改制订单记录 AS GZ
ON V.工艺计划流水号 = GZ.工艺计划流水号
AND ISNULL(GZ.是否删除, 0) = 0
```
订单号显示：
```sql
ISNULL(GZ.改制订单编号, V.订单号) AS 订单号
```
## 3. 验证步骤
1. 前端运行 eslint。
2. 查询改制记录是否回写工艺计划流水号。
3. 查询生产任务视图显示字段是否与改制记录一致。
4. 查询是否存在同一工艺计划流水号关联多条未删除改制记录。
5. 用图号筛选生产任务查询过程，确认不再出现 4104 错误。

29
docs/零件改制/03-推进台账.md Normal file
View File

@@ -0,0 +1,29 @@
# 03-推进台账
| 轮次 | 日期 | 做了什么 | 改了哪些文件/程序 | 验证了什么 | 下一步 |
| --- | --- | --- | --- | --- | --- |
| 1 | 2026-06-23 | 梳理零件改制整体方案 | `零件改制功能设计方案.md` | 方案包含需求背景、应用场景、流程、表设计 | 生成 PDF 和流程图 |
| 2 | 2026-06-23 | 生成设计方案 PDF 和流程图 | `零件改制功能设计方案.pdf`、`零件改制流程图.svg` | PDF 可打开，流程图包含入库节点 | 开始前端组件 |
| 3 | 2026-06-24 | 新建零件改制组件 | `src/views/TechnologyCenter/PartModificationOrder/index.vue` | 修复动态路由加载 ENOENT | 调整查询接口 |
| 4 | 2026-06-24 | 调整订单和零件查询接口 | `PartModificationOrder/index.vue` | 使用 `技术中心_改制订单_订单_查询`、`技术中心_改制订单_零件_查询` | 调整订单下拉 |
| 5 | 2026-06-24 | 订单编号输入框改为下拉框 | `PartModificationOrder/index.vue` | 下拉数据来自 `订单信息_列表_查询数据_bak` | 参考 BOM 优化界面 |
| 6 | 2026-06-24 | 参考 BOM 更换物料界面调整发起改制弹窗 | `PartModificationOrder/index.vue` | eslint 通过 | 开始后端存储过程设计 |
| 7 | 2026-06-25 | 设计发起改制过程 | `技术中心_改制订单_发起改制` | 明确只分配到精工车间 | 增加改制记录表 |
| 8 | 2026-06-25 | 增加改制订单记录表方案 | `技术中心_改制订单记录` | 明确记录字段和回写工艺计划流水号 | 增加订单号规则 |
| 9 | 2026-06-25 | 设计改制订单号生成规则 | `技术中心_改制订单排序` | 规则为 `BHGZ + 年月日 + 4位顺序号` | 添加默认工艺 |
| 10 | 2026-06-25 | 设计默认工艺 `改制` | `车间生产管理工艺_基础表_工艺名称`、`车间生产管理工艺_零件工序` | 明确不存在则新增基础工艺 | 调整 INSERT/UPDATE 工序逻辑 |
| 11 | 2026-06-25 | 工序插入逻辑改为优先更新 | `技术中心_改制订单_发起改制` | 有默认空工序时更新，无则插入兜底 | 修改查询关联方式 |
| 12 | 2026-06-25 | 查询关联由基本件流水号改为工艺计划流水号 | 生产任务查询、MES 待加工显示 SQL | 避免同一基本件多次改制重复显示 | 补充原零件信息字段 |
| 13 | 2026-06-25 | 添加原零件名称、原零件图号 | `技术中心_改制订单记录`、发起过程 INSERT | 改制记录可追溯原零件 | 修改生产任务视图 |
| 14 | 2026-06-27 | 修复生产任务显示的零件名称不是改制名称 | `车间生产管理_零件工艺计划_视图` | 抽样验证订单号/零件名称/图号与改制记录一致 | 生成测试报告 |
| 15 | 2026-06-27 | 执行不污染数据的测试并生成测试报告 | `零件改制功能测试报告.md` | eslint 通过；显示不一致数为 0；重复关联数为 0 | 补历史数据或做真实流程验收 |
| 16 | 2026-06-29 | 修复生产任务查询动态 SQL 别名绑定问题 | `精工车间_生成任务_查询数据` | 将动态条件统一改为 `P.字段名` | 执行数据库过程更新并页面验证 |
| 17 | 2026-06-29 | 拆分标准化推进文档 | `docs/零件改制/README.md`、`01-06` 文档 | 文档结构完成 | 后续按任务矩阵继续推进 |
## 当前下一步
1. 将 `精工车间_生成任务_查询数据` 最新完整 SQL 应用到数据库。
2. 使用图号 `XT40-07.01` 再次执行查询，确认不再出现 4104 错误。
3. 使用一条业务允许的测试订单发起真实改制。
4. 验证生产任务查询、车间派工、MES 待加工显示。
5. 补齐 3 条历史未回写 `工艺计划流水号` 的改制记录，或确认无需处理。

44
docs/零件改制/04-任务矩阵.md Normal file
View File

@@ -0,0 +1,44 @@
# 04-任务矩阵
| 任务编号 | 任务名称 | 状态 | 验收标准 | 备注 |
| --- | --- | --- | --- | --- |
| GZ-001 | 编写零件改制功能方案 | 已完成 | 文档包含需求背景、应用场景、现有流程承接、入库节点 | 已生成设计方案 |
| GZ-002 | 生成方案 PDF 和流程图 | 已完成 | PDF 存在，流程图位置正确，流程包含入库 | 已生成 PDF/SVG |
| GZ-003 | 新建技术中心改制组件 | 已完成 | 路由能加载 `PartModificationOrder/index.vue`，无 ENOENT | 已创建组件 |
| GZ-004 | 左侧订单/产品查询 | 已完成 | 可通过订单编号下拉筛选订单/产品 | 使用 `技术中心_改制订单_订单_查询` |
| GZ-005 | 订单编号下拉 | 已完成 | 下拉 label 为订单编号，value 为订单流水号 | 使用 `订单信息_列表_查询数据_bak` |
| GZ-006 | 右侧零件查询 | 已完成 | 点击左侧产品后显示对应零件 | 使用 `技术中心_改制订单_零件_查询` |
| GZ-007 | 发起改制弹窗 | 已完成 | 可录入改制零件名称、图号、数量、精工期限 | 参考 BOM 更换物料风格调整 |
| GZ-008 | 图号一致校验 | 已完成 | 原零件图号与改制零件图号相同时禁止提交 | 前端已加，后端建议保留 |
| GZ-009 | 改制订单记录表 | 已完成 | 表包含原零件、改制零件、工艺计划流水号等字段 | 需以数据库实际结构为准 |
| GZ-010 | 改制订单编号生成 | 已完成 | 编号符合 `BHGZ + 年月日 + 4位顺序号` | 已设计排序表 |
| GZ-011 | 发起改制后端过程 | 进行中 | 能生成改制记录、工艺计划、回写工艺计划流水号 | 需持续按数据库实际过程校验 |
| GZ-012 | 默认工艺 `改制` | 进行中 | 基础工艺不存在时自动新增，工序默认改制 | 已提供 SQL 方案 |
| GZ-013 | 工艺计划流水号回写 | 已完成 | 改制记录可通过工艺计划流水号关联生产任务 | 测试显示 7 条已回写 |
| GZ-014 | 生产任务视图显示改制信息 | 已完成 | 改制任务订单号、零件名称、图号优先取改制记录 | 已修改视图并验证 |
| GZ-015 | 生产任务查询动态 SQL 修复 | 待执行验证 | 图号筛选不再报 4104，排序正常 | 需应用完整 SQL |
| GZ-016 | MES 待加工显示改制单号 | 待联调 | MES 端改制任务订单号显示 BHGZ 编号 | 已给 SQL 方案 |
| GZ-017 | 车间派工显示改制单号 | 待联调 | 派工页订单号、零件名称、图号显示改制信息 | 依赖视图或查询调整 |
| GZ-018 | 改制记录查询页面 | 待开发 | 可按改制订单号、原订单、零件图号查询记录 | 后续新增 |
| GZ-019 | 历史记录回写处理 | 待确认 | 未回写工艺计划流水号的历史记录明确处理方式 | 当前有 3 条未回写 |
| GZ-020 | 完整业务流验收 | 待验收 | 使用测试订单完成发起、生产任务、派工、MES、入库验证 | 需业务允许测试数据 |
## 状态说明
| 状态 | 含义 |
| --- | --- |
| 已完成 | 已实现并至少完成基础验证 |
| 进行中 | 已有实现方案或部分实现，仍需数据库/页面联调确认 |
| 待执行验证 | 已提供修改 SQL，但需要在数据库执行并验证 |
| 待联调 | 依赖上下游页面或接口，需要真实流程验证 |
| 待开发 | 尚未开始编码或建库 |
| 待确认 | 需要业务或数据归属确认 |
| 待验收 | 功能已基本闭环，需要按验收场景跑通 |
## 后续推进优先级
1. `GZ-015`：先修复生产任务查询动态 SQL。
2. `GZ-020`：选择测试订单跑完整流程。
3. `GZ-016`、`GZ-017`：验证 MES 和车间派工显示。
4. `GZ-019`：确认历史未回写记录是否需要补数据。
5. `GZ-018`：开发改制记录查询页面。

149
docs/零件改制/05-验收证据.md Normal file
View File

@@ -0,0 +1,149 @@
# 05-验收证据
## 1. 前端检查证据
组件文件：
```text
D:\景耀\JY1.0\src\views\TechnologyCenter\PartModificationOrder\index.vue
```
执行命令：
```bash
npx eslint --ext .vue D:\景耀\JY1.0\src\views\TechnologyCenter\PartModificationOrder\index.vue
```
结果：
```text
通过
```
备注：
- 命令输出中出现 npm 日志目录权限警告，不影响 eslint 检查结果。
## 2. 设计文档证据
| 文件 | 说明 |
| --- | --- |
| `docs/零件改制/零件改制功能设计方案.md` | 设计方案 Markdown |
| `docs/零件改制/零件改制功能设计方案.pdf` | 设计方案 PDF |
| `docs/零件改制/零件改制流程图.svg` | 改制流程图 |
| `docs/零件改制/零件改制功能开发说明.md` | 汇总版开发说明 |
| `docs/零件改制/零件改制功能测试报告.md` | 测试报告 |
## 3. 数据库视图修改证据
已修改视图：
```text
dbo.车间生产管理_零件工艺计划_视图
```
关键显示逻辑：
```sql
ISNULL(dbo.技术中心_改制订单记录.改制零件名称, dbo.库存管理_物料主文件_基本.名称) AS 零件名称
ISNULL(dbo.技术中心_改制订单记录.改制零件图号, dbo.车间生产管理工艺_零件工艺计划.零件图号) AS 零件图号
ISNULL(dbo.技术中心_改制订单记录.改制订单编号, dbo.合同管理_订单信息_基础表.订单编号) AS 订单号
```
关键关联逻辑：
```sql
LEFT JOIN dbo.技术中心_改制订单记录
ON dbo.车间生产管理工艺_零件工艺计划.工艺计划流水号 = dbo.技术中心_改制订单记录.工艺计划流水号
AND ISNULL(dbo.技术中心_改制订单记录.是否删除, 0) = 0
```
## 4. 数据库验证证据
执行 SQL：
```sql
SELECT
(SELECT COUNT(*) FROM dbo.技术中心_改制订单记录 WHERE ISNULL(是否删除,0)=0) AS 改制记录数,
(SELECT COUNT(*) FROM dbo.技术中心_改制订单记录 WHERE ISNULL(是否删除,0)=0 AND 工艺计划流水号 IS NOT NULL) AS 已回写工艺计划数,
(SELECT COUNT(*) FROM dbo.技术中心_改制订单记录 GZ INNER JOIN dbo.车间生产管理_零件工艺计划_视图 V ON GZ.工艺计划流水号 = V.工艺计划流水号 WHERE ISNULL(GZ.是否删除,0)=0) AS 视图可关联数,
(SELECT COUNT(*) FROM dbo.技术中心_改制订单记录 GZ INNER JOIN dbo.车间生产管理_零件工艺计划_视图 V ON GZ.工艺计划流水号 = V.工艺计划流水号 WHERE ISNULL(GZ.是否删除,0)=0 AND (ISNULL(V.订单号,'') <> ISNULL(GZ.改制订单编号,'') OR ISNULL(V.零件名称,'') <> ISNULL(GZ.改制零件名称,'') OR ISNULL(V.零件图号,'') <> ISNULL(GZ.改制零件图号,''))) AS 显示不一致数,
(SELECT COUNT(*) FROM (SELECT 工艺计划流水号 FROM dbo.技术中心_改制订单记录 WHERE ISNULL(是否删除,0)=0 AND 工艺计划流水号 IS NOT NULL GROUP BY 工艺计划流水号 HAVING COUNT(*) > 1) T) AS 工艺计划重复关联数;
```
结果：
| 改制记录数 | 已回写工艺计划数 | 视图可关联数 | 显示不一致数 | 工艺计划重复关联数 |
| --- | --- | --- | --- | --- |
| 10 | 7 | 7 | 0 | 0 |
结论：
- 已回写工艺计划流水号的改制记录均可关联生产任务视图。
- 订单号、零件名称、零件图号显示一致。
- 未发现重复关联。
## 5. 抽样验证证据
执行 SQL：
```sql
SELECT TOP 5
V.工艺计划流水号,
V.订单号,
V.零件名称,
V.零件图号,
GZ.改制订单编号,
GZ.改制零件名称,
GZ.改制零件图号
FROM dbo.车间生产管理_零件工艺计划_视图 V
INNER JOIN dbo.技术中心_改制订单记录 GZ
ON V.工艺计划流水号 = GZ.工艺计划流水号
WHERE ISNULL(GZ.是否删除,0)=0
ORDER BY GZ.改制订单流水号 DESC;
```
抽样结果：
| 工艺计划流水号 | 订单号 | 零件名称 | 零件图号 | 改制订单编号 |
| --- | --- | --- | --- | --- |
| 6590 | BHGZ-202606270010 | 从动同步带轮(8M50T50W-45) | XT40-2-BT40-14.09-G | BHGZ-202606270010 |
| 6589 | BHGZ-202606260009 | 防水挡盖 | XT20-02-G | BHGZ-202606260009 |
| 6588 | BHGZ-202606250008 | 止刀键 | XT30-2-01-G | BHGZ-202606250008 |
| 6587 | BHGZ202606250007 | 箱体前盖 | XT30-1-MB-01-G | BHGZ202606250007 |
| 6586 | BHGZ202606250006 | 箱体 | XT30-2-MF-02-G | BHGZ202606250006 |
## 6. 错误与修复证据
错误：
```text
消息 4104，级别 16，状态 1
无法绑定由多个部分组成的标识符 "车间生产管理_零件工艺计划_视图.零件图号"。
```
原因：
```sql
FROM 车间生产管理_零件工艺计划_视图 AS P
```
主表已经使用别名 `P`，动态 SQL 条件中不能继续写原表名。
修复：
```sql
AND P.零件图号 LIKE '%' + @图号 + '%'
AND P.操作日期 >= @开始时间
AND P.操作日期 <= @结束时间
```
## 7. 待补充证据
| 证据 | 状态 | 说明 |
| --- | --- | --- |
| 生产任务查询页面截图 | 待补充 | 需页面打开后截图 |
| 车间派工页面截图 | 待补充 | 需选择改制任务后截图 |
| MES 待加工页面截图 | 待补充 | 需现场终端或模拟终端截图 |
| 真实发起改制 job_id/report_id | 暂无 | 当前未通过自动化任务创建真实业务数据 |
| 完整流程测试报告 | 待补充 | 需业务允许测试数据后生成 |

81
docs/零件改制/06-决策记录.md Normal file
View File

@@ -0,0 +1,81 @@
# 06-决策记录
## DR-001：为什么要新增零件改制流程
现场存在零件改制业务，且现场计件、派工、完工入库、统计追溯都需要系统数据支撑。原线下记录无法满足过程管控和后续核算要求，因此需要将改制订单接入系统。
## DR-002：为什么改制订单由技术中心发起
改制通常涉及零件图号、技术要求、加工目标等技术信息。由技术中心发起可以保证改制来源和技术要求准确，再由精工车间承接生产。
## DR-003：为什么改制订单编号使用 `BHGZ`
改制订单需要与销售订单、补货订单、普通生产任务区分。使用 `BHGZ` 前缀可以让生产任务、派工、MES 加工端快速识别改制任务。
## DR-004：为什么改制记录必须保存原零件名称和原零件图号
如果只保存改制后的名称和图号，后续无法追溯“从哪个零件改成哪个零件”。因此记录表必须同时保存：
```text
原零件名称
原零件图号
改制零件名称
改制零件图号
```
## DR-005：为什么前后端都要校验图号不能相同
前端校验用于提高操作体验，避免无效提交。后端校验用于保证数据安全，防止绕过前端调用接口导致无意义改制记录。
## DR-006：为什么要回写工艺计划流水号
早期临时方案按 `原基本件流水号` 关联改制记录，但同一个基本件可能多次改制，会导致生产任务重复显示。正式方案改为按 `工艺计划流水号` 关联，保证一条改制记录对应一条生产任务。
## DR-007：为什么生产任务视图直接显示改制信息
生产任务查询、车间派工、MES 待加工等多个功能都依赖 `车间生产管理_零件工艺计划_视图`。在视图层统一改为改制信息优先显示，可以减少多个页面重复改造。
决策：
```sql
零件名称 = ISNULL(改制零件名称, 原零件名称)
零件图号 = ISNULL(改制零件图号, 原零件图号)
订单号 = ISNULL(改制订单编号, 原订单号)
```
## DR-008：为什么默认工艺设置为 `改制`
改制任务通常需要快速进入派工和加工。如果每次都人工制定工艺，会增加车间操作成本。自动添加默认工艺 `改制` 后，任务可以直接进入派工流程。
## DR-009：为什么默认工序优先 UPDATE
部分工艺计划生成后可能已经存在一条默认空工序。如果直接 INSERT，可能导致多一条工序。最终采用：
```text
有默认工序 -> UPDATE 为改制
没有默认工序 -> INSERT 一条改制工序
```
## DR-010：为什么动态 SQL 必须统一使用别名
`精工车间_生成任务_查询数据` 中主查询使用：
```sql
FROM 车间生产管理_零件工艺计划_视图 AS P
```
因此动态 WHERE 中必须使用 `P.字段名`。继续使用原表名会触发 SQL Server 4104 错误。
## DR-011：为什么不在当前阶段处理领料单
当前阶段目标是打通：
```text
技术中心发起 -> 精工生产任务 -> 默认工艺 -> 派工/MES 显示
```
非毛坯物料领料、仓库出库、派工限制会影响仓储流程和现场规则，需要作为后续阶段单独联调。
## DR-012：为什么保留历史设计方案和测试报告
本次拆分出的 `01-06` 文档用于后续推进和任务管理，原设计方案、开发说明、测试报告保留作为上下文证据，避免历史决策丢失。

32
docs/零件改制/README.md Normal file
View File

@@ -0,0 +1,32 @@
# 零件改制功能文档索引
本目录用于维护“零件改制”功能的设计、开发、推进、验收和决策资料。后续继续开发时，优先从任务矩阵进入，避免重复开发和遗漏验收。
## 文档目录
| 序号 | 文档 | 用途 |
| --- | --- | --- |
| 01 | [01-项目功能内容.md](./01-项目功能内容.md) | 说明需求来源、业务场景、功能范围和流程边界 |
| 02 | [02-项目程序开发详细步骤.md](./02-项目程序开发详细步骤.md) | 记录前端、后端、数据库、查询接口的开发步骤 |
| 03 | [03-推进台账.md](./03-推进台账.md) | 记录每轮做了什么、改了哪些文件、验证了什么、下一步是什么 |
| 04 | [04-任务矩阵.md](./04-任务矩阵.md) | 按任务编号维护状态和验收标准，作为后续推进入口 |
| 05 | [05-验收证据.md](./05-验收证据.md) | 汇总命令、SQL、页面、PDF、报告等证据 |
| 06 | [06-决策记录.md](./06-决策记录.md) | 记录关键技术和业务决策，减少后续重复争论 |
## 现有辅助文档
| 文档 | 说明 |
| --- | --- |
| [零件改制功能设计方案.md](./零件改制功能设计方案.md) | 原始功能设计方案 |
| [零件改制功能设计方案.pdf](./零件改制功能设计方案.pdf) | 设计方案 PDF |
| [零件改制流程图.svg](./零件改制流程图.svg) | 改制流程图 |
| [零件改制功能开发说明.md](./零件改制功能开发说明.md) | 早期汇总版开发说明 |
| [零件改制功能测试报告.md](./零件改制功能测试报告.md) | 早期测试报告 |
## 当前推进建议
1. 先查看 [04-任务矩阵.md](./04-任务矩阵.md)，确认任务状态。
2. 如继续开发，按未完成任务编号推进。
3. 每完成一轮修改，同步更新 [03-推进台账.md](./03-推进台账.md)。
4. 每次验证后，同步补充 [05-验收证据.md](./05-验收证据.md)。
5. 如出现影响后续实现方式的选择，同步补充 [06-决策记录.md](./06-决策记录.md)。

301
docs/零件改制/零件改制功能开发说明.md Normal file
View File

@@ -0,0 +1,301 @@
# 零件改制功能开发说明
## 01-功能内容
### 1.1 需求来源
因现场计件和生产过程追溯需要，将零件改制流程接入系统管理。该需求由罗总牵头，组织技术中心、精工车间、仓储等相关部门讨论后提出。
### 1.2 应用场景
- 技术中心根据现场或订单需求发起零件改制订单。
- 改制订单进入精工车间生产流程。
- 精工车间可在生产任务查询中查看改制任务。
- 车间派工可查看改制任务并进行派工。
- MES 加工端显示改制订单编号，现场按改制任务加工。
- 改制过程形成记录，便于后续查询、统计、追溯。
### 1.3 功能范围
- 技术中心新增“零件改制订单发起”组件。
- 左侧显示订单/产品，右侧显示所选产品下的零件。
- 点击零件操作列“改制”按钮后弹窗发起改制。
- 发起改制时要求改制零件图号不能与原零件图号相同。
- 后端生成改制订单编号，规则为：`BHGZ + 年月日 + 4位顺序号`。
- 后端写入 `技术中心_改制订单记录`。
- 后端生成精工车间工艺计划任务。
- 后端自动添加默认工艺 `改制`。
- 改制记录表回写 `工艺计划流水号`，后续查询统一按该字段关联。
- 生产任务、派工、MES 待加工显示改制订单编号。
## 02-程序开发步骤
### 2.1 前端组件
文件：
```text
src/views/TechnologyCenter/PartModificationOrder/index.vue
```
开发步骤：
1. 新建技术中心零件改制组件目录和 `index.vue`。
2. 左侧订单下拉使用 `订单信息_列表_查询数据_bak` 获取订单列表。
3. 左侧订单/产品查询使用 `技术中心_改制订单_订单_查询`。
4. 点击左侧产品后，右侧零件列表使用 `技术中心_改制订单_零件_查询`。
5. 右侧零件表格增加操作列，提供“查看图纸”和“改制”按钮。
6. 参考 BOM 查询/维护组件“更换物料”交互调整改制弹窗。
7. 发起改制提交前判断：
```js
var oldDrawingNo = (this.form.原零件图号 || '').toString().trim()
var newDrawingNo = (this.form.改制零件图号 || '').toString().trim()
if (oldDrawingNo && newDrawingNo && oldDrawingNo === newDrawingNo) {
this.$message.warning('改制零件图号不能与原零件图号相同')
return
}
```
8. 提交接口使用 `技术中心_改制订单_发起改制`。
### 2.2 后端表结构
新增或维护表：
```sql
技术中心_改制订单记录
技术中心_改制订单排序
```
`技术中心_改制订单记录` 需要包含关键字段：
```text
改制订单流水号
改制订单编号
原订单流水号
原组件流水号
原基本件流水号
原零件名称
原零件图号
改制零件名称
改制零件图号
改制数量
精工期限
工艺计划流水号
状态
发起人
发起时间
是否删除
```
如字段不存在，执行：
```sql
IF COL_LENGTH('dbo.技术中心_改制订单记录', '原零件名称') IS NULL
BEGIN
ALTER TABLE dbo.技术中心_改制订单记录
ADD 原零件名称 nvarchar(50) NULL;
END;
IF COL_LENGTH('dbo.技术中心_改制订单记录', '原零件图号') IS NULL
BEGIN
ALTER TABLE dbo.技术中心_改制订单记录
ADD 原零件图号 nvarchar(50) NULL;
END;
IF COL_LENGTH('dbo.技术中心_改制订单记录', '工艺计划流水号') IS NULL
BEGIN
ALTER TABLE dbo.技术中心_改制订单记录
ADD 工艺计划流水号 int NULL;
END;
```
### 2.3 后端发起改制过程
存储过程：
```text
技术中心_改制订单_发起改制
```
处理步骤：
1. 校验原订单流水号、原组件流水号、改制零件名称、改制零件图号、改制数量。
2. 后端再次校验原零件图号和改制零件图号不能相同。
3. 生成改制订单编号。
4. 插入 `技术中心_改制订单记录`。
5. 插入 `车间生产管理工艺_零件工艺计划`。
6. 回写 `技术中心_改制订单记录.工艺计划流水号`。
7. 查询基础工艺表是否存在 `改制`。
8. 不存在则插入 `车间生产管理工艺_基础表_工艺名称`。
9. 更新或插入 `车间生产管理工艺_零件工序`，默认工艺为 `改制`。
10. 调用或复用 `精工车间_工艺保存_派工`，将工艺计划推进到工艺完成状态。
11. 更新原组件和原订单为精工车间承接。
### 2.4 查询接口调整
需要调整的查询：
```text
精工车间生产任务查询
MES_机加工MES_零件待加工显示
车间派工相关查询
```
关联方式统一改为：
```sql
LEFT JOIN 技术中心_改制订单记录 AS GZ
ON 主表.工艺计划流水号 = GZ.工艺计划流水号
AND ISNULL(GZ.是否删除, 0) = 0
```
订单号显示规则：
```sql
ISNULL(GZ.改制订单编号, 原订单号) AS 订单号
```
## 03-推进台账
| 轮次 | 工作内容 | 修改文件/程序 | 验证内容 | 下一步 |
| --- | --- | --- | --- | --- |
| 1 | 梳理零件改制流程方案 | `零件改制功能设计方案.md` | 方案内容、流程承接关系、入库节点 | 生成 PDF 和流程图 |
| 2 | 生成方案 PDF 和流程图 | `part-modification-plan.html`、`part-modification-plan.pdf` | PDF 文件生成、流程图位置调整 | 开发前端组件 |
| 3 | 新建零件改制组件 | `src/views/TechnologyCenter/PartModificationOrder/index.vue` | 组件路径、动态路由加载不再报 ENOENT | 调整查询接口 |
| 4 | 查询接口调整 | `PartModificationOrder/index.vue` | 订单查询、零件查询接口名调整 | 优化界面 |
| 5 | 参考 BOM 更换物料功能调整界面 | `PartModificationOrder/index.vue` | 弹窗交互、物料选择样式、eslint | 后端过程设计 |
| 6 | 设计发起改制后端过程 | `技术中心_改制订单_发起改制` | 生成改制记录、生成精工任务 | 增加改制订单编号规则 |
| 7 | 改制订单编号规则 | `技术中心_改制订单排序`、发起过程 | `BHGZ + 年月日 + 4位顺序号` | 增加默认工艺 |
| 8 | 增加默认工艺 `改制` | 发起过程、基础工艺表、零件工序表 | 自动添加默认工艺并推进到工艺完成 | 查询显示改制订单号 |
| 9 | 查询关联改制记录 | 生产任务查询、MES 待加工显示 | 订单号优先显示改制订单编号 | 完善验收 |
| 10 | 增加原零件信息字段 | `技术中心_改制订单记录`、发起过程 | 记录原零件名称、原零件图号 | 联调完整流程 |
## 04-任务矩阵
| 任务编号 | 任务名称 | 状态 | 验收标准 |
| --- | --- | --- | --- |
| GZ-001 | 编写零件改制功能方案 | 已完成 | 文档包含背景、场景、流程、表设计、接口设计 |
| GZ-002 | 生成 PDF 和流程图 | 已完成 | PDF 存在，流程图位置正确，流程包含入库 |
| GZ-003 | 新建技术中心改制组件 | 已完成 | 路由可加载 `PartModificationOrder/index.vue` |
| GZ-004 | 左侧订单/产品查询 | 已完成 | 可通过订单编号下拉筛选并显示订单/产品 |
| GZ-005 | 右侧零件查询 | 已完成 | 点击左侧产品后显示对应零件 |
| GZ-006 | 发起改制弹窗 | 已完成 | 可录入改制零件名称、图号、数量、精工期限 |
| GZ-007 | 图号一致校验 | 已完成 | 原零件图号与改制零件图号相同时禁止提交 |
| GZ-008 | 改制订单记录表 | 待数据库执行 | 表包含原零件和改制零件信息 |
| GZ-009 | 改制订单编号生成 | 待数据库执行 | 编号符合 `BHGZyyyyMMdd0001` 规则 |
| GZ-010 | 发起改制后端过程 | 待数据库执行 | 成功写入记录并返回改制订单编号、工艺计划流水号 |
| GZ-011 | 默认工艺 `改制` | 待数据库执行 | 基础工艺不存在时自动创建，工序默认改制 |
| GZ-012 | 工艺计划流水号回写 | 待数据库执行 | 改制记录表能通过工艺计划流水号关联生产任务 |
| GZ-013 | 生产任务查询显示改制单号 | 待联调 | 改制任务显示改制订单编号，非改制任务显示原订单号 |
| GZ-014 | MES 待加工显示改制单号 | 待联调 | 加工端订单号优先显示改制订单编号 |
| GZ-015 | 改制记录查询 | 待开发 | 可按改制订单编号、原订单、零件图号查询记录 |
## 05-验收证据
### 5.1 前端文件
```text
D:\景耀\JY1.0\src\views\TechnologyCenter\PartModificationOrder\index.vue
```
### 5.2 文档与 PDF
```text
D:\景耀\JY1.0\零件改制功能设计方案.md
D:\景耀\JY1.0\part-modification-plan.html
D:\景耀\JY1.0\part-modification-plan.pdf
```
### 5.3 已执行验证命令
```bash
npx eslint --ext .vue D:\景耀\JY1.0\src\views\TechnologyCenter\PartModificationOrder\index.vue
```
结果：已通过。
### 5.4 关键 SQL 验收点
发起改制成功后应能查到：
```sql
SELECT *
FROM 技术中心_改制订单记录
WHERE 改制订单编号 LIKE 'BHGZ%';
```
改制记录应回写工艺计划流水号：
```sql
SELECT 改制订单编号, 原零件名称, 原零件图号, 改制零件名称, 改制零件图号, 工艺计划流水号
FROM 技术中心_改制订单记录
WHERE 工艺计划流水号 IS NOT NULL;
```
默认工艺应生成：
```sql
SELECT *
FROM 车间生产管理工艺_基础表_工艺名称
WHERE 工艺名称 = N'改制';
```
默认工序应生成或被更新：
```sql
SELECT *
FROM 车间生产管理工艺_零件工序
WHERE 工艺计划流水号 = @工艺计划流水号;
```
### 5.5 页面验收点
- 技术中心零件改制页面可以正常打开。
- 订单编号下拉可选择订单。
- 左侧订单/产品数据去重显示。
- 点击左侧产品后，右侧显示零件。
- 点击“改制”打开弹窗。
- 改制零件图号与原图号相同时，页面阻止提交。
- 改制提交成功后返回成功提示。
- 精工车间生产任务查询可看到改制任务。
- MES 待加工显示中，改制任务订单号显示为 `BHGZ...`。
## 06-决策记录
### 6.1 为什么改制订单号使用独立编号
改制订单不是原销售订单，也不是普通生产订单。使用 `BHGZ + 年月日 + 4位顺序号` 可以明确区分补货改制任务，便于车间识别、计件统计和后续追溯。
### 6.2 为什么改制记录表要保存工艺计划流水号
早期临时方案按 `原基本件流水号` 关联改制记录，但同一个基本件可能多次改制，会导致生产任务或 MES 待加工数据重复显示。最终决定在发起改制时回写 `工艺计划流水号`，后续查询统一按 `工艺计划流水号` 关联，保证一对一。
### 6.3 为什么需要保存原零件名称和原零件图号
改制后零件名称和图号会变化，如果只保存改制后的信息，后续无法准确追溯改制来源。增加 `原零件名称`、`原零件图号` 后，改制记录可以完整展示“从哪个零件改成哪个零件”。
### 6.4 为什么前后端都校验图号不能相同
前端校验用于提升用户体验，避免无效提交。后端校验用于保证数据安全，防止绕过前端直接调用接口造成无意义改制记录。
### 6.5 为什么默认工艺设为 `改制`
改制任务进入精工车间后，需要可派工、可加工、可计件。如果每次都人工制定工艺，会增加现场操作成本。自动添加默认工艺 `改制` 后，改制任务可以快速进入派工和生产流程。
### 6.6 为什么不继续按基本件流水号关联改制记录
基本件流水号代表原零件来源，不代表某一次具体改制任务。改制任务真正进入车间后，对应的是新生成的 `工艺计划流水号`。因此正式查询必须按 `工艺计划流水号` 关联，避免重复数据和错误显示。
### 6.7 为什么生产任务和 MES 显示改制订单编号
现场需要识别当前任务是改制任务，并且计件、派工、加工、入库都需要统一单号。生产任务和 MES 端优先显示改制订单编号，可以减少现场沟通成本。
## 后续建议
1. 补充 `技术中心_改制订单_记录_查询` 接口。
2. 建立改制记录查询页面。
3. 对生产任务查询、车间派工、MES 待加工显示做完整联调。
4. 补充改制任务取消、退料、异常处理规则。
5. 如后续恢复“非毛坯物料改制需要领料”，再扩展领料单生成与仓库出库状态。

187
docs/零件改制/零件改制功能测试报告.md Normal file
View File

@@ -0,0 +1,187 @@
# 零件改制功能测试报告
## 1. 测试范围
本次测试针对零件改制功能近期修改内容进行验证，重点覆盖：
- 技术中心发起零件改制组件静态检查。
- `车间生产管理_零件工艺计划_视图` 改制记录关联验证。
- 改制订单编号、改制零件名称、改制零件图号在生产任务数据源中的显示验证。
- `技术中心_改制订单记录.工艺计划流水号` 回写数据检查。
- 改制记录与工艺计划一对一关联检查，避免重复显示。
本次测试未新建真实改制订单，避免污染业务数据。
## 2. 测试环境
| 项目 | 内容 |
| --- | --- |
| 前端项目 | `D:\景耀\JY1.0` |
| 数据库 | `ERPTOOL_JY_20250826Back` |
| SQL Server | 内网 SQL Server |
| 测试日期 | 2026-06-27 |
| 测试方式 | 前端静态检查 + 数据库只读查询验证 |
## 3. 测试项
### 3.1 前端组件静态检查
测试对象：
```text
D:\景耀\JY1.0\src\views\TechnologyCenter\PartModificationOrder\index.vue
```
执行命令：
```bash
npx eslint --ext .vue D:\景耀\JY1.0\src\views\TechnologyCenter\PartModificationOrder\index.vue
```
结果：
```text
通过
```
说明：
- 组件语法与 eslint 规则检查通过。
- 命令输出中存在 npm 日志目录权限警告，不影响组件检查结果。
### 3.2 改制记录回写检查
执行 SQL：
```sql
SELECT
(SELECT COUNT(*) FROM dbo.技术中心_改制订单记录 WHERE ISNULL(是否删除,0)=0) AS 改制记录数,
(SELECT COUNT(*) FROM dbo.技术中心_改制订单记录 WHERE ISNULL(是否删除,0)=0 AND 工艺计划流水号 IS NOT NULL) AS 已回写工艺计划数,
(SELECT COUNT(*) FROM dbo.技术中心_改制订单记录 GZ INNER JOIN dbo.车间生产管理_零件工艺计划_视图 V ON GZ.工艺计划流水号 = V.工艺计划流水号 WHERE ISNULL(GZ.是否删除,0)=0) AS 视图可关联数,
(SELECT COUNT(*) FROM dbo.技术中心_改制订单记录 GZ INNER JOIN dbo.车间生产管理_零件工艺计划_视图 V ON GZ.工艺计划流水号 = V.工艺计划流水号 WHERE ISNULL(GZ.是否删除,0)=0 AND (ISNULL(V.订单号,'') <> ISNULL(GZ.改制订单编号,'') OR ISNULL(V.零件名称,'') <> ISNULL(GZ.改制零件名称,'') OR ISNULL(V.零件图号,'') <> ISNULL(GZ.改制零件图号,''))) AS 显示不一致数,
(SELECT COUNT(*) FROM (SELECT 工艺计划流水号 FROM dbo.技术中心_改制订单记录 WHERE ISNULL(是否删除,0)=0 AND 工艺计划流水号 IS NOT NULL GROUP BY 工艺计划流水号 HAVING COUNT(*) > 1) T) AS 工艺计划重复关联数;
```
结果：
| 改制记录数 | 已回写工艺计划数 | 视图可关联数 | 显示不一致数 | 工艺计划重复关联数 |
| --- | --- | --- | --- | --- |
| 10 | 7 | 7 | 0 | 0 |
结论：
- 当前共有 10 条未删除改制记录。
- 其中 7 条已回写 `工艺计划流水号`。
- 已回写的 7 条均可通过 `车间生产管理_零件工艺计划_视图` 关联到生产任务。
- 关联后的订单号、零件名称、零件图号与改制记录一致，不一致数量为 0。
- 未发现同一 `工艺计划流水号` 对应多条未删除改制记录的情况。
### 3.3 改制任务显示字段抽样检查
执行 SQL：
```sql
SELECT TOP 5
V.工艺计划流水号,
V.订单号,
V.零件名称,
V.零件图号,
GZ.改制订单编号,
GZ.改制零件名称,
GZ.改制零件图号
FROM dbo.车间生产管理_零件工艺计划_视图 V
INNER JOIN dbo.技术中心_改制订单记录 GZ
ON V.工艺计划流水号 = GZ.工艺计划流水号
WHERE ISNULL(GZ.是否删除,0)=0
ORDER BY GZ.改制订单流水号 DESC;
```
抽样结果：
| 工艺计划流水号 | 订单号 | 零件名称 | 零件图号 | 改制订单编号 | 改制零件名称 | 改制零件图号 |
| --- | --- | --- | --- | --- | --- | --- |
| 6590 | BHGZ-202606270010 | 从动同步带轮(8M50T50W-45) | XT40-2-BT40-14.09-G | BHGZ-202606270010 | 从动同步带轮(8M50T50W-45) | XT40-2-BT40-14.09-G |
| 6589 | BHGZ-202606260009 | 防水挡盖 | XT20-02-G | BHGZ-202606260009 | 防水挡盖 | XT20-02-G |
| 6588 | BHGZ-202606250008 | 止刀键 | XT30-2-01-G | BHGZ-202606250008 | 止刀键 | XT30-2-01-G |
| 6587 | BHGZ202606250007 | 箱体前盖 | XT30-1-MB-01-G | BHGZ202606250007 | 箱体前盖 | XT30-1-MB-01-G |
| 6586 | BHGZ202606250006 | 箱体 | XT30-2-MF-02-G | BHGZ202606250006 | 箱体 | XT30-2-MF-02-G |
结论：
- `车间生产管理_零件工艺计划_视图.订单号` 已优先显示改制订单编号。
- `车间生产管理_零件工艺计划_视图.零件名称` 已优先显示改制零件名称。
- `车间生产管理_零件工艺计划_视图.零件图号` 已优先显示改制零件图号。
## 4. 已修改内容确认
### 4.1 视图修改
已修改：
```text
dbo.车间生产管理_零件工艺计划_视图
```
核心逻辑：
```sql
ISNULL(dbo.技术中心_改制订单记录.改制零件名称, dbo.库存管理_物料主文件_基本.名称) AS 零件名称
ISNULL(dbo.技术中心_改制订单记录.改制零件图号, dbo.车间生产管理工艺_零件工艺计划.零件图号) AS 零件图号
ISNULL(dbo.技术中心_改制订单记录.改制订单编号, dbo.合同管理_订单信息_基础表.订单编号) AS 订单号
```
关联逻辑：
```sql
LEFT JOIN dbo.技术中心_改制订单记录
ON dbo.车间生产管理工艺_零件工艺计划.工艺计划流水号 = dbo.技术中心_改制订单记录.工艺计划流水号
AND ISNULL(dbo.技术中心_改制订单记录.是否删除, 0) = 0
```
## 5. 测试结论
本轮测试通过。
已验证：
- 前端改制组件静态检查通过。
- 改制记录已按 `工艺计划流水号` 与生产任务视图关联。
- 已回写工艺计划流水号的改制记录，生产任务视图显示字段一致。
- 未发现工艺计划重复关联改制记录导致重复显示的问题。
- 生产任务数据源中的订单号、零件名称、零件图号已优先显示改制记录中的信息。
## 6. 风险与遗留项
### 6.1 仍有历史记录未回写工艺计划流水号
当前 10 条未删除改制记录中，有 7 条已回写 `工艺计划流水号`，仍有 3 条未回写。
影响：
- 未回写的历史改制记录无法通过新视图逻辑显示改制订单编号、改制零件名称、改制零件图号。
建议：
- 如这些历史记录仍需展示，需要补写 `工艺计划流水号`。
- 新发起的改制订单必须在发起过程内立即回写 `工艺计划流水号`。
### 6.2 本次未执行真实新增改制订单
本次测试没有调用 `技术中心_改制订单_发起改制` 新增业务数据。
原因：
- 避免污染当前业务库。
建议：
- 如需完整流程验收，可指定一条测试订单和测试零件，在业务允许的情况下执行一次真实发起改制，再验证生产任务、派工、MES 待加工端显示。
## 7. 下一步建议
1. 确认 3 条未回写历史改制记录是否需要补数据。
2. 使用一条测试订单执行完整发起改制流程。
3. 验证生产任务查询页面显示。
4. 验证车间派工页面显示。
5. 验证 MES 待加工显示。
6. 验证改制默认工艺 `改制` 是否可直接派工和加工。

477
docs/零件改制/零件改制功能设计方案.html Normal file
View File

@@ -0,0 +1,477 @@
<!doctype html>
<html>
<head>
<meta charset="utf-8">
<title>零件改制功能设计方案</title>
<style>
@page { size: A4; margin: 18mm 16mm; }
body {
font-family: "Microsoft YaHei", "SimSun", Arial, sans-serif;
color: #1f2933;
font-size: 13px;
line-height: 1.65;
}
h1 {
font-size: 26px;
text-align: center;
margin: 0 0 24px;
padding-bottom: 12px;
border-bottom: 2px solid #2f80ed;
}
h2 {
font-size: 19px;
margin: 24px 0 10px;
padding-left: 8px;
border-left: 4px solid #2f80ed;
page-break-after: avoid;
}
h3 {
font-size: 16px;
margin: 18px 0 8px;
page-break-after: avoid;
}
p { margin: 7px 0; }
ul { margin: 6px 0 10px 22px; padding: 0; }
li { margin: 3px 0; }
table {
width: 100%;
border-collapse: collapse;
margin: 10px 0 16px;
page-break-inside: avoid;
}
th, td {
border: 1px solid #cbd5e1;
padding: 6px 8px;
text-align: left;
vertical-align: top;
word-break: break-word;
}
th {
background: #eef4ff;
font-weight: 600;
}
code {
font-family: Consolas, "Microsoft YaHei", monospace;
background: #f3f4f6;
padding: 1px 4px;
border-radius: 3px;
}
pre {
background: #f8fafc;
border: 1px solid #d8dee9;
padding: 10px;
overflow-wrap: break-word;
white-space: pre-wrap;
page-break-inside: avoid;
}
figure {
margin: 14px 0 20px;
page-break-inside: avoid;
}
figure img {
display: block;
width: 100%;
max-width: 100%;
height: auto;
border: 1px solid #d8dee9;
}
figcaption {
margin-top: 6px;
color: #64748b;
font-size: 12px;
text-align: center;
}
</style>
</head>
<body>
<h1>零件改制功能设计方案</h1>
<h2>0. 需求背景</h2>
<h3>0.1 需求提出</h3>
<p>本需求由罗总牵头，组织技术中心、精工车间、仓储等相关部门讨论后提出。</p>
<h3>0.2 提出原因</h3>
<p>当前现场存在零件改制业务，但改制过程尚未完整纳入系统管理。由于现场计件、派工生产、完工入库和后续统计都需要明确的数据来源，原有线下记录或零散流转方式无法满足计件核算、过程追溯和部门协同要求。</p>
<p>因此，需要在系统内补充零件改制订单流程，将改制订单从技术中心发起、精工车间派工生产到完工入库的全过程纳入系统管理。</p>
<h3>0.3 应用场景</h3>
<p>本功能主要应用于以下场景：</p>
<ul><li>技术中心根据现场或订单需求发起零件改制订单。</li><li>精工车间根据改制订单制定工艺、派工生产。</li><li>改制订单涉及非毛坯物料时，由系统生成领料单并交由仓库出库。</li><li>改制加工完成后，按现有流程办理入库。</li><li>现场计件、生产统计、入库记录和后续追溯均以系统内改制订单数据为依据。</li></ul>
<h2>1. 需求目标</h2>
<p>基于项目现有精工车间生产流程，新增“零件改制”业务。</p>
<p>本次方案调整为：</p>
<ul><li>在技术中心新增组件发起改制订单。</li><li>改制订单生成后进入现有精工车间生产任务流程。</li><li>精工车间生产任务查询组件可以查看改制订单。</li><li>车间派工组件可以查看改制订单并继续派工。</li><li>新增改制记录查询，用于查看改制订单的发起、生产、派工、领料和完工状态。</li><li>领料时根据改制订单和物料来源判断是否生成领料单。</li></ul>
<p>核心原则：</p>
<ul><li>技术中心负责发起改制订单。</li><li>精工车间复用现有生产任务、工艺、派工、加工流程。</li><li>仓储只在需要额外领用非毛坯物料时介入。</li><li>改制记录独立查询，但状态关联现有生产任务状态。</li></ul>
<h2>2. 现有流程承接关系</h2>
<p>根据项目现有页面，改制订单应承接以下流程：</p>
<table>
<thead><tr><th>流程节点</th><th>现有承接页面</th><th>说明</th></tr></thead>
<tbody>
<tr><td>技术发起</td><td>技术中心新增页面</td><td>发起改制订单，填写改制要求</td></tr>
<tr><td>生成任务</td><td>精工车间生产任务查询</td><td>改制订单进入生产任务列表</td></tr>
<tr><td>制定工艺</td><td>精工车间制定工艺</td><td>可复用或复制原工艺后调整</td></tr>
<tr><td>车间派工</td><td>精工车间车间派工</td><td>工艺完成后派工</td></tr>
<tr><td>领料判断</td><td>领料/仓储出库流程</td><td>根据物料类型决定是否生成领料单</td></tr>
<tr><td>加工执行</td><td>精工车间现有加工流程</td><td>扫码、报工、质检等复用现有逻辑</td></tr>
<tr><td>入库</td><td>仓储入库流程</td><td>改制完工后按现有流程办理入库</td></tr>
<tr><td>记录查询</td><td>改制记录查询</td><td>查看改制全流程</td></tr>
</tbody>
</table>
<figure><img src="零件改制流程图.svg" alt="零件改制业务流程图"><figcaption>零件改制业务流程图</figcaption></figure>
<h2>3. 页面设计</h2>
<h3>3.1 技术中心新增页面：改制订单发起</h3>
<p>建议路径：</p>
<pre><code>src/views/TechnologyCenter/PartModificationOrder/index.vue</code></pre>
<p>页面名称：</p>
<pre><code>改制订单发起</code></pre>
<p>归属模块：</p>
<pre><code>技术中心</code></pre>
<p>主要功能：</p>
<ul><li>查询需要改制的原订单、原零件或原自制件。</li><li>发起改制订单。</li><li>填写改制后零件信息、改制数量、改制原因、技术要求。</li><li>指定是否使用原件改制、毛坯改制或其他物料改制。</li><li>提交后生成改制订单，并进入精工车间生产任务查询。</li></ul>
<h3>3.2 精工车间修改页面：生产任务查询</h3>
<p>现有路径：</p>
<pre><code>src/views/SeikoWorkshop/ProductionTaskQuery/index.vue</code></pre>
<p>需要支持：</p>
<ul><li>查询改制订单生成的生产任务。</li><li>增加任务类型筛选。</li><li>增加任务类型列。</li><li>改制任务显示 <code>改制</code> 标识。</li><li>改制任务继续使用现有 <code>工艺</code>、<code>派工</code> 按钮。</li></ul>
<h3>3.3 精工车间修改页面：车间派工</h3>
<p>现有路径：</p>
<pre><code>src/views/SeikoWorkshop/WorkshopAssignment/index.vue</code></pre>
<p>需要支持：</p>
<ul><li>查询改制订单对应的待派工任务。</li><li>增加任务类型筛选。</li><li>增加任务类型列。</li><li>复用现有已派工查询、待派工工序查询、派工、取消派工逻辑。</li></ul>
<h3>3.4 新增页面：改制记录查询</h3>
<p>建议路径：</p>
<pre><code>src/views/TechnologyCenter/PartModificationRecord/index.vue</code></pre>
<p>也可以放在精工车间模块，建议最终按业务归属确认。</p>
<p>页面名称：</p>
<pre><code>改制记录查询</code></pre>
<p>主要功能：</p>
<ul><li>查询改制订单记录。</li><li>查看改制订单状态。</li><li>查看是否生成领料单。</li><li>查看仓库是否已出库。</li><li>查看精工生产任务、工艺、派工、完工状态。</li><li>支持跳转生产任务查询、车间派工、零件追溯。</li></ul>
<h2>4. 改制订单类型</h2>
<p>改制订单需要明确物料来源，建议增加字段：</p>
<pre><code>改制来源类型</code></pre>
<p>建议枚举：</p>
<table>
<thead><tr><th>改制来源类型</th><th>说明</th><th>是否生成领料单</th></tr></thead>
<tbody>
<tr><td>原现自制订单</td><td>使用原现有自制订单零件进行改制</td><td>否</td></tr>
<tr><td>毛坯改制</td><td>直接使用已有毛坯进行改制</td><td>否</td></tr>
<tr><td>非毛坯物料改制</td><td>使用仓库其他物料、半成品或成品改制</td><td>是</td></tr>
</tbody>
</table>
<p>说明：</p>
<ul><li>“原现自制订单”指当前已经存在的自制订单或自制零件，改制时不需要额外从仓库领料。</li><li>“毛坯改制”指直接使用毛坯进行改制，不额外生成领料单。</li><li>“非毛坯物料改制”指改制需要领用库存中的非毛坯物料，需要生成领料单并由仓库出库。</li></ul>
<h2>5. 领料规则</h2>
<h3>5.1 领料判断条件</h3>
<p>领料时增加判断：</p>
<pre><code>如果是改制订单，并且使用的物料不是毛坯，则生成领料单，由仓库物料出库。
如果是原现自制订单改制，或者直接使用毛坯改制，则不生成领料单。</code></pre>
<p>规则可表达为：</p>
<pre><code>是否生成领料单 =
是否改制订单 === 1
且 改制来源类型 === 非毛坯物料改制
且 是否毛坯 !== 1</code></pre>
<h3>5.2 生成领料单场景</h3>
<p>以下场景需要生成领料单：</p>
<ul><li>改制订单使用库存半成品。</li><li>改制订单使用库存成品。</li><li>改制订单使用其他非毛坯物料。</li><li>改制订单指定的物料需要仓库出库。</li></ul>
<p>生成后流程：</p>
<p>1. 技术中心发起改制订单。 2. 系统判断需要领料。 3. 生成领料单。 4. 仓库根据领料单出库。 5. 出库完成后，精工车间继续生产、工艺、派工。</p>
<h3>5.3 不生成领料单场景</h3>
<p>以下场景不生成领料单：</p>
<ul><li>原现自制订单改制。</li><li>直接使用毛坯改制。</li><li>改制对象已经在精工车间现场，不需要仓库出库。</li></ul>
<p>不生成领料单时：</p>
<ul><li>改制订单直接进入精工生产任务。</li><li>生产任务查询可查看。</li><li>车间派工可查看并派工。</li></ul>
<h3>5.4 领料状态字段</h3>
<p>建议改制订单增加以下字段：</p>
<table>
<thead><tr><th>字段名</th><th>说明</th></tr></thead>
<tbody>
<tr><td>是否需要领料</td><td>1 是，0 否</td></tr>
<tr><td>是否已生成领料单</td><td>1 是，0 否</td></tr>
<tr><td>领料单号</td><td>生成的领料单编号</td></tr>
<tr><td>领料状态</td><td>未生成、待出库、已出库、已取消</td></tr>
<tr><td>出库日期</td><td>仓库出库日期</td></tr>
<tr><td>出库人</td><td>仓库操作人</td></tr>
</tbody>
</table>
<h2>6. 业务流程</h2>
<h3>6.1 技术中心发起改制订单</h3>
<p>用户进入技术中心“改制订单发起”页面。</p>
<p>查询原始数据：</p>
<ul><li>订单编号</li><li>产品/部件名称</li><li>零件名称</li><li>图号</li><li>原自制订单</li><li>库存物料</li><li>毛坯物料</li></ul>
<p>发起改制时填写：</p>
<ul><li>改制订单号</li><li>原订单编号</li><li>原零件名称</li><li>原零件图号</li><li>改制零件名称</li><li>改制零件图号</li><li>改制数量</li><li>改制来源类型</li><li>是否毛坯</li><li>物料编号</li><li>物料名称</li><li>改制原因</li><li>改制要求</li><li>技术备注</li><li>精工期限</li></ul>
<p>提交时校验：</p>
<ul><li>改制数量必须大于 0。</li><li>改制来源类型不能为空。</li><li>改制原因不能为空。</li><li>改制要求不能为空。</li><li>精工期限不能为空。</li><li>如果来源类型为非毛坯物料改制，必须选择物料编号。</li></ul>
<h3>6.2 后端生成改制订单</h3>
<p>提交后，后端需要同时处理：</p>
<ul><li>写入改制订单主记录。</li><li>根据改制来源类型判断是否生成领料单。</li><li>生成精工车间生产任务。</li><li>写入任务类型为 <code>改制</code>。</li><li>关联改制订单号和新工艺计划流水号。</li></ul>
<h3>6.3 进入精工车间生产任务查询</h3>
<p>改制订单生成后，应能在现有接口中查到：</p>
<pre><code>精工车间_生成任务_查询数据</code></pre>
<p>建议返回字段增加：</p>
<ul><li>任务类型</li><li>是否改制</li><li>改制订单号</li><li>改制来源类型</li><li>是否需要领料</li><li>领料状态</li><li>改制原因</li><li>改制要求</li></ul>
<p>生产任务查询页面显示：</p>
<ul><li><code>任务类型 = 改制</code></li><li>若 <code>是否需要领料 = 1</code> 且 <code>领料状态 !== 已出库</code>，可显示领料状态提示。</li></ul>
<p>是否允许工艺/派工，需要按业务决定：</p>
<ul><li>如果非毛坯物料改制必须先出库，建议未出库前允许制定工艺，但不允许派工。</li><li>如果现场允许先派工后补出库，则只做提示，不阻断派工。</li></ul>
<p>建议采用更稳妥规则：</p>
<pre><code>需要领料且未出库：允许制定工艺，不允许派工。
不需要领料：正常工艺、派工。
需要领料且已出库：正常工艺、派工。</code></pre>
<h3>6.4 制定工艺</h3>
<p>改制订单在生产任务查询中点击 <code>工艺</code>，进入现有：</p>
<pre><code>/SeikoWorkshop/DevelopProcess</code></pre>
<p>工艺规则：</p>
<ul><li>改制订单必须生成新的工艺计划流水号。</li><li>不覆盖原自制订单或原零件工艺。</li><li>可支持从原工艺复制后调整。</li><li>工艺保存后，任务状态进入 <code>工艺完成</code>。</li></ul>
<h3>6.5 车间派工</h3>
<p>工艺完成后进入现有车间派工页面：</p>
<pre><code>src/views/SeikoWorkshop/WorkshopAssignment/index.vue</code></pre>
<p>现有查询接口：</p>
<pre><code>精工车间_车间派工_查询</code></pre>
<p>改制订单派工前判断：</p>
<ul><li>不需要领料：允许派工。</li><li>需要领料且已出库：允许派工。</li><li>需要领料但未出库：禁止派工，并提示“改制订单物料未出库，不能派工”。</li></ul>
<p>派工明细继续复用现有接口：</p>
<pre><code>车间生产管理工艺_零件工序_已派工查询
车间生产管理工艺_零件工序_派工_工序查询
车间生产管理工艺_零件工序_派工
车间生产管理工艺_零件工序_取消派工</code></pre>
<h3>6.6 仓库出库</h3>
<p>当改制订单需要领料时，系统生成领料单。</p>
<p>仓库根据领料单完成出库后，需要回写：</p>
<ul><li>领料状态 = 已出库</li><li>出库日期</li><li>出库人</li><li>出库数量</li></ul>
<p>出库完成后，精工车间派工限制解除。</p>
<h3>6.7 加工和完工</h3>
<p>改制订单派工后，继续走现有精工车间加工流程：</p>
<ul><li>工序派工</li><li>扫码加工</li><li>完工报工</li><li>质检</li><li>零件追溯</li><li>工时统计</li></ul>
<p>完工后改制记录状态同步为：</p>
<pre><code>已完成</code></pre>
<h2>7. 数据字段设计</h2>
<h3>7.1 改制订单主记录字段</h3>
<table>
<thead><tr><th>字段名</th><th>说明</th></tr></thead>
<tbody>
<tr><td>改制订单号</td><td>改制业务编号</td></tr>
<tr><td>原订单编号</td><td>原订单编号</td></tr>
<tr><td>原订单流水号</td><td>原订单流水号</td></tr>
<tr><td>原组件流水号</td><td>原组件流水号</td></tr>
<tr><td>原基本件流水号</td><td>原零件流水号</td></tr>
<tr><td>原工艺计划流水号</td><td>原工艺计划流水号</td></tr>
<tr><td>原零件名称</td><td>改制前零件名称</td></tr>
<tr><td>原零件图号</td><td>改制前零件图号</td></tr>
<tr><td>原数量</td><td>原数量</td></tr>
<tr><td>改制零件名称</td><td>改制后零件名称</td></tr>
<tr><td>改制零件图号</td><td>改制后零件图号</td></tr>
<tr><td>改制数量</td><td>改制数量</td></tr>
<tr><td>改制来源类型</td><td>原现自制订单、毛坯改制、非毛坯物料改制</td></tr>
<tr><td>是否毛坯</td><td>1 是，0 否</td></tr>
<tr><td>物料编号</td><td>使用物料编号</td></tr>
<tr><td>物料名称</td><td>使用物料名称</td></tr>
<tr><td>物料流水号</td><td>使用物料流水号</td></tr>
<tr><td>是否需要领料</td><td>1 是，0 否</td></tr>
<tr><td>是否已生成领料单</td><td>1 是，0 否</td></tr>
<tr><td>领料单号</td><td>领料单编号</td></tr>
<tr><td>领料状态</td><td>未生成、待出库、已出库、已取消</td></tr>
<tr><td>改制原因</td><td>改制原因</td></tr>
<tr><td>改制要求</td><td>改制要求</td></tr>
<tr><td>技术备注</td><td>技术备注</td></tr>
<tr><td>精工期限</td><td>精工完工期限</td></tr>
<tr><td>新基本件流水号</td><td>改制任务生成的新零件流水号</td></tr>
<tr><td>新工艺计划流水号</td><td>改制任务生成的新工艺计划流水号</td></tr>
<tr><td>发起人</td><td>当前用户 ID</td></tr>
<tr><td>发起日期</td><td>发起时间</td></tr>
<tr><td>状态</td><td>改制订单状态</td></tr>
<tr><td>是否启用</td><td>逻辑删除标识</td></tr>
</tbody>
</table>
<h3>7.2 改制订单状态</h3>
<table>
<thead><tr><th>状态</th><th>说明</th></tr></thead>
<tbody>
<tr><td>待领料</td><td>需要领料，领料单未出库</td></tr>
<tr><td>待工艺</td><td>不需要领料或已出库，等待制定工艺</td></tr>
<tr><td>工艺完成</td><td>工艺已保存，等待派工</td></tr>
<tr><td>待派工</td><td>工艺完成且满足派工条件</td></tr>
<tr><td>加工中</td><td>已派工或已开始加工</td></tr>
<tr><td>已完成</td><td>改制任务完工</td></tr>
<tr><td>已取消</td><td>改制订单取消</td></tr>
</tbody>
</table>
<p>说明：</p>
<ul><li>如果不需要领料，提交后可直接进入 <code>待工艺</code>。</li><li>如果需要领料，提交后进入 <code>待领料</code>。</li><li>仓库出库后从 <code>待领料</code> 转为 <code>待工艺</code> 或保持生产任务状态，由查询时关联显示。</li></ul>
<h2>8. API 设计</h2>
<p>项目请求继续使用：</p>
<pre><code>this.CreateData(type, name, param, pageSize, pageCurrent)
this.ExecDatabase(Data)</code></pre>
<h3>8.1 技术中心查询可改制对象</h3>
<pre><code>var Data = this.CreateData('11', '技术中心_改制订单_可改制对象_查询', param, this.pageSize, this.pageCurrent)</code></pre>
<h3>8.2 技术中心发起改制订单</h3>
<pre><code>var Data = this.CreateData('12', '技术中心_改制订单_发起改制', param)</code></pre>
<p>参数建议：</p>
<table>
<thead><tr><th>参数名</th><th>说明</th></tr></thead>
<tbody>
<tr><td>原订单流水号</td><td>原订单流水号</td></tr>
<tr><td>原组件流水号</td><td>原组件流水号</td></tr>
<tr><td>原基本件流水号</td><td>原基本件流水号</td></tr>
<tr><td>原工艺计划流水号</td><td>原工艺计划流水号</td></tr>
<tr><td>原订单编号</td><td>原订单编号</td></tr>
<tr><td>原零件名称</td><td>原零件名称</td></tr>
<tr><td>原零件图号</td><td>原零件图号</td></tr>
<tr><td>改制零件名称</td><td>改制零件名称</td></tr>
<tr><td>改制零件图号</td><td>改制零件图号</td></tr>
<tr><td>改制数量</td><td>改制数量</td></tr>
<tr><td>改制来源类型</td><td>原现自制订单、毛坯改制、非毛坯物料改制</td></tr>
<tr><td>是否毛坯</td><td>是否毛坯</td></tr>
<tr><td>物料流水号</td><td>使用物料流水号</td></tr>
<tr><td>物料编号</td><td>物料编号</td></tr>
<tr><td>物料名称</td><td>物料名称</td></tr>
<tr><td>改制原因</td><td>改制原因</td></tr>
<tr><td>改制要求</td><td>改制要求</td></tr>
<tr><td>技术备注</td><td>技术备注</td></tr>
<tr><td>精工期限</td><td>精工期限</td></tr>
<tr><td>发起人</td><td>当前用户 ID</td></tr>
</tbody>
</table>
<p>后端处理结果：</p>
<ul><li>生成改制订单。</li><li>判断是否生成领料单。</li><li>生成精工生产任务。</li><li>返回 <code>result</code>、<code>改制订单号</code>、<code>领料单号</code>、<code>是否需要领料</code>。</li></ul>
<h3>8.3 改制记录查询</h3>
<pre><code>var Data = this.CreateData('11', '技术中心_改制订单_记录_查询', param, this.pageSize, this.pageCurrent)</code></pre>
<h3>8.4 改制订单详情</h3>
<pre><code>var Data = this.CreateData('11', '技术中心_改制订单_详情_查询', param)</code></pre>
<h3>8.5 取消改制订单</h3>
<pre><code>var Data = this.CreateData('12', '技术中心_改制订单_取消', param)</code></pre>
<p>取消前后端需要校验：</p>
<ul><li>未派工可以取消。</li><li>已派工未加工，需要先取消派工。</li><li>已加工、已有质检记录或已完成，不允许取消。</li><li>已生成领料单且已出库，不允许直接取消，需要走退料或异常处理。</li></ul>
<h2>9. 现有接口扩展</h2>
<h3>9.1 生产任务查询接口</h3>
<p>现有接口：</p>
<pre><code>精工车间_生成任务_查询数据</code></pre>
<p>新增查询参数：</p>
<table>
<thead><tr><th>参数名</th><th>说明</th></tr></thead>
<tbody>
<tr><td>任务类型\_check</td><td>是否按任务类型过滤</td></tr>
<tr><td>任务类型</td><td>全部、正常、改制、报废补投</td></tr>
<tr><td>领料状态\_check</td><td>是否按领料状态过滤</td></tr>
<tr><td>领料状态</td><td>待出库、已出库、不需要领料</td></tr>
</tbody>
</table>
<p>新增返回字段：</p>
<table>
<thead><tr><th>字段名</th><th>说明</th></tr></thead>
<tbody>
<tr><td>任务类型</td><td>正常、改制、报废补投</td></tr>
<tr><td>是否改制</td><td>1 是，0 否</td></tr>
<tr><td>改制订单号</td><td>改制订单编号</td></tr>
<tr><td>改制来源类型</td><td>原现自制订单、毛坯改制、非毛坯物料改制</td></tr>
<tr><td>是否需要领料</td><td>1 是，0 否</td></tr>
<tr><td>领料状态</td><td>未生成、待出库、已出库、已取消</td></tr>
<tr><td>领料单号</td><td>领料单号</td></tr>
<tr><td>改制原因</td><td>改制原因</td></tr>
<tr><td>改制要求</td><td>改制要求</td></tr>
</tbody>
</table>
<h3>9.2 车间派工查询接口</h3>
<p>现有接口：</p>
<pre><code>精工车间_车间派工_查询</code></pre>
<p>新增查询参数：</p>
<table>
<thead><tr><th>参数名</th><th>说明</th></tr></thead>
<tbody>
<tr><td>任务类型\_check</td><td>是否按任务类型过滤</td></tr>
<tr><td>任务类型</td><td>全部、正常、改制、报废补投</td></tr>
</tbody>
</table>
<p>新增返回字段：</p>
<table>
<thead><tr><th>字段名</th><th>说明</th></tr></thead>
<tbody>
<tr><td>任务类型</td><td>正常、改制、报废补投</td></tr>
<tr><td>是否改制</td><td>1 是，0 否</td></tr>
<tr><td>改制订单号</td><td>改制订单编号</td></tr>
<tr><td>改制来源类型</td><td>改制来源类型</td></tr>
<tr><td>是否需要领料</td><td>1 是，0 否</td></tr>
<tr><td>领料状态</td><td>领料状态</td></tr>
<tr><td>领料单号</td><td>领料单号</td></tr>
</tbody>
</table>
<p>派工前端限制：</p>
<pre><code>如果 是否改制 = 1 且 是否需要领料 = 1 且 领料状态 != 已出库，则不允许派工。</code></pre>
<h2>10. 前端交互调整</h2>
<h3>10.1 技术中心改制订单发起页面</h3>
<p>查询条件：</p>
<ul><li>订单编号</li><li>零件名称</li><li>图号</li><li>物料编号</li><li>物料名称</li><li>改制来源类型</li></ul>
<p>表格列：</p>
<ul><li>订单编号</li><li>产品/部件名称</li><li>零件名称</li><li>零件图号</li><li>数量</li><li>当前状态</li><li>来源类型</li><li>物料编号</li><li>物料名称</li><li>操作</li></ul>
<p>操作：</p>
<ul><li>发起改制</li><li>图纸</li><li>PLM传入工艺</li><li>追溯</li></ul>
<p>发起改制弹窗：</p>
<ul><li>原订单编号</li><li>原零件名称</li><li>原零件图号</li><li>改制零件名称</li><li>改制零件图号</li><li>改制数量</li><li>改制来源类型</li><li>是否毛坯</li><li>物料编号</li><li>物料名称</li><li>改制原因</li><li>改制要求</li><li>技术备注</li><li>精工期限</li></ul>
<h3>10.2 生产任务查询页面</h3>
<p>新增筛选：</p>
<pre><code>任务类型：全部 / 正常 / 改制 / 报废补投
领料状态：全部 / 不需要领料 / 待出库 / 已出库</code></pre>
<p>新增列：</p>
<ul><li>任务类型</li><li>改制订单号</li><li>改制来源类型</li><li>领料状态</li></ul>
<p>显示建议：</p>
<pre><code>&lt;el-tag type="warning" size="mini"&gt;改制&lt;/el-tag&gt;
&lt;el-tag type="danger" size="mini"&gt;待出库&lt;/el-tag&gt;
&lt;el-tag type="success" size="mini"&gt;已出库&lt;/el-tag&gt;
&lt;el-tag type="info" size="mini"&gt;不需要领料&lt;/el-tag&gt;</code></pre>
<h3>10.3 车间派工页面</h3>
<p>新增筛选：</p>
<pre><code>任务类型：全部 / 正常 / 改制 / 报废补投</code></pre>
<p>新增列：</p>
<ul><li>任务类型</li><li>改制订单号</li><li>领料状态</li></ul>
<p>派工按钮或派工操作前增加判断：</p>
<pre><code>if (Number(row.是否改制) === 1 &amp;&amp; Number(row.是否需要领料) === 1 &amp;&amp; row.领料状态 !== '已出库') {
this.$message.warning('改制订单物料未出库，不能派工')
return
}</code></pre>
<h3>10.4 改制记录查询页面</h3>
<p>查询条件：</p>
<ul><li>改制订单号</li><li>原订单编号</li><li>零件名称或图号</li><li>改制来源类型</li><li>领料状态</li><li>改制状态</li><li>发起日期</li><li>发起人</li></ul>
<p>表格列：</p>
<ul><li>改制订单号</li><li>状态</li><li>原订单编号</li><li>原零件名称</li><li>原零件图号</li><li>改制零件名称</li><li>改制零件图号</li><li>改制数量</li><li>改制来源类型</li><li>是否需要领料</li><li>领料单号</li><li>领料状态</li><li>改制原因</li><li>发起人</li><li>发起日期</li><li>精工期限</li><li>完成日期</li><li>操作</li></ul>
<p>操作：</p>
<ul><li>详情</li><li>生产任务</li><li>派工</li><li>追溯</li><li>取消</li></ul>
<h2>11. 菜单配置</h2>
<p>建议后端菜单配置：</p>
<pre><code>技术中心
改制订单发起
改制记录查询</code></pre>
<p>组件路径：</p>
<pre><code>TechnologyCenter/PartModificationOrder/index
TechnologyCenter/PartModificationRecord/index</code></pre>
<p>精工车间不新增发起入口，只扩展现有页面：</p>
<pre><code>SeikoWorkshop/ProductionTaskQuery/index
SeikoWorkshop/WorkshopAssignment/index</code></pre>
<h2>12. 实施顺序</h2>
<p>建议按以下顺序实施：</p>
<p>1. 后端新增改制订单主记录表。 2. 后端新增技术中心发起改制订单接口。 3. 后端在发起接口中加入领料判断规则。 4. 后端按规则生成或不生成领料单。 5. 后端生成标准精工生产任务，并标记 <code>任务类型 = 改制</code>。 6. 扩展生产任务查询接口，返回改制和领料字段。 7. 扩展车间派工查询接口，返回改制和领料字段。 8. 前端新增技术中心改制订单发起页面。 9. 前端新增改制记录查询页面。 10. 前端修改生产任务查询页面，增加任务类型和领料状态显示。 11. 前端修改车间派工页面，增加改制任务显示和派工前领料状态校验。 12. 联调从技术中心发起、领料判断、仓库出库、精工工艺、车间派工、加工完工、记录查询的完整流程。</p>
<h2>13. 风险点</h2>
<h3>13.1 领料判断风险</h3>
<p>改制订单是否生成领料单，必须以后端判断为准。</p>
<p>前端可以显示和提示，但不能只依赖前端判断，避免绕过仓库出库流程。</p>
<h3>13.2 派工前物料状态风险</h3>
<p>如果改制订单需要仓库出库，但尚未出库，直接派工会导致车间无物料加工。</p>
<p>建议车间派工接口或派工保存接口再次校验：</p>
<pre><code>需要领料且未出库，不允许派工。</code></pre>
<h3>13.3 原任务数据覆盖风险</h3>
<p>改制订单必须生成新的生产任务和新的工艺计划流水号。</p>
<p>不能直接覆盖原自制订单或原零件工艺，否则会影响原订单追溯、工时和质量记录。</p>
<h3>13.4 取消改制风险</h3>
<p>已生成领料单、已出库、已派工或已加工的改制订单取消规则需要严格控制。</p>
<p>建议：</p>
<ul><li>未出库、未派工：允许取消。</li><li>已出库：需要退料后取消。</li><li>已派工未加工：先取消派工再取消。</li><li>已加工：不允许取消，只能走异常处理。</li></ul>
<h3>13.5 统计口径风险</h3>
<p>改制订单进入精工生产任务后，会影响生产任务数量、工时统计、完工统计。</p>
<p>建议所有统计接口增加任务类型维度：</p>
<pre><code>正常
改制
报废补投</code></pre>
<h2>14. 总结</h2>
<p>本方案采用：</p>
<pre><code>技术中心发起改制订单，精工车间承接生产，仓库按需出库，改制记录统一查询。</code></pre>
<p>关键规则：</p>
<ul><li>技术中心新增组件发起改制订单。</li><li>改制订单生成后进入精工车间生产任务查询。</li><li>改制订单工艺和派工复用现有精工流程。</li><li>领料时如果是改制订单，并且使用物料不是毛坯，则生成领料单，由仓库物料出库。</li><li>如果是原现自制订单改制，或者直接使用毛坯改制，则不生成领料单。</li><li>改制记录查询独立展示全流程状态。</li></ul>
</body>
</html>

841
docs/零件改制/零件改制功能设计方案.md Normal file
View File

@@ -0,0 +1,841 @@
# 零件改制功能设计方案
## 0. 需求背景
### 0.1 需求提出
本需求由罗总牵头，组织技术中心、精工车间、仓储等相关部门讨论后提出。
### 0.2 提出原因
当前现场存在零件改制业务，但改制过程尚未完整纳入系统管理。由于现场计件、派工生产、完工入库和后续统计都需要明确的数据来源，原有线下记录或零散流转方式无法满足计件核算、过程追溯和部门协同要求。
因此，需要在系统内补充零件改制订单流程，将改制订单从技术中心发起、精工车间派工生产到完工入库的全过程纳入系统管理。
### 0.3 应用场景
本功能主要应用于以下场景：
- 技术中心根据现场或订单需求发起零件改制订单。
- 精工车间根据改制订单制定工艺、派工生产。
- 改制订单涉及非毛坯物料时，由系统生成领料单并交由仓库出库。
- 改制加工完成后，按现有流程办理入库。
- 现场计件、生产统计、入库记录和后续追溯均以系统内改制订单数据为依据。
## 1. 需求目标
基于项目现有精工车间生产流程，新增“零件改制”业务。
本次方案调整为：
- 在技术中心新增组件发起改制订单。
- 改制订单生成后进入现有精工车间生产任务流程。
- 精工车间生产任务查询组件可以查看改制订单。
- 车间派工组件可以查看改制订单并继续派工。
- 新增改制记录查询，用于查看改制订单的发起、生产、派工、领料和完工状态。
- 领料时根据改制订单和物料来源判断是否生成领料单。
核心原则：
- 技术中心负责发起改制订单。
- 精工车间复用现有生产任务、工艺、派工、加工流程。
- 仓储只在需要额外领用非毛坯物料时介入。
- 改制记录独立查询，但状态关联现有生产任务状态。
## 2. 现有流程承接关系
根据项目现有页面，改制订单应承接以下流程：
| 流程节点 | 现有承接页面 | 说明 |
| ---- | ---------- | --------------- |
| 技术发起 | 技术中心新增页面 | 发起改制订单，填写改制要求 |
| 生成任务 | 精工车间生产任务查询 | 改制订单进入生产任务列表 |
| 制定工艺 | 精工车间制定工艺 | 可复用或复制原工艺后调整 |
| 车间派工 | 精工车间车间派工 | 工艺完成后派工 |
| 领料判断 | 领料/仓储出库流程 | 根据物料类型决定是否生成领料单 |
| 加工执行 | 精工车间现有加工流程 | 扫码、报工、质检等复用现有逻辑 |
| 入库 | 仓储入库流程 | 改制完工后按现有流程办理入库 |
| 记录查询 | 改制记录查询 | 查看改制全流程 |
![零件改制业务流程图](零件改制流程图.svg)
## 3. 页面设计
### 3.1 技术中心新增页面：改制订单发起
建议路径：
```text
src/views/TechnologyCenter/PartModificationOrder/index.vue
```
页面名称：
```text
改制订单发起
```
归属模块：
```text
技术中心
```
主要功能：
- 查询需要改制的原订单、原零件或原自制件。
- 发起改制订单。
- 填写改制后零件信息、改制数量、改制原因、技术要求。
- 指定是否使用原件改制、毛坯改制或其他物料改制。
- 提交后生成改制订单，并进入精工车间生产任务查询。
### 3.2 精工车间修改页面：生产任务查询
现有路径：
```text
src/views/SeikoWorkshop/ProductionTaskQuery/index.vue
```
需要支持：
- 查询改制订单生成的生产任务。
- 增加任务类型筛选。
- 增加任务类型列。
- 改制任务显示 `改制` 标识。
- 改制任务继续使用现有 `工艺`、`派工` 按钮。
### 3.3 精工车间修改页面：车间派工
现有路径：
```text
src/views/SeikoWorkshop/WorkshopAssignment/index.vue
```
需要支持：
- 查询改制订单对应的待派工任务。
- 增加任务类型筛选。
- 增加任务类型列。
- 复用现有已派工查询、待派工工序查询、派工、取消派工逻辑。
### 3.4 新增页面：改制记录查询
建议路径：
```text
src/views/TechnologyCenter/PartModificationRecord/index.vue
```
也可以放在精工车间模块，建议最终按业务归属确认。
页面名称：
```text
改制记录查询
```
主要功能：
- 查询改制订单记录。
- 查看改制订单状态。
- 查看是否生成领料单。
- 查看仓库是否已出库。
- 查看精工生产任务、工艺、派工、完工状态。
- 支持跳转生产任务查询、车间派工、零件追溯。
## 4. 改制订单类型
改制订单需要明确物料来源，建议增加字段：
```text
改制来源类型
```
建议枚举：
| 改制来源类型 | 说明 | 是否生成领料单 |
| ------- | ----------------- | ------- |
| 原现自制订单 | 使用原现有自制订单零件进行改制 | 否 |
| 毛坯改制 | 直接使用已有毛坯进行改制 | 否 |
| 非毛坯物料改制 | 使用仓库其他物料、半成品或成品改制 | 是 |
说明：
- “原现自制订单”指当前已经存在的自制订单或自制零件，改制时不需要额外从仓库领料。
- “毛坯改制”指直接使用毛坯进行改制，不额外生成领料单。
- “非毛坯物料改制”指改制需要领用库存中的非毛坯物料，需要生成领料单并由仓库出库。
## 5. 领料规则
### 5.1 领料判断条件
领料时增加判断：
```text
如果是改制订单，并且使用的物料不是毛坯，则生成领料单，由仓库物料出库。
如果是原现自制订单改制，或者直接使用毛坯改制，则不生成领料单。
```
规则可表达为：
```text
是否生成领料单 =
是否改制订单 === 1
且 改制来源类型 === 非毛坯物料改制
且 是否毛坯 !== 1
```
### 5.2 生成领料单场景
以下场景需要生成领料单：
- 改制订单使用库存半成品。
- 改制订单使用库存成品。
- 改制订单使用其他非毛坯物料。
- 改制订单指定的物料需要仓库出库。
生成后流程：
1. 技术中心发起改制订单。
2. 系统判断需要领料。
3. 生成领料单。
4. 仓库根据领料单出库。
5. 出库完成后，精工车间继续生产、工艺、派工。
### 5.3 不生成领料单场景
以下场景不生成领料单：
- 原现自制订单改制。
- 直接使用毛坯改制。
- 改制对象已经在精工车间现场，不需要仓库出库。
不生成领料单时：
- 改制订单直接进入精工生产任务。
- 生产任务查询可查看。
- 车间派工可查看并派工。
### 5.4 领料状态字段
建议改制订单增加以下字段：
| 字段名 | 说明 |
| -------- | --------------- |
| 是否需要领料 | 1 是，0 否 |
| 是否已生成领料单 | 1 是，0 否 |
| 领料单号 | 生成的领料单编号 |
| 领料状态 | 未生成、待出库、已出库、已取消 |
| 出库日期 | 仓库出库日期 |
| 出库人 | 仓库操作人 |
## 6. 业务流程
### 6.1 技术中心发起改制订单
用户进入技术中心“改制订单发起”页面。
查询原始数据：
- 订单编号
- 产品/部件名称
- 零件名称
- 图号
- 原自制订单
- 库存物料
- 毛坯物料
发起改制时填写：
- 改制订单号
- 原订单编号
- 原零件名称
- 原零件图号
- 改制零件名称
- 改制零件图号
- 改制数量
- 改制来源类型
- 是否毛坯
- 物料编号
- 物料名称
- 改制原因
- 改制要求
- 技术备注
- 精工期限
提交时校验：
- 改制数量必须大于 0。
- 改制来源类型不能为空。
- 改制原因不能为空。
- 改制要求不能为空。
- 精工期限不能为空。
- 如果来源类型为非毛坯物料改制，必须选择物料编号。
### 6.2 后端生成改制订单
提交后，后端需要同时处理：
- 写入改制订单主记录。
- 根据改制来源类型判断是否生成领料单。
- 生成精工车间生产任务。
- 写入任务类型为 `改制`。
- 关联改制订单号和新工艺计划流水号。
### 6.3 进入精工车间生产任务查询
改制订单生成后，应能在现有接口中查到：
```text
精工车间_生成任务_查询数据
```
建议返回字段增加：
- 任务类型
- 是否改制
- 改制订单号
- 改制来源类型
- 是否需要领料
- 领料状态
- 改制原因
- 改制要求
生产任务查询页面显示：
- `任务类型 = 改制`
- 若 `是否需要领料 = 1` 且 `领料状态 !== 已出库`，可显示领料状态提示。
是否允许工艺/派工，需要按业务决定：
- 如果非毛坯物料改制必须先出库，建议未出库前允许制定工艺，但不允许派工。
- 如果现场允许先派工后补出库，则只做提示，不阻断派工。
建议采用更稳妥规则：
```text
需要领料且未出库：允许制定工艺，不允许派工。
不需要领料：正常工艺、派工。
需要领料且已出库：正常工艺、派工。
```
### 6.4 制定工艺
改制订单在生产任务查询中点击 `工艺`，进入现有：
```text
/SeikoWorkshop/DevelopProcess
```
工艺规则：
- 改制订单必须生成新的工艺计划流水号。
- 不覆盖原自制订单或原零件工艺。
- 可支持从原工艺复制后调整。
- 工艺保存后，任务状态进入 `工艺完成`。
### 6.5 车间派工
工艺完成后进入现有车间派工页面：
```text
src/views/SeikoWorkshop/WorkshopAssignment/index.vue
```
现有查询接口：
```text
精工车间_车间派工_查询
```
改制订单派工前判断：
- 不需要领料：允许派工。
- 需要领料且已出库：允许派工。
- 需要领料但未出库：禁止派工，并提示“改制订单物料未出库，不能派工”。
派工明细继续复用现有接口：
```text
车间生产管理工艺_零件工序_已派工查询
车间生产管理工艺_零件工序_派工_工序查询
车间生产管理工艺_零件工序_派工
车间生产管理工艺_零件工序_取消派工
```
### 6.6 仓库出库
当改制订单需要领料时，系统生成领料单。
仓库根据领料单完成出库后，需要回写：
- 领料状态 = 已出库
- 出库日期
- 出库人
- 出库数量
出库完成后，精工车间派工限制解除。
### 6.7 加工和完工
改制订单派工后，继续走现有精工车间加工流程：
- 工序派工
- 扫码加工
- 完工报工
- 质检
- 零件追溯
- 工时统计
完工后改制记录状态同步为：
```text
已完成
```
## 7. 数据字段设计
### 7.1 改制订单主记录字段
| 字段名 | 说明 |
| -------- | ------------------- |
| 改制订单号 | 改制业务编号 |
| 原订单编号 | 原订单编号 |
| 原订单流水号 | 原订单流水号 |
| 原组件流水号 | 原组件流水号 |
| 原基本件流水号 | 原零件流水号 |
| 原工艺计划流水号 | 原工艺计划流水号 |
| 原零件名称 | 改制前零件名称 |
| 原零件图号 | 改制前零件图号 |
| 原数量 | 原数量 |
| 改制零件名称 | 改制后零件名称 |
| 改制零件图号 | 改制后零件图号 |
| 改制数量 | 改制数量 |
| 改制来源类型 | 原现自制订单、毛坯改制、非毛坯物料改制 |
| 是否毛坯 | 1 是，0 否 |
| 物料编号 | 使用物料编号 |
| 物料名称 | 使用物料名称 |
| 物料流水号 | 使用物料流水号 |
| 是否需要领料 | 1 是，0 否 |
| 是否已生成领料单 | 1 是，0 否 |
| 领料单号 | 领料单编号 |
| 领料状态 | 未生成、待出库、已出库、已取消 |
| 改制原因 | 改制原因 |
| 改制要求 | 改制要求 |
| 技术备注 | 技术备注 |
| 精工期限 | 精工完工期限 |
| 新基本件流水号 | 改制任务生成的新零件流水号 |
| 新工艺计划流水号 | 改制任务生成的新工艺计划流水号 |
| 发起人 | 当前用户 ID |
| 发起日期 | 发起时间 |
| 状态 | 改制订单状态 |
| 是否启用 | 逻辑删除标识 |
### 7.2 改制订单状态
| 状态 | 说明 |
| ---- | ---------------- |
| 待领料 | 需要领料，领料单未出库 |
| 待工艺 | 不需要领料或已出库，等待制定工艺 |
| 工艺完成 | 工艺已保存，等待派工 |
| 待派工 | 工艺完成且满足派工条件 |
| 加工中 | 已派工或已开始加工 |
| 已完成 | 改制任务完工 |
| 已取消 | 改制订单取消 |
说明：
- 如果不需要领料，提交后可直接进入 `待工艺`。
- 如果需要领料，提交后进入 `待领料`。
- 仓库出库后从 `待领料` 转为 `待工艺` 或保持生产任务状态，由查询时关联显示。
## 8. API 设计
项目请求继续使用：
```js
this.CreateData(type, name, param, pageSize, pageCurrent)
this.ExecDatabase(Data)
```
### 8.1 技术中心查询可改制对象
```js
var Data = this.CreateData('11', '技术中心_改制订单_可改制对象_查询', param, this.pageSize, this.pageCurrent)
```
### 8.2 技术中心发起改制订单
```js
var Data = this.CreateData('12', '技术中心_改制订单_发起改制', param)
```
参数建议：
| 参数名 | 说明 |
| -------- | ------------------- |
| 原订单流水号 | 原订单流水号 |
| 原组件流水号 | 原组件流水号 |
| 原基本件流水号 | 原基本件流水号 |
| 原工艺计划流水号 | 原工艺计划流水号 |
| 原订单编号 | 原订单编号 |
| 原零件名称 | 原零件名称 |
| 原零件图号 | 原零件图号 |
| 改制零件名称 | 改制零件名称 |
| 改制零件图号 | 改制零件图号 |
| 改制数量 | 改制数量 |
| 改制来源类型 | 原现自制订单、毛坯改制、非毛坯物料改制 |
| 是否毛坯 | 是否毛坯 |
| 物料流水号 | 使用物料流水号 |
| 物料编号 | 物料编号 |
| 物料名称 | 物料名称 |
| 改制原因 | 改制原因 |
| 改制要求 | 改制要求 |
| 技术备注 | 技术备注 |
| 精工期限 | 精工期限 |
| 发起人 | 当前用户 ID |
后端处理结果：
- 生成改制订单。
- 判断是否生成领料单。
- 生成精工生产任务。
- 返回 `result`、`改制订单号`、`领料单号`、`是否需要领料`。
### 8.3 改制记录查询
```js
var Data = this.CreateData('11', '技术中心_改制订单_记录_查询', param, this.pageSize, this.pageCurrent)
```
### 8.4 改制订单详情
```js
var Data = this.CreateData('11', '技术中心_改制订单_详情_查询', param)
```
### 8.5 取消改制订单
```js
var Data = this.CreateData('12', '技术中心_改制订单_取消', param)
```
取消前后端需要校验：
- 未派工可以取消。
- 已派工未加工，需要先取消派工。
- 已加工、已有质检记录或已完成，不允许取消。
- 已生成领料单且已出库，不允许直接取消，需要走退料或异常处理。
## 9. 现有接口扩展
### 9.1 生产任务查询接口
现有接口：
```text
精工车间_生成任务_查询数据
```
新增查询参数：
| 参数名 | 说明 |
| ----------- | ------------- |
| 任务类型\_check | 是否按任务类型过滤 |
| 任务类型 | 全部、正常、改制、报废补投 |
| 领料状态\_check | 是否按领料状态过滤 |
| 领料状态 | 待出库、已出库、不需要领料 |
新增返回字段：
| 字段名 | 说明 |
| ------ | ------------------- |
| 任务类型 | 正常、改制、报废补投 |
| 是否改制 | 1 是，0 否 |
| 改制订单号 | 改制订单编号 |
| 改制来源类型 | 原现自制订单、毛坯改制、非毛坯物料改制 |
| 是否需要领料 | 1 是，0 否 |
| 领料状态 | 未生成、待出库、已出库、已取消 |
| 领料单号 | 领料单号 |
| 改制原因 | 改制原因 |
| 改制要求 | 改制要求 |
### 9.2 车间派工查询接口
现有接口：
```text
精工车间_车间派工_查询
```
新增查询参数：
| 参数名 | 说明 |
| ----------- | ------------- |
| 任务类型\_check | 是否按任务类型过滤 |
| 任务类型 | 全部、正常、改制、报废补投 |
新增返回字段：
| 字段名 | 说明 |
| ------ | ---------- |
| 任务类型 | 正常、改制、报废补投 |
| 是否改制 | 1 是，0 否 |
| 改制订单号 | 改制订单编号 |
| 改制来源类型 | 改制来源类型 |
| 是否需要领料 | 1 是，0 否 |
| 领料状态 | 领料状态 |
| 领料单号 | 领料单号 |
派工前端限制：
```text
如果 是否改制 = 1 且 是否需要领料 = 1 且 领料状态 != 已出库，则不允许派工。
```
## 10. 前端交互调整
### 10.1 技术中心改制订单发起页面
查询条件：
- 订单编号
- 零件名称
- 图号
- 物料编号
- 物料名称
- 改制来源类型
表格列：
- 订单编号
- 产品/部件名称
- 零件名称
- 零件图号
- 数量
- 当前状态
- 来源类型
- 物料编号
- 物料名称
- 操作
操作：
- 发起改制
- 图纸
- PLM传入工艺
- 追溯
发起改制弹窗：
- 原订单编号
- 原零件名称
- 原零件图号
- 改制零件名称
- 改制零件图号
- 改制数量
- 改制来源类型
- 是否毛坯
- 物料编号
- 物料名称
- 改制原因
- 改制要求
- 技术备注
- 精工期限
### 10.2 生产任务查询页面
新增筛选：
```text
任务类型：全部 / 正常 / 改制 / 报废补投
领料状态：全部 / 不需要领料 / 待出库 / 已出库
```
新增列：
- 任务类型
- 改制订单号
- 改制来源类型
- 领料状态
显示建议：
```html
<el-tag type="warning" size="mini">改制</el-tag>
<el-tag type="danger" size="mini">待出库</el-tag>
<el-tag type="success" size="mini">已出库</el-tag>
<el-tag type="info" size="mini">不需要领料</el-tag>
```
### 10.3 车间派工页面
新增筛选：
```text
任务类型：全部 / 正常 / 改制 / 报废补投
```
新增列：
- 任务类型
- 改制订单号
- 领料状态
派工按钮或派工操作前增加判断：
```js
if (Number(row.是否改制) === 1 && Number(row.是否需要领料) === 1 && row.领料状态 !== '已出库') {
this.$message.warning('改制订单物料未出库，不能派工')
return
}
```
### 10.4 改制记录查询页面
查询条件：
- 改制订单号
- 原订单编号
- 零件名称或图号
- 改制来源类型
- 领料状态
- 改制状态
- 发起日期
- 发起人
表格列：
- 改制订单号
- 状态
- 原订单编号
- 原零件名称
- 原零件图号
- 改制零件名称
- 改制零件图号
- 改制数量
- 改制来源类型
- 是否需要领料
- 领料单号
- 领料状态
- 改制原因
- 发起人
- 发起日期
- 精工期限
- 完成日期
- 操作
操作：
- 详情
- 生产任务
- 派工
- 追溯
- 取消
## 11. 菜单配置
建议后端菜单配置：
```text
技术中心
改制订单发起
改制记录查询
```
组件路径：
```text
TechnologyCenter/PartModificationOrder/index
TechnologyCenter/PartModificationRecord/index
```
精工车间不新增发起入口，只扩展现有页面：
```text
SeikoWorkshop/ProductionTaskQuery/index
SeikoWorkshop/WorkshopAssignment/index
```
## 12. 实施顺序
建议按以下顺序实施：
1. 后端新增改制订单主记录表。
2. 后端新增技术中心发起改制订单接口。
3. 后端在发起接口中加入领料判断规则。
4. 后端按规则生成或不生成领料单。
5. 后端生成标准精工生产任务，并标记 `任务类型 = 改制`。
6. 扩展生产任务查询接口，返回改制和领料字段。
7. 扩展车间派工查询接口，返回改制和领料字段。
8. 前端新增技术中心改制订单发起页面。
9. 前端新增改制记录查询页面。
10. 前端修改生产任务查询页面，增加任务类型和领料状态显示。
11. 前端修改车间派工页面，增加改制任务显示和派工前领料状态校验。
12. 联调从技术中心发起、领料判断、仓库出库、精工工艺、车间派工、加工完工、记录查询的完整流程。
## 13. 风险点
### 13.1 领料判断风险
改制订单是否生成领料单，必须以后端判断为准。
前端可以显示和提示，但不能只依赖前端判断，避免绕过仓库出库流程。
### 13.2 派工前物料状态风险
如果改制订单需要仓库出库，但尚未出库，直接派工会导致车间无物料加工。
建议车间派工接口或派工保存接口再次校验：
```text
需要领料且未出库，不允许派工。
```
### 13.3 原任务数据覆盖风险
改制订单必须生成新的生产任务和新的工艺计划流水号。
不能直接覆盖原自制订单或原零件工艺，否则会影响原订单追溯、工时和质量记录。
### 13.4 取消改制风险
已生成领料单、已出库、已派工或已加工的改制订单取消规则需要严格控制。
建议：
- 未出库、未派工：允许取消。
- 已出库：需要退料后取消。
- 已派工未加工：先取消派工再取消。
- 已加工：不允许取消，只能走异常处理。
### 13.5 统计口径风险
改制订单进入精工生产任务后，会影响生产任务数量、工时统计、完工统计。
建议所有统计接口增加任务类型维度：
```text
正常
改制
报废补投
```
## 14. 总结
本方案采用：
```text
技术中心发起改制订单，精工车间承接生产，仓库按需出库，改制记录统一查询。
```
关键规则：
- 技术中心新增组件发起改制订单。
- 改制订单生成后进入精工车间生产任务查询。
- 改制订单工艺和派工复用现有精工流程。
- 领料时如果是改制订单，并且使用物料不是毛坯，则生成领料单，由仓库物料出库。
- 如果是原现自制订单改制，或者直接使用毛坯改制，则不生成领料单。
- 改制记录查询独立展示全流程状态。

BIN
docs/零件改制/零件改制功能设计方案.pdf Normal file
View File

Binary file not shown.

85
docs/零件改制/零件改制流程图.svg Normal file
View File

@@ -0,0 +1,85 @@
<svg xmlns="http://www.w3.org/2000/svg" width="1180" height="1080" viewBox="0 0 1180 1080">
<defs>
<style>
.title { font: 700 30px "Microsoft YaHei", "SimSun", Arial, sans-serif; fill: #1f2933; }
.label { font: 600 18px "Microsoft YaHei", "SimSun", Arial, sans-serif; fill: #1f2933; }
.small { font: 15px "Microsoft YaHei", "SimSun", Arial, sans-serif; fill: #475569; }
.node { fill: #ffffff; stroke: #2f80ed; stroke-width: 2; rx: 10; }
.tech { fill: #eef6ff; stroke: #2f80ed; }
.seiko { fill: #f0fdf4; stroke: #16a34a; }
.warehouse { fill: #fff7ed; stroke: #f97316; }
.record { fill: #f8fafc; stroke: #64748b; }
.decision { fill: #fff7ed; stroke: #f59e0b; stroke-width: 2; }
.line { stroke: #64748b; stroke-width: 2; fill: none; marker-end: url(#arrow); }
.yesno { font: 600 14px "Microsoft YaHei", "SimSun", Arial, sans-serif; fill: #334155; }
</style>
<marker id="arrow" markerWidth="10" markerHeight="10" refX="9" refY="3" orient="auto" markerUnits="strokeWidth">
<path d="M0,0 L0,6 L9,3 z" fill="#64748b" />
</marker>
</defs>
<rect x="0" y="0" width="1180" height="1080" fill="#ffffff"/>
<text x="590" y="48" text-anchor="middle" class="title">零件改制业务流程图</text>
<rect x="70" y="90" width="1040" height="90" class="node tech"/>
<text x="590" y="126" text-anchor="middle" class="label">技术中心：改制订单发起</text>
<text x="590" y="154" text-anchor="middle" class="small">选择原订单/零件/物料，填写改制数量、来源类型、原因、要求、精工期限</text>
<path d="M590 180 L590 225" class="line"/>
<polygon points="590,225 755,305 590,385 425,305" class="decision"/>
<text x="590" y="292" text-anchor="middle" class="label">是否改制订单</text>
<text x="590" y="322" text-anchor="middle" class="small">且使用物料不是毛坯？</text>
<path d="M755 305 L900 305 L900 365" class="line"/>
<text x="820" y="292" class="yesno">是</text>
<rect x="760" y="365" width="280" height="88" class="node warehouse"/>
<text x="900" y="400" text-anchor="middle" class="label">生成领料单</text>
<text x="900" y="428" text-anchor="middle" class="small">仓库按领料单物料出库</text>
<path d="M900 453 L900 515 L670 515" class="line"/>
<text x="918" y="488" class="yesno">已出库</text>
<path d="M425 305 L280 305 L280 515 L510 515" class="line"/>
<text x="320" y="292" class="yesno">否</text>
<text x="118" y="384" class="small">原现自制订单改制</text>
<text x="118" y="410" class="small">或直接毛坯改制</text>
<text x="118" y="436" class="small">不生成领料单</text>
<rect x="510" y="475" width="160" height="80" class="node seiko"/>
<text x="590" y="508" text-anchor="middle" class="label">生成精工</text>
<text x="590" y="535" text-anchor="middle" class="small">生产任务</text>
<path d="M590 555 L590 602" class="line"/>
<rect x="390" y="602" width="400" height="80" class="node seiko"/>
<text x="590" y="636" text-anchor="middle" class="label">精工车间：生产任务查询</text>
<text x="590" y="662" text-anchor="middle" class="small">显示任务类型=改制、领料状态、改制订单号</text>
<path d="M590 682 L590 728" class="line"/>
<rect x="390" y="728" width="400" height="80" class="node seiko"/>
<text x="590" y="762" text-anchor="middle" class="label">制定工艺</text>
<text x="590" y="788" text-anchor="middle" class="small">生成新工艺计划，可复制原工艺后调整</text>
<path d="M590 808 L590 854" class="line"/>
<rect x="390" y="854" width="400" height="80" class="node seiko"/>
<text x="590" y="888" text-anchor="middle" class="label">车间派工与加工完工</text>
<text x="590" y="914" text-anchor="middle" class="small">需要领料且未出库时禁止派工，出库后正常派工</text>
<path d="M590 934 L590 980" class="line"/>
<rect x="390" y="980" width="400" height="70" class="node warehouse"/>
<text x="590" y="1010" text-anchor="middle" class="label">仓储入库</text>
<text x="590" y="1036" text-anchor="middle" class="small">改制完工后按现有流程办理入库并回写状态</text>
<path d="M790 1015 L970 1015 L970 215 L720 215" class="line"/>
<rect x="820" y="188" width="300" height="54" class="node record"/>
<text x="970" y="222" text-anchor="middle" class="label">改制记录查询贯穿全流程</text>
<path d="M390 1015 L210 1015 L210 215 L460 215" class="line"/>
<rect x="60" y="188" width="300" height="54" class="node record"/>
<text x="210" y="222" text-anchor="middle" class="label">状态回写与追溯关联</text>
</svg>
Side by Side

After

Width:  |  Height:  |  Size: 4.6 KiB