58 篇教程，从上线到二次开发
不讲功能列表，只讲「你现在要做这件事，点哪里、填什么、哪里容易错」。 每篇都有目标、前置条件和踩过的坑，可以直接发给对应的同事。 最后 8 篇是给集成商和开发看的接口对接与源码改造。
共 58 篇
上线
基础从零把一个车间搬进系统4 篇经营
经营层老板看的那条线：客户、报价、对账、成本、报表8 篇客户档案与销售漏斗：订单不是凭空来的
客户、线索、商机、漏斗、公海池，是一套从「有人问价」到「签下来」的接力流程。不建这套，接单能力就只能靠老板的记忆。
报价单：把「凭感觉报价」变成可复算的公式
同一批货报出三个价、报完就忘、客户回头问上次多少钱——报价单要解决的正是这三个问题。
客户 H5 自助下单：把催单电话变成系统记录
客户自己下单、自己查进度，跟单员不用再一条条微信回「做到哪了」。
客户对账单与往来核对：月底不吵架
对账扯皮的根因是双方各有一本账。让客户对着同一份明细签字，比事后解释有效。
收支流水与成本毛利：这张单到底赚没赚
产值高不等于赚钱。成本毛利要按单算，才知道哪类活儿该多接、哪类在赔本赚吆喝。
综合数据报表：不写 SQL 也能出月报
产量、质量、工时、采购四类报表都在这一页，筛选完直接导出，不用找 IT 提需求。
车间大屏与经营看板：挂在墙上，看在手上
车间大屏解决「员工自己想看产量」，经营看板解决「老板三十秒判断今天要不要下车间」。两者口径不同，别混用。
客户询价到报价转订单：把报价这件事收到系统里
客户在微信问价、销售在笔记本记、报完就忘——这套流程丢的不是效率，是订单。
计划
执行层接单之后怎么拆、怎么排、怎么备料5 篇从订单到工单：一次完整的排产
订单确认后系统自动拆出工单与任务。这一步拆错了，后面报工和工资全错。
甘特图排产：插单、改期与重排
客户插单是常态。学会看关键路径，才知道改哪张单不会连带拖累其他单。
齐套检查与缺料预警
开工才发现缺料，是计划环节最常见的浪费。齐套检查把它提前到排产阶段。
物料与多级 BOM：齐套检查的地基
BOM 决定齐套检查准不准、MRP 算得对不对、成本核得实不实。它是三件事的共同地基。
班次与技能标签：让派工自动找到对的人
班次决定考勤怎么算，技能标签决定派工时系统推荐谁。两件事都配对，班组长每天少想十分钟。
执行
执行层车间每天真正在发生的事7 篇派工与任务码打印
派工不是分任务，是把「谁、做什么、多少件」写到纸面上，让扫码能落地。
报工审核：初审看什么、什么时候该驳回
审核不是点通过。审错了，月底工资一定出错，而且错在明处。
手机扫码报工：从扫码到看到工资
写给车间员工看的：三步报完工，还能当场看到这笔活值多少钱。
件次报工审核：按件核量，别按批糊弄
同批多件、单片流转的场景，一批报一次数容易浑水摸鱼。件次粒度核量能精确到每一件。
临时报工与补报：漏报、代报、跨天怎么处理
扫码扫不出来、员工忘了报、班组长代报——真实车间一定会有这些情况。关键是让补报也留痕。
打印模板：工单、任务码、标签、工资条一次配好
模板配一次能用一年。配得好的模板能减少一半现场提问——因为该印的信息都印在纸上了。
AI 报工辅助：说一句话就把数填好
员工手上有油、戴着手套、打字慢——语音录入比让他们点数字快。
质量
执行层检验、缺陷分析、追溯与客诉处置6 篇质检模板与缺陷代码
不良原因如果只写「不良」，一年后你什么也分析不出来。
一物一码与溯源查询
客户投诉时，能三分钟内查到这批货是哪天、哪台机、谁做的。
缺陷代码体系：让不良数据能用来做决策
不良数填了但没有代码，等于没填。有代码才能回答「主要问题是什么」，没代码只能回答「有多少」。
SPC 过程控制：在出问题之前看出来
不良率是事后指标。SPC 看的是过程有没有失控——在还没出批量不良的时候就报警。
客诉反查：客户投诉时，先查记录再定责任
客户说「这批不行」，你第一反应是道歉还是查记录？有记录才能在半小时内说清是料、是机、还是人的问题。
活码：让印出去的码还能改内容、收表单、推状态
码印出去就改不了了，这是大部分工厂对二维码的印象。活码不是——它指向一个可编辑的页面，内容随时能换。
物料
执行层料从哪来、剩多少、什么时候补5 篇物料出入库与库存盘点
库存不准，齐套检查和 MRP 全都是假的。先把出入库做对。
MRP 运算与采购建议
不用再把订单逐张翻出来手工算用量。MRP 按 BOM 和库存倒推该买什么。
供应商与采购闭环：从请购到对账付钱
采购最容易出问题的不是买错，是「买了没记、记了没对、对了没付」。闭环的意思是每一环都能查到上一环。
库存盘点：账实不符是所有成本的源头
账面有 500 件实际只有 380 件，齐套检查、MRP、成本核算全部跟着错。盘点不是财务要求，是系统能不能用的前提。
委外加工：外协工序的成本与进度怎么管
外协是最容易失控的环节：料出去了、活没回来、钱照付。关键是把「发料—回货—结算」三段都记上。
设备
执行层机器和模具别在关键单上停3 篇结算
经营层月底算薪与对账，口径唯一5 篇计件工资核算与工资条签名
工资出错一次，后面三个月都在扯皮。口径唯一是唯一解。
考勤、补贴与扣款怎么进工资
计件之外的部分——迟到、请假、夜班补贴——不进系统，工资就永远要手工补。
计时工资：按考勤和工时算，不和计件打架
厂里通常两种人：计件的和计时的。两种算法可以共存，混算才会出错。
补贴与扣款：每一项都要有依据来源
补贴和扣款是工资争议的高发区。有依据来源的项目不会吵，手工填的数字一定会吵。
工资条与电子签名：月底不再逐个解释
工资条不是通知，是确认。员工签名之后，"我不知道""没跟我说"这类争议就少了一大半。
支撑
支撑层审批、推送、AI 与小程序7 篇工厂助手：用一句话问出你要的数
不用学报表筛选。直接问「上个礼拜二车间干了多少」，它去查库再回答。
审批流配置：把「找老板签字」搬到线上
审批流不是把纸单电子化，而是把「什么情况下需要谁签」这件事写死。写不死，就还是靠人情。
飞书 / 钉钉 / 企业微信推送：让提醒真正到人
系统里的消息如果没人看，等于没发。把通知推到他每天必开的那几个 App 里，才有触达率。
AI 深度分析与预测：把它当参谋，不当裁判
十个分析模块不是十个摆设。它们回答的是「为什么会这样」，而不是「是什么」。用错地方就会得出错误结论。
AI 数字员工：配一个会自己跑任务的助手
不是聊天机器人。数字员工是按规则自己跑活的：每天定时汇总、异常自动追、固定报表自动出。
微信小程序：员工不装 App 也能报工
H5 要记网址，小程序在微信里一点就开。对不爱用浏览器的员工，这一步差别很大。
AI 用量与钱包：搞清楚 AI 到底花了多少钱
AI 功能用起来很爽，账单来了才发现没人说得清钱花在哪。这套计量是按实际 token 算的，每一笔都能对到具体场景。
开发
开发接口对接与源码二次开发8 篇API 快速开始：认证、响应格式、分页与错误码
系统对外暴露 800+ 个 REST 端点，OpenAPI 文档在 /openapi.json。先搞清四件事：怎么拿 token、响应长什么样、怎么翻页、错误怎么判。
订单同步对接：把外部订单自动拉进系统
最常见的集成需求：客户在商城/ERP 下单，自动进本系统变成生产订单。难点不在调接口，在幂等、对照表和失败重试。
Webhook 回调：扫码、表单提交、状态变更实时通知
一物一码模块支持对外 webhook。相比轮询，回调能做到秒级，但必须自己处理签名校验、重试、乱序三件事。
认证与 SSO：把本系统接进你的账号体系
目前是 JWT Bearer，没有内置的 OIDC/SAML。要做单点登录有两种做法：前置代理换 token，或改源码接 IdP。
数据导出与 BI 对接：把数拉到你自己的看板
系统里的报表够日常用，但老板可能想在帆软/PowerBI 里看。两条路：调接口拉数据，或私有化直连数据库。
后端源码二次开发：加接口、加字段、加迁移
FastAPI + SQLAlchemy 2.0 + Alembic 的分层结构。改之前先搞清五个目录各自负责什么，否则改一处崩三处。
管理端前端二次开发：加页面、加菜单、加权限点
Vue 3 + Vite + Element Plus。三处必须同步改：路由、菜单、权限点。少改一处就会出现「页面能进但菜单没有」或「菜单点了 403」。
数据库迁移与版本升级：别让升级变成事故
升级出问题，九成是没有备份、或者跳过了迁移检查。这两件事做到，剩下都是可恢复的小问题。