JeecgBoot 从入门到精通

JeecgBoot 从入门到精通学习笔记

一、顶层认知：平台核心定位与核心理念（入门第一步）

1.1 平台核心定义

JeecgBoot 是一款企业级AI低代码开发平台，采用前后端分离架构，融合AI大模型能力与低代码开发模式，通过「AI生成->OnlineCoding->代码生成->手工MERGE」的全流程开发模式，解决Java项目80%的重复开发工作，兼顾开发效率与业务灵活性。

1.2 核心宗旨与设计理念

• 简单功能：通过OnlineCoding在线配置实现零代码开发，人人皆可快速搭建业务功能
• 复杂功能：通过代码生成器一键生成前后端代码，再通过手工Merge实现低代码开发
• 核心优势：解决传统低代码产品普遍存在的「灵活性不足」痛点，既保证智能化，又支持深度定制编码

1.3 核心适用场景

可应用于所有J2EE项目开发，全面支持信创国产化环境，尤其适配以下场景：

• 企业级管理系统：MIS、OA、ERP、CRM
• 互联网SAAS项目，支持多租户架构
• 企业AI应用快速构建与部署
• 国产化信创环境下的业务系统开发

1.4 开源协议与版权说明

• 开源版采用 Apache-2.0 开源协议，允许商业使用，可基于平台开展业务系统开发
• 禁止使用本软件开发与JeecgBoot形成竞争关系的产品
• 企业版提供额外技术支持与企业级高级功能，与开源版形成能力互补

二、入门准备：环境搭建与快速上手

2.1 环境要求

前端环境

后端环境

2.2 项目获取与资源地址

• 官方网站：http://www.jeecg.com
• 在线演示：平台演示、APP演示、零代码演示
• 源码地址：
  • Github：https://github.com/jeecgboot/JeecgBoot
  • Gitee：https://gitee.com/jeecg/JeecgBoot
• 技术支持：官方文档、视频教程、QQ交流群（964611995）

2.3 快速启动与体验

1. 环境校验：确认Node、JDK、MySQL、Redis环境符合版本要求
2. 项目初始化：拉取源码，后端导入IDEA，前端导入对应IDE
3. 数据库初始化：执行官方提供的MySQL脚本，完成库表初始化
4. 配置修改：修改后端数据库、Redis连接配置，前端接口地址配置
5. 项目启动：先启动后端服务，再启动前端项目
6. 系统访问：通过浏览器访问前端地址，使用默认账号密码登录系统，体验核心功能

三、核心架构体系：底层技术与架构设计

3.1 整体技术架构

前端技术栈

核心技术栈：Vue3.0 + TypeScript + Vite6 + Ant-Design-Vue4
配套生态：pinia + echarts + unocss + vxe-table + qiankun + es6
核心能力：二次封装组件、utils、hooks、动态菜单、权限校验、按钮级别权限控制

后端技术栈

3.2 系统分层架构

自顶向下分为6层，架构解耦，支持灵活扩展：

1. 展示层：PC端、WEB端、APP端、PAD端，全端适配
2. API接口层：API GateWay（防刷、鉴权），统一RESTful接口规范，集成Swagger在线接口文档
3. 业务应用层：基础模块（用户、部门、权限、字典等）、高级模块（OA、流程、大屏、在线开发等）
4. 服务治理层：消息队列、分布式任务、分库分表、分布式事务、监控预警、分布式锁等
5. 基础中间件层：Spring Boot、Spring Cloud、工作流引擎、报表引擎、WebSocket、MQTT等
6. 数据层：关系型数据库、Redis缓存、MinIO/OSS文件存储、MongoDB等

3.3 微服务架构能力

平台支持单体与微服务自由切换，满足不同规模项目需求，核心微服务组件：

• 服务注册与发现、统一配置中心：Nacos
• 路由网关：Gateway（支持三种加载方式）
• 熔断降级限流：Sentinel
• 分布式通信：OpenFeign
• 分布式文件存储：MinIO、阿里OSS
• 统一权限控制：JWT + Shiro
• 服务监控：SpringBootAdmin
• 链路追踪：Skywalking
• 分布式任务：xxl-job
• 分布式事务：Seata
• 容器化支持：docker-compose、k8s、jenkins
• 单点登录：CAS

3.4 数据库与信创兼容

主流数据库兼容

一套代码全兼容，默认提供MySQL脚本，其他数据库可通过官方转库文档适配：

• 关系型数据库：MySQL、Oracle11g、Sqlserver2017、PostgreSQL、MariaDB
• 国产化数据库：达梦、人大金仓、TiDB、kingbase8

全信创环境适配

• 操作系统：国产麒麟、银河麒麟等基于Linux内核的国产系统
• 中间件：东方通 TongWeb/TongRDS、宝兰德 AppServer/CacheDB
• 完整适配信创生态，为国产化环境提供高效开发解决方案

四、核心低代码能力（平台核心，精通必备）

4.1 Online在线开发（零代码核心）

Online模块是平台零代码能力的核心，无需编码，通过可视化配置即可完成全功能开发，核心能力：

1. Online在线表单
   • 无需编码，在线配置表单，实现增删改查全功能
   • 支持单表、树、一对多、一对一等数据模型
   • 内置23种控件，支持字段校验、权限控制、布局自定义
   • 支持AI建表，通过自然语言快速生成表单模型
2. Online在线报表
   • 零代码在线配置数据报表、图形报表，快速抽取业务数据
   • 支持主子表关联查询、高级组合查询，可保存查询历史
   • 查询过滤器自动生成，后台动态拼接SQL，支持全匹配、模糊查询、包含查询等多种匹配方式
3. Online在线增强
   • 内置在线代码编辑器，支持代码高亮、代码提示
   • 支持Java、SQL、JavaScript等多语言在线编写，实现业务逻辑自定义
4. 配套能力：仪表盘设计器、系统编码规则、系统校验规则，全流程零代码闭环

4.2 代码生成器（低代码核心）

平台核心效率工具，一键生成前后端代码，大幅降低重复开发工作量：

1. 核心能力
   • 支持单表、树列表、一对多、一对一等多种数据模型
   • 增删改查、导入导出、权限控制、页面校验等功能一键生成，菜单配置直接使用
2. 模板机制
   • 强大的自定义模板体系，支持用户自定义生成模板
   • 官方默认提供4套风格模板：单表2套、树模型1套、一对多3套
   • 新增uniapp3移动端代码生成器模板，一套代码多端适配
3. 自带能力
   • 生成代码自带Excel导入导出，支持单表、一对多表模式
   • 自动生成页面校验规则（必填、数字、金额、时间区间等）
   • 自动集成查询过滤器、高级查询器，无需额外编码

4.3 表单设计能力

1. 可视化表单设计器
   • 支持用户自定义表单布局，拖拽式配置，所见即所得
   • 支持单表、一对多表单，内置select、radio、checkbox、textarea、date、popup、列表、宏等丰富控件
   • 支持AI字段建议，通过自然语言快速生成表单字段与配置
   • 支持移动适配、外部填报，表单视图功能（日历、表格、看板、甘特图等）
2. 多表单解决方案：支持表单设计器、online配置表单、编码表单三种模式，适配不同业务复杂度

4.4 流程设计与工作流能力

基于开源Flowable流程引擎打造，实现流程与表单松耦合设计，大幅简化BPM开发：

1. 可视化流程设计
   • 在线画流程、自定义流程转向、流程节点配置
   • 支持会签配置、任务监听、执行监听、全局监听、流程表达式自定义
2. 流程与表单解耦
   • 流程节点可灵活挂靠表单，支持自定义表单、编码表单等多种表单模式
   • 扩展任务接口，支持开发者编写业务逻辑，兼顾标准化与个性化
3. 全流程管理能力
   • 流程实例管理、历史流程、任务管理、我发起的流程、我的抄送
   • 支持流程委派、抄送、跳转、驳回等高级操作
   • 提供简流设计器（类钉钉版），适配轻量化审批场景

4.5 报表与可视化能力

1. 积木报表设计器
   • 内置打印设计器、数据报表设计、图形报表设计（基于ECharts）
   • 支持报表打印、数据导出，一键生成PDF、Excel、Word等格式报表
   • 支持Excel模板导入，多级循环表头、分组报表、横向/纵向报表等复杂报表场景
2. 大屏与仪表盘设计
   • 拖拽式大屏设计器，内置丰富大屏模板，适配作战指挥中心、物流监控等场景
   • 仪表盘设计器，支持自定义门户、自定义系统首页，多种组合模式可选
   • 支持丰富的图表类型：柱形图、折线图、散点图、饼图、环形图、面积图、漏斗图、进度图、仪表盘、雷达图、地图等
3. 高性能表格组件：提供新行编辑表格JVXETable，适配复杂ERP布局，具备更高性能、更灵活的扩展能力

五、系统基础能力（二次开发必备基础）

5.1 RBAC权限体系

平台采用基于角色的访问控制（RBAC） 模型，实现精细化权限管控：

1. 功能权限：菜单权限、按钮权限，支持不同角色分配不同操作权限
2. 数据权限：精细化控制到行级、列表级、表单字段级，实现不同人看不同数据、不同人操作不同字段
3. 表单权限：控制字段禁用、隐藏，适配不同角色的表单操作场景
4. 接口权限：细化接口授权控制，基于AK/SK认证鉴权的OpenAPI能力，实现不同客户端的接口访问管控
5. 多租户权限：完整的SaaS多租户架构，支持租户管理、租户角色、租户数据隔离

5.2 系统管理核心模块

平台内置完善的系统管理能力，开箱即用，无需重复开发：

• 组织架构：用户管理、角色管理、部门管理、职务管理、通讯录
• 基础配置：菜单管理、字典管理、分类字典、系统公告、多数据源管理
• 二级管理员：我的部门管理，支持分级权限管控
• 多租户管理：租户管理、租户角色、我的租户，完整SaaS能力

5.3 通用工具与集成能力

平台封装了大量通用工具，覆盖80%以上的项目通用需求：

1. 通用工具类：定时任务、短信接口、邮件发送、Excel导入导出、文件上传管理
2. 文件存储：集成MinIO、阿里OSS，同时支持本地存储，分布式文件服务
3. 消息中心：支持短信、邮件、微信推送，集成WebSocket消息通知机制
4. 国际化：支持多语言，提供完整的国际化方案
5. 数据日志：记录数据每次变更内容，支持版本对比查看历史变化
6. 在线接口文档：集成Swagger-UI，统一RESTful接口规范，JWT token安全验证
7. 打印插件：简单易用，兼容谷歌、火狐、IE11+等主流浏览器

5.4 系统监控能力

全维度系统监控，实时跟踪系统运行状态：

• 性能监控：Redis、Tomcat、JVM、服务器信息、磁盘监控
• 请求追踪：全链路请求耗时监控、SQL监控
• 定时任务：在线配置、管理定时任务，支持cron表达式在线生成
• 系统日志：系统操作日志、数据变更日志、登录日志全记录
• 服务监控：SpringBootAdmin服务监控、Skywalking全链路追踪

六、AI赋能低代码（平台核心特色）

6.1 AI平台整体定位

JeecgBoot内置一套完善的AI应用管理系统，是类似Dify的AIGC应用开发平台 + RAG知识库问答系统，基于LLM大语言模型与RAG检索增强技术，帮助企业快速从原型到生产，落地AI服务能力。

6.2 核心AI能力

1. AI低代码全流程赋能
   • AI建表：通过自然语言一键生成Online表单与表结构
   • AI字段建议：表单设计器中通过AI快速生成字段配置与规则
   • AI写文章：内置CMS内容生成能力
   • AI报表：自然语言生成报表配置与查询SQL
2. AI对话与应用能力
   • AI对话助手：智能问答，支持图片理解，聊天窗口支持嵌入第三方、适配移动端
   • AI知识库问答系统：基于RAG的知识库管理，实现企业私有数据问答
   • AI流程编排与设计器：可视化编排AI工作流，实现复杂AI业务场景
   • AI OCR示例：内置文字识别能力
3. AI模型管理
   • 支持主流大模型：ChatGPT、DeepSeek、Ollama、智谱AI、通义千问等
   • 最新版默认使用DeepSeek大模型，兼顾速度与生成质量
   • 支持模型切换、模型配置管理，适配不同业务场景

七、进阶开发与二次开发（精通核心）

7.1 单体与微服务无缝切换

平台提供简易切换机制，一套代码同时支持单体与微服务架构：

• 中小项目：使用单体架构，部署简单、维护成本低
• 中大型项目：切换为微服务架构，支持分布式部署、水平扩展
• 官方提供Docker一键启动微服务前后端方案，降低部署难度

7.2 自定义业务开发

1. 代码生成+手工Merge模式
   • 基础增删改查功能通过代码生成器一键生成
   • 复杂业务逻辑在生成代码基础上进行手工扩展，不影响基础功能的迭代升级
   • 避免重复开发，同时保证业务逻辑的灵活性
2. Online在线增强开发
   • 零代码场景下，通过在线Java、JS、SQL编写，实现业务逻辑自定义
   • 支持表单事件、数据校验、业务钩子、接口扩展等场景
3. 自定义前后端组件
   • 前端：基于Vue3组件规范，自定义业务组件，集成到表单设计器与Online表单中
   • 后端：基于Spring Boot规范，自定义业务模块、工具类、接口，复用平台基础能力

7.3 工作流进阶开发

• 自定义任务接口：在流程节点中开发自定义业务逻辑，实现流程与业务深度集成
• 流程监听：执行监听、任务监听，实现流程节点的前置/后置业务处理
• 流程表达式：自定义流程条件表达式，实现复杂的流程分支流转规则
• 流程权限：自定义审批人规则、审批权限管控，适配企业复杂的组织架构与审批流程

7.4 高级集成能力

1. 多数据源集成：在线配置数据源，便捷从其他数据库抓取数据，支持跨库查询与报表开发
2. 单点登录集成：官方提供CAS单点登录集成方案，完善的对接代码，快速对接企业统一身份体系
3. 第三方系统对接：基于RESTful接口规范与OpenAPI能力，快速对接第三方业务系统
4. 物联网集成：支持MQTT协议，适配物联网设备数据接入与业务开发

八、全端适配能力

8.1 移动端全平台适配

平台提供成熟的移动端解决方案，一份代码多终端适配，覆盖：小程序、H5、安卓、iOS、鸿蒙Next。

• 新版APP框架技术栈：Uniapp、Vue3.0、Vite、Wot-design-uni、TypeScript
• 核心能力：二次封装组件、路由拦截、请求拦截，与JeecgBoot后端完美对接
• 内置功能：登录、用户信息、通讯录、公告、移动首页、九宫格、聊天、Online表单、仪表盘
• 低代码支持：移动端Online表单、仪表盘低代码设计，零代码生成移动端页面

8.2 桌面端适配

支持electron桌面应用打包，兼容Windows、Linux、macOS三大桌面平台，快速将Web系统打包为桌面客户端。

九、部署与运维（上线必备）

9.1 部署方案

1. 传统部署：手动部署前后端项目，适配Linux、Windows服务器
2. 容器化部署：Docker一键部署，官方提供docker-compose编排文件，快速搭建单机/集群环境
3. 云原生部署：支持K8s容器编排、Jenkins自动化CI/CD，适配企业级云原生环境

9.2 运维与监控

1. 系统监控：内置Redis、Tomcat、JVM、服务器、磁盘监控，实时掌握系统运行状态
2. 链路追踪：集成Skywalking，实现全链路请求追踪、性能瓶颈定位
3. 日志管理：支持轻量分布式日志Loki+grafana套件，集中化日志收集、查询、分析
4. 安全运维：接口限流、防刷机制，数据权限隔离，定期安全更新与漏洞修复

9.3 安全机制

• 身份认证：JWT + Shiro安全认证体系，支持多因素认证
• 数据安全：数据权限隔离、数据变更日志、数据加密存储
• 接口安全：接口鉴权、AK/SK认证、接口限流、防刷机制
• 代码安全：输入校验、SQL注入防护、XSS攻击防护
• 官方团队持续维护安全更新，修复已知漏洞，提供全面的安全解决方案

十、版本差异与生态支持

10.1 开源版与企业版核心差异

10.2 产品生态

• 敲敲云零代码平台：Jeecg团队研发的零代码产品，与JeecgBoot低代码平台形成互补，满足从简单业务到复杂系统的全场景开发需求
• 积木报表：开源报表工具，JeecgBoot内置，可独立使用，满足企业级报表需求
• 活跃的社区生态：官方文档、视频教程、交流群、技术博客，持续更新迭代

十一、从入门到精通的最佳实践

11.1 入门阶段（1-2周）

1. 完成环境搭建，成功启动前后端项目，熟悉系统整体界面与菜单
2. 体验Online表单功能，零代码完成一个单表的增删改查功能
3. 使用代码生成器，基于数据库表生成前后端代码，完成菜单配置与功能测试
4. 熟悉系统管理模块，掌握用户、角色、权限、字典的基础配置

11.2 进阶阶段（2-4周）

1. 掌握表单设计器的使用，完成一对多复杂表单的配置与业务开发
2. 学习流程设计器，完成一个完整的审批流程（请假/出差/报销）的配置与测试
3. 掌握积木报表与大屏设计，完成一个业务报表与可视化大屏的开发
4. 学习二次开发模式，基于代码生成器完成复杂业务逻辑的自定义开发
5. 熟悉平台权限体系，实现精细化的按钮权限与数据权限配置

11.3 精通阶段（1个月以上）

1. 掌握AI低代码全流程应用，实现AI建表、AI流程编排、知识库问答的落地
2. 掌握单体与微服务切换，完成微服务架构的项目搭建与部署
3. 掌握自定义组件开发，实现前后端自定义组件的封装与平台集成
4. 掌握工作流深度开发，实现流程与业务系统的深度集成
5. 完成信创环境适配，实现国产化系统的部署与运行
6. 掌握云原生部署，完成K8s环境下的集群部署、监控与运维

11.4 避坑指南

1. 环境版本必须严格匹配，尤其是Node.js、JDK版本，避免出现兼容性问题
2. 二次开发优先使用「代码生成+手工Merge」模式，避免直接修改平台底层源码，影响后续版本升级
3. 复杂业务流程优先做好表单与流程的解耦设计，避免强耦合导致的后续维护困难
4. 生产环境必须做好权限管控、数据备份、接口安全配置，避免安全风险
5. 优先使用官方提供的封装工具与组件，避免重复造轮子，同时保证系统稳定性