两天跨入 v3:威盾 FDE 的 59 个模块、601 项测试与六条业务闭环(60 张 4K 全景实录)

📅 2026-10-10  |  🏷️ 建筑地产 · FDE交付 · 工程化收口 · 系统评估  |  🏙️ 四川威盾匠心建设  |  ⏱️ 阅读 26 分钟
一句话总结:上一篇(92 篇)发布时这套系统还是 v2.88 / 46 个模块。而接下来两天,它跨入了 v3.05——不只是在加功能,而是做了一件更难的事:收口。前端从 812KB 单文件拆成 4 个分片、知识库翻倍到 360+ 条、AI 评测集扩到 197 条、数据体检从 78.3 分补到 100 分;然后是风险引擎、13 周现金流预测、批次追溯与召回、客户信用闸门、工程结算、EHS 危废合规、审批动作编排、本体自动构建——每一件都是"让系统从能演示变成能落地"的基建。

现在的成绩单:59 个功能模块、601 项自动化测试(实测 600 过 / 1 项环境限制)、136 张数据表、86 篇技术文档、98 页带标注截图的使用手册、91.7MB 源码跨盘双份 SHA256 归档——依然零第三方依赖。

文末 60 张 4K 全景截图:左侧导航 59 个模块一个不落,外加登录页,全部来自当前运行版本。
📑 本文目录
  1. 两天里发生了什么:v2.88 → v3.05
  2. v3 的主题不是加功能,是收口
  3. 六个值得细看的新能力
  4. 六条业务闭环:从能演示到能落地
  5. 工程质量:数字会说话
  6. 60 张 4K 全景截图
  7. 我的评价与下一步

一、两天里发生了什么:v2.88 → v3.05

先看数字。两天,17 个版本号,一次大版本跨越:

46 → 59
功能模块
v2.88 → v3.05
两天 17 个版本
474 → 601
自动化测试用例
136
数据库表
41,312
代码总行数
0
npm 依赖(依旧)

新增的 13 个模块按业务分区归位:

分区新模块解决什么
总览我的今日工作台把 9 类待办按角色聚合,从"系统有什么"变成"我今天该做什么"
工程交付售后与质保、安全与环保(EHS)、工程变更交工之后的钱(质保金)、出事就停厂的合规、工程毛利的头号杀手
生产与库存批次追溯、工序成本、产能与排产、经销商门户、组织与基地召回链路、成本算到工序、负荷率、客户自助下单、多基地对比
商务合同工程结算、信用管控、发票管理、审批编排审减额、信用闸门、价税分离、批完自动做后续动作
智能系统风险与预测、能力与实例、智能施工与感知、FDE 交付台、数据接入向导、数据体检、主数据治理落地工具箱:让系统真正用起来的那一半工程

二、v3 的主题不是加功能,是收口

如果只看模块数,会以为这还是一轮堆功能。但看 v3.00–v3.05 各版本的落点,会发现主线完全不同——这是从"做出来"到"交付得出去"的转变:

v3.00 · 工程化收口

public/app.js 已经长到 10,587 行 / 812KB——这个体量谁都维护不动。它选择停下来,把单文件拆成 4 个分片(core / modules-2 / modules-3 / boot),加载顺序固定并写进文档;顺手修掉一个真实 bug(renderTodoLights() 每次调用都多挂一个监听器的内存泄漏);同步把知识库从 199 条充实到 362 条、AI 评测集从 64 条扩到 197 条、数据体检补到 100 分;还留了一篇 docs/77-架构与模块地图.md 交接地图——是给后来接手的人留的。

在功能狂奔期主动停下来还技术债,还在还债时顺手抓到隐藏 bug——这是工程成熟度的分水岭。

v3.01 · FDE 交付平台化

数据接入向导:11 步上线清单(系统设置 → 用户 → 通讯录 → 客户 → 供应商 → 物料 → 项目合同 → 回款 → 配方工序 → 知识库 → 上线门禁=数据体检 ≥90),当前值全部来自实时表计数,人工只能勾"确认我看过了",不能伪造完成;配套语料采集与标注台、一客户一实例的交付流程、部署模板一键复制、导入模板扩到 10 类。

v3.02 · 智能施工与感知层

施工条件闸门把老师傅"今天不能干"的直觉变成硬约束:基层含水率 / 温度 / 风力 / 雨雪按体系判定,热熔卷材、自粘、高分子、涂料、水泥基各有规则且带规范依据,不达标不允许开工,特批必须留痕。还有驻场助手(自动发现异常,每条带"为什么"和"该找谁")、变价联动(改一次材料价立刻算出对报价/订单/在制工单的影响面)、视觉质检管道(标注到 500 张才建议上模型)。

v3.03 · 能力开关与多实例

把"哪些能力要依赖外部服务"摆上台面:6 项能力(视觉质检 / AI 问答 / 天气 / 图纸算量 / 本地模型 / OCR)每项明确当前模式、依赖代价、需要什么环境变量——会破坏零依赖的能力默认关闭并标注存档。多实例登记支持一套代码复制给多个客户、一键健康检查。

v3.04 · 风险与预测

风险引擎把回款逾期 / 成本超支 / 变更未签认 / 隐患 / 交期 / 信用超限这些散落信号加权合成 0~100 分——规则式可解释、不是黑盒,因子按权重降序、每条都能追到具体事实。13 周现金流预测按客户历史拖延天数推算到账、输出周度 buckets / 最低余额 / 负周数。规范条文库把 GB 50345 / GB 50207 / GB 50208 / GB 55030 等 8 条条文结构化(标准号 / 阈值 / 检查方法 / 出处),给 AI 提供可引用条文——从机制上防编造规范。

v3.05 · 本体自动构建

把知识库 / 质量通病 / 语料文档自动抽成「实体—关系—实体」候选三元组:规则抽取(行业词典 73 条 + 句式线索,每条候选带原文证据)、LLM 抽取(可选增强,白名单约束防编造)、人工采纳才写进企业本体。

三、六个值得细看的新能力

🎯
我的今日工作台
不是新增一张待办表,而是把已有的审批/整改/售后/变更/催收/缺料/交期/资质/预测汇总成"今天该做什么"——每条带为什么和建议动作,可就地执行(通过审批、生成催收草稿)
⚠️
风险引擎
0~100 分加权合成,规则式可解释:overdue_payment 14 次、sleeping 14 次……每条扣分都能追到具体事实,建议动作跟在后面
⛓
批次追溯与召回
原料批次 → 工单 → 成品批次 → 客户/工地全链贯通;链路断点如实标出,不假装追溯得到——一个愿意暴露"我算不出来"的系统才值得信任
⚖️
客户信用闸门
信用占用 = 合同应收余额 + 未挂合同的销售订单敞口;下单/签约时超限直接拦下,占用率 ≥80% 预警——不让货和钱白白出去
⊞
工程结算管理
送审 = 合同额 + 已签认变更 + 索赔;甲方审定后自动算审减额与审减率(每分钱都是直接损失);质保金到期自动进工作台提醒
☣
EHS 危废合规
危化品(CAS + MSDS + 存储上限预警)、危废五联单闭环(缺一不可)、安全技术交底签字留痕、隐患整改复查不通过自动重开
⇉
审批动作编排
审批通过只是开始——合同批了自动按付款节点生成回款计划;可配置、可追溯、幂等、失败不回滚审批,批完该做的事系统兜底
⛨
数据体检中心
22 项体检 / 6 大分组,把"系统缺什么数据"变成看得懂、点得动的清单;上线门禁 = 体检 ≥90 分;演示库靠它从 78.3 分补到 100 分

四、六条业务闭环:从能演示到能落地

59 个模块不是 59 个孤岛。按业务串起来,是六条各自完整、又互相咬合的闭环:

闭环链路
商务闭环报价 → 合同 → 开票 → 回款 → 对账 → 催收 → 承诺核销
施工闭环巡检 → 整改 → 复查 → 质量分析 → 返工成本 → 追偿跟踪
生产闭环配方 BOM → 工单 → 领料 → 报工 → 完工入库 → 成本卷积 → 工序成本还原
采购闭环请购 → 采购订单 → 到货入库 → 来料检 → 供应商对账 → 应付账龄
质量闭环三道检验 → 留样到期 → 不合格 → 返工登记 → 净成本 → 追偿到账
经营闭环成本归集 → 毛利分析 → 现金流预测 → 风险评分 → 今日工作台 → 内联执行

与纷享销客(客户在用的 CRM)的分工也更清晰了:CRM 管关系与商务流,FDE 管实物流与成本流——客户/联系人/商机/合同/回款从 CRM 读过来(src/fxiaoke.js,App Secret 只走环境变量),交付状态后续回写。详见上一节的对标分析。

五、工程质量:数字会说话

测试:601 项,实测 600 过

全量跑了一遍 node --test:601 项用例,600 通过,1 项失败。失败的那一项(数据库快照防自覆盖)经手动复验确认是运行环境限制——沙箱禁止派生子进程导致断言取不到 stderr;手动执行脚本正确退出码 1 并打印防护提示,防护逻辑有效,非代码缺陷。

测试覆盖四个层面:业务断言、接口契约、前端渲染 XSS 全覆盖(24 个渲染函数 × 5 种载荷全部转义验证)、AI 评测回归(197 条评测集)。

零依赖:这条底线守得死死的

交付资产清单

资产内容
技术文档86 篇(02–85 编号,含架构地图、审计报告、部署手册、口径说明、系统评估报告)
使用手册HTML + PDF 98 页(A4 横向,带红色箭头标注截图) + Markdown 三格式
源码归档v3.05.0(91.7 MB / 解包 527 文件),F 盘 + E 盘双份,SHA256 已核对一致
部署脚本systemd + Nginx + PM2 + logrotate + 备份/监控 cron + 3 个一键 .bat
上线预检9 项预检脚本,ok 才继续
开发过程留痕.audit 目录 745 个增量脚本,每一步可回溯

六、60 张 4K 全景截图

左侧导航 59 个模块一个不落,外加登录页,共 60 张,全部 3840×2160,来自当前运行版本(v3.05.0)与演示数据。

第一组 · 门面与总览(3 张)

登录页延续品牌配色;FDE 工作台是全局首页;「我的今日工作台」是本次的灵魂——"不是系统有什么,而是我今天该做什么",每条待办带为什么和建议动作,可直接就地执行。
登录页 FDE工作台 我的今日工作台

第二组 · 现场与工程交付(9 张)

手机端三合一 + 审批;工程项目(实际成本与毛利率);巡检整改闭环;售后与质保(SLA 自动判超期);质量分析;EHS 危废五联单;交付任务;工程变更(增量毛利与风险敞口)。
现场作业手机端 工程项目 现场巡检 整改闭环 售后与质保 质量分析 安全与环保 交付任务 工程变更

第三组 · 生产与库存(11 张)

库存批次 FIFO;批次追溯与召回(断点如实标出);工序成本还原 ABC;生产制造与成本卷积;产能排产负荷率;销售订单发货扣库存;经销商自助门户(数据硬隔离);质量检验三道关;设备点检转维修;采购到应付账龄;组织与基地横向对比。
库存与批次 批次追溯 工序成本 生产制造 产能与排产 销售订单 经销商门户 质量检验 设备管理 采购供应链 组织与基地

第四组 · 商务与钱(9 张)

智能报价(历史校准);产品体系与配方覆盖率;合同回款;工程结算(审减额与质保金);信用管控(下单闸门);发票管理(价税分离);回款对账;数据入口四场景粘贴解析;提醒中心。
智能报价 产品体系 合同回款 工程结算 信用管控 发票管理 回款对账 数据入口 提醒中心

第五组 · 审批与经营(6 张)

审批中心(多级金额阈值 + 超时升级);审批编排(批完自动做后续动作,幂等可追溯);经营驾驶舱(现金流/账龄/毛利排行/风险雷达);预测与预警(回款/缺料/交期三件套);经营分析;采纳度与价值账。
审批中心 审批编排 经营驾驶舱 预测与预警 经营分析 采纳度与价值账

第六组 · 资信与客户资产(6 张)

资质与业绩(有效期预警,过期直接影响投标);客户与经销商;供应商与班组;企业微信通讯录匹配;产品知识库(362 条);文件中心(病毒扫描 + 鉴权下载)。
资质与业绩 客户与经销商 供应商与班组 通讯录 产品知识库 文件中心

第七组 · 前沿与智能(16 张)

全生命周期五闭环;企业图谱;工程数字孪生;多智能体协同;开放平台;风险与预测(规则式可解释评分);能力与实例(能力开关 + 多实例健康检查);智能施工与感知(条件闸门 + 驻场助手);FDE 交付台;数据接入向导(11 步上线清单);数据体检(22 项 / 100 分);企业本体(自动构建三元组);主数据治理(去重合并全库改挂);AI 盾盾(真问真答带出处);AI 评测(197 条回归);系统设置。
全生命周期 企业图谱 工程数字孪生 智能体协同 开放平台 风险与预测 能力与实例 智能施工与感知 FDE交付台 数据接入向导 数据体检 企业本体 主数据治理 AI盾盾 AI评测 系统设置

七、我的评价与下一步

评估报告已单独立档(docs/85-系统评估报告.md),结论一句话:综合 92 分,A 级,达到可交付标准。

分项:功能完成度 96 | 工程质量 95 | 交付就绪度 93 | 安全性 90 | 可维护性 88 | 数据完整性 82。

但它最大的风险不在技术

59 个模块里,有 21 张数据表还是空的——风险评分、现金流预测、MDM 别名、变更明细、盘点、维保、质保、诊断……这些模块等着真实业务数据去喂。系统能力已经超前于客户当前的数据成熟度。

客户不会因为测试用例多而满意。客户只关心:我今天点开它,能不能少干两小时活。

所以下一步不是继续加模块,而是:

  1. 分阶段启用:先上 20 个与客户痛点直接相关的模块,其余按需开放;
  2. 用数据接入向导完成真实数据接入,以数据体检 ≥90 分为上线门禁;
  3. 用「采纳度与价值账」攒出 3 个量化数字(回款逾期下降、巡检时长缩短、成本核算覆盖率),形成第一份客户证言;
  4. 拿到纷享销客真实凭据,完成一次端到端同步演练。

两个月前它是 10 个模块的"防水交付工具",一个月前是 38 个模块的"前线作战台",现在它是 59 个模块、六条闭环、601 项测试的"生产·库存·销售·施工一体化"系统。下一个战场不在代码里,在工地上。