Skip to content

项目介绍 ​

柠檬跨境ERP(Lemon Ecom ERP)是一套面向跨境电商卖家的开源 ERP:多平台多店铺的订单、刊登定价、FBA 与海外仓、头程物流、广告、平台结算与利润分析,和采购、仓库、财务、审批流程放在一套系统里。后端为 Gradle 多模块的 Spring Boot 应用,前端为 Vite + Vue 3 + Ant Design Vue 单页应用,另有一个 uni-app 开发的微信小程序(lemon-mp),与 Web 端共用后端接口。

项目由开源项目 柠檬ERP 衍生:去掉了生产制造、质量、客户关系、项目管理、人力资源、商务智能和门户,保留了成熟的仓库、采购、财务、流程中心和系统平台能力,在此之上新增了跨境电商模块 lemon-ecom。本开发文档面向需要部署、二次开发或对接新平台的程序员;业务功能的使用方法见 用户手册。

电商看板

技术栈 ​

端分类技术版本
后端语言Java17
后端框架Spring Boot(Spring Framework 7、Spring Security)4.1.1
后端持久层MyBatis-Plus(分页、多租户、数据权限插件)3.5.17
后端工作流Flowable(只启用 BPMN 流程引擎)8.0.0
后端认证JJWT0.12.6
后端数据库 / 缓存MySQL / Redis(可切换为进程内缓存)8.0+ / 6.2+
后端单据打印JasperReports(PDF;面单、拣货单合并用 OpenPDF)7.0.8
后端平台接口JDK HttpClient + Jackson 自行实现各平台的签名与 OAuth,不引入平台 SDK-
后端大模型OpenAI Chat Completions 兼容客户端,接入 DeepSeek、通义千问、智谱 GLM、Kimi、豆包等-
后端其他ip2region、OSHI、pinyin4j3.3.7、6.12.0、2.5.1
后端构建Gradle(项目自带 Wrapper)9.7.1
前端框架Vue、Vue Router、Pinia3.5、4.5、3.0
前端构建 / UIVite、Ant Design Vue7、4.2
前端其他vue-i18n、ECharts、Axios、Day.js、ExcelJS、JsBarcode-
小程序框架uni-app(Vue 3),编译为微信小程序-

后端依赖版本统一维护在 gradle/libs.versions.toml,前端依赖见 lemon-web/package.json。

Spring Boot 4 的变化

Spring Boot 4 默认使用 Jackson 3,ObjectMapper 等类位于 tools.jackson.databind 包;注解(@JsonFormat、@JsonProperty 等)仍然是 com.fasterxml.jackson.annotation。

架构总览 ​

文档导航 ​

章节内容
目录结构仓库目录、后端模块、前端与小程序目录
本地运行bootTestRun 免装数据库体验、连接 MySQL 运行、前端、小程序、演示数据
配置说明多环境配置、常用配置项与环境变量
架构设计模块依赖、多租户、权限与店铺数据权限、连接器 SPI、OAuth、同步任务、利润口径、工作流
开发指南新增平台连接器、新增海外仓 / 物流商、演示数据、菜单与权限、多语言、前端约定、单据组件、导出与打印
部署运维Docker 部署、环境变量与回调地址、生产部署、升级与发版

更完整的设计细节(每张表、每个接口、每个已知限制)写在主项目的 docs/development.md,本开发文档是它的整理版。

面向跨境电商卖家的开源 ERP · 基于 GPL-3.0 协议
联系我们:电话 17701123202 · 微信 BG7LIF · 邮箱 zmissu@163.com