长出工厂的一个月：威盾 FDE 从交付工具升级为「生产·库存·销售·施工」一体化（模块 25→38 全记录）
文末 39 张 4K 实拍截图——左侧导航 38 个功能模块一个不落，外加登录页，全部来自当前运行版本，含真实演示数据。
一、一个月前它还是个「交付工具」
上一篇文章发布时（89 篇），威盾 FDE 的定位是「防水建材公司的前线作战台」：工程项目、合同回款、现场巡检、客户经销商、产品知识库、AI 盾盾——25 个模块，主线是「报价 → 合同 → 回款 → 对账 → 催收」和「巡检 → 整改 → 复查」两条业务线。
这个定位有个天然的截断：它管交付，不管交付之前和之后的事。材料是买来的还是自己产的？成本从哪来、到哪去？客户下了单谁发货？这一整段，系统是缺席的。
而这一个月（对应用户视角里「Codex 连续两天爆肝 + 前后数轮迭代」），这条断层被补上了。现在的 README 第一行写着：
公司主体也正式更名为「四川省威盾匠心建设有限公司」——系统跟着客户的工商抬头走，从名字开始对齐。
二、定位升级：一条从研发到维护的完整链条
新链条长这样：
原来的两条老主线没有丢，而是被接进了更大的网络：报价可以直接转销售订单；工地领料直接扣库存、挂项目成本；采购到货自动入库并按批次记成本，供应商对账和应付账龄自动算。三件事（生产、买卖、施工）终于共用同一套库存和同一套成本口径。
三、生产制造：BOM 展开工单，成本卷积到每一桶
这是本次升级里最硬的一块。生产这条线以前是完全不在系统里的——客户工厂里产一桶防水涂料，料耗多少、人工多少、制造费用摊多少，全在老师的脑子里和 Excel 里。
配方是生产的地基
先录 BOM（物料清单）：一桶「W8 外墙防水涂料」由哪几种原料各多少组成，版本化管理，改配方留痕。建生产工单时选配方，系统自动按计划产量展开用料需求，不用人工算。
领料与报工是两个独立口径
这里做了一个刻意的设计：报工与入库分开。领料扣的是原料库存（真实发生才算），报工记的是工时和完工进度（人说了算），完工入库增的是成品库存。两个动作不强制捆绑——现实中「报了工但还没入库」「先入库后补报工」都存在，系统不假装它们总是一起发生。
成本卷积：完工那一桶到底花了多少钱
工单完工时，单位成本 = 材料（实际领料，无领料时退回 BOM 标准成本）+ 人工 + 制造费用。人工和制造费率按「车间优先、全局兜底」取用——不同车间人工费率不一样，没单独设置的车间用全局默认值。报工累计的工时参与分摊，成本算完回写工单和成品入库单。
实拍截图里的真实数据：MO-00001 工单产 50 桶 W8 外墙防水涂料，材料 ¥1,982.29 + 人工 ¥2,880.00 + 制造费用 ¥1,610.00 = 总成本 ¥6,472.29，单位成本 ¥129.45/桶。这个数会一路跟着成品走进库存、走进销售发货、走进项目成本——毛利率不再靠拍脑袋。
四、库存与批次：FIFO、效期、批次追溯
库存是生产、销售、施工三方的共同底座，所以单独做厚了：
- 三类型分仓：原料 / 半成品 / 成品各自独立仓库，各管各的账；
- 批次与效期：入库必须带批次和到期日，临期批次预警；
- FIFO 出库：先进先出，出库单自动选批次，账面与实物对得上；
- 多计量单位：吨 / 公斤 / 桶 / 组自由换算，采购按吨、领料按公斤不打架；
- 调拨与盘点：仓库间调拨留痕，盘点差异一键生成调整单；
- 批次追溯：某一批原料用到了哪些工单、发给了哪些项目，正查反查都能到。
截图里的演示数据：5 个仓、18 条出入库流水，库存余额按「仓库 × 物料 × 批次」逐行挂着单价和到期日——这是能直接对实物的账，不是装饰性表格。
五、采购供应链：请购到应付账龄的完整闭环
采购线之前只有一张「采购台账」，这次升级成了完整的供应链：
几个值得说的细节：
- 订单按到货进度自动流转：部分到货自动标「部分到货」，全部到完自动「已完成」，不用人工改状态；
- 到货自动加库存、按批次记成本：采购入库的材料成本真实挂到供应商——成本口径三选一里的「采购入库」口径从此有了完整的数据来源；
- 应付余额 = 到货 − 已付，账龄按「先到期先付」FIFO 冲抵到货后分桶 0-30 / 31-60 / 61-90 / 90+ 天，供应商欠款结构一眼看清。
六、销售订单与发货：报价单长出了下半身
以前智能报价生成报价单之后，故事就停在「客户签了合同」。现在：
发货直接扣成品库存——卖出去的每一桶都从账上走，库存数字不会撒谎。物流单号和签收回执挂回订单，客户问「我的货到哪了」，系统里有答案。
七、质量检验与设备管理：来料检、留样、点检转维修
质量检验覆盖三道关：来料检（供应商的货进门先验）、过程检（生产中间环节抽查）、成品检（出厂前最后一道）。支持留样管理——涂料行业有留样要求，样品到期自动提醒。
设备管理做了状态机：设备台账 → 点检（发现异常自动生成维修单）→ 维修中 → 维保完工自动恢复在用。反应釜坏了不用在群里喊师傅，系统自己把单派出去。
八、现场作业手机端：拍照水印、扫码领料、离线幂等
这块是给工地上的 FDE 用的。手机端三合一：
拍照巡检
手机拍一张，自动打上项目名、时间、定位水印——工地照片最怕「说不清是哪天拍的哪个部位」，水印一步解决。选部位和结果，一步生成巡检单并挂照片。
扫码领料
扫材料码直接工程领用，自动扣库存、自动记到项目。以前工地领料靠纸条，月底对账全靠猜。
今日现场
我的项目 / 待整改 / 最近巡检，早上打开一眼知道今天干什么。
离线可用 + 幂等去重
工地信号差是常态，所以做了离线队列：拍照巡检和扫码领料先存本机队列，联网自动补传。服务端用 client_ref 幂等去重——同一台手机重复补传三次，也只会建一张单、扣一次库存。这个细节是「能不能真用」和「演示时能跑」的分水岭。
九、经营驾驶舱：老板要的一屏，拼出来了
前面 37 个模块是给干活的人用的，第 38 个是给老板的。经营驾驶舱一屏四件事：
- 现金流趋势（近 6 个月）：回款 − 付款，柱线叠加，每一根柱子带数字；
- 应收 / 应付账龄双堆叠条：谁欠我、我欠谁，都按账龄分桶；
- 毛利排行（最好 / 最差 8 个）：项目毛利率直接排，最好和最差都在一屏上；
- 风险雷达：逾期、超期整改、临期批次、审批超时汇成一个总分。
实拍截图里的数据：经营总额 ¥6,080,500、应收余额 ¥3,726,500（红色警示）、在手现金 ¥13,330,000、毛利 17.5%——全是系统里真实流转出来的数，不是摆拍。
十、数据入口与自动同步：让数据自己走进来
系统越大，最贵的成本越不是开发，而是录入。所以这次同步加了两条「进料口」：
数据入口管道：粘贴即解析
四个场景——回款流水 / 现场巡检 / 材料报价 / ERP 出库单。银行流水、Excel 片段、微信里甩过来的一串数字、工程师随口说的现场描述，粘进来就自动解析匹配成结构化草稿，人工确认后一键入账。零依赖实现，24 项测试。
数据同步：ERP / CRM 定时对齐
「数据入口」页新增「数据同步（ERP / CRM）」：客户、项目、合同、回款、成本、供应商、班组、出勤、工资九类数据一键或定时同步进系统，每次同步留运行审计（状态 / 条数 / 耗时 / 触发方式 / 错误）。支持进程内定时（FDE_SYNC_INTERVAL_MIN）和外部 cron（npm run sync:run）两种节奏。
十一、工程化底座：事务加固、路由索引、跨盘归档
功能堆到 38 个模块，再不补底座迟早出事。这轮专门做了几件「看不见但救命」的工程：
- 写库事务一致性加固（v2.63）：多表写入统一走可重入事务，子表失败整体回滚——工单写完、领料明细写一半挂掉这种「脏数据」从此不存在；
- 路由索引自动生成（
npm run route:index）：239 条路由 / 65 个模块，覆盖 server.js + 独立路由模块，带行号与服务反查——38 个模块的系统再也不能「凭记忆找代码」； - 源码归档跨盘双份：
npm run archive生成干净源码包（61.47 MB / 388 文件，SHA256 校验），F 盘 + E 盘各一份，解包后 360 项测试全通过； - 演示数据一键管理：
npm run demo:seed/demo:clear，五套幂等脚本（成本 / 库存 / 制造 / 采购 / 通讯录），带「演示数据」标记可整清； - 接入 FDE 平台底座：18 个领域无关内核模块 + 防水行业包——下一个行业的 FDE 不用从零写；
- 88 页使用手册：28 个模块全部配红色箭头标注截图，HTML / PDF / Markdown 三格式交付，客户培训有抓手。
十二、39 张 4K 实拍截图全记录
左侧导航 38 个功能模块一个不落，外加登录页，共 39 张，全部 3840×2160。数据来自 demo:seed 演示种子（备注带「演示数据」标记），浏览器仅缩放无压缩直出。
第一组 · 门面与总览（2 张）
第二组 · 生产与库存（本次升级主角，7 张）
第三组 · 钱与经营（10 张）
第四组 · 现场与工程交付（6 张）
第五组 · 客户资产与人（5 张）
第六组 · 前沿与智能（9 张）
十三、写在最后：下一步
38 个模块之后，系统最大的风险不再是「功能不够」，而是用不起来。所以下阶段的主线已经明确：
- 驻场机制：采纳度与价值账持续运转——谁在用、卡在哪、省了多少，每周复盘改版；
- 云上交付：部署手册 + 上线预检 9 项 + systemd + Nginx TLS 已就绪，随时可上客户服务器；
- 行业复制：FDE 平台底座（18 个内核模块）+ 行业包模式已验证，防水之后是下一个行业；
- AI 从问答到代办：AI 盾盾现在会答题，下一步让它直接起草工单、生成对账差异说明。
两个月前它是 10 个模块的「防水交付工具」，一个月前是 25 个模块的「前线作战台」，现在是 38 个模块的「生产·库存·销售·施工一体化」。下一个版本见。