# lemon-erp
**Repository Path**: doutoo/lemon-erp
## Basic Information
- **Project Name**: lemon-erp
- **Description**: 柠檬ERP(Lemon ERP)开源 ERP 系统:进销存、生产制造 MES、仓储 WMS、财务、CRM、人力 HR、项目管理、BI,Spring Boot + Vue 3,支持 SaaS 多租户、审批流、微信小程序。Open-source ERP system with MES, WMS, CRM, HRM and accounting.
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 13
- **Created**: 2026-11-12
- **Last Updated**: 2026-11-12
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
柠檬ERP · Lemon ERP
真正 100% 开源、无功能限制的 ERP 系统
让企业经营像柠檬一样清新高效:进销存、生产、仓储、质量、财务、人力、客户、项目、商务智能与 AI,一套系统全部打通
在线演示 ·
官网 ·
用户手册 ·
开发文档 ·
联系我们 ·
English
## 项目简介
柠檬ERP(Lemon ERP)是一套面向中小制造、商贸企业的**真正 100% 开源、无功能限制的全功能 ERP 系统**,前后端分离,开箱即用;既可以直接作为企业的 ERP 软件使用,也适合作为 Java 企业级项目二次开发的基础。
- **业务全覆盖**:14 大模块、171 个功能页面,从请购到收款、从 BOM 到完工入库、从凭证到报表,一套系统闭环
- **单据自动联动**:出入库自动更新库存、生成应收应付,业务单据一键生成会计凭证,账实一致
- **多端使用**:电脑浏览器、微信小程序、手机 / PDA 扫码作业、数据大屏投屏,支持中英文界面
- **技术栈新**:Spring Boot 4 + Vue 3 + Ant Design Vue 4,Gradle 多模块、单向依赖,代码结构清晰
- **真正 100% 开源**:全部功能、全部源码开放,没有商业版、没有隐藏模块、没有授权码,个人与企业均可免费商用
> 如果这个项目对你有帮助,请点一下右上角的 **Star**,这是对我们最大的鼓励!
## 在线演示
演示地址:**https://erp.dqq.me**(演示环境只能查看,不能新增、修改、删除数据)
| 租户 | 账号 | 密码 | 说明 |
| --- | --- | --- | --- |
| 柠檬科技 | admin | admin123 | 超级管理员,可以浏览全部功能 |
| 柠檬科技 | test | admin123 | 普通用户(只读),数据权限为「本部门及以下」 |
## 为什么选择柠檬ERP
### 与常见方案对比
| | 商业 ERP 软件 | 「开源版 + 商业版」的开源 ERP | **柠檬ERP** |
| --- | --- | --- | --- |
| 费用 | 按用户数、模块或年费收费,实施费另计 | 开源版免费,常用的高级功能需要购买商业版 | **完全免费**,没有付费版本 |
| 功能范围 | 按购买的模块开通 | 开源版多为进销存等基础功能,生产、财务等常在商业版中 | **全部 14 大模块开源**:进销存、生产、质量、财务、人力、客户、项目、BI、AI |
| 源码 | 不提供 | 只开放部分源码 | **全部源码开放**,可以审计、修改 |
| 数据归属 | SaaS 版数据在厂商服务器 | 自己部署 | **私有化部署**,数据在自己的服务器上 |
| 用户数、单据量 | 按授权限制 | 部分有限制 | **没有授权码,系统本身不限制** |
| 二次开发 | 依赖厂商或认证伙伴 | 可以,但闭源部分改不了 | **完全自主**,有 250 多页开发文档和完整示例 |
### 核心优势
1. **省钱**:软件本身零费用,没有按用户、按模块、按年收费,企业只需要一台服务器;软件服务商用它交付项目,不用再付授权费
2. **一套系统管全业务**:采购、销售、仓储、生产、质量、财务、人力、客户、项目、BI 都在一个系统里,不用买多套软件再做接口集成,数据天然一致
3. **业财一体,账实相符**:出入库自动更新库存、生成应收应付,业务单据一键生成凭证;生产领料、完工入库自动进入成本核算,月末结账一键完成
4. **贴合国内企业**:小企业会计准则的资产负债表、利润表、现金流量表,数电票导入勾稽,个税累计预扣与专项附加扣除、社保公积金,钉钉 / 企业微信 / 飞书、微信小程序,DeepSeek、通义千问等国产大模型
5. **数据自主可控**:私有化部署在自己的服务器或内网,源码完全开放可审计,不依赖任何厂商的云服务
6. **拿来就能用**:Docker 一条命令启动;内置示例基础资料、按行业模板开通功能、期初启用向导;中英文界面;250 多页用户手册覆盖每个页面的操作
7. **容易二次开发**:Spring Boot 4 + Vue 3 主流技术栈,Gradle 多模块、依赖单向,单据审批、状态流转、数据权限、明细行等都有公共组件;新增模块、接入审批、扩展 AI 能力都有完整的开发文档和示例
8. **多端协同**:电脑浏览器处理全部业务,微信小程序审批和外勤,手机 / PDA 扫码收发货和盘点,数据大屏投屏到车间和仓库
9. **安全可靠**:菜单 / 按钮 / 接口三级权限和五种数据权限,操作日志与登录日志,会话可强制下线,登录验证码与密码策略,审批流程留痕
10. **可以做成 SaaS**:内置多租户、租户套餐和行业模板,软件服务商可以直接用它为多家客户提供在线 ERP 服务
### 适合谁使用
| 用户 | 能得到什么 |
| --- | --- |
| **中小制造企业** | 从销售订单、MRP、生产工单、质量检验到成本核算的完整闭环,车间扫码报工、数据大屏 |
| **商贸、批发零售企业** | 采购、销售、库存、多价格体系、客户价格等级、进销存报表、应收应付与资金管理 |
| **项目型、服务型企业** | 项目计划与工时、成本核算、客户关系与服务工单、费用报销与审批 |
| **软件服务商、实施商** | 免授权费的 ERP 底座,可二次开发后交付客户,或用多租户做成 SaaS 服务 |
| **开发者、学生** | 一个完整的企业级 Java 项目:多模块架构、权限与多租户、工作流、AI 集成、Docker 部署,可以直接学习和参考 |
## 功能一览
| 模块 | 主要功能 |
| 供应链 | 请购、询价比价、招标、采购合同、采购订单、送货通知、采购入库 / 退货;销售报价、价目表与商品多价格、客户价格等级与执行价(Excel 导入导出)、促销、返利、销售提成、销售订单、发货拣货、销售出库 / 退货、物流发运;入库出库可直接开单;订单、直接开单、报价可整单优惠 / 抹零;供应商 / 经销商门户 |
| 进销存报表 | 销售报表、进货报表(多维汇总,汇总 → 明细 → 单据穿透)、经营状况、资产状况(可选截至日期)、商品分析(畅销、滞销、积压、缺货、周转)、客户 RFM 分群 |
| 仓库 | 入库、出库、调拨、盘点、组装拆卸;实时库存成本(移动加权平均,生产完工按标准成本或工单实际料工费(报工工时 × 工作中心费率),提前关闭、完工后退料自动调整产品成本,库存均价与金额、经营历史);批次与序列号追踪、库存预留与冻结、收发存汇总;多规格物料(SKU)、库位与上架策略;手机 / PDA 扫码作业 |
| 生产制造 | 主生产计划、MRP 运算、产能排程、生产看板;工单、齐套分析、领料超领控制、补料、报工、完工入库;BOM 与工艺路线、工程变更、设备维护与 OEE、模具工装 |
| 质量 | 检验方案(AQL 抽样)、来料 / 过程 / 成品 / 首件检验;不合格品 MRB、纠正预防(8D)、供应商索赔;合格率趋势、不良柏拉图、SPC 与 Cp / Cpk |
| 财务 | 凭证、账簿、资产负债表 / 利润表 / 现金流量表(小企业会计准则)、期末结账;应收应付与核销(自动核销、折让抹零、多收转预收、冲账单、坏账,支持外币)、账龄、数电票、往来对账;出纳、费用报销、票据、资金计划;固定资产、成本核算、标准成本、预算 |
| 客户关系 | 客户公海、线索、商机看板、跟进记录、合同、服务工单、市场活动、客户分析 |
| 项目管理 | WBS 计划与甘特图、资源负荷、工时填报审批、成本控制、项目核算与挣值分析 |
| 人力资源 | 员工档案与异动、劳动合同、招聘培训、考勤打卡、请假加班、绩效考核、薪酬核算(社保、个税、计件、提成)、员工自助 |
| 商务智能 | 经营驾驶舱、多维分析、自定义报表与仪表盘、决策支持与预警、数据大屏(可投屏到电视) |
| 智能(AI) | 接入 DeepSeek、通义千问、智谱 GLM、Kimi、豆包等大模型:AI 问数、智能录入(识别图片 / 文件生成单据)、数据整理、智能报告 |
| 流程中心 | 仿钉钉流程设计器(条件分支、并行分支、会签 / 或签),业务单据一键接入审批 |
| 系统平台 | 用户、部门、角色、菜单 / 按钮 / 数据权限;SaaS 多租户与行业模板;编码规则、打印模板(PDF、套打)、业务参数、自定义字段;钉钉 / 企业微信 / 飞书集成;中英文切换;系统监控与定时任务 |
每个功能的详细说明见 [用户手册](https://makesomefakenews.github.io/lemon-erp-website/manual/guide/)。
## 系统截图
**采购订单详情**

**MRP 运算**

**财务报表(资产负债表)**

**项目计划(甘特图)**

**经营驾驶舱**

**流程设计器**

**数据大屏(生产车间)**

**微信小程序**

更多截图:登录与首页、供应链、仓库
 登录页 |
 工作台(深色模式) |
 采购订单 |
 销售订单详情 |
 供应商评估 |
 库存查询 |
 批次与序列号追踪 |
 物料管理 |
 库位管理 |
 手机 / PDA 移动作业 |
更多截图:生产、质量
 生产计划 |
 产能排程 |
 齐套分析 |
 生产工单详情 |
 物料清单(BOM) |
 质量检验 |
 不合格品处理 |
 SPC 控制图 |
 质量分析 |
 数据大屏(质量管理) |
更多截图:财务
 凭证管理 |
 记账凭证 |
 科目余额表 |
 应收管理 |
 固定资产 |
 成本核算 |
 预算管理 |
 经营分析 |
更多截图:客户关系、项目、人力资源
 销售机会看板 |
 客户分析 |
 客户管理 |
 服务工单 |
 项目列表 |
 资源分配 |
 项目核算 |
 员工档案 |
 考勤管理 |
 薪酬核算 |
 绩效考核 |
 招聘管理 |
更多截图:商务智能、数据大屏、流程与系统
 多维分析 |
 自定义仪表盘 |
 数据大屏(仓储物流) |
 数据大屏(销售经营) |
 流程实例 |
 打印模板设计 |
 用户管理 |
 角色管理 |
 部门管理 |
 服务监控 |
 缓存监控 |
 定时任务 |
## 系统架构
**业务架构**:蓝色虚线是模块内的业务流程,灰色虚线是跨模块的自动联动(生成下游单据、更新库存、生成应收应付与凭证)。

**技术架构**

## 快速开始
### 方式一:Docker 一键部署(推荐)
安装了 Docker(含 Compose v2)时,一条命令启动 MySQL、Redis、后端和前端:
```bash
cd docker
cp .env.example .env # 修改其中的密码和 JWT_SECRET
docker compose up -d --build
```
启动完成后访问 http://localhost(端口见 `.env` 中的 `WEB_PORT`)。构建、推送镜像使用 `./docker/build.sh`,详见 [Docker 部署](https://makesomefakenews.github.io/lemon-erp-website/dev/deploy/docker)。
不想在服务器上编译时,可以直接使用 [GitHub Packages](https://github.com/MakeSomeFakeNews?tab=packages&repo_name=lemon-erp) 中已构建好的镜像(支持 x86 和 ARM):从 [Releases](https://github.com/MakeSomeFakeNews/lemon-erp/releases/latest) 下载 `lemon-erp-docker-<版本>.zip`,解压后:
```bash
cd docker
cp .env.example .env # 已填好镜像地址 ghcr.io/makesomefakenews/lemon-erp,修改密码和 JWT_SECRET 即可
docker compose up -d
```
Releases 中还提供后端 jar、前端静态文件和 `init.sql`,可用于不使用 Docker 的传统部署。
已经部署的系统升级到新版本时,备份数据库后执行 [sql/upgrade](sql/upgrade) 中部署之后新增的升级脚本(可重复执行),步骤见其中的 README。
### 方式二:源码运行
```bash
# 1. 初始化数据库(会删除并重建全部表)
mysql -uroot -p -e "CREATE DATABASE lemon_erp DEFAULT CHARSET utf8mb4"
mysql -uroot -p lemon_erp < sql/init.sql
# 2. 启动后端(项目根目录执行,默认连接本机 MySQL root / root 和本机 Redis,
# 可用环境变量 DB_URL、DB_USERNAME、DB_PASSWORD、REDIS_HOST、REDIS_PORT、REDIS_PASSWORD 覆盖)
DB_PASSWORD=你的密码 ./gradlew bootRun
# 3. 启动前端,访问 http://localhost:5173(/api 自动代理到 http://localhost:8080)
cd lemon-web && npm install && npm run dev
```
打包部署与 Nginx 参考配置
```bash
./gradlew build # 生成 lemon-admin/build/libs/lemon-erp.jar
cd lemon-web && npm run build # 生成 lemon-web/dist,交给 Nginx 托管
# 生产环境配置全部取环境变量,JWT_SECRET 至少 32 字节
java -jar lemon-erp.jar --spring.profiles.active=prod
```
```nginx
location / {
root /path/to/lemon-web/dist;
try_files $uri $uri/ /index.html;
}
location /api/ {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
```
使用 AI 问数时还需要为 `/api/ai/` 关闭代理缓冲,见 [Nginx 配置](https://makesomefakenews.github.io/lemon-erp-website/dev/deploy/nginx)。
**默认账号**:`admin` / `admin123`(超级管理员)、`test` / `admin123`(只读用户)。开启 SaaS 多租户(`LEMON_TENANT_ENABLED=true`)后登录需要填写租户「柠檬科技」;设置 `LEMON_DEMO_ENABLED=true` 开启演示模式(只能查看,不能修改数据)。
## 技术栈
| 分类 | 技术 | 环境要求 |
| --- | --- | --- |
| 后端 | Java 17、Spring Boot 4.1、Spring Security + JWT、MyBatis-Plus 3.5、Flowable 8、JasperReports 7 | JDK 17 |
| 数据与缓存 | MySQL、Redis(可切换为内存缓存) | MySQL 8.0+、Redis 6.2+ |
| 前端 | Vue 3.5、Vite 7、Ant Design Vue 4.2、Pinia、Vue Router、ECharts 5、vue-i18n | Node 20+ |
| 小程序 | uni-app(Vue 3),微信小程序 | 微信开发者工具 |
| 构建部署 | Gradle 多模块、Docker / Docker Compose、Nginx | Docker 20.10+、Nginx 1.20+ |
## 项目结构
```
lemon-erp
├── lemon-common 通用层:统一返回、异常、基础实体、工具类
├── lemon-framework 框架层:安全、数据权限、多租户、缓存、日志、模块间契约接口
├── lemon-modules 业务模块
│ ├── lemon-system 系统管理 ├── lemon-fin 财务管理
│ ├── lemon-monitor 系统监控 ├── lemon-hr 人力资源
│ ├── lemon-workflow 流程中心 ├── lemon-crm 客户关系
│ ├── lemon-dashboard 工作台 ├── lemon-pm 项目管理
│ ├── lemon-wms 仓库管理 ├── lemon-bi 商务智能、进销存报表
│ ├── lemon-scm 供应链管理 └── lemon-ai 智能(AI)
│ └── lemon-mes 生产制造 + 质量管理
├── lemon-admin 启动模块:组装全部业务模块,打包为可执行 jar
├── lemon-web 前端(Vite + Vue 3 + Ant Design Vue)
├── lemon-mp 微信小程序(uni-app + Vue 3)
├── sql/init.sql 建表与初始数据
├── docker Dockerfile、docker-compose 与镜像构建脚本
└── docs 开发说明、架构图与截图
```
## 联系方式
商务合作、定制开发、部署实施或使用中遇到问题,欢迎联系:
- 电话:17701123202
- 微信:BG7LIF
- 邮箱:zmissu@163.com
也欢迎在 [Issues](https://github.com/MakeSomeFakeNews/lemon-erp/issues) 中反馈问题和建议,或提交 Pull Request 一起完善。
## 真正 100% 开源
柠檬ERP 不是「开源版 + 商业版」的模式,演示环境和文档中看到的全部功能,都在本仓库中完整开源:
- **全部功能开源**:供应链、仓储、生产、质量、财务、人力、客户、项目、商务智能、AI,没有任何模块收费或闭源
- **没有功能限制**:没有授权码和激活,系统本身不限制用户数、租户数和单据量,也没有隐藏的高级功能
- **免费商用**:遵守 [Apache-2.0](LICENSE) 协议,个人与企业都可以免费使用、修改、二次开发和商业部署,使用时保留原作者版权声明与许可证文件即可
- **文档同样开放**:250 多页 [用户手册](https://makesomefakenews.github.io/lemon-erp-website/manual/guide/) 和 [开发文档](https://makesomefakenews.github.io/lemon-erp-website/dev/start/)、Docker 一键部署脚本全部公开
如果觉得柠檬ERP 不错,请点一个 **Star**,也欢迎推荐给身边做生意、办工厂、做软件的朋友。
## English
**Lemon ERP** is a truly 100% open-source, full-featured **ERP system** with no paid edition and no feature restrictions, for small and medium-sized manufacturers and distributors, built with **Spring Boot 4 + Vue 3 + Ant Design Vue 4**. It covers purchasing, sales, inventory and warehouse management (**WMS**), manufacturing execution (**MES**: BOM, MRP, work orders, shop-floor reporting), quality management (**QMS**), accounting and finance, **CRM**, human resources (**HRM**, payroll, attendance), project management, business intelligence (**BI**) and **AI** assistants. Documents flow between modules automatically: stock movements update inventory and generate receivables/payables, and business documents generate accounting vouchers.
- Visual approval workflow (Flowable), SaaS multi-tenancy, menu / button / API permissions and department-level data permissions
- AI assistants with DeepSeek, Qwen, GLM, Kimi or Doubao: natural-language data queries, document recognition, data cleansing and business reports
- WeChat mini program, mobile / PDA barcode scanning, data screens, DingTalk / WeCom / Feishu login and notifications
- Chinese and English UI, demo mode, Docker one-click deployment
- Every feature and every line of source code is open: no paid edition, no hidden modules, no license keys; Apache-2.0 licensed, free for commercial use
Online demo: https://erp.dqq.me (tenant「柠檬科技」, `admin` / `admin123`) · Documentation: https://makesomefakenews.github.io/lemon-erp-website/ · Contact: zmissu@163.com
---
Apache License 2.0 © 2026 柠檬ERP