摘要
制造企业数字化转型正在从「单点系统建设」走向「平台化、模块化、可运营」的新阶段。重复建设用户体系、权限体系、菜单体系、基础主数据与开发工具链，已成为 MES、WMS、QMS、能源管理、设备管理等项目的共性成本。
韬煜集成平台（TOPAUT Integration Platform）是一套面向制造场景的数字化系统底座：以统一的后端内核、前端壳层与可选能力模块为组合，帮助集成商、软件厂商与制造企业 IT 团队在数周内搭建可交付的行业系统，把精力集中在业务差异化上，而非基础设施重复开发。
本文介绍平台定位、总体架构、二次开发解决方案、典型落地路径与建设收益，供项目立项、方案评审与商务推广使用。
一、行业背景与建设痛点
1.1制造企业数字化建设的共性挑战
- 每个新项目都要重做登录、用户、角色、菜单、按钮权限、日志审计，交付周期长、质量不稳定。
- MES、报表、大屏、低代码等能力分散在不同产品，接口风格不一，后期集成与运维成本高。
- 工厂模型、职员、班组、班次等主数据缺乏统一模型，跨系统对账困难。
- 源码交付导致知识产权边界模糊；版本升级时合并冲突严重，客户现场难以平滑演进。
- 项目团队人员流动大，缺少标准化宿主工程与模块包机制，知识难以沉淀。
1.2客户真正需要的是什么
客户需要的不是又一个「从零写起的 MES」，而是一个可快速装配、可授权、可升级、可二开的制造数字化底座：
- 内核稳定：平台方持续维护安全、权限、布局、授权与通用 API。
- 模块可选：BI 大屏、报表设计、在线编程等按 license 选购，未购模块不进入交付物。
- 业务可扩展：二开团队在同一数据库、同一权限体系下扩展实体、页面与接口。
- 交付可控：NuGet / npm 商用包交付，边界清晰，便于报价、验收与维保。
二、平台定位与价值主张
维度 | 传统自建 | 韬煜集成平台底座 |
交付形态 | 全量源码、难以裁剪 | 核心 NuGet + npm 商用包 + 瘦宿主工程 |
权限体系 | 各系统各做一套 | 菜单 / 角色 / 按钮级权限统一模型 |
主数据 | 分散维护 | 工厂模型、组织、字典、通讯点位统一 |
扩展方式 | 改平台源码 | IPlatformModule 插件 + 共用 AppDbContext |
工具能力 | 外购或重复集成 | BI / 报表 / 在线编程可选模块内置 |
授权运营 | 弱 | 机器码绑定 + 模块 license + 反注册管控 |
一句话定位：
韬煜集成平台 = 制造数字化系统的「操作系统 + 应用商店」——操作系统提供登录、权限、布局、主数据与 API 规范；应用商店提供 BI、报表、在线编程等可选能力；二开团队在其上快速构建 MES、工艺管理、能源、仓储等行业应用。
三、总体架构图
3.1逻辑分层架构
3.2部署架构（典型现场）
3.3前后端模块化架构
四、核心能力说明
4.1平台内核（所有项目标配）
能力域 | 主要内容 | 业务价值 |
身份与权限 | JWT 登录、用户/角色/菜单/按钮权限 | 统一安全模型，满足审计与分级管理 |
组织与主数据 | 职员、部门、字典、工厂模型树 | 制造场景标准主数据，支撑 MES/SCADA 绑定 |
生产辅助主数据 | 班组、班次、通讯站点与变量 | 贴近产线采集与排班管理 |
系统管理 | 菜单、权限项、日志 | 运维可管可控，问题可追溯 |
软件授权 | 硬件序列号、.lic 授权、模块 license | 商业化交付与防扩散 |
多数据库 | MySQL / SQL Server / PostgreSQL 等 | 适配客户现有 IT 标准 |
4.2可选开发平台模块（开发平台菜单）
模块 | 能力概要 | 典型场景 |
BI 设计 | 大屏、模板、数据集、Excel 报表、文件管理 | 车间看板、产线 KPI、管理驾驶舱 |
报表设计 | 报表、数据源、数据集、定时任务 | 质量月报、产量统计、能源报表 |
在线编程 | 数据源、实体、页面设计、代码编辑、发布 | 快速表单、接口编排、规则扩展 |
模块采用「按需引用、按需授权」：客户未购买的模块不会出现在菜单中，也不会进入 NuGet/npm 交付包，从源头降低实施范围与授权风险。
4.3工厂模型——制造数字化的共同语言
平台内置工厂模型树：工厂 → 车间 → 产线 → 工段 → 工位 → 设备。该模型被 BI 大屏、通讯变量、二开业务（如停机原因、SOP 绑定）统一引用，避免「同一台设备在 MES 和 SCADA 里 ID 不一致」的集成噩梦。
五、二次开发解决方案
5.1解决方案总览
5.2后端二开模式
- 实现 IPlatformModule，注册 Controller、Swagger 分组、启动迁移。
- 业务实体通过 IEntityTypeConfiguration 合并进同一 AppDbContext，可与 DcEmployee、DcModel 等 LINQ 连表。
- 不修改平台内核源码，升级时仅需更新 IntegrationPlatform.* 包版本。
典型代码结构（概念）：
5.3前端二开模式
- package.json 引用商用 tgz：@integration-platform/ui、bi、report、codegen。
- createPlatformRouter 注入二开路由；平台布局路由可按需开启（系统设置、基础数据）。
- 业务页面 meta.pageName 与菜单名一致，自动对接按钮权限（增删改查）。
- 商用 webpack 垫片确保 dist 包在宿主工程中稳定运行，无需暴露平台源码。
5.4菜单与权限一体化
二开新功能只需：在 T_SYS_MENU 增加菜单 → 执行权限修复或 SQL 种子 → 角色授权。前端 pageName 与菜单中文名对齐即可自动获得按钮级权限控制，无需重复造轮子。
5.5参考落地：MOM制造运营管理
以 MOM（制造运营管理）为样板工程：在集成平台底座之上扩展 MES 业务 API（如停机原因、工艺管理等），前端以商用 npm 包为壳，业务路由与页面独立在 Topaut.Web 中维护。该模式证明了：
- 平台内核与行业应用仓库可分离。
- 多模块（BI + 报表 + 在线编程）可与 MES 业务共存。
- 现场可通过 license 控制模块可见性与 API 暴露范围。
六、商用交付与版本体系
交付物 | 说明 | 当前版本 |
后端 NuGet | Core + Extensions.*，输出至 artifacts/nupkg | 2.0.0 |
前端 npm tgz | ui / bi / report / codegen 商用 dist | 2.0.0 |
宿主样板 | IntegrationPlatform.Host.Api、frontend、MOM/Topaut.* | 随仓库提供 |
授权工具 | IntegrationPlatform.KeyGen 生成 .lic | 模块级授权 |
打包脚本 | pack-commercial.ps1、pack-npm-commercial-dist.ps1 | 一键 CI 产出 |
商用交付的核心原则：客户拿到的是「可运行宿主 + 授权模块包」，而非平台全部源码，从而保护知识产权，并降低客户侧误改内核的风险。
七、建设收益分析
7.1对软件厂商 /集成商
收益项 | 说明 | 量化参考 |
缩短立项交付周期 | 权限/菜单/主数据/登录免开发 | 首版可节省 4~8 人周 |
提高方案复用率 | 多行业项目共用同一底座 | 2~3 个项目后即可摊薄平台成本 |
商业化报价清晰 | 平台费 + 模块 license + 二开人天 | 便于标准价目表 |
升级路径明确 | 换包升级，而非合并源码 | 降低年度维保成本 |
工具链溢价 | BI/报表/低代码作为高毛利模块 | 提升单客 ARPU |
7.2对制造企业 IT部门
- 统一账号权限体系，减少「一个系统一套管理员」的运维负担。
- 工厂模型与组织主数据一次维护、多处复用。
- 现场看板、统计报表、表单扩展可在平台工具内配置，降低对供应商的频繁定制依赖。
- 授权与模块边界清晰，便于分阶段投资（先 MES 核心，后 BI 大屏）。
7.3对项目决策层（ROI视角）
将数字化投资从「重复建设基础设施」转向「投资业务闭环」：
- 第一年：平台底座 + 核心业务（如生产执行、质量管理）上线。
- 第二年：叠加 BI 驾驶舱、报表中心，实现可视化管理。
- 第三年：通过在线编程支撑工艺变更、表单变更，提升业务响应速度。
平台化建设使每一期投资都沉淀为可复用资产，而不是一次性工程费用。
八、典型实施路径（建议）
阶段 | 周期（参考） | 工作内容 | 交付成果 |
P0 底座部署 | 1~2 周 | 安装平台、授权、主数据初始化 | 可登录的管理台 |
P1 核心业务二开 | 4~8 周 | MES/工艺/SOP 等行业模块 | 可上线业务系统 |
P2 可视化 | 2~4 周 | BI 大屏 + 报表 | 车间看板、管理报表 |
P3 扩展工具 | 按需 | 在线编程、接口扩展 | 快速应对工艺变更 |
P4 运维升级 | 持续 | 平台包升级、license 续期 | 长期可演进系统 |
九、技术规格摘要
项目 | 规格 |
后端框架 | .NET 8 Web API + EF Core 8 |
前端框架 | Vue 2.7 + Element UI + Vuex + Vue Router |
数据库 | MySQL（默认），支持 SQL Server / PostgreSQL / Oracle / SQLite |
认证 | JWT |
API 文档 | Swagger，按平台 / BI / 报表 / 在线编程 / MES 分组 |
授权 | 硬件绑定 + AES 加密 license 文件 + 模块 license |
二开扩展 | IPlatformModule + 共用 AppDbContext + npm 路由注入 |
十、合作与下一步
韬煜集成平台已在内部产品（制造运营管理 MOM）与多个模块场景中验证「底座 + 二开」模式。我们面向以下合作方式开放：
- 平台 License 采购 + 模块选配（BI / 报表 / 在线编程）。
- 基于底座的行业解决方案联合交付（MES、WMS、能源、质量等）。
- OEM / 白标合作：集成商以自有品牌交付，内核由韬煜维护升级。
技术培训：宿主搭建、模块引用、二开规范与商用打包流程。
