# 星云ERP

**Repository Path**: boboliao/xingyun

## Basic Information

- **Project Name**: 星云ERP
- **Description**: 星云ERP基于SpringBoot框架，为中小企业提供完全开源、永久免费、用户体验好的进销存ERP系统，解决开店难、管理难、数据统计难的问题，实现业务线上化、透明化、简易化管理的目标。本版本星云ERP专注于进销存管理和财务管理，主要包括基础信息管理、商品中心、采购管理、销售管理、零售管理、库存管理、盘点管理、结算管理等，各业务模块均支持参数配置。同时支持对部门、角色、权限等进行精细化管理。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://www.lframework.com
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 863
- **Created**: 2025-07-14
- **Last Updated**: 2025-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

**项目代码开源免费可商用 遵循开源协议即可**

**过去、现在和未来都不会有商业版！！！**

### 项目介绍

星云ERP基于SpringBoot框架，为中小企业提供完全开源、永久免费、用户体验好的进销存ERP系统，解决开店难、管理难、数据统计难的问题。星云ERP主要包括基础信息管理、商品中心、采购管理、销售管理、零售管理、库存管理、盘点管理、结算管理等，各业务模块均支持参数配置，满足实际遇到的各种业务场景。丰富的报表模块支持用户做各项数据分析。同时支持对部门、角色、用户、权限等进行精细化管理。最终，达到业务线上化、透明化、简易化管理的目标，实现物流、资金流、信息流的一体化管控。

### 开源协议说明
> **已申请软著，您如果需要修改源码或者二开，需要注意以下几点：**
> * 请不要删除和修改根目录下的LICENSE文件。
> * 请不要删除和修改源码头部的版权声明。
> * 本项目代码可免费商业使用，商业使用请保留源码和相关描述文件的项目出处、作者声明等。
> * 分发源码时，请注明软件出处 https://www.lframework.com/
> * 不可二次分发开源参与同类竞品。
#### 具体说明
> * 不可二次分发开源参与同类竞品指的是：不可以基于本项目代码二开后再进行开源。
> * 分发源码时，注明软件出处的目的：分发源码时，接收源码的人也需要知晓上述的注意事项，所以要注明软件出处。
> * 允许改包名，但是不要删除源码和相关描述文件的项目出处、作者声明等信息。

### 单体架构

集成常用的SpringBoot、MybatisPlus等框架，更利于上手使用或二次开发。

### 演示环境地址

星云ERP平台地址：http://erp.lframework.com   <a href="http://erp.lframework.com" target="_blank">
点此进入</a>

### 底层框架源码

底层框架源码：https://gitee.com/lframework/jugg   <a href="https://gitee.com/lframework/jugg" target="_blank">
点此进入</a>

### 前端项目源码

前端项目源码：https://gitee.com/lframework/xingyun-front   <a href="https://gitee.com/lframework/xingyun-front" target="_blank">
点此进入</a>

### 后端开发的一些约定
* cacheName不使用{}
* 主库的名称为master
* 创建子线程时使用DefaultCallable或DefaultRunnable包装

### 关于多租户
application.yml中的tenant.enabled改为true则代表开启多租户模式；false则代表关闭多租户模式。
虽然开启和关闭多租户是由配置文件控制，但是由于两种模式数据库结构不同，不支持正在运行中的系统修改租户模式。

### 使用说明文档

星云ERP说明文档：https://www.lframework.com   <a href="https://www.lframework.com" target="_blank">点此进入</a>

### 为什么将代码分了这么多仓库？ 全部放在一个仓库里面不是更方便吗？

因为这些代码全部放在一个仓库的话，会导致这个仓库的文件占用很大，并且有些代码可能您并不需要，所以分了几个仓库，这样选择性下载代码，速度更快、体验更好。

### 系统功能

| 系统功能 | 功能描述                        |
|------|-----------------------------|
| 系统管理 | 系统设置、菜单、部门、角色、用户、操作日志       |
| 基础信息 | 仓库、供应商、客户、会员基础信息            |
| 商品中心 | 商品主数据、商品分类、品牌、属性（自定义属性）     |
| 采购管理 | 采购订单、收货单、退货单                |
| 销售管理 | 销售订单、出库单、退货单                |
| 零售管理 | 零售出库单、退货单                   |
| 库存管理 | 商品库存                        |
| 库存盘点 | 盘点参数设置、预先盘点单管理、盘点任务管理、盘点单管理 |
| 库存调整 | 库存调整原因管理、库存调整               |
| 结算管理 | 供应商费用单、预付款单、对账单、结算单、收入/支出项目 |
| 代码生成 | 生成增删改查代码                    |
| 多租户  | 支持多租户                       |

### 主要技术框架

* Springboot 2.2.2.RELEASE
* MyBatis-plus 3.4.2
* Spring-session-data-redis 2.2.0.RELEASE
* HuTool 5.7.17
* Lombok 1.18.10
* EasyExcel 2.2.10（内置了两种导出excel方式：一次性导出、分段导出（只支持简单表头））

### 开发环境

* JDK 1.8
* Mysql 5.7.18
* Redis 4.0.8（版本可以根据自己的redis进行调整，项目本身依赖Redis的功能很简单，就是两部分：缓存、Session，不会出现大的兼容问题）
* RabbitMQ 3.12.4

### 技术交流

QQ交流群号： **717574596（已满员）** **562654879**

### 注意事项

项目依赖的底层框架全部封装成starter，关于这部分的代码详见：<a href="https://gitee.com/lframework/jugg" target="_blank">点此进入</a>

### License

项目使用Apache 2.0许可证，请遵守此许可证的限制条件。

### 集成第三方库

<a href="https://gitee.com/dromara/sa-token" target="_blank">Sa-Token</a> 统一用户鉴权

<a href="https://gitee.com/xiaoym/knife4j" target="_blank">knife4j</a> knife4j是为Java MVC框架集成Swagger生成Api文档的工具

<a href="https://github.com/xaboy/form-create" target="_blank">FormCreate</a> 强大的动态表单生成器

<a href="https://gitee.com/dromara/warm-flow" target="_blank">Warm-Flow</a> Dromara Warm-Flow国产工作流引擎