Skip to content

本地运行 ​

环境要求 ​

软件版本说明
JDK17Gradle 使用项目自带的 Wrapper,无需单独安装
Node.js20+前端与小程序
MySQL8.0+使用 bootTestRun 体验时不需要
Redis6.2+使用 bootTestRun 体验时不需要
微信开发者工具最新版只在开发小程序时需要

所有 Gradle 命令都在项目根目录执行,启动模块是 lemon-admin。

方式一:免装数据库体验(bootTestRun) ​

bash
./gradlew bootTestRun

用 H2 内存库(MySQL 兼容模式,同样执行 sql/init.sql 建表)和内存缓存启动后端,入口是 lemon-admin/src/test/java/.../TestLemonErpApplication,以 SaaS 多租户模式运行(登录时租户填「柠檬科技」)。启动完成后会在后台自动生成演示数据(约 1–2 分钟,电商看板上显示进度),数据在重启后丢失。test 配置关闭了定时任务的自动调度(lemon.job.enabled: false),订单同步、库存回传等任务只能在「系统监控 → 定时任务」中手动执行。

不需要演示数据时:

bash
LEMON_ECOM_DEMO_DATA=false ./gradlew bootTestRun

方式二:连接本机 MySQL(bootRun) ​

dev 环境默认连接本机 MySQL localhost:3306/lemon_ecom(root / root)和本机 Redis。

bash
# 1. 初始化数据库(会删除并重建全部表)
mysql -uroot -p -e "CREATE DATABASE lemon_ecom DEFAULT CHARSET utf8mb4"
mysql -uroot -p lemon_ecom < sql/init.sql

# 2. 启动后端,可用 DB_URL、DB_USERNAME、DB_PASSWORD、REDIS_HOST、REDIS_PORT、REDIS_PASSWORD 覆盖
DB_PASSWORD=你的密码 ./gradlew bootRun
  • 工作流引擎的 ACT_ 开头的表由 Flowable 在启动时自动创建,不在 init.sql 中。自定义 DB_URL 时要带上 nullCatalogMeansCurrent=true,否则 Flowable 可能误读同一实例中其他库的表结构。
  • 需要演示数据时启动前设置 LEMON_ECOM_DEMO_DATA=true,或登录后在「运营管理 → 电商看板」没有数据时点击「生成演示数据」。

前端 ​

bash
cd lemon-web
npm install
npm run dev        # http://localhost:5173,/api 代理到 http://localhost:8080

默认账号:

账号密码说明
adminadmin123超级管理员,拥有全部权限
testadmin123普通用户,所有页面只读,数据权限为「本部门及以下」

开启 SaaS 多租户(bootTestRun 默认开启,bootRun 用 LEMON_TENANT_ENABLED=true)时登录要填写租户「柠檬科技」。

小程序 ​

bash
cd lemon-mp
cp .env.example .env     # 设置 VITE_API_BASE(含 /api)
npm install
npm run dev:mp-weixin    # 用微信开发者工具导入 dist/dev/mp-weixin

开发时可在开发者工具中勾选「不校验合法域名」;AppID 填在 src/manifest.json 的 mp-weixin.appid,后端设置同一个小程序的 LEMON_MINIAPP_APP_ID / LEMON_MINIAPP_APP_SECRET 后才能用微信登录。详见主项目的 lemon-mp/README.md。

演示数据 ​

演示数据模拟一个跨境卖家的完整业务,打开系统就能看到各页面的效果:

内容说明
基础资料近 6 个月汇率、国内发货仓、亚马逊 FBA 美 / 德 / 日仓、美国海外仓、不良品仓,头程与尾程物流渠道及费率,3 个电商运营演示账号
店铺与商品10 个平台店铺(亚马逊美 / 德 / 日、虾皮、TikTok Shop、Temu、速卖通、Shopify、eBay 等),40 个带示意图的商品、在线商品与组合商品
业务单据供应商与采购、头程货件与装箱、近 120 天约 5000 张订单(覆盖待审核、缺货、待打单、已发货、异常等各环节)、包裹与物流轨迹、退货、结算与回款
运营数据广告(SP / SB / SD)、客服消息与评价、ASIN 监控、促销、补货建议、销量预测(含断货日)、FBA 库存健康与索赔
扩展功能海外仓账号与入库 / 出库 / 退件 / 费用、开发项目与利润试算方案、1688 货源与采购单

触发方式:

  • ./gradlew bootTestRun:默认自动生成(LEMON_ECOM_DEMO_DATA=false 关闭)。
  • bootRun / Docker / jar:设置环境变量 LEMON_ECOM_DEMO_DATA=true,应用启动完成后以平台租户管理员的身份生成一次,已生成过则跳过。
  • 页面:电商看板本月和今天都没有订单时显示「生成演示数据」入口(按钮权限 ecom:demo:generate,超级管理员和电商运营默认拥有)。

注意

演示店铺的编码以 DEMO- 开头,授权信息是占位值,不会访问真实平台:刊登直接记为失败、改价只改本地、海外仓账号关闭了自动同步。每个租户只能生成一次,正式使用的库不要生成演示数据。

运行测试 ​

bash
./gradlew test                                                               # 全部测试(H2,不依赖外部服务)
./gradlew :lemon-admin:test --tests 'com.lemon.erp.modules.ecom.EcomTests'   # 单个测试类必须指定模块
LEMON_TENANT_ENABLED=false ./gradlew test                                    # 验证单租户模式

各平台、海外仓、物流商连接器的单元测试在 lemon-modules/lemon-ecom/src/test,用本地 HTTP 服务模拟平台接口,验证签名、授权、分页、报文与错误处理。

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