feat: 库存管理系统 MaterialWMS 初始版本

- Flask + SQLAlchemy 物料/入库/出库/BOM/生产订单全模块管理
- PyInstaller 打包为单文件 EXE (双击运行, 自动建库)
- 物料维度: 入库总数量 / 消耗总数量 / 逐次入库流水(含时间)
- BOM 详情展示组成物料的规格型号与单套用量
- 支持 Altium / 嘉立创 BOM 批量导入(文本与 Excel 双通道)
- 内置端到端验证脚本(tools/_exe_util.py 等, 清理进程树防残留)

README.md

@@ -0,0 +1,76 @@
+# 物料入库 / 出库系统 (M1 + M2 + M3 完整版)
+
+本地 Web 系统,对标桌面 `物料明细表.xlsx` 的台账 + BOM 核算能力。Flask + SQLite,免外部数据库,即开即用。
+库存由 SQL 实时聚合(在库 = 入库 − 出库),彻底规避原 Excel 的 `[1]物料入库!D_` 外部链接断链风险。
+
+## 运行方式
+
+**方式一 · 单文件 EXE(推荐车间用)**
+`dist/MaterialWMS.exe` 双击即开,自动弹出浏览器到 http://127.0.0.1:8080。
+库文件 `app.db` 自动生成在 exe 同目录,换机器直接拷贝 exe 即可。
+
+**方式二 · 源码(双击 bat)**
+双击 `启动.bat` 启动;或命令行 `python app.py`。
+
+**方式三 · 指定库位置**
+`set WMS_DB=D:/path/app.db` 后再启动,可把数据放到任意位置。
+
+## 默认账号
+- 管理员 `admin / admin123`(首次启动自动建;可在「用户」页加 operator / manager)
+
+## 角色权限
+| 角色 | 权限 |
+|---|---|
+| admin | 全部,含用户管理 |
+| manager | 物料/BOM/订单/报表/日志/Excel 导入导出 |
+| operator | 库存看板 / 物料查看 / 入库 / 出库 |
+
+## 功能清单
+| 模块 | 说明 |
+|---|---|
+| 库存看板 | 实时核算在库;低于安全库存标黄、库存为负标红,顶部统计负数/预警数 |
+| 物料 | 主数据 CRUD(编号/型号/单位/安全库存)+ 搜索 |
+| 入库 | 流水登记(批次/数量/经手人/来源),写入即更新库存 |
+| 出库 | 流水登记,**库存不足自动拦截** |
+| **批量导入窗口** | 入库/出库/物料/BOM 页「批量导入窗口」按钮弹出模态框:粘贴多行清单或上传 Excel/CSV,实时预览解析与校验,一键批量生成。各页格式见下 |
+| 入库/出库批量窗口 | 每行 `物料编号 数量 批次(可选) 日期(可选) 备注(可选)`,校验物料存在/数量>0/出库库存充足 |
+| 物料批量窗口 | 每行 `物料编号 型号/规格 单位 安全库存(可选) 期初库存(可选)`,校验重复编号;已存在编号显示「更新」,一键批量 upsert(含期初流水) |
+| BOM 批量窗口 | ① **上传真实 Altium / 嘉立创 BOM 模板**(`Item/Part Number/Manufacture Part Number/Quantity/Reference/Part/Package`):每个 worksheet 视为一个 BOM,sheet 名即 BOM 型号,Part Number 关联物料、Quantity 列即单套用量(若存在两个 Quantity 列,取首列,首列空时回退次列);也支持中文「组装」sheet(物料代码 + 数量)。② 粘贴文本:以 `#BOM <型号> <名称>` 分段、其下 `物料编号 单套用量`。物料不存在的项预览时标「新建」,**导入时自动新建物料**(并写入型号/规格),一键多 BOM 落库 |
+| **BOM(M2)** | BOM 型号 + 组成物料单套用量;支持 Excel 导入 |
+| **生产订单(M2)** | 选 BOM + 接单量 → 自动展开「需求 = 单套用量 × 接单量」,一键「确认领料」生成出库,缺料在看板预警 |
+| **Excel 双向(M2)** | 物料导入/导出、BOM 导入、库存报表导出、导入模板下载 |
+| **报表(M3)** | 库存报表页,支持打印(浏览器打印)与导出 Excel |
+| **操作日志(M3)** | 每次收发/BOM/订单/导入/用户操作全记录(谁/何时/做了什么) |
+| **用户管理(M3)** | admin 增删改角色、启停账号 |
+
+## 数据来源
+`init_db.py` 已从桌面 `物料明细表.xlsx` 的「物料入库」表导入 **439 条真实物料**,
+把 Excel 库存数量作为"期初入库"写入,看板开箱即有数。
+
+## 目录结构
+```
+material_wms/
+├─ app.py            # 路由 + 鉴权 + 库存核算 + 冻结路径处理
+├─ models.py         # SQLAlchemy 2.0 模型(user/material/inbound/outbound/bom/bom_item/prod_order/operation_log)
+├─ excel_io.py       # Excel 双向导入导出 + 模板生成
+├─ init_db.py        # 建表 + 管理员 + Excel 导入真实物料
+├─ build_exe.py      # PyInstaller 单文件打包脚本
+├─ requirements.txt
+├─ 启动.bat
+├─ templates/        # 登录/看板/物料/收发/BOM/订单/报表/日志/用户/导入 共 15 个页面
+├─ static/style.css
+├─ instance/app.db   # SQLite 库(源码模式自动生成)
+├─ dist/MaterialWMS.exe  # 打包产物(单文件)
+└─ tools/            # e2e_test.py(全量冒烟) / check_server.py
+```
+
+## 打包 EXE
+```bat
+python build_exe.py
+```
+产物在 `dist/MaterialWMS.exe`。冻结后模板/静态走 `sys._MEIPASS`,库文件落 exe 同目录。
+
+## 测试
+```bat
+python tools/e2e_test.py   # 覆盖 登录/收发核算/BOM/订单展开/领料/日志/报表/导入导出/入库·物料·BOM 批量导入窗口/角色拦截
+```