feat: 多工厂/厂间调拨/替代料/流水台账折叠 + 重写 README
- 多工厂(factory 表) + 顶栏工厂下拉过滤, 库存按厂聚合 - 厂间调拨(transfer): 源厂减+目标厂加, 总库存不变, 双向流水对账 - 替代料关系(substitute): 出库/BOM领料/生产领料缺料时提示可替代料 - 流水台账(ledger): 入出按日期合并折叠, 按日期导出同一 Excel - 生产订单增强: 编辑/删除(级联清关联流水)/调入数量/确认调入=厂间调拨 - 入库新增送货日期字段; 出库物料编码扫码定位 - 重写 README 补全全部模块; .gitignore 排除 dist_pkg/build_pkg/*.db - 停止跟踪 instance/app.db(运行时自动生成)
This commit is contained in:
+102
-14
@@ -2,7 +2,8 @@
|
||||
|
||||
> 适用对象：仓库管理员、车间计划员、系统管理员
|
||||
> 系统形态：Windows 单文件 EXE（双击即用，免安装数据库，中文界面）
|
||||
> 版本：M1 基础版 + M2 核算版 + M3 治理版
|
||||
> 版本：M1 基础版 + M2 核算版（含 M2-1 多工厂 / M2-2 厂间调拨）+ M3 治理版
|
||||
> 最近新增：多工厂与代工厂、出库 BOM 批量操作、生产订单删除/编辑/调入数量、厂间调拨
|
||||
|
||||
---
|
||||
|
||||
@@ -56,9 +57,12 @@
|
||||
| 库存看板 | ✅ | ✅ | ✅ |
|
||||
| 物料（列表 / 明细） | ✅ | ✅ | ✅ |
|
||||
| 入库 / 出库 | ✅ | ✅ | ✅ |
|
||||
| 出库里的 BOM 批量操作 | ✅ | ✅ | ❌ |
|
||||
| 物料新增 / 编辑 / 删除 | ✅ | ✅ | ❌ |
|
||||
| BOM 管理 | ✅ | ✅ | ❌ |
|
||||
| 生产订单 | ✅ | ✅ | ❌ |
|
||||
| 生产订单（新建 / 编辑 / 删除 / 调入） | ✅ | ✅ | ❌ |
|
||||
| 工厂（工厂管理 / 工厂工作台） | ✅ | ✅ | ✅（仅查看工作台，不能导入/建厂） |
|
||||
| 调拨（厂间调拨） | ✅ | ✅ | ❌ |
|
||||
| 报表 / 导出 Excel | ✅ | ✅ | ❌ |
|
||||
| 操作日志 | ✅ | ✅ | ❌ |
|
||||
| 用户管理 | ✅ | ❌ | ❌ |
|
||||
@@ -149,7 +153,21 @@
|
||||
|
||||
批量导入窗口同样可用（见 6.2），勾选「出库」时同样有库存校验。
|
||||
|
||||
---
|
||||
### 7.1 按 BOM 批量操作（admin / manager）
|
||||
|
||||
出库页底部有一个 **「🧩 按 BOM 批量操作」** 卡片（仅管理员、主管可见），提供两种模式：
|
||||
|
||||
**① 齐套领料出库**（从本厂库存发料）
|
||||
- 选 BOM + 填「生产套数」→ 点「预览需求」，系统按 `单套用量 × 套数` 列出每种料的「需求数量 / 本厂在库 / 缺料数」。
|
||||
- 缺料的行会标红；**缺口 > 0 的行不会出库**，只把够的部分发掉，避免库存变负。
|
||||
- 点「确认齐套领料」即生成一批出库流水（用途「生产领用」）。
|
||||
|
||||
**② 调拨入库（调入到工厂）**
|
||||
- 选「目标工厂」+ 选 BOM + 填套数 → 预览后点「确认调拨入库」。
|
||||
- 系统生成的是**入库流水**，直接计入目标工厂的该物料库存（来源「调拨入库」）。
|
||||
- 适合「总部有货、代工厂缺料」时，把料调拨进代工厂库存的场景。
|
||||
|
||||
> 两种模式共用同一张预览表，切换模式即可；预览实时显示缺料，确认前请先核对数量。
|
||||
|
||||
## 八、BOM 管理（admin / manager）
|
||||
|
||||
@@ -191,16 +209,75 @@ P0003 4
|
||||
|
||||
路径：导航栏 **生产订单**。
|
||||
|
||||
1. **新建订单**：选 BOM + 填接单量 → 生成订单号（如 `WO20260920xxx`）。
|
||||
2. **订单详情（用量展开）**：系统按 `需求量 = 接单量 × 单套用量` 算出每种料需要领多少，并和当前在库对比：
|
||||
- 够 → 正常；不够 → **缺料标红**，列出缺口数量。
|
||||
3. **一键领料**：点「领料」，系统按 BOM 用量自动生成一批出库流水（用途记为「生产领用」，关联订单号）。若仍有缺料会提示，但不会阻止操作——需人工确认。
|
||||
### 9.1 新建订单
|
||||
选 BOM + 选「生产工厂」+ 填接单量（+ 可选单号 / 备注）→ 生成订单号（如 `WO20260920xxx`）。订单会与所选工厂绑定，后续看库存、调入都按该工厂口径。
|
||||
|
||||
这一步等价于原来 Excel 里「接单量 × 单套用量」的手算，且自动扣减库存、留痕。
|
||||
### 9.2 编辑 / 删除订单
|
||||
- **编辑**：订单详情页点「编辑订单」→ 可改单号、BOM、生产工厂、接单量、备注。
|
||||
- **删除**：列表或详情页点「删除」→ 只删订单头与「调入计划行」，**保留**已发生的关联出入库流水（已发/已调入的料不会因删单而回滚），操作需谨慎。
|
||||
|
||||
### 9.3 订单详情（用量展开 + 调入数量）
|
||||
详情页按 `需求量 = 接单量 × 单套用量` 算出每种料需要领多少，并与**该生产工厂**当前在库对比：够 → 正常；不够 → **缺料标红**，列出缺口。特点是：
|
||||
|
||||
- **BOM 物料后新增「调入数量」列**（可手动录入）：你可以逐料填「计划从别的厂/渠道调入多少」。
|
||||
- **保存调入数量**：把计划暂存（不立即动库存）。
|
||||
- **确认调入**：把每行的「调入数量」一键生成**入库流水**直接计入该生产工厂库存（来源「生产订单调入」）。已入账的行显示徽标、不可重复入账，避免重复调入。
|
||||
- 物料编号可点击直达该物料明细页。
|
||||
- 底部「**调入总览**」汇总：已调入项数 / 已调入合计件数 / 计划调入合计。
|
||||
- **一键领料**：点「领料」，系统按 BOM 用量自动生成一批出库流水（用途「生产领用」，关联订单号）；仍有缺料会提示但不阻止，需人工确认。
|
||||
|
||||
这一步既保留了原来「接单量 × 单套用量」的自动展开与一键领料，又让你能手动登记「这单要从别处调多少料进来」。
|
||||
|
||||
---
|
||||
|
||||
## 十、报表与操作日志（admin / manager）
|
||||
## 十、多工厂与代工厂管理（M2-1，admin / manager）
|
||||
|
||||
如果你的业务涉及多个工厂 / 代工厂，可以用「单库多地点」模式把各厂的库存放在同一套系统里管理，既统一又互不串库。
|
||||
|
||||
### 10.1 工厂管理页
|
||||
路径：导航栏 **工厂**（仅管理员、主管可见）。
|
||||
- 列出全部工厂：编码、名称、类型（**自厂 / 代工厂**）、是否启用。
|
||||
- **新增工厂**：填编码（如 `SUB01`，唯一）、名称、类型、备注。
|
||||
- **停用 / 启用**：停用的工厂不再出现在切换器与下拉里（历史数据保留）。
|
||||
|
||||
### 10.2 顶栏工厂切换器
|
||||
页面右上角有一个 **「全部工厂 / 各工厂」** 下拉：
|
||||
- 选「全部工厂」→ 看板、物料、出入库均为**汇总口径**。
|
||||
- 选某个具体工厂 → 看板 / 物料列表 / 出入库明细 / 物料流水全部**按该厂过滤**。
|
||||
- 选择写入当前会话，刷新后保持。
|
||||
|
||||
### 10.3 工厂工作台
|
||||
在工厂管理页点某厂的「进入」，或访问 `/factory/<id>`，是一个三页签的工作台：
|
||||
- **物料看板**：仅该厂的在库与预警。
|
||||
- **BOM 齐套**：基于该厂库存判断各 BOM 是否齐套。
|
||||
- **批量导入**：可把期初物料 / 入库快速导入到该厂（仅管理员、主管可操作）。
|
||||
|
||||
> 设计原则：所有账号都能看到全部工厂数据（不做厂间权限隔离）；库存聚合按 `factory_id` 实时计算，不冗余存储。
|
||||
|
||||
---
|
||||
|
||||
## 十一、厂间调拨（M2-2，admin / manager）
|
||||
|
||||
当「甲厂有货、乙厂缺料」时，用调拨把料从一个厂划到另一个厂，系统自动做**双向记账**。
|
||||
|
||||
### 11.1 新建调拨
|
||||
路径：导航栏 **调拨** → **+ 新建调拨**。
|
||||
填写：源厂、目标厂、物料、数量、业务日期、经手人、备注。
|
||||
- **库存校验**：源厂在库不足时拦截，不让调拨变负。
|
||||
- 提交后自动生成两条流水：
|
||||
- 源厂：`Outbound`（出库，库存 −N）
|
||||
- 目标厂：`Inbound`（入库，库存 +N）
|
||||
- 同时写入 `transfer` 调拨主表，作为调拨凭证。
|
||||
|
||||
### 11.2 调拨列表
|
||||
路径：导航栏 **调拨**（列表页，所有角色可查看）。
|
||||
显示每笔调拨：调拨单号、源厂→目标厂、物料、数量、经手人、业务日期、备注。可用于对账。
|
||||
|
||||
> 调拨与「出库页的调拨入库」区别：本模块是**厂与厂之间的正式调拨**（双向记账、有调拨单号）；出库页的「调拨入库」是把 BOM 料直接调入某厂（单向入库）。两者都会让目标厂库存 +N，看板/物料按厂过滤后都会体现。
|
||||
|
||||
---
|
||||
|
||||
## 十二、报表与操作日志（admin / manager）
|
||||
|
||||
- **报表**：导航栏 **报表**，全量库存表，预警状态标红，可点 **⬇ 导出库存 Excel** 下载 `库存导出_日期.xlsx`。
|
||||
- **日志**：导航栏 **日志**，记录所有关键操作（新增/编辑/删除物料、入库、出库、导入、领料等），含操作人、动作、目标、明细，最多保留 200 条，用于审计追溯。
|
||||
@@ -217,7 +294,7 @@ P0003 4
|
||||
|
||||
---
|
||||
|
||||
## 十二、数据备份与维护（重要）
|
||||
## 十四、数据备份与维护（重要）
|
||||
|
||||
| 项目 | 说明 |
|
||||
|---|---|
|
||||
@@ -249,6 +326,15 @@ P0003 4
|
||||
**Q6：忘记 admin 密码？**
|
||||
关闭程序，用备份恢复，或联系部署人重置 `app.db`（暂无自助找回，需直接改库）。
|
||||
|
||||
**Q7：顶栏工厂切换器怎么用？**
|
||||
右上角下拉选「全部工厂」看汇总，选某厂只看该厂数据；切换只影响当前浏览器会话。新增/停用工厂在「工厂」页（管理员、主管）。
|
||||
|
||||
**Q8：厂间调拨和出库里的「调拨入库」有什么不同？**
|
||||
调拨模块是厂↔厂的正式调拨（源厂减、目标厂加，有调拨单号）；出库页的「调拨入库」是单向把 BOM 料直接加进某厂。两者都会让目标厂库存增加，按厂过滤后都会体现。
|
||||
|
||||
**Q9：生产订单里的「调入数量」是什么？**
|
||||
是逐料「计划从别处调多少进来」的手工登记。点「保存调入数量」暂存计划，点「确认调入」才真正生成入库流水进该生产工厂；已入账的行不可重复调入。
|
||||
|
||||
---
|
||||
|
||||
## 附：快速上手清单
|
||||
@@ -256,7 +342,9 @@ P0003 4
|
||||
1. 双击 `MaterialWMS.exe`，浏览器打开，用 `admin / admin123` 登录。
|
||||
2. 下载「物料导入模板」，把现有物料清单填好导入。
|
||||
3. 用「BOM 批量导入窗口」上传嘉立创 BOM（或粘贴文本），建好产品用料。
|
||||
4. 日常收发货：入库 / 出库 单笔或批量录入。
|
||||
5. 接单后：生产订单新建 → 看缺料 → 一键领料。
|
||||
6. 每天看一眼「库存看板」的红/黄预警，每周备份一次 `app.db`。
|
||||
7. 给同事建独立账号并分配角色（admin 专属）。
|
||||
4. 多工厂场景：进「工厂」页建好各工厂/代工厂，用顶栏切换器按厂查看。
|
||||
5. 日常收发货：入库 / 出库 单笔或批量录入；出库页可用「按 BOM 批量操作」（齐套领料 / 调拨入库）。
|
||||
6. 接单后：生产订单新建（选工厂）→ 看缺料 → 登记「调入数量」并确认调入 → 一键领料。
|
||||
7. 厂间调拨：调拨页建调拨单，系统自动源厂减、目标厂加。
|
||||
8. 每天看一眼「库存看板」的红/黄预警，每周备份一次 `app.db`。
|
||||
9. 给同事建独立账号并分配角色（admin 专属）。
|
||||
|
||||
Reference in New Issue
Block a user