开发指南
本章介绍二次开发的常见任务。动手之前建议先读 架构设计,尤其是 模块与依赖 和 连接器设计。
| 页面 | 适用场景 |
|---|---|
| 新增平台连接器 | 接入新的电商平台,或为已有平台补充刊登、客服、广告能力 |
| 新增海外仓 / 物流商 | 对接新的第三方海外仓或物流商 |
| 演示数据 | 为新功能补充演示数据(DemoContributor) |
| 菜单与权限 | 新增页面、按钮权限,给内置角色授权,功能模块与行业模板 |
| 多语言 | 前后端中英文、枚举常量生成、检查脚本 |
| 前端约定 | 列表页、表单与子页、操作列、远程下拉、金额格式化 |
| 单据公共组件 | 接入审批、状态流转、数据权限、明细行、数据访问规范 |
| 导入导出与打印 | Excel 导入导出、单据编号、单据打印与面单 |
| 新增业务模块 | 新建一个 Gradle 业务模块 |
通用约定
- 编译保持零警告;没有配置 lint 工具,前端没有单元测试,后端集成测试放在
lemon-admin/src/test,纯单元测试放在所属模块。 - 新表、新菜单、新字典写进
sql/init.sql(唯一的建表与初始数据脚本,测试和bootTestRun也用它初始化 H2,必须同时兼容 MySQL 与 H2)。 - 后端返回给用户的文字一律用消息键(
new BizException("ecom.error.xxx")),前端界面文字写进语言包,提交前运行检查脚本(见 多语言)。 - 状态、种类等取值用枚举,实体字段直接用枚举类型,比较用
==,不写字符串字面量比较;前端用@/constants/enums中的常量。 - 有两次及以上写操作的 public 方法加
@Transactional;事务内不做 HTTP 等外部调用,改用@TransactionalEventListener(AFTER_COMMIT)。