Skip to content

新增业务模块 ​

大部分电商功能直接加在 lemon-ecom 中(较大的功能建子包和独立的 Mapper 扫描配置,如 publish、owh、fba)。确实需要独立模块时,以 foo 为例:

后端 ​

  1. 新建 lemon-modules/lemon-foo/build.gradle:
groovy
plugins {
    id 'lemon.java-conventions'
}

dependencies {
    api project(':lemon-framework')
    // 需要其他业务模块时再加,例如 implementation project(':lemon-modules:lemon-ecom'),不能形成循环
}
  1. settings.gradle 的模块清单中加 'foo',lemon-admin/build.gradle 中加 implementation project(':lemon-modules:lemon-foo')。
  2. 代码放在 src/main/java/com/lemon/erp/modules/foo/{controller,service,mapper,entity,dto,model};实体继承 BaseEntity,Mapper 继承 BaseMapper,会被自动扫描;自定义 SQL 写在 src/main/resources/mapper/foo/*.xml;消息写在 src/main/resources/i18n/foo.properties / foo_en.properties。
  3. 接口加 @PreAuthorize,增删改加 @OperLog;新增用 @Validated(Create.class),修改用 @Validated(Update.class)。
  4. 新表加 tenant_id,唯一约束末尾加 tenant_id;新租户需要的基础数据实现 TenantInitializer。

前端 ​

新建 lemon-web/src/api/foo/*.js、lemon-web/src/views/foo/<页面>/index.vue 和语言包 locales/zh-CN/foo.js、locales/en-US/foo.js,约定见 前端约定。

菜单与权限 ​

在 sql/init.sql 中登记模块目录、分组、页面和按钮,给内置角色授权,在 SysFeatureCatalog 中归入功能模块,见 菜单与权限。

验证 ​

bash
./gradlew build                     # 编译、测试,保持零警告
python3 scripts/check_i18n.py       # 后端资源包
cd lemon-web && npm run i18n:check && npm run build

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