# lumin
**Repository Path**: xfcode-source/lumin
## Basic Information
- **Project Name**: lumin
- **Description**: Lumin 是基于Java构建的标准化企业级开发平台,以「技术自主可控、开发规范高效」为核心目标,通过模块化架构设计和AI赋能,助力企业快速搭建高可靠、可扩展的业务系统,实现数字化转型的敏捷落地。
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://www.xfcode.com
- **GVP Project**: No
## Statistics
- **Stars**: 191
- **Forks**: 93
- **Created**: 2015-10-16
- **Last Updated**: 2026-05-12
## Categories & Tags
**Categories**: backend
**Tags**: None
## README
lumin-开源的标准化企业级系统开发平台
"呦呦鹿鸣,食野之苹。我有嘉宾,鼓瑟吹笙"
### 愿景
成为企业数字化转型的首选技术底座,让每一行代码都承载商业价值。
### 核心精神
**分享** - 开源共享,共同成长
**和谐** - 架构优雅,协作顺畅
**召唤** - 聚沙成塔,群策群力
**共鸣** - 技术相通,价值共创
---
lumin是基于Java构建的标准化企业级开发平台,以「技术自主可控、开发规范高效」为核心目标,通过模块化架构设计和AI赋能,助力企业快速搭建高可靠、可扩展的业务系统,实现数字化转型的敏捷落地。
### 技术全景图
#### 全栈技术体系
- 移动端:V3+Uniapp跨端方案,集成Uview组件库
- PC前端:Vue3+Element Plus渐进式框架
- 后端架构:Spring Boot 3.x + Mybatis Plus + Spring Security 6
- 核心中间件:Redis 7.x + JWT + Flowable工作流引擎
- 智能扩展:GPT-4集成/OCR图像识别/AI辅助开发
#### 特色功能支撑
- 实时通信:WebSocket消息中枢
- 数据可视化:ECharts+DataV双引擎支持
- 云端存储:多厂商OSS统一接入(阿里云/腾讯云)
- 企业级报表:IReport动态报表+kkFileView全格式预览
- 安全体系:OAuth2.0授权/多因子认证/数据权限控制
### 核心特性
#### 标准化开发范式
- 📐 代码生成器:零编码生成CRUD前后端代码(支持Java/XML/SQL)
- 🧩 动态表单构建器:可视化拖拽生成业务页面
- 🔗 智能API文档:基于代码注释自动生成OpenAPI规范
#### 企业级管控能力
- 🔒 四维权限体系:菜单权限/操作权限/数据权限/接口权限
- 🛡️ 安全审计矩阵:操作日志/登录追踪/会话监控三合一
- ⚙️ 性能优化看板:连接池监控/SQL分析/缓存治理
#### 智能化扩展
- 🤖 GPT深度集成:智能文档生成/数据报告分析/代码辅助
- 👁️ 计算机视觉:OCR文字识别/商品图像智能解析
- 💳 支付中台:微信+支付宝+银联统一支付网关
### 功能模块矩阵
#### 基础支撑层
- 组织架构:用户/部门/岗位的多维度权限映射
- 系统配置:动态参数/数据字典/公告管理
- 日志中心:操作审计/异常追踪/登录画像
#### 效能工具集
- 流程引擎:BPMN 2.0标准流程设计器
- 定时调度:分布式任务管理+执行日志
- 数据库兼容:MySQL/PostgreSQL双驱动支持
#### 智能应用层
- 大屏数据中台:DataV可视化编排系统
- 协同办公套件:在线文档/即时通讯
- AI实验室:模型训练/智能问答/知识库
### 前端地址
* 移动版
https://gitee.com/xfcode-source/lumin-uniapp
* pc版本
https://gitee.com/xfcode-source/lumin-web
### LuminPro 商业增强版
**LuminPro** 是 Lumin 的企业级商业增强版本,深度融合 CRM、智能开单、仓储物流等核心业务模块,助力企业实现数字化转型与商业价值最大化。
👉 [点击查看 LuminPro 详细介绍](lumin-pro.md)
### 💡 选型建议
- **Lumin (开源版)**:适合需要标准化后台管理框架、侧重内部行政管理或拥有较强研发团队进行二次开发的项目。
- **LuminPro (企业版)**:适合需要快速落地复杂商业业务(如销售开单、WMS、巡检)、涉及多场景协同或需要构建 SaaS 平台的企业。
📝 [查看完整版本对比与选型指南](VERSION_COMPARISON.md)
### 版本功能对比
| 功能模块 | Lumin (开源版) | LuminPro (企业版) |
| :--- | :---: | :---: |
| **基础架构** | Spring Boot 3 + Vue3 | 同左,支持微服务化部署 |
| **核心业务** | 系统管理、代码生成、工作流 | 包含开源版所有功能 |
| **客户管理 (CRM)** | ❌ | ✅ 线索/客户/公海/销售漏斗 |
| **智能开单 (Mall)** | ❌ | ✅ 移动开单/库存联动/业绩统计 |
| **仓储管理 (WMS)** | ❌ | ✅ 扫码出入库/盘点/调拨/库龄分析 |
| **智能巡检** | ❌ | ✅ 路线规划/扫码打卡/异常闭环 |
| **合同管理** | ❌ | ✅ 模板创建/审批/执行/归档 |
| **物流运输 (TMS)** | ❌ | ✅ 路线规划/运费结算/实时追踪 |
| **车队管理** | ❌ | ✅ 车辆/司机/维修/油耗管理 |
| **即时通讯 (IM)** | ❌ | ✅ WebSocket 实时消息推送 |
| **多租户支持** | ❌ | ✅ 数据隔离/租户管理 |
| **IoT 物联网** | ❌ | ✅ 设备管理/告警/地理围栏 |
| **AI 智能增强** | 基础集成 | ✅ GPT深度集成/OCR/智能解析 |
| **技术支持** | 社区支持 | ✅ 专属技术支持/定期升级 |
### 项目结构
```
lumin/
├── lumin-admin # 主应用启动模块
├── lumin-common # 通用工具与核心组件
├── lumin-framework # 框架核心(安全、数据源、切面等)
├── lumin-system # 系统管理模块(用户、角色、菜单等)
├── lumin-quartz # 定时任务模块
├── lumin-generator # 代码生成器模块
├── lumin-flowable # 工作流引擎模块
├── lumin-ai # AI 智能服务模块
├── lumin-kb # 知识库模块
├── lumin-infrastructure # 基础设施层(OSS、短信等)
└── doc # 数据库脚本与配置文件
```
### 快速开始
#### 环境要求
- JDK >= 1.8 (推荐 JDK 17/21)
- Maven >= 3.6
- MySQL >= 5.7 或 PostgreSQL >= 13
- Redis >= 6.0
- Node.js >= 16 (前端开发)
#### 后端启动
1. 创建数据库 `lumin` 并执行 `doc/数据库文件(SQL)/flowable_6.7.2_mysql.sql` 和 `doc/数据库文件(SQL)/source-vue.sql`
2. 修改 `lumin-admin/src/main/resources/application.yml` 中的数据库和 Redis 配置
3. 运行 `LuminAdminApplication.java` 启动后端服务
#### 前端启动
1. 进入前端项目目录(见下方前端地址)
2. 执行 `npm install` 安装依赖
3. 执行 `npm run dev` 启动开发服务器
---
### 应用场景
#### 企业管理系统(ERP)
* 演示系统:erp.xfcode.com
* 账号密码:请联系管理员
#### 生产管理系统(MES)
* 演示系统:mes.xfcode.com
* 账号密码:请联系管理员
#### 仓库管理系统(WMS)
* 演示系统:wms.xfcode.com
* 账号密码:请联系管理员
#### 运输管理系统(TMS)
* 演示系统:erp.xfcode.com
* 账号密码:请联系管理员
#### 客户管理系统(CRM)
* 演示系统:crm.xfcode.com
* 账号密码:请联系管理员
#### 物联网平台(IOT)
* 演示系统:iot.xfcode.com
* 账号密码:请联系管理员
### QQ交流群
| 2群(140586555) |
| :------: |
|
|
### 结语
欢迎一起探讨,如果您觉得还可以,您可以给我点一个star