新增业务模块
大部分电商功能直接加在 lemon-ecom 中(较大的功能建子包和独立的 Mapper 扫描配置,如 publish、owh、fba)。确实需要独立模块时,以 foo 为例:
后端
- 新建
lemon-modules/lemon-foo/build.gradle:
groovy
plugins {
id 'lemon.java-conventions'
}
dependencies {
api project(':lemon-framework')
// 需要其他业务模块时再加,例如 implementation project(':lemon-modules:lemon-ecom'),不能形成循环
}settings.gradle的模块清单中加'foo',lemon-admin/build.gradle中加implementation project(':lemon-modules:lemon-foo')。- 代码放在
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。 - 接口加
@PreAuthorize,增删改加@OperLog;新增用@Validated(Create.class),修改用@Validated(Update.class)。 - 新表加
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