← 返回首页 / Back

FIS 企业级套件 · ERP / CRM / OA / 流程中台

四个独立部署的 NestJS 全栈系统,共享同一套可嵌入工作流引擎(源码单源分发)。前端均为独立 SPA,通过 JWT 访问各自 API;CRM 与 ERP 之间走 REST + SSO 免登。低代码能力整体对标钉钉 / 飞书 / 泛微 / 简道云。

4子系统 · 独立部署
6+1前端应用 + 流程设计器
3/3业务系统已内嵌工作流引擎
17ERP 单据类型(docType)
62 项对标矩阵能力已落地

① 总架构 四个系统 · 一个引擎

共享工作流引擎 fis-workflow v1.3.0-fis 以「源码单源分发」方式内嵌进三个业务系统:引擎源码只有一份(scripts/sync-engine.sh 整目录同步),禁止散改;业务系统通过 SPI 挂接点接入身份与单据回调。

用户接入层 · 6 前端应用 + 1 设计器(独立 SPA) ERP PC ERP H5 CRM PC CRM H5 OA Vue3 设计器 fis-erp · 通用 ERP 内核 4S 汽车 + 多行业 · 17 docType fis-crm · 医疗器械 CRM IVD / 影像设备 · 行业合规硬闸 fis-oa 协同办公 fis-workflow 工作流引擎 源码单源分发 · embed() 内嵌 · SPI 挂接 JWT 认证 · SSO 免登 · REST /agent/invoke 互通 · 4 MySQL + Redis

互通与身份

JWT + Passport(local/JWT 策略)统一认证;CRM ↔ ERP 走 REST /agent/invoke + SSO 换票免登。
多租户:tenant 模块 + 租户装包(tenant-pack),一套代码多组织隔离运行。

引擎分发铁律

引擎源码唯一:sync-engine.sh 整目录同步到 ERP / CRM / OA,版本 WF_ENGINE_VERSION 统一升级,禁止散改。
attach() 于 onModuleInit 回填(构造期耦合会 DI 死锁);published 定义不可改图,改动必须 version +1。

② fis-erp 通用 ERP 内核 12 内核引擎 + 13 业务包

平台地基(modules)+ 内核引擎(kernel)+ 业务包(packs)三层:单据引擎驱动 17 种 docType,Agentic ERP 让 Agent 成为第一操作者。

内核引擎 kernel/(12)

document单据引擎:create/submit/approve/reject/post/reverse/discard 全生命周期
metadata动态实体/字段/记录,替代 form-designer 的低代码底座
event-busoutbox → Bull → dispatch,重试 5 次进死信
gl总账与凭证(gl.voucher.posted)
agentAgentic ERP:Agent 第一操作者 + 定时调度 + 异常扫描
doc-ai单据 AI 能力
permissionRBAC 权限(perm_role)
report报表 + 驾驶舱每日快照
wf-engine内嵌工作流引擎 + SPI 三件套

业务包 packs/(13)

4s整车 / 服务工单 / 索赔 / 会员 / 套餐
sales订单 / 发货 / 发票 3 docType
purchase采购订单 / 收货 / 发票
inventory出入库 / 调拨 / 盘点 / 报废
wms仓储收货 / 发运
mrpBOM / MRP / 生产工单
finance应收 / 科目 / 凭证 / 余额 / 期间 / 预算 / 成本
asset固定资产
md医疗器械:首检 / 召回,证照效期扫描 02:00
integration出站集成网关 + SAP 适配器

平台地基 modules/

authJWT + Passport(local/JWT 策略)
tenant多租户管理
organization组织与分支
user用户与角色
system系统配置 /system/configs

前端与运行时

PCVue3 + Element Plus,68 路由 / 66 页面 · 16 菜单组
H5React18 + antd-mobile:移动审批 / 驾驶舱
cron定时任务 ×7(证照扫描 / 快照 / 死信重投等)
docType17 种单据类型,manifest 声明式注册

③ fis-crm 医疗器械行业 CRM IVD / 影像设备 · 行业硬闸

围绕「获客 → 交易 → 交付 → 合规」医疗器械业务闭环:证照过期冻结开单、两票制硬闸、UDI 追溯、不良事件 CAPA、监管直报,行业规则内建为系统闸门而非人工约定。

获客与商机

lead线索 + 公海回收(每日 02:30)
customer客户主档 / 360° 视图 / 决策链图谱
bid招投标:保证金跟踪 / 中标率分析
opportunity商机漏斗:阶段状态机 / 赢率 / 竞对
quote报价单:证照硬闸 + 过期 cron(01:00)

交易与收款

order订单提交推送 ERP(单号回写 / 幂等闸)
contract合同:法务/财务/合规三角色评审 + 两票制硬闸
receivable应收 / 回款登记 → ERP 核销
quota销售指标

交付与服务

device装机台账 / 序列号 / 补货预测(90 天外推)+ 复购商机 cron
ticket售后工单:SLA 违约红染(30min 扫描)
pm预防性维护:逾期自动开工单(06:20)
udiUDI 追溯:DI/PI / 事件时间线 / 召回圈定

合规与风控(行业硬闸)

license证照效期 180/90/30 三级预警,过期冻结开单(02:00)
adr不良事件:严重度分级 / 立案停用设备 / CAPA 闭环
regreport监管直报:严重 7 日报国家局 / 一般 30 日报省局
dealer经销商分层 / 两票制 / 流向登记(02:20 扫证照)
audit@Audit 装饰器 + 全局拦截器

协同与运营

visit拜访 / H5 GPS 签到 / KOL 合规审计(月度)
todo每日待办派发(08:00)
weekly周报:周五 17:00 催交,可挂流程批阅
H5企微挂载 20 路由

前端

PCReact18 + antd v5,29 路由 / 30 页面
H5移动端 · 企微工作台免登

④ fis-oa 协同办公系统 低代码 · 引擎接入参考实现

请假 / 报销 / 用章 / 出差 / 采购 / 会议室 / 公告 / 自定义表单 / 统一审批中心,7 套流程定义 wf-seed 幂等种入;低代码能力(公开表单 / 超时催办 / 报表中心 / 数据预警 / 文档中心)对标钉钉 / 飞书 / 泛微 / 简道云,对标矩阵 62 项已落地。

业务模块 modules/(9)

leave请假:额度冻结 → 扣减闭环
expense报销
seal用章申请
travel出差申请
purchase办公采购
meeting会议室 + 预订(含提醒 cron)
announcement公告
form自定义表单 + FormDesigner + 数据源 / 导出
approval-center统一审批中心:inbox/mine/inst/act/bulk/cancel/restart/urge

低代码与运营能力(对标钉钉 / 飞书)

公开表单/f/:token 免登录填报 + IP 频控 + 名额 + 过期
报表中心聚合查询 + CSS 图表
数据预警阈值 + cooldown + cron 推站内信 + 试算页
超时催办审批超时自动催办 / 升级
文档中心目录树 + 可见性 + latin1 文件名修正
Excel 导入业务数据批量导入
开放 APIapikey 开放接口
移动端≤768px 汉堡抽屉自适应

⑤ fis-workflow 流程中台 可嵌入引擎 + 可视化设计器

既是独立系统(REST /api/wf/* + 设计器 :3500),又是被三个业务系统内嵌的引擎内核。提交即 wf.start(),bizData 为提交时快照,在途审批不受单据后续修改影响;幂等闸防重复发起。

引擎能力(核心)

节点 ×6start / approval / service(预留)/ exclusive 排他 / parallel 并行 fork+join / end
resolver审批人:role: / user: / dept_leader / initiator / field:payload.a.b
多人策略或签 any / 会签 all / 按比例 ratio
驳回策略回发起 to_start / 终止 to_end / 上一节点 to_previous
超时timeoutHours + 自动通过/驳回/提醒,提醒可升级 escalate(10min 扫描)
任务操作转办 / 加签 / 委托(wf_delegate_rule 期间委托)/ 撤回 / 催办(单条/批量)
实例操作挂起 / 恢复 / 重发起 / 取消 / 批量通过驳回
其他定义版本化 / 克隆 / 导入导出 / 模板市场 / 抄送 / 统计 / 幂等发起 / 多租户 / graphCache

SPI 挂接点与嵌入方式

IdentitySpiresolveRole / resolveDeptLeader / getUserNames / hasRole
BizCallbackonFinished 终态回调单据状态机 / onServiceNode / onNotify
embed()WorkflowEngineModule.embed() 一行接入,接入指南 embed-guide.ts
数据模型wf_def(租户+code+version 唯一,graph JSON)/ wf_inst / wf_task 等 ×6
Designer可视化流程设计器 Vue3(:3500),拖拽画图 → 发布版本
REST/api/wf/* 全量管理 API

落地进度

P0 · OA接入 + 引擎成熟 ✅
P1 · ERP高频单据先行 ✅
P2 · ERP全量切换 + 摘除旧引擎 ✅
P3 · CRM已挂接(混合态待收敛)
P4standalone host 升级为跨系统统一流程管理台(规划)

关键契约

发起wf.start({ bizType, bizId, bizNo, bizData }),快照隔离
幂等idempotent:true 同 bizType+bizId 已有 running 实例直接返回
终态approved/rejected/cancelled 与单据状态机一一映射(bizCallback)