🚀 iBiz 模型体系：模型驱动应用开发的基石

在 iBiz 体系中，传统软件开发中的 数据结构、业务规则、用户交互、工作流程、AI/BI 分析 都被统一抽象为 模型对象。

使命：让企业软件开发更简单、更智能、更高效。
理念：通过创新的模型体系，将业务需求转化为可视化、可配置的模型元素，实现 「一切皆模型」 的开发方式。

这些模型不仅支持 静态代码生成，还能驱动 动态运行时解释执行，并可进一步 自动发布文档，实现 「代码、运行、文档三合一」 的价值闭环。 借助这一体系，开发者可以摆脱繁琐编码，确保系统文档与实现一致，真正聚焦于业务创新与价值交付。

🏗️ 体系架构与设计原则

iBiz 模型体系采用 分层架构，核心位于 net.ibizsys.model 包下。 顶层是 系统模型（IPSSystem），向下分层包括：

• 应用层（app）
• 数据层（dataentity）
• UI 层（control & view）
• 逻辑层（logic）
• 扩展层（ai, bi, wf 等）

这种设计确保 高内聚、低耦合，便于模块独立演进与横向扩展（如新插件、第三方服务集成），而不影响核心逻辑。

开源代码仓库

🌟 模型的多重价值

iBiz 模型既能 解释执行 ibiz-service-runner（实时灵活），也能 代码生成 ibiz-code-generator（稳定可控），并支持 文档发布（知识传递）。

🔹 解释执行（ibiz-service-runner）

• 模型文件直接解析运行，无需编译，修改后立即生效
• 适合快速原型、实验、热部署
• 支持 A/B 测试 与 在线实验

🔹 代码生成（ibiz-code-generator）

• 模型结合模板生成 标准代码（Java、Groovy、Vue 等）
• 前后端代码一致，便于交付与二次开发
• 代码可优化，支持 静态分析 与 性能调优

🔹 文档发布（ibiz-doc-generator）

• 模型结合模板生成 项目文档（Markdown、Docsify、vitepress 等）
• 模型即文档：代码与文档共源，修改模型即可同步更新文档
• 支持接入团队门户或在线文档平台，实现 一键发布与持续交付

📐 设计原则详解

• 统一性：所有组件继承自 IPSModelObject，保证一致接口（load()、validate()），支持 JSON/XML 热加载。
• 插件化：支持外部插件（DB、MQ、缓存…），核心精简，外围功能可灵活扩展。
• 安全治理：内置权限、审计、多租户隔离，支持流程监控与 AI 治理代理。
• 标准兼容：支持 OpenAPI3、JSON Schema、REST/GraphQL，便于与微服务、K8s、第三方 API 集成。

👉 该架构符合 MDD 标准，并融合 云原生原则（容器化部署、弹性扩展），帮助开发者专注业务逻辑，同时提升生产力与可持续性。

🔑 核心模块详解

以下模块按目录结构分组，列出主要接口、职责与实现类。

1️⃣ 系统与应用模块（system & app）

负责全局配置、模块管理与资源协调，定义系统骨架。
支持多租户、国际化、动态加载与模块融合。

组件接口/类	说明	典型实现类
IPSSystem	系统模型顶层，支持版本管理、多系统引用	PSSystemImpl
IPSApplication	应用模型，含多语言、模块划分、资源管理	PSApplicationImpl

2️⃣ 数据实体模块（dataentity）

业务数据建模核心，处理 实体定义、关系、数据操作。
支持 CRUD、复杂查询、聚合、事务与一致性检查。

组件接口/类	说明	典型实现类
IPSDataEntity	数据实体核心，定义属性、生命周期、行为	PSDataEntityImpl
IPSDEField	字段类型（公式、拾取、值规则等）	PSDEFieldImpl
IPSDERBase	实体关系基类（1:1、1:N、继承等）	PSDERBaseImpl
IPSDEDataSet	数据集，支持参数输入与过滤	PSDEDataSetImpl
IPSDELogic	业务逻辑（决策、循环、参数绑定）	PSDELogicImpl

3️⃣ UI 控件与视图模块（control & view）

用户交互核心，支持 响应式布局、事件驱动、跨设备一致性。

组件接口/类	说明	典型实现类
IPSAppView	视图基类（索引、门户视图）	PSAppViewImpl
IPSControl	控件基类，支持属性与逻辑绑定	PSControlImpl
IPSDEForm	表单控件（分组、表单项）	PSDEFormImpl
IPSDEGrid	表格控件（列分组、编辑）	PSDEGridImpl
IPSChart	图表控件（多轴、柱状等）	PSChartImpl
IPSDashboard	仪表盘，支持 Portlet、过滤器	PSDashboardImpl

4️⃣ 工作流模块（wf）

支持 BPMN-like 流程建模，集成用户交互与定时事件，确保流程可靠执行。

组件接口/类	说明	典型实现类
IPSWFProcess	流程节点（并行网关、调用活动）	PSWFProcessImpl
IPSWFLink	流程链接（条件表达式、角色绑定）	PSWFLinkImpl
IPSWorkflow	完整工作流，支持版本管理	PSWorkflowImpl

5️⃣ AI & BI 模块（ai & bi）

为系统注入 智能与洞察，支持 AI 推理、BI 报表与多维分析。

组件接口/类	说明	典型实现类
IPSAIChatAgent	AI 聊天代理	PSSysAIChatAgentImpl
IPSAIPipelineAgent	AI 管道与 Worker	PSSysAIPipelineAgentImpl
IPSBICube	BI 立方体（层次、度量）	PSSysBICubeImpl
IPSBIReport	BI 报告（维度、指标）	PSSysBIReportImpl

6️⃣ 服务与扩展模块（service & res）

聚焦 API 暴露、插件扩展、资源管理，构建体系与外部生态的连接桥梁。

组件接口/类	说明	典型实现类
IPSSubSysServiceAPI	子系统 API，支持方法输入/输出	PSSubSysServiceAPIImpl
IPSSysContent	内容资源与分类	PSSysContentImpl
IPSSysPFPlugin	插件框架，支持自定义逻辑	PSSysPFPluginImpl

📖 更多模型说明：详细文档

⚙️ 典型消费场景

代码发布：springboot

使用 Maven 插件发布模型代码：

mvn cn.ibizlab.plugin:ibizlab-generator-plugin:2.0.7:code \
  -Doutput=./plm-code \
  -DinputSpec=../plm/model \
  -DembedTemplates=cn.ibizlab.plugin:ibizlab-template-ibizedge:2.6.1.P2

参数说明：

• 发布器maven插件：cn.ibizlab.plugin:ibizlab-generator-plugin:2.0.7

• 模板：cn.ibizlab.plugin:ibizlab-template-ibizedge:2.6.1.P2 一个典型的springboot系统工程模板，模板源码

• inputSpec：模型目录

• output：代码发布目标目录

代码发布：groovy

使用 Maven 插件发布模型代码：

mvn cn.ibizlab.plugin:ibizlab-generator-plugin:2.0.7:code \
  -Doutput=./plm-code \
  -DinputSpec=../plm/model \
  -DembedTemplates=cn.ibizlab.plugin:ibizlab-template-groovy:1.0.1

参数说明：

• 发布器maven插件：cn.ibizlab.plugin:ibizlab-generator-plugin:2.0.7

• 模板：cn.ibizlab.plugin:ibizlab-template-groovy:1.0.1 ibiz-service-hub的最轻groovy调试工程模板，模板源码

• inputSpec：模型目录

• output：代码发布目标目录

文档生成：docsify

mvn cn.ibizlab.plugin:ibizlab-generator-plugin:2.0.7:doc \
  -Doutput=./plm-doc \
  -DinputSpec=../plm/model \
  -DembedTemplates=cn.ibizlab.plugin:ibizlab-template-docsify:1.0.63

参数说明：

• 发布器maven插件：cn.ibizlab.plugin:ibizlab-generator-plugin:2.0.7

• 模板：cn.ibizlab.plugin:ibizlab-template-docsify:1.0.63 docsify文档模板，模板源码

• inputSpec：模型目录

• output：文档发布目标目录

✨ 通过 iBiz 模型体系，您可以在 低代码灵活性 与 高代码可控性 之间自由切换，加速企业级软件的开发与治理。