刀具库存管理工具 — 操作培训手册
版本： v3.2（2026-07-10） 适用对象： 管理员、仓管、采购、财务
1. 系统概述
本系统用于管理刀具等物料的入库 → 领用 → 归还 → 损耗全流程，支持扫码枪/手机摄像头快速操作。
核心流程总览：
flowchart LR
A[入库/快速入库] --> B[库存]
B --> C[出库领用]
C --> D[在借]
D --> E[归还]
E --> F{归还类型}
F -->|以旧换新| G{旧件处置}
G -->|需修复| H[待修复清单]
G -->|报废| I[损耗处理]
F -->|领用错误| J[库存加回]
F -->|刀具异常| K[待退供应商清单]
H --> L[修复入库]
L --> B
访问地址： 管理员提供的网址（建议用 Chrome 浏览器，手机电脑均可）
核心特性：
- 库存表格可自适应列宽，表头右侧竖线可手动拖拽调整
- 每条数据都可点击修改（名称、库位、安全库存、单价）
- 入库时输入名称可自动匹配已有物料
- 出库领用人支持花名册自动补全，新同事可一键加入
2. 登录流程
flowchart TD
A[打开系统] --> B{有保存的登录信息?}
B -->|是| C[自动校验会话]
C -->|有效| D[直接进入系统]
C -->|无效| E[显示登录页]
B -->|否| E
E --> F[输入用户名和密码]
F --> G{验证通过?}
G -->|否| H[显示错误信息]
H --> F
G -->|是| I{使用默认密码?}
I -->|是| J[弹出修改密码提醒]
J --> K[立即修改]
J --> L[跳过]
K --> D
L --> D
I -->|否| D
初始账号
| 账号 | 姓名 | 角色 | 初始密码 |
|---|---|---|---|
| 管理员 | 管理员 | ||
| 老张 | 仓管 | ||
| 老李 | 仓管 | ||
| 老刘 | 采购 | ||
| 小陈 | 财务 |
初次登录后建议立即修改密码
修改密码
flowchart LR
A[顶部导航栏] --> B[点击密码]
B --> C[输入旧密码]
C --> D[输入新密码>=4位]
D --> E[输入确认密码]
E --> F[提交]
F --> G{检查通过?}
G -->|是| H[密码修改成功]
G -->|否| I[提示错误]
I --> C
退出登录
顶部导航栏 → 点击 退出
3. 角色权限一览
以下权限基于系统 role_permissions 表的实际配置（2026-07-10），与 App 底部标签页及功能入口一一对应。
| 功能 | 仓管 | 采购 | 财务 | 管理员 |
|---|---|---|---|---|
| 查看库存 | ✅ | ✅ | ✅ | ✅ |
| 入库（含扫码） | ✅ | — | — | ✅ |
| 出库领用 | ✅ | — | — | ✅ |
| 在借查询 | ✅ | ✅ | — | ✅ |
| 交易记录 | ✅ | ✅ | ✅ | ✅ |
| 损耗统计 | ✅ | ✅ | ✅ | ✅ |
| 导出数据 | ✅ | ✅ | ✅ | ✅ |
| 盘存（月度盘存） | — | — | ✅ | ✅ |
| 用户管理 | — | — | — | ✅ |
| 物料变更 | ✅ | — | — | ✅ |
| 批量导入 | — | — | — | ✅ |
4. 入库操作
4.1 单件入库
flowchart TD
A[点击入库标签] --> B{已有物料?}
B -->|是| C[输入或扫码 SKU]
C --> D[自动带出名称单价库位供应商]
D --> E[填写数量]
B -->|否| F[输入名称]
F --> G{名称匹配?}
G -->|完全匹配| H[自动填充全部字段+供应商]
G -->|部分匹配| I[显示下拉列表选择]
G -->|无匹配| J[手动填写名称和单价]
H --> E
I --> E
J --> E
J --> E
E --> K[点击确认入库]
K --> L[库存增加]
快速入库： 在"库存"页面，找到物料 → 点击右侧闪电按钮 → 填数量 → 确认，无需切换标签页。快速入库弹窗同样支持供应商选择。
供应商管理：
- 入库时单价输入框右侧新增「供应商」下拉框，格式为
代码(中文名)如HG(哈工)、LX(零星) - 下拉框右侧有「+」按钮，可快速新增或管理供应商代码
- 输入 SKU 后系统自动从编码后缀识别供应商并填入（如
ZT-D10-HG→ 自动选「哈工」） - 无法识别的 SKU 保持为空，用户手动选择
命名规范：
- 输入名称时，输入框下方显示格式提示：「命名格式：品类名-关键参数，如「直钻-D10-含钴」「刀片-TNMG160404-HQ」」
- 点击名称标签右侧的「? 规范」按钮，可查看完整命名规范弹窗；完整规则与 19 品类格式表见 §4.4 命名规范详解
4.2 修复入库（旧刀修复后重新上架）
flowchart TD
A[刀具修复完成] --> B[切换到入库标签]
B --> C[输入 SKU]
C --> D[填写数量]
D --> E[勾选「修复入库」]
E --> F[系统自动禁用单价输入]
F --> G[点击确认入库]
G --> H[库存+N, 单价不变, 不计费]
4.3 批量导入
flowchart TD
A[准备 Excel 文件] --> B[入库 Tab 批量导入]
B --> C[点击选择 Excel 文件]
C --> D[系统自动识别 SKU 和名称列]
D --> E[预览前 10 条数据]
E --> F[点击确认导入]
F --> G[已存在的 SKU 自动跳过]
G --> H[导入完成显示结果]
支持的列名：SKU/sku/物料代码/编码 + 名称/品名/物料名称。可选列：单价、库位、供应商（supplier/供应商/厂商）
💡 若 Excel 未提供供应商列，系统自动从 SKU 后缀检测供应商代码并填入预览。
批量导入只新增不存在的 SKU，已存在的记录不会被覆盖，也不会改动其库存数量和单价。
4.4 命名规范详解
物料名称统一采用 「品类名-关键参数」 结构，便于搜索、匹配与复用。
核心原则：
- 🔹 直径符号
φ/∅/Ф一律去掉，改用D表示直径 - 🔹 分隔符统一用
-和x，不用*和空格 - 🔹 旧名称
ф10直钻含钴→ 新名称直钻-D10-含钴
19 个品类命名格式表：
| 品类 | 命名格式 | 示例 |
|---|---|---|
| 直钻 | 直钻-D{直径}[-附加] | 直钻-D10-含钴、直钻-D5.8x200L |
| 铣刀 | 铣刀-D{直径}[R{圆角}][L{长度}][刃数T] | 立铣刀-D12-R0.5-L100、球刀-D10-R2 |
| 中心钻 | 中心钻-{型号}{直径}[-附加] | 中心钻-A3.15-涂层、中心钻-B6.3 |
| 刀杆 | 刀杆-{型号} | 刀杆-MGEHR2020-1.5 |
| 刀片 | 刀片-{型号}[-附加] | 刀片-TNMG160404-HQ |
| 刀柄 | 刀柄-{型号} | 刀柄-BT40-ER32-120 |
| 枪钻 | 枪钻-D{直径}x{长度} | 枪钻-D10.1x650 |
| U钻 | U钻-{型号}[-特征] | U钻-WC21-2D-C25 |
| 砂轮 | 砂轮-{品牌}/{规格}x{厚度}颜色 | 砂轮-PA70/400x40x203红 |
| 丝攻 | {类型}丝攻-M{规格} | 螺旋槽丝攻-M10x1.25-H2 |
| 铰刀 | 铰刀-D{直径}[-特征] | 铰刀-D6H7-涂层 |
| 三面刃 | 三面刃铣刀-{规格} | 三面刃铣刀-80x10 |
| 锪钻 | 锪钻-{直径}x{角度} | 锪钻-16x120° |
| 车刀 | 车刀-{型号}[特征] | 车刀-合金YT15/90°18x20 |
| 拉刀 | 拉刀-{型号} | 拉刀-34J50 |
| 镗刀 | 镗刀-{型号} | 镗刀体-BT40-NBJ16 |
| 滚丝轮 | 滚丝轮-M{规格} | 滚丝轮-M10x1x50x54 |
| 百钢刀 | 百钢刀-{规格} | 百钢刀-4x16x200 |
| 顶杆 | 顶杆-D{直径} | 顶杆-D22 |
💡 入库时使用「SKU 编码助手」（见 §10.4）可自动拼装 SKU 编码，其品类代码与上方品类一一对应；编码格式为[品类代码]-[特征参数]-[供应商代码]（如ZT-D10-HG）。
5. 出库操作
flowchart TD
A[点击出库标签] --> B[查找物料]
B --> C{三选一}
C -->|扫码| D[点击扫码按钮]
C -->|输 SKU| E[手动输入编码]
C -->|搜名称| F[输入名称关键词下拉选择]
D --> G[自动显示名称和库存]
E --> G
F --> G
G --> H{物料替换拦截?}
H -->|有拦截| I[❌ 提示旧库存未消耗完]
I --> B
H -->|无拦截| J[填写领用人+数量]
J --> K[点击确认领用]
K --> L[库存扣减, 生成领用记录]
注意： 同一人不能重复领用同一把未归还的刀具，但不同人可以同时领用同一个 SKU
选中物料后显示库位：
- 搜索或扫码选中物料后，下方信息区域同步显示该物料的 SKU、名称、当前库存和库位信息，方便确认存放位置
- 下拉搜索列表已优化点击响应，确保每次点击都能选中
领用人自动补全（花名册）
出库「领用人」输入框支持智能补全：
- 输入任意字（如"张"），系统会从领用人花名册（制造部人员名单 + 历史领用人）中实时联想，列出匹配人员，每条显示「姓名（部门）」，点击即可填入
- 匹配为包含匹配（不限于姓），输入越精确列表越短
- 若输入的名字不在花名册中，下拉底部会出现「＋ 添加」按钮：选择所属车间（精益车间 / 精工车间）后点击添加，该人即加入花名册，下次可直接选用
- 添加新领用人需要联网（写入数据库），仅影响花名册，不影响库存
6. 归还操作
flowchart TD
A[点击在借标签页] --> B[找到对应员工]
B --> C[点击该行归还按钮]
C --> D{选择归还类型}
D -->|以旧换新| E[选择旧件处置]
E --> F{处置方式}
F -->|需修复| G[标记待修复清单]
F -->|直接报废| H[损耗处理]
D -->|领用错误| I[归还数加回库存]
D -->|刀具异常| J[标记待退供应商]
D -->|其他| K[库存不变]
G --> L{归还数量=在借?}
H --> L
I --> L
J --> L
K --> L
L -->|是| M[全部归还, 无损耗]
L -->|否| N[差额变损耗, 填原因]
M --> O[确认归还]
N --> O
O --> P[更新领用/归还/损耗记录]
归还类型说明
| 类型 | 什么时候用 | 库存变化 |
|---|---|---|
| 以旧换新（默认） | 正常换刀 | 库存不变（出库已扣），差额记损耗 |
| 领用错误 | 员工领错了 | 归还数加回库存，差额记损耗 |
| 刀具异常 | 刀具有质量问题 | 库存不变，标记待退供应商 |
7. 库存管理
7.1 查看库存
flowchart TD
A[点击库存标签页] --> B[查看实时库存表格]
B --> C[搜索SKU/名称/库位/供应商]
C --> D[实时过滤结果]
B --> E[默认展示全部物料]
E --> F[可点击单价表头排序]
F --> G[升序/降序/还原]
E --> H[可导出库存清单]
说明：
- 库存表格默认展示全部物料，无需点击"显示全部"
- 顶部搜索框支持按 SKU、名称、库位、供应商即时模糊过滤（输入即筛选，无需按钮）
- 价格排序： 点击「单价」列表头，可在「从低到高 → 从高到低 → 恢复默认（按最近操作时间）」之间循环切换，表头箭头会显示当前排序状态
- 供应商列： 表格新增「供应商」列，显示供应商代码（如 HG），鼠标悬停时显示完整中文名称（如「哈工」），方便快速识别物料供应商来源
7.2 修改库存信息
库存表格中，以下信息可直接点击修改：
| 列 | 点击效果 |
|---|---|
| 名称 | 弹出修改框，输入新名称 |
| 单价 | 弹出修改框，输入新单价（仅 admin/warehouse/purchase 可改） |
| 安全库存 | 弹出输入框，设置新的库存预警值 |
| 库位 | 弹出输入框，设置/修改存放位置 |
| 供应商 | 弹出下拉选择框，重新选择供应商（仅 admin/warehouse/purchase 可改） |
单价、安全库存、库位仅 admin / warehouse / purchase 角色可修改，其他角色点击无响应并提示无权限。
7.3 在借记录
flowchart TD
A[点击在借标签页] --> B[按领用人分组展示]
B --> C[搜索SKU/名称/领用人]
C --> D[实时过滤结果]
B --> E{超时预警}
E -->|超过7天| F[数字变红色]
E -->|正常| G[正常显示]
F --> H[可折叠/展开每组]
G --> H
8. 导出与报表
8.1 各 Tab 内联导出
| Tab | 按钮 | 导出内容 |
|---|---|---|
| 库存 | 导出 | 全部物料清单（含供应商列） |
| 在借 | 导出 | 当前所有未归还记录 |
| 记录 | 导出 | 全部交易记录 |
| 损耗 | 导出 | 当月损耗明细 |
| 盘存 | 导出Excel | 当月盘存明细（含数量+金额） |
8.2 独立导出 Tab
flowchart TD
A[点击导出标签页] --> B{选择导出方式}
B -->|导出全部| C[一个Excel包含7个Sheet]
B -->|库存清单| D[仅物料清单]
B -->|交易记录| E[仅出入库流水]
B -->|在借记录| F[仅未归还记录]
B -->|损耗记录| G[仅损耗明细]
C --> H[自动下载xlsx]
D --> H
E --> H
F --> H
G --> H
8.3 损耗统计
flowchart TD
A[点击损耗标签页] --> B[查看本月统计卡片]
B --> C{切换视图}
C -->|损耗统计| D[正常损耗明细+金额]
C -->|待退供应商| E[刀具异常记录]
C -->|待修复| F[需修复刀具记录]
D --> G[按月/人员筛选]
E --> G
F --> G
G --> H[导出当月损耗Excel]
9. 撤销操作
当入库/出库/归还/损耗操作有误时，仓管或管理员可在当天内撤销。
flowchart TD
A[点击「记录」标签页] --> B[找到目标交易记录<br/>类型已明确：入库/出库/归还/损耗]
B --> C{是当天记录且<br/>右侧显示「撤销」按钮?}
C -->|否| E[❌ 仅 admin/warehouse 的当天记录可撤销]
C -->|是| D[点击「撤销」按钮]
D --> F[系统弹窗确认]
F --> G[系统按记录类型<br/>自动执行反向操作]
G -->|入库| H{库存充足?<br/>当前库存≥撤销数量}
G -->|出库| J[库存增加]
G -->|归还| L[库存减少<br/>恢复到归还前]
G -->|损耗| N[库存增加]
H -->|否| HX[❌ 提示库存不足]
H -->|是| H1[库存减少]
H1 --> O[原记录标记「已撤销」<br/>半透明显示]
J --> O
L --> O
N --> O
O --> P[新增一条反向操作记录]
P --> Q[已撤销记录不可重复操作]
怎么操作： 进入「记录」页，找到当天的交易记录，点击其右侧的「撤销」按钮并按弹窗提示确认即可（非当天记录或当前角色无权时不会显示该按钮）。
反向操作规则（系统自动执行，无需手动改库存）：
| 原操作 | 库存变化 | 说明 |
|---|---|---|
| 入库撤销 | 减少 | 校验库存充足；已出库部分不可撤销 |
| 出库撤销 | 增加 | — |
| 归还撤销 | 减少 | 恢复到归还前状态 |
| 损耗撤销 | 增加 | — |
约束条件：
- 仅 admin、warehouse 角色可操作
- 仅当天记录可撤销
- 已撤销记录不可重复操作
- 入库撤销前校验库存（已出库部分不能撤销）
10. 管理员功能
10.1 用户管理
flowchart TD
A[点击用户标签页] --> B[查看用户列表]
B --> C{操作}
C -->|新增| D[填写用户名+密码+姓名+角色]
C -->|删除| E[点击用户行删除按钮]
C -->|重置密码| F[点击重置密码]
D --> G[提交→创建成功]
E --> H[确认→删除成功]
F --> I[默认设为123456]
10.2 角色权限设置
flowchart TD
A[用户Tab底部角色权限] --> B[点击编辑]
B --> C[选择角色]
C --> D[仓管]
C --> E[采购]
C --> F[财务]
C --> G[管理员]
D --> H[勾选可访问的功能模块]
E --> H
F --> H
G --> H
H --> I[点击保存]
I --> J[所有该角色的用户刷新后生效]
10.3 物料变更管理
场景： 刀具换了供应商或工艺改进，旧刀库存消耗完才能领新刀
flowchart LR
A[入库标签底部] --> B[物料变更]
B --> C{操作}
C -->|新增| D[填旧SKU+新SKU+原因]
C -->|删除| E[点击删除]
D --> F[点击新增→保存]
E --> G[拦截自动解除]
F --> H[出库时自动拦截旧件]
H --> I{旧库存>0?}
I -->|是| J[❌ 拦截]
I -->|否| K[✅ 放行]
两种替换方式：
| 方式 | 设置方式 | 拦截条件 |
|---|---|---|
| 跨码替换 | old ≠ new | 旧 SKU 库存 > 0 → 拦截 |
| 同码升级 | old = new | 不拦截（同一料号库存共享） |
10.4 SKU 编码助手
flowchart LR
A[入库Tab] --> B[输入名称]
B --> C[点击编码助手]
C --> D[选择品类]
D --> E[填写核心特征参数]
E --> F[选择供应商代码]
F --> G[点击填入SKU]
G --> H[自动拼装SKU到入库表单]
管理员可管理品类代码和供应商代码（点击编码助手弹窗中的齿轮图标）。品类/供应商代码已持久化保存，刷新页面不会丢失。
10.5 批量导入
仅管理员可操作。上传 Excel 文件，系统自动识别 SKU 和名称列，已存在的 SKU 自动跳过。
11. 月度盘存
盘存功能由角色权限标签 count 控制：管理员在用户管理界面对某个角色（如仓管、采购、财务、管理员）勾选 count，该角色就能看到并使用"盘存"标签；取消勾选则隐藏。用于核对某一周期的库存价值，并和库存页当前金额做对账。计算由系统自动完成，无需手填。
11.1 盘存周期怎么算
- 系统按"自然月 + 25 号切账"划分周期
- 一个周期 = 上月 26 日 到 本月 25 日
- 例：查看 2026-07 周期 → 统计 2026-06-26 至 2026-07-25 的数据
- 25 号是"盘存日"，当天界面顶部会显示横幅提示
- 若 25 号之后查看，自动顺延到下个周期（如 7 月 26 日之后看的是 8 月周期）
11.2 期末结存怎么算
盘存页会显示一张对账表，核心公式（系统自动算）：
期末结存 = 期初 + 入库 − 领用(净)其中：
- 期初：本周期之前，所有入库减领用（领用错误已退回的部分加回）的累计价值
- 入库：本周期内入库数量 × 当前单价
- 领用(净)：按下面方式计算，确保"退回库房的都算作没消耗"
领用(净) = 领用毛额 − 撤销领用回库 − 领用错误退回 + 撤销归还冲减- 领用毛额：本周期实际领用数量 × 当前单价
- 撤销领用回库：本周期"撤销领用"操作退回库房的数量 × 当前单价——货已回架，不算消耗，从领用中扣掉
- 领用错误退回：只有"领用错误"类型的归还会冲减领用——东西退回库房了，没产生消耗
- 撤销归还冲减：本周期"撤销归还"操作产生的冲减（抵消原先那笔归还），相应加回领用
- "以旧换新""刀具异常"等归还，东西已消耗，不冲减领用
- 损耗不计入结存：损耗金额只在"损耗"页单独看，不影响盘存期末结存
11.3 对账差额
盘存页把"按流水算的期末结存"和"库存页当前库存价值"做对比：
对账差额 = 库存页当前金额 − 期末结存正常情况下差额应为 0（两边都按"当前单价 × 数量"计算，且撤销领用/撤销归还已正确计入流水）。2026-07-16 系统修正过一次：此前漏算"撤销领用"回库量，会使账面上差额非 0（曾出现约 ¥2,896.97 的漂移）。修正后盘存期末结存与库存页金额应完全一致。若仍有明显差额，说明有数据异常，需要排查。
11.4 导出盘存明细
在盘存页点击「导出 Excel」，可导出当月盘存明细（含每种刀具的数量和金额），便于财务留存和实物盘点核对。
12. 常见问题
Q1: 出库时提示"旧刀具仍有库存"？
说明该 SKU 配置了物料替换，旧刀具还有库存未消耗。需要先用完旧刀库存才能领用新刀。
Q2: 入库时单价不想改变？
勾选"修复入库"复选框，入库后只增加库存数量，单价保持不变，且不产生采购费用。
Q3: 员工领错刀具了怎么办？
在"在借"页面点击该员工的"归还"→ 归还类型选择"领用错误"→ 数量填实际归还数 → 系统自动把库存加回去。
Q4: 表格列太窄/太宽？
表头右侧有半透明竖线，鼠标放上去变蓝色，按住左右拖动即可调整列宽。
Q5: 找不到某个功能？
各角色的可见功能不同，请联系管理员确认你的角色是否有该权限。
Q6: 忘记密码？
联系管理员为用户重置密码（重置后默认密码为 123456）。
Q7: 入库时输入名称自动填充了错误的物料？
现在只有输入的名称完全一致时才会自动填充。部分匹配会显示下拉列表供选择，不会覆盖你的输入。
Q8: 出库领用人怎么快速选人？
在"领用人"框输入姓名任意字，系统会联想出花名册里的人员（显示姓名+部门）直接点选；名单里没有的人，下拉底部点"＋ 添加"并选车间即可加入，下次直接能选。
Q9: 库存想按价格排个序？
点击库存表格的「单价」列表头：第一次从低到高、第二次从高到低、第三次恢复默认（按最近操作时间）。灰色箭头表示未排序。