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

2026-07-06 11:21:59 +08:00
parent be0ff91e24
commit 9c1f52078d
43 changed files with 8566 additions and 233 deletions
--- a/docs/JY1.0-阶段功能需求文档.md
+++ b/docs/JY1.0-阶段功能需求文档.md
@@ -15,20 +15,21 @@
 5. 优化现有看板数据展示，并新增仓库、采购等业务看板。
 6. 增加新订单语音播报能力，提升部门电视机、现场广播等场景下的消息触达效率。
 7. 完善质检 PDA 应急方案，在 PDA 设备故障时使用手机扫码保障生产不中断。
+8. 三楼仓库可视化界面，直观展示各库位状态及整体仓储情况

-## 03-需求一：默认库位设置功能调整
+## 需求一：优化仓储相关业务流程，减少物料维护页面职责过重的问题

-### 3.1 需求背景
+### 1 需求背景

-当前“设置默认库位”功能位于物料标准维护或物料标准相关页面中，导致物料基础维护页面承载了仓储业务配置职责。为降低页面复杂度，并使库位规则更贴近入库业务，需要将默认库位设置从物料标准维护中移出。
+由仓库主管提出.当前“设置默认库位”功能位于物料标准维护或物料标准相关页面中，导致物料基础维护页面承载了仓储业务配置职责。为降低页面复杂度，并使库位规则更贴近入库业务，需要将默认库位设置从物料标准维护中移出,该功能转到由仓库人员决定库位。

-### 3.2 功能目标
+### 2 功能目标

 1. 去除物料标准维护中的“设置默认库位”入口和相关操作。
 2. 将默认库位设置功能迁移到其他更合适的仓储组件，或新建“默认库位设置”组件。
 3. 物料入库选择库位时，根据该物料是否存在默认库存或库位库存显示不同的库位范围。

-### 3.3 业务规则
+### 3 业务规则

 1. 如果物料没有默认库存或没有可识别的默认库位库存，入库时显示全库位选择。
 2. 如果物料已有库存库位，入库时优先显示该物料已有库存的库位选择。
@@ -36,7 +37,7 @@
 4. 新组件需要支持按物料编码、物料名称、图号、规格型号等条件查询物料。
 5. 默认库位设置后，应能被物料入库、库存盘点、库存查询等仓储业务读取。

-### 3.4 前端范围
+### 4 前端范围

 1. 移除物料标准维护页面中的默认库位设置按钮、弹窗和相关方法。
 2. 新增或迁移默认库位设置组件，建议放入仓储管理模块。
@@ -45,13 +46,31 @@
   - 有库存时显示该物料已有库存库位。
 4. 保持 Vue 2 Options API 和 Element UI 原有开发风格。

-### 3.5 后端范围
+### 5 后端范围

 1. 梳理现有默认库位相关存储过程、表字段和调用页面。
 2. 根据新组件补充查询、保存、删除默认库位的接口。
 3. 入库库位查询过程需支持按物料返回全库位或已有库存库位。

-### 3.6 验收标准
+### 6 功能实现流程图
+
+```mermaid
+flowchart TD
+  A["开始：调整默认库位设置功能"] --> B["前端移除物料标准维护中的默认库位入口"]
+  B --> C["新建或迁移默认库位设置组件"]
+  C --> D["组件提供物料查询和默认库位维护"]
+  D --> E["调用后端默认库位查询/保存/删除过程"]
+  E --> F["数据库保存物料与默认库位关系"]
+  F --> G["物料入库页面选择物料"]
+  G --> H{"该物料是否已有库存库位"}
+  H -- "是" --> I["查询并显示该物料已有库存库位"]
+  H -- "否" --> J["查询并显示全库位或默认库位候选"]
+  I --> K["用户选择库位并提交入库"]
+  J --> K
+  K --> L["刷新入库、库存盘点、库存查询相关数据"]
+```
+
+### 7 验收标准

 1. 物料标准维护页面不再出现默认库位设置入口。
 2. 新默认库位设置组件可完成查询、设置、修改、删除。
@@ -59,19 +78,19 @@
 4. 物料已有库存库位时，入库页面只显示符合规则的库位。
 5. 默认库位变更后，相关仓储页面读取结果一致。

-## 04-需求二：现有查询功能增加物料编码查询
+## 需求二：提升物料查询效率，在现有查询功能中统一补充物料编码查询能力

-### 4.1 需求背景
+### 1 需求背景

-系统中已有多个物料查询入口，但部分页面只能按物料名称、图号、规格型号等条件查询，无法直接按物料编码定位，影响仓储、销售、技术、装配等场景的查询效率。
+由罗伟提出.系统中已有多个物料查询入口，但部分页面只能按物料名称、图号、规格型号等条件查询，无法直接按物料编码定位，影响仓储、销售、技术、装配等场景的查询效率,以及查询准确性。

-### 4.2 功能目标
+### 2 功能目标

 1. 在现有涉及物料查询的组件中新增“物料编码”查询条件。
 2. 物料编码查询需要与原有条件组合查询。
 3. 查询结果、导出结果、选择弹窗结果保持一致。

-### 4.3 覆盖范围
+### 3 覆盖范围

 优先覆盖以下类型页面：

@@ -83,7 +102,7 @@
 | 销售管理 | 订单管理、订单审核、订单查询      | 物料选择弹窗     |
 | 装配管理 | 接收装配任务、接收滑台装配任务     | 物料选择弹窗     |

-### 4.4 前端规则
+### 4 前端规则

 1. 搜索栏新增 `物料编码` 输入框。
 2. 输入框 placeholder 可使用“物料编码”或“物料编号”，但传参建议统一使用 `物料编码`。
@@ -91,7 +110,7 @@
 4. 导出功能应同步携带物料编码条件。
 5. 不新增第三方库，不改变现有 `CreateData`、`ExecDatabase`、`getTable` 调用模式。

-### 4.5 后端规则
+### 5 后端规则

 1. 相关查询存储过程增加可选参数：
   - `物料编码_check`
@@ -100,26 +119,44 @@
 3. 传入物料编码时，应支持模糊查询或按现场确认规则查询。
 4. 导出过程与页面查询过程保持条件一致。

-### 4.6 验收标准
+### 6 功能实现流程图
+
+```mermaid
+flowchart TD
+  A["开始：现有查询补充物料编码"] --> B["梳理涉及物料查询的页面和弹窗"]
+  B --> C["搜索栏或弹窗新增物料编码输入框"]
+  C --> D["查询方法拼接物料编码_check和物料编码参数"]
+  D --> E["调用原有CreateData/ExecDatabase/getTable流程"]
+  E --> F["后端查询过程接收物料编码可选参数"]
+  F --> G{"是否传入物料编码"}
+  G -- "是" --> H["按物料编码追加过滤条件"]
+  G -- "否" --> I["沿用原有查询条件"]
+  H --> J["返回查询结果"]
+  I --> J
+  J --> K["表格或物料选择弹窗刷新"]
+  K --> L["导出流程同步携带相同物料编码条件"]
+```
+
+### 7 验收标准

 1. 用户可通过物料编码直接查询目标物料。
 2. 物料编码可与物料名称、图号、规格型号等条件组合查询。
 3. 查询和导出数据一致。
 4. 所有改造页面无模板解析错误、无明显布局错位。

-## 05-需求三：车间派工组件移动端自适应
+## 需求三：改善移动端使用体验，支持车间派工在手机或移动终端上自适应展示和操作

-### 5.1 需求背景
+### 1 需求背景

-车间派工业务需要在移动设备上查看和操作，当前桌面端布局在手机或窄屏设备上可能存在表格过宽、按钮拥挤、筛选条件不易操作等问题。
+由车间主管提出.车间派工业务需要在移动设备上查看和操作，当前桌面端布局在手机或窄屏设备上可能存在表格过宽、按钮拥挤、筛选条件不易操作等问题。

-### 5.2 功能目标
+### 2 功能目标

 1. 开发车间派工组件的移动端自适应布局。
 2. 保持桌面端原有操作习惯不受影响。
 3. 移动端重点保证查询、查看、派工、确认等高频操作可用。

-### 5.3 前端要求
+### 3 前端要求

 1. 使用响应式样式适配手机、平板、窄屏电脑。
 2. 搜索条件在移动端可折叠或纵向排列。
@@ -128,27 +165,44 @@
 5. 弹窗在移动端宽度应适配屏幕，不应超出视口。
 6. 不引入 Vue 3、Composition API 或新的 UI 库。

-### 5.4 重点场景
+### 4 重点场景

 1. 手机查看待派工任务。
 2. 手机按订单、物料、工序、人员等条件筛选。
 3. 手机进入派工明细并提交。
 4. 手机查看派工状态、数量、人员、设备等关键字段。

-### 5.5 验收标准
+### 5 功能实现流程图
+
+```mermaid
+flowchart TD
+  A["开始：车间派工移动端适配"] --> B["梳理车间派工桌面端页面结构和核心操作"]
+  B --> C["识别搜索区、列表区、明细区、操作按钮"]
+  C --> D["增加响应式样式和移动端布局规则"]
+  D --> E{"当前屏幕宽度是否为移动端"}
+  E -- "是" --> F["搜索条件纵向排列或折叠展示"]
+  F --> G["表格转为横向滚动或核心字段卡片列表"]
+  G --> H["弹窗宽度和按钮点击区域适配手机"]
+  E -- "否" --> I["保留桌面端原有布局"]
+  H --> J["调用原有查询、派工、提交接口"]
+  I --> J
+  J --> K["按移动端和桌面端分别验证页面与业务操作"]
+```
+
+### 6 验收标准

 1. 375px、414px、768px、1366px 宽度下页面可正常展示。
 2. 移动端无关键按钮遮挡、重叠、不可点击问题。
 3. 桌面端布局保持稳定。
 4. 派工提交、查询、刷新等原有功能正常。

-## 06-需求四：库存盘点及物料系列、库位编辑优化
+## 需求四：完善库存盘点、物料系列、库位编辑、入库库位选择等库存基础能力

-### 6.1 需求背景
+### 1 需求背景

-库存盘点需要更细粒度筛选物料，并支持对盘点库位进行维护。当前盘点和入库库位选择逻辑需要与物料库存库位更紧密关联。
+由罗伟提出.库存盘点需要更细粒度筛选物料，并支持对盘点库位进行维护。当前盘点和入库库位选择逻辑需要与物料库存库位更紧密关联。

-### 6.2 功能目标
+### 2 功能目标

 1. 新增“系列”字段，用于物料筛选和盘点筛选。
 2. 在物料维护组件中支持编辑物料系列。
@@ -156,14 +210,14 @@
 4. 库存盘点组件添加编辑库位功能。
 5. 物料入库组件的库位选择只显示有该物料的库位。

-### 6.3 物料维护要求
+### 3 物料维护要求

 1. 物料维护列表展示“系列”字段。
 2. 新增、编辑物料时可维护“系列”。
 3. 系列字段建议使用中文字段名 `系列`。
 4. 系列可根据现场数据情况使用输入框或下拉框。

-### 6.4 库存盘点要求
+### 4 库存盘点要求

 1. 搜索栏增加“系列”筛选条件。
 2. 支持按系列查询物料盘点数据。
@@ -171,13 +225,13 @@
 4. 表格展示需要包含系列字段，便于盘点人员核对。
 5. 增加编辑库位功能，可调整物料对应盘点库位。

-### 6.5 物料入库要求
+### 5 物料入库要求

 1. 入库时选择库位只显示有该物料的库位。
 2. 如果该物料没有任何库存库位，需要结合需求一规则显示全库位或默认库位候选。
 3. 库位下拉数据需要避免显示与该物料无关且容易误选的库位。

-### 6.6 后端要求
+### 6 后端要求

 1. 物料基础表或相关视图增加 `系列` 字段。
 2. 物料维护查询、新增、编辑过程支持系列字段。
@@ -185,7 +239,27 @@
 4. 库位编辑过程需要记录修改人、修改时间。
 5. 入库库位查询过程按物料库存库位过滤。

-### 6.7 验收标准
+### 7 功能实现流程图
+
+```mermaid
+flowchart TD
+  A["开始：库存盘点和物料系列优化"] --> B["数据库物料基础数据增加系列字段"]
+  B --> C["物料维护组件新增系列展示和编辑"]
+  C --> D["保存物料系列到后端"]
+  D --> E["库存盘点组件搜索栏增加系列筛选"]
+  E --> F["调用盘点查询过程并传入系列参数"]
+  F --> G["盘点表格展示物料、库存、系列、库位等信息"]
+  G --> H["用户编辑盘点库位"]
+  H --> I["调用库位编辑过程并记录修改人和修改时间"]
+  I --> J["刷新库存盘点列表"]
+  J --> K["物料入库选择物料"]
+  K --> L["按物料查询已有库存库位"]
+  L --> M{"是否存在该物料库位"}
+  M -- "是" --> N["入库库位下拉只显示该物料库位"]
+  M -- "否" --> O["按默认库位规则显示候选库位"]
+```
+
+### 8 验收标准

 1. 物料维护可新增和编辑系列字段。
 2. 库存盘点可按系列筛选数据。
@@ -193,13 +267,13 @@
 4. 物料入库库位选择符合“只显示该物料相关库位”的规则。
 5. 相关查询、保存后刷新数据一致。

-## 07-需求五：看板优化
+## 需求五：优化现有看板数据展示，并新增仓库、采购等业务看板

-### 7.1 需求背景
+### 1 需求背景

-现场看板需要更清晰地展示仓库、采购、订单、库存等业务状态。现有看板需要数据口径优化，同时新增部分业务看板。
+由罗总提出,开会讨论得出.现场看板需要更清晰地展示仓库、采购、订单、库存等业务状态。现有看板需要数据口径优化，同时新增部分业务看板。

-### 7.2 功能目标
+### 2 功能目标

 1. 新增仓库看板组件。
 2. 新增或优化采购看板组件。
@@ -207,7 +281,7 @@
 4. 仓库看板展示入库单滚动信息。
 5. 采购看板展示仍在采购中的合同。

-### 7.3 仓库看板要求
+### 3 仓库看板要求

 1. 展示入库单滚动列表。
 2. 滚动内容建议包括入库单号、供应商、物料名称、物料编码、数量、入库日期、状态。
@@ -215,21 +289,40 @@
 4. 大屏展示时文字清晰，不出现字段重叠。
 5. 支持异常状态突出显示，例如待处理、待上架、未完成。

-### 7.4 采购看板要求
+### 4 采购看板要求

 1. 展示仍在采购中的合同。
 2. 合同状态口径需要明确，例如未完成、采购中、部分到货、逾期未到。
 3. 建议展示合同号、供应商、物料、数量、已到数量、未到数量、交期、状态。
 4. 对逾期或临近交期的数据进行醒目提示。

-### 7.5 现有看板优化要求
+### 5 现有看板优化要求

 1. 梳理现有看板数据来源和字段含义。
 2. 对不准确、不及时或口径不一致的数据进行调整。
 3. 保持大屏自适应显示效果。
 4. 对滚动、刷新、排序、状态颜色做统一规范。

-### 7.6 验收标准
+### 6 功能实现流程图
+
+```mermaid
+flowchart TD
+  A["开始：看板新增与优化"] --> B["梳理现有看板组件和数据接口"]
+  B --> C["确认仓库看板、采购看板、现有看板数据口径"]
+  C --> D["新增仓库看板组件"]
+  C --> E["新增或优化采购看板组件"]
+  C --> F["调整现有看板数据查询逻辑"]
+  D --> G["查询入库单数据并生成滚动列表"]
+  E --> H["查询采购中的合同和交期状态"]
+  F --> I["统一字段、排序、状态颜色、刷新频率"]
+  G --> J["大屏页面自动滚动展示"]
+  H --> J
+  I --> J
+  J --> K["按刷新频率重新拉取数据"]
+  K --> L["验证大屏分辨率、滚动、刷新和数据准确性"]
+```
+
+### 7 验收标准

 1. 仓库看板可滚动展示入库单数据。
 2. 采购看板可展示采购中的合同。
@@ -237,27 +330,27 @@
 4. 大屏展示无明显错位、遮挡、空白异常。
 5. 自动刷新不影响页面稳定性。

-## 08-需求六：语音播报
+## 需求六：增加新订单语音播报能力，提升部门电视机、现场广播等场景下的消息触达效率

-### 8.1 需求背景
+### 1 需求背景

-当系统产生新的订单或重要业务消息时，需要在部门电视机或全场广播中自动播报，类似商家外卖新订单语音提醒，减少人工盯屏和漏看消息。
+由罗总提出,开会讨论的出.当系统产生新的订单或重要业务消息时，需要在部门电视机或全场广播中自动播报，类似商家外卖新订单语音提醒，减少人工盯屏和漏看消息。

-### 8.2 功能目标
+### 2 功能目标

 1. 新订单产生时触发语音播报。
 2. 支持部门电视机播报或全场广播播报。
 3. 播报内容简洁明确，便于现场人员快速理解。
 4. 后续可扩展到采购到货、异常提醒、质检任务等事件。

-### 8.3 播报场景
+### 3 播报场景

 1. 新订单生成。
 2. 新订单分配到指定部门。
 3. 订单状态发生关键变化。
 4. 后续可扩展为库存预警、采购逾期、质检待处理等。

-### 8.4 播报内容建议
+### 4 播报内容建议

 新订单播报示例：

@@ -271,7 +364,7 @@
 技术中心有新的图纸确认任务，请及时处理。
 ```

-### 8.5 技术要求
+### 5 技术要求

 1. 前端可使用浏览器语音能力或播放预生成音频。
 2. 如果用于电视机浏览器，需要确认浏览器是否允许自动播放声音。
@@ -279,14 +372,33 @@
 4. 新消息检测可采用轮询、WebSocket 或已有消息接口。
 5. 需要增加播报开关、播报范围、播报频率、防重复播报规则。

-### 8.6 权限和配置
+### 6 权限和配置

 1. 管理员可配置是否启用语音播报。
 2. 可按部门配置播报内容和播报设备。
 3. 同一订单不应重复无限播报。
 4. 需要记录已播报状态或播报日志，便于追查。

-### 8.7 验收标准
+### 7 功能实现流程图
+
+```mermaid
+flowchart TD
+  A["开始：语音播报功能"] --> B["配置播报开关、部门范围、播报终端"]
+  B --> C["前端看板或播报终端启动消息监听"]
+  C --> D["通过轮询、WebSocket或消息接口检测新订单"]
+  D --> E{"是否存在未播报的新订单"}
+  E -- "否" --> C
+  E -- "是" --> F["生成播报文本"]
+  F --> G{"当前终端是否允许播放声音"}
+  G -- "是" --> H["调用浏览器语音或播放音频"]
+  G -- "否" --> I["提示用户激活播放权限或使用客户端方案"]
+  H --> J["回写已播报状态或记录播报日志"]
+  I --> J
+  J --> K["防止同一订单重复播报"]
+  K --> C
+```
+
+### 8 验收标准

 1. 新订单出现后，指定终端可听到语音播报。
 2. 同一订单不会被重复播报造成干扰。
@@ -294,19 +406,19 @@
 4. 部门播报和全场播报范围符合配置。
 5. 电视机或广播设备在生产环境中可稳定使用。

-## 09-需求七：质检 PDA 手机扫码应急功能
+## 需求七：完善质检 PDA 应急方案，在 PDA 设备故障时使用手机扫码保障生产不中断

-### 9.1 需求背景
+### 1 需求背景

-质检 PDA 已有扫码作业能力，但在 PDA 设备故障时，需要使用手机应急完成扫码和质检相关工作。当前功能已开发完成，但生产环境下由于扫码组件安全限制无法使用。
+由质检部门提出,梁宁超核实后上报需求.质检 PDA 已有扫码作业能力，但在 PDA 设备故障时，需要使用手机应急完成扫码和质检相关工作。当前功能已开发完成，但生产环境下由于扫码组件安全限制无法使用。

-### 9.2 功能目标
+### 2 功能目标

 1. 确保手机扫码功能在生产环境可正常使用。
 2. 在 PDA 故障时，手机可以临时替代 PDA 进行扫码质检作业。
 3. 解决扫码组件在生产环境下的安全限制问题。

-### 9.3 问题说明
+### 3 问题说明

 扫码组件通常依赖浏览器摄像头权限。生产环境可能存在以下限制：

@@ -316,7 +428,7 @@
 4. 扫码组件要求安全上下文，HTTP 环境不可用。
 5. 内嵌浏览器或企业微信、钉钉 WebView 权限策略不同。

-### 9.4 解决方向
+### 4 解决方向

 1. 将生产环境扫码页面部署到 HTTPS。
 2. 配置可信域名和证书，避免直接使用不安全 HTTP 地址调用摄像头。
@@ -324,7 +436,7 @@
 4. 针对手机浏览器、企业微信、钉钉等访问方式分别验证摄像头权限。
 5. 保留手工输入条码的兜底方案，避免扫码不可用时业务中断。

-### 9.5 功能要求
+### 5 功能要求

 1. 手机页面可打开摄像头并扫码。
 2. 扫码结果可回填到质检业务流程。
@@ -332,7 +444,27 @@
 4. 页面需要适配手机端显示。
 5. 扫码权限异常时给出明确提示，例如“请使用 HTTPS 地址访问”或“请允许摄像头权限”。

-### 9.6 验收标准
+### 6 功能实现流程图
+
+```mermaid
+flowchart TD
+  A["开始：质检PDA手机扫码应急"] --> B["用户使用手机打开质检扫码页面"]
+  B --> C{"访问环境是否为HTTPS或安全上下文"}
+  C -- "否" --> D["提示使用HTTPS地址或可信访问方式"]
+  C -- "是" --> E["请求摄像头权限"]
+  E --> F{"用户是否授权摄像头"}
+  F -- "否" --> G["提示开启摄像头权限并提供手动输入"]
+  F -- "是" --> H["启动扫码组件识别条码"]
+  H --> I{"是否扫码成功"}
+  I -- "否" --> G
+  I -- "是" --> J["扫码结果回填质检业务单据"]
+  G --> K["手动输入条码"]
+  J --> L["调用原有质检业务查询或提交接口"]
+  K --> L
+  L --> M["完成质检应急作业并保留PDA原有流程"]
+```
+
+### 7 验收标准

 1. 生产环境手机扫码可正常调用摄像头。
 2. 扫码后可完成质检业务操作。
@@ -340,19 +472,103 @@
 4. 摄像头权限失败时有明确提示和手动输入兜底。
 5. 不影响 PDA 原有扫码功能。

-## 10-优先级建议
+## 需求八：三楼仓库可视化界面，直观展示各库位状态及整体仓储情况

-| 优先级 | 需求              | 原因                 |
-| --- | --------------- | ------------------ |
-| P2  | 质检 PDA 手机扫码应急功能 | 已开发但生产不可用，影响故障应急能力 |
-| P0  | 库存盘点及入库库位选择优化   | 直接影响库存准确性和入库操作     |
-| P0  | 默认库位设置功能调整      | 影响仓储配置职责和入库库位逻辑    |
-| P0  | 物料编码查询          | 涉及页面多，但收益明确        |
-| P1  | 车间派工移动端适配       | 改善现场移动操作效率         |
-| P2  | 看板优化            | 影响现场展示和管理效率        |
-| P2  | 语音播报            | 需要确认硬件、浏览器和广播接入方案  |
+### 1 需求背景

-## 11-实施拆分建议
+由仓库管理提出.三楼仓库目前缺少直观的库位可视化展示能力，仓库人员无法快速了解各库位使用状态、物料分布和整体仓储情况。现有立库查询界面已具备 2D 网格矩阵可视化能力（巷道筛选、状态颜色标识、库位点击查看物料详情、统计面板），可参考该方案为三楼仓库开发类似的可视化界面。
+
+### 2 功能目标
+
+1. 新增三楼仓库可视化组件，直观展示三楼仓库各库位的实时状态。
+2. 展示三楼仓库整体统计信息，包括总库位数、已占用库位数、空闲库位数、使用率等。
+3. 支持按区域、库位类型、物料等条件筛选库位。
+4. 支持点击库位查看物料详情，包括物料编号、物料名称、图号、规格型号、库存数量等。
+5. 参考立库可视化界面的颜色标识方案，用不同颜色区分库位状态。
+
+### 3 界面参考
+
+参考现有立库可视化界面（`WarehouseVisualization` 组件）的设计模式：
+
+1. **统计面板**：顶部展示总库位数、已占用数、空闲数、使用率等关键指标，参考立库的 `el-row` + `el-col` 卡片布局。
+2. **颜色图例**：用不同颜色标识库位状态，参考立库的颜色方案：
+   - 绿色：有库存（对应立库"有物料有托盘"）
+   - 橙色/黄色：预占或待处理
+   - 灰色：空闲库位
+   - 红色：异常或禁用
+3. **库位矩阵**：以网格或表格形式展示库位分布，行列对应仓库物理位置。
+4. **库位详情弹窗**：点击库位后弹窗展示物料明细，参考立库的 `el-dialog` 详情弹窗。
+5. **筛选条件**：支持按区域、库位编号、物料编码等条件筛选。
+
+### 4 前端要求
+
+1. 新增三楼仓库可视化页面，建议放在仓储管理模块下，路径如 `src/views/WarehouseManagement/ThirdFloorWarehouse/`。
+2. 参考立库可视化组件的页面结构：统计卡片 + 图例 + 库位网格矩阵 + 详情弹窗。
+3. 使用 Vue 2 Options API + Element UI，保持与现有代码风格一致。
+4. 库位网格支持点击交互，点击后弹出物料详情。
+5. 支持区域切换或筛选，适配三楼仓库的物理布局（如多个区域或排）。
+6. 统计数据实时计算，支持手动刷新和自动刷新（刷新频率可配置）。
+7. 适配大屏展示，文字清晰、布局不拥挤。
+8. 不引入新的第三方库，不使用 Vue 3 或 Composition API。
+
+### 5 后端要求
+
+1. 新增三楼仓库库位数据查询接口，返回库位编号、库位状态、所在区域等信息。
+2. 新增三楼仓库库位物料详情查询接口，根据库位编号返回物料信息（物料编号、物料名称、图号、规格型号、库存数量、批次等）。
+3. 接口命名遵循现有规范（如 `仓储管理_三楼仓库库位_查询数据`）。
+4. 如果三楼仓库库位数据已有现成的查询过程，优先复用，必要时补充字段。
+5. 统计数据可由前端根据库位列表计算，也可由后端单独提供汇总接口。
+
+### 6 功能实现流程图
+
+```mermaid
+flowchart TD
+  A["开始：三楼仓库可视化界面"] --> B["梳理三楼仓库库位数据和物理布局"]
+  B --> C["后端新增或复用库位查询和物料详情接口"]
+  C --> D["前端新增三楼仓库可视化页面组件"]
+  D --> E["页面加载时调用库位查询接口获取全部库位数据"]
+  E --> F["根据库位数据生成网格矩阵并按状态着色"]
+  F --> G["顶部展示统计面板：总库位、已占用、空闲、使用率"]
+  G --> H["用户点击某个库位"]
+  H --> I{"库位是否有物料"}
+  I -- "是" --> J["弹出物料详情弹窗：物料编号、名称、图号、型号、数量等"]
+  I -- "否" --> K["弹出库位信息弹窗：库位编号、状态、区域"]
+  J --> L["用户关闭弹窗或继续操作"]
+  K --> L
+  L --> M{"是否切换区域或筛选条件"}
+  M -- "是" --> N["按筛选条件重新查询库位数据"]
+  N --> F
+  M -- "否" --> O{"是否手动刷新或自动刷新触发"}
+  O -- "是" --> E
+  O -- "否" --> L
+```
+
+### 7 验收标准
+
+1. 三楼仓库可视化页面可正常加载并展示所有库位。
+2. 不同状态的库位用不同颜色区分，图例说明清晰。
+3. 统计面板数据与实际库位状态一致。
+4. 点击有物料的库位可查看物料详情。
+5. 点击空闲库位可查看库位基本信息。
+6. 区域筛选和条件筛选功能正常。
+7. 刷新数据后页面状态更新正确。
+8. 大屏展示布局合理，文字清晰可读。
+9. 不影响现有立库可视化功能。
+
+## 03-优先级建议
+
+| 优先级 | 需求              | 原因                                        |
+| --- | --------------- | ----------------------------------------- |
+| P2  | 质检 PDA 手机扫码应急功能 | 已开发但生产不可用，影响故障应急能力,即使PDA设备故障也可手动输入不影响现场生产 |
+| P0  | 库存盘点及入库库位选择优化   | 直接影响库存准确性和入库操作,现场急要                       |
+| P0  | 默认库位设置功能调整      | 影响仓储配置职责和入库库位逻辑,现场急要                      |
+| P0  | 物料编码查询          | 涉及页面多，但收益明确,现场急要                          |
+| P1  | 三楼仓库可视化界面       | 参考立库已有方案，可快速实现,提升仓库管理直观性                  |
+| P1  | 车间派工移动端适配       | 改善现场移动操作效率,现场提出,未经过确认需要                   |
+| P2  | 看板优化            | 影响现场展示和管理效率,需求还不明确                        |
+| P2  | 语音播报            | 需要确认硬件、浏览器和广播接入方案,需求还不明确                  |
+
+## 04-实施拆分建议

 ### 第一阶段：库存与查询基础能力

@@ -360,6 +576,7 @@
 2. 物料编码查询补充。
 3. 物料系列字段和库存盘点筛选。
 4. 物料入库库位过滤。
+5. 三楼仓库可视化界面（参考立库可视化组件）。

 ### 第二阶段：移动端与应急能力

@@ -373,7 +590,7 @@
 3. 现有看板数据口径调整。
 4. 新订单语音播报试点。

-## 12-待确认事项
+## 05-待确认事项

 1. 默认库位设置新组件归属菜单：仓储管理、基础数据，或单独配置模块。
 2. “没有默认库存”与“没有库存库位”的业务定义是否一致。
@@ -384,8 +601,11 @@
 7. 语音播报使用电视机网页播放，还是接入全场广播硬件。
 8. 手机扫码生产环境访问方式：HTTPS 域名、内网 IP、企业微信、钉钉或普通浏览器。
 9. 语音播报和扫码功能是否需要新增系统配置表。
+10. 三楼仓库的物理布局和库位编码规则（区域划分、行列定义）。
+11. 三楼仓库库位状态分类是否与立库一致，还是需要单独定义（如是否有"预占"、"异常"等状态）。
+12. 三楼仓库可视化是否需要自动刷新，刷新频率多少。

-## 13-风险说明
+## 06-风险说明

 1. 默认库位、库存库位、入库库位逻辑如果口径不统一，可能导致入库误选库位。
 2. 物料编码查询涉及页面多，需要避免漏改导出和弹窗查询。
@@ -393,9 +613,18 @@
 4. 看板数据口径需与业务部门确认，否则容易出现“页面正确但业务理解不一致”的问题。
 5. 浏览器语音自动播放和摄像头扫码都受 HTTPS、安全策略、设备权限影响，必须在生产环境实测。
 6. 全场广播接入可能涉及硬件、网络、音频设备，不应只按前端功能估算工作量。
+7. 三楼仓库库位数据如果与立库数据结构差异较大，可能需要单独设计接口和前端组件，复用程度需评估。

-## 14-文档备注
+## 07-文档备注

 本次变更为新增需求文档，未修改业务代码。

 修改人:Ld 修改时间:2026-06-29 10:29:16
+
+补充内容：为 7 项需求分别增加功能实现流程图。
+
+修改人:Ld 修改时间:2026-06-29 14:24:36
+
+补充内容：新增需求八"三楼仓库可视化界面"，参考立库查询界面设计，优先级 P1，纳入第一阶段实施。同步更新优先级建议、实施拆分、待确认事项和风险说明。
+
+修改人:Ld 修改时间:2026-06-30