Skip to content

开发指南 ​

本章介绍二次开发的常见任务。动手之前建议先读 架构设计,尤其是 模块与依赖 和 连接器设计。

页面适用场景
新增平台连接器接入新的电商平台,或为已有平台补充刊登、客服、广告能力
新增海外仓 / 物流商对接新的第三方海外仓或物流商
演示数据为新功能补充演示数据(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)。

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