坭芯库管理系统产品系统

1. 立项原因（旨在解决的产品问题）
铸造制芯环节中，泥芯在 线边暂存 与 泥芯库集中存放 之间流转频繁，若仍依赖纸质台账或分散表格，易出现 账实不符、库位不清、先进先出难执行、补录滞后 等问题，直接影响排产与发料效率。立项旨在用统一的 B/S + PDA 扫码 产品化方案，把 入库登记与待入库确认、FIFO 出库指引与待出库扫码确认、库位/料架/BOM/存储策略 等串成闭环，解决 现场作业与后台数据不同步、责任不可追溯、库存查询与调整成本高 等核心产品痛点，支撑泥芯库 可管、可查、可按策略上架与按 FIFO 下架。
2. 行业场景与业务背景
行业定位于 铸造/制芯及相近离散制造 的 泥芯（砂芯）仓储与线边物流：泥芯按 产品与泥芯 BOM 组织，绑定 料架、库位、制芯机与工单，线边通过扫描制芯机等完成 线边在架入库，泥芯库通过扫描料架、系统按 存储策略推荐库位 并经 待入库扫码 完成上架；出库侧按 FIFO 给出取料指引，经 待出库与扫码校验 完成下架，桌面端承担 主数据维护、流水补录与查询、库存与大屏监控。典型背景是 多品种、多库位、人机协同、现场移动作业多 的工厂仓库，需要在 权限可控 的前提下，让办公室与 PDA 共用同一套数据与流程，降低错发、漏记与呆滞风险。

一、具体功能模块（文字列举）
系统包含以下功能模块：用户登录与按角色授权（查询、编辑、系统管理员等，含管理员侧用户管理）；桌面端库存管理中的入库与出库（流水查询、有权限时的登记补录）；库存明细与 FIFO 相关查询（及界面允许时的库存调整）；PDA 端的入库作业（线边库入库、泥芯库入库）、待入库扫码确认；PDA 端的出库作业（FIFO 出库指引）、待出库列表与扫码确认出库；主数据与策略维护，包括库位、产品、泥芯 BOM、泥芯料架、制芯机、制芯工单、泥芯存储策略（用于入库库位推荐）；线边库状态查询与管理；以及可选的大屏展示（库区容量与待入、待出概要并自动刷新）。此外配套 B/S 访问、接口服务与健康检查等运行与部署相关能力。

二、主要功能描述
项目以泥芯在制芯线边与集中泥芯库之间的流转为主线，把办公室管理与现场扫码作业统一到同一套数据与流程中。桌面端侧重主数据维护、入出库流水与库存的可视化与补录；PDA 侧重现场扫描与分步确认，例如线边按制芯机等完成在架登记，泥芯库按料架与推荐库位生成任务并在到位后扫码完结入库，出库则按产品与泥芯 BOM 给出 FIFO 取料指引，经待出库与库位、料架扫码校验后完成下架，从而减少账实不符与错发漏记，提高作业可追溯性与仓库运转效率。

1. 主要负责的具体任务
围绕泥芯库与线边业务，承担服务端与接口设计与实现、MySQL 库表与增量脚本的维护与部署衔接、Web 管理端（登录、主框架、入库出库、主数据、库存与线边等单页路由）与 PDA 端多页面（线边入库、泥芯库入库、待入出库确认与扫码出库等）的实现与联调；完成权限与角色控制、入出库与库存扣减或状态流转的服务端逻辑；配合现场完成环境变量配置、子路径部署、进程守护与健康检查，以及可选大屏对接展示数据。

2. 技术栈、架构、实现亮点与难点
技术栈为 Node.js + Express 提供 REST API，MySQL 持久化业务与库存数据，前端采用 B/S 架构：桌面端以浏览器访问 单页应用（ES Module），PDA 以独立页面适配现场扫码与移动操作；身份认证采用 JWT，跨域等通过环境变量配置。
架构上前后端分离，浏览器经 HTTP 调用后端接口，同一用户体系贯通桌面与 PDA。
实现亮点：一是 桌面补录查询 + PDA 分步扫码（如待入库、待出库与双码校验）形成闭环；二是 泥芯 BOM、库位、料架与存储策略 支撑 库位推荐与 FIFO 出库指引，把规则沉淀在系统中。
难点：多角色权限与库存一致性（并发下待出库、扫码确认与桌面登记并行时的数据与状态约束）；现场网络与子路径反向代理下 前端基路径与 /api 拼接、令牌与安全策略的配置与验证；PDA 交互步骤多、异常分支多，需保证流程清晰与错误可恢复。