新手手册 —— 从登录到玩转全流程

不需要任何培训课。跟着这 8 步走一遍,你就见过砺锋的全部主要能力:单据流、齐套、寿命、模具。

适用读者:第一次接触砺锋的车间 / 仓库 / 计划同事 · 全程约 15 分钟

第〇步:把系统跑起来

已经有人帮你部署好了?直接跳到第一步。自己折腾的往下看。

启动与登录

命令行两个窗口

① 后端:dotnet run --project backend/TMS.API(首次运行自动建库、迁移、种子数据,监听 :5000)
② 前端:cd frontend && npm install && npm run dev(打开 localhost:3000)
③ 登录:默认管理员 admin / admin123。

想有一套「冲压车间」演示数据(本手册截图全部来自它)?跑一次 powershell -File scripts\seed-mold-story.ps1——幂等脚本,重复执行不会造重复数据。

登录页
登录页:默认 admin / admin123

第一步:看板——今天车间什么状况

读懂数字,而不是找功能

菜单 → 刀具看板

六个数字回答六个问题:库里有多少物料、外面借出去多少、多少库存低于安全线、多少异常没处理、多少刀在维修中、多少组件可用。 右边两栏是「现在就该管」的明细:库存预警(黄色数字 = 低于安全线)和待处理异常。

页面右上角「实时」标签亮着,表示看板与服务器保持推送连接——任何人在任何页面入库、报修、还刀,这里的数字几秒内自己变。

刀具看板
演示数据:异常 6 / 待维修 4——含试模不合格自动开的异常报告

第二步:台账与库存——每把刀的户口本

现存量、批次、库位

菜单 → 刀具管理 → 库存管理

台账每一行是一把(套)工装:物料编码、类别、批次(Lot)、现存量、占用量。红色数字 = 低于安全库存 MinQty,黄色 = 快到线了。 库存口径全系统只有一条:default 批次的现存量——领用、齐套、备刀、补货、AI 工具,全部看同一个数。

库存管理
库存页:880-20-12H-C 两个批次分别 3 / 6 件,红色即低于安全线
要点:砺锋不做「魔法库存」。任何人改库存都必须走单据(入库 / 领用 / 退库 / 报废),账本的每一次变动可追溯到人和单号。

第三步:单据流——入库、领用、归还、报废

一张领用单的完整旅程

菜单 → 出入库管理 → 领出管理 / 退库管理

仓库新建入库单(RK 单)→ 挑物料、填数量 → 保存即真实增库存。
机台同事申请领用单(LY 单)→ 审批派发 → 领用即占用(现存量减、占用量加)
→ 用完走退库(占用释放)或报废(走报废单,需要审批)。

每张单据的状态机是显式的:待处理 → 派工/执行 → 完成,状态流转全部落审计账本。

要点:单据可以改,但历史不可改——审计日志页能按单号看到每一次流转的经手人、时间、IP。

第四步:寿命管理——红黄绿与「还能用几天」

先配台账,再看预警

菜单 → 刀具维护 → 生命周期设置 / 寿命实时预警

在生命周期设置里给每把刀配:额定寿命(分钟或次)、黄线阈值、红线阈值;模具类工装还能配保养间隔冲次。 然后到寿命实时预警看三色:红 = 已超红线或已过期,黄 = 过黄线,绿 = 正常。

刃磨或保养后做一次「刃磨重置」:寿命已用从重置时点重新累计(M1 循环口径),累计冲次保持全生命周期口径——两个数分开、都如实展示。

寿命实时预警
演示数据:TON160-M01 用到 70%(黄)、TON160-M02 用到 90%(红)
要点:这套红黄绿判定在 REST 端点和 AI 工具里是同一个引擎——你问 AI 和你看页面,答案永远一致。

第五步:齐套检查——「这张单拿什么做?」

导入需求,三分钟要答案

契约端点 /api/v1/kitting/check(或问 AI:tms_kit_check)

谋序(APS)排好产导出工序-工装需求 → 砺锋逐行核对 → 一句话结论: ready(齐)/ shortage(缺数)/ tonnage_mismatch(吨位不符——160t 的机台带不动 200t 的模具)。

缺口行一键生成备刀单(BD 单)→ 审批派发 → 自动生成同枢(ILESP)搬运任务 → 仓库按单入库 → 重排后重查,缺口消失。同一 plan_revision 重放检查是幂等的:返回存档快照,库存变化不影响已锁定的结论。

演示全链剧本:powershell -File scripts\demo-kitting-e2e.ps1(需求导入 → 缺口 → 备刀 → 搬运 → 补货 → 齐套达成)。

要点:齐套行级「吨位不符」会计入未齐套汇总,但不会进缺库存明细——模具缺吨位问题靠人调机台,不是靠备刀单能补的。

第六步:模具工作台——模次、保养、试模

冲压车间的日常在这一个页面

菜单 → 刀具维护 → 模具管理

冲次报工 / 刃磨:机台每打完一批,报一次冲次(mold_shot),寿命消耗自动累计;刃磨重置一键归零分子(累计冲次不动)。
保养建议:模次达到台账间隔 → 系统生成建议 → 人批准(给出预计完工时间)→ 自动开 WX 保养单,并向谋序回写保养约束窗(单向)。建议本身没有任何业务效果——没有人的批准不成单。
试模记录:试模 fail → 模具自动封锁 + 自动开异常报告(走既有维修流程,不自动开维修单);pass → 解除封锁。试模结论是人的判定,系统只做状态联动。

保养建议
保养建议:TON160-M03 已用 110000 / 间隔 100000 → 已批准,预计完工由批准人给出
试模记录
试模记录:M02 不合格(封锁+异常报告)、M03 通过(放行)

第七步:维修与异常——出了事之后

异常报告 → 维修单 → 质检

菜单 → 刀具维护 → 异常上报 / 维修返修管理

异常可以人上报,也可以由系统自动开(如试模失败,标记 trial_fail、严重程度「重」)。 维修单(WX 单)状态机:上报 → 派工 → 完工 → 待质检 → 合格/不合格——每一步谁经手、什么时候,账本可查。

异常上报
异常列表顶部两条 trial_fail:TON160-M02(演示)与 TON160-SMOKE-01
维修返修管理
维修单列表:WX20261106031743 是 M03 的保养单(maintenance 类型)

第八步:审计日志——谁动过什么

账本是系统的黑匣子

菜单 → 系统管理 → 操作日志

所有关键动作(单据、齐套、寿命、保养、主数据)追加写进审计账本,哈希链防篡改。 AI 工具 tms_audit_verify 能当场验完整条链——有任何一条被改过,验证立刻失败。

履历追溯
履历追溯:TON160-M03 的报工 → 入库 → 保养单 → 入库全轨迹,每步带单号与经手人

角色与权限速查

四类角色,菜单按角色出,AI 工具面与 REST 权限一致。

角色能干什么典型岗位
Admin全部:主数据、单据审批、建议批准/驳回、用户角色、审计系统管理员 / 主管
Planner齐套检查、备刀审批、保养建议批准/驳回、全部读面计划员
Technician维修执行、质检、试模记录、报工;不能批准建议/备刀维修技师 / 班长
Operator领用申请、报工、查库存与寿命;审计面不可见机台操作工

常见问题

为什么齐套结果里「缺库存」和「吨位不符」分开列?

因为解决办法完全不同:缺库存可以靠备刀单补货解决;吨位不符是机台与模具的物理匹配问题,只能靠人调整机台或模具——把它混进缺库存明细会误导人去开一张永远补不上的备刀单。

为什么保养建议生成了却没有产生任何单据?

设计如此。建议只是提示(没有任何业务效果),必须 Admin/Planner 批准并填写预计完工时间,系统才开 WX 保养单并向谋序回写保养约束窗。AI 可以查到建议,但 AI 永远批不了。

为什么我给模具报了 35 万冲次,寿命才 70%?

看两个数:寿命已用按「自上次刃磨/保养重置起算」,累计冲次是全生命周期。如果这副模具做过刃磨重置,重置前的冲次不计入寿命分子——这是 M1 循环口径,页面提示和 AI 工具口径一致。

AI 助手能帮我批一张备刀单吗?

不能。砺锋的 16 个 AI 工具全部只读——没有 approve、没有 reject、没有批量报工。AI 能做的是:查库存、跑齐套、给寿命预警、找单据、验证账本,并且每个回答都带引用(引用的工具与数据快照)可以逐条对账。

演示数据能重跑吗?会重复吗?

不会。scripts\seed-mold-story.ps1 每一步都有存在性检查(模具复用、已有库存跳过、已有报工跳过、建议不重复裁决、试模不重复记),重复执行只是把结论重新打印一遍。