# 物料入库 / 出库系统 (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 批量导入窗口/角色拦截
```