项目介绍
柠檬跨境ERP(Lemon Ecom ERP)是一套面向跨境电商卖家的开源 ERP:多平台多店铺的订单、刊登定价、FBA 与海外仓、头程物流、广告、平台结算与利润分析,和采购、仓库、财务、审批流程放在一套系统里。后端为 Gradle 多模块的 Spring Boot 应用,前端为 Vite + Vue 3 + Ant Design Vue 单页应用,另有一个 uni-app 开发的微信小程序(lemon-mp),与 Web 端共用后端接口。
项目由开源项目 柠檬ERP 衍生:去掉了生产制造、质量、客户关系、项目管理、人力资源、商务智能和门户,保留了成熟的仓库、采购、财务、流程中心和系统平台能力,在此之上新增了跨境电商模块 lemon-ecom。本开发文档面向需要部署、二次开发或对接新平台的程序员;业务功能的使用方法见 用户手册。

技术栈
| 端 | 分类 | 技术 | 版本 |
|---|---|---|---|
| 后端 | 语言 | Java | 17 |
| 后端 | 框架 | Spring Boot(Spring Framework 7、Spring Security) | 4.1.1 |
| 后端 | 持久层 | MyBatis-Plus(分页、多租户、数据权限插件) | 3.5.17 |
| 后端 | 工作流 | Flowable(只启用 BPMN 流程引擎) | 8.0.0 |
| 后端 | 认证 | JJWT | 0.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、pinyin4j | 3.3.7、6.12.0、2.5.1 |
| 后端 | 构建 | Gradle(项目自带 Wrapper) | 9.7.1 |
| 前端 | 框架 | Vue、Vue Router、Pinia | 3.5、4.5、3.0 |
| 前端 | 构建 / UI | Vite、Ant Design Vue | 7、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,本开发文档是它的整理版。