Skip to content

目录结构 ​

Gradle 多模块项目,Java 包名与模块一一对应(com.lemon.erp.common、com.lemon.erp.framework、com.lemon.erp.modules.<模块>)。

lemon-ecom
├── settings.gradle
模块清单
├── gradle
│   ├── libs.versions.toml
依赖版本目录,各模块通过 libs.xxx 引用
│   └── build-logic
构建约定插件 lemon.java-conventions(Java 17、Spring Boot BOM、Lombok、-parameters、JUnit 5)
├── lemon-common
通用层:统一返回 R、BizException、BaseEntity、Decimals、校验分组
├── lemon-framework
框架层:安全、多租户、数据权限、缓存、日志、定时任务、模块间契约接口与事件
├── lemon-modules
业务模块,每个模块包含自己的 Java 代码、mapper XML 与语言包
│   ├── lemon-system
系统管理:登录、用户、部门、角色、菜单、字典、租户、打印、通知公告、第三方集成
│   ├── lemon-monitor
系统监控:在线用户、操作 / 登录日志、服务监控、缓存监控、定时任务
│   ├── lemon-workflow
流程中心:Flowable 集成、流程模型、发起与审批
│   ├── lemon-dashboard
首页工作台
│   ├── lemon-wms
仓库管理:仓库、库位、物料、出入库 / 调拨 / 盘点、库存、批次与序列号、实时成本
│   ├── lemon-scm
供应链:供应商、客户、采购订单、出入库与退货、直接开单、商品速查、价格
│   ├── lemon-fin
财务:科目、凭证、结账、账簿报表、应收应付、收付款、资产、成本、预算、币种汇率
│   ├── lemon-ecom
跨境电商(见下)与进销存报表(jxc)
│   └── lemon-ai
智能:大模型客户端、AI 设置与用量、AI 问数、智能录入、数据整理、智能报告
├── lemon-admin
启动模块:组装全部业务模块,打包为 lemon-ecom.jar;application*.yml;集成测试
├── lemon-web
前端(Vite + Vue 3 + Ant Design Vue)
├── lemon-mp
微信小程序(uni-app + Vue 3)
├── docker
Dockerfile、docker-compose、Nginx 配置与镜像构建脚本
├── sql/init.sql
建表 + 初始数据(MySQL,H2 兼容)
└── docs/development.md
完整的开发说明

跨境电商模块 ​

lemon-modules/lemon-ecom 按功能分包,较大的功能有自己的 Mapper 扫描配置和 XML 目录:

com.lemon.erp.modules.ecom
├── connector
渠道连接器 SPI 与 11 个平台实现(ChannelConnector、ConnectorRegistry、CredentialCipher、OAuthState)
├── carrier
物流商连接器(CarrierConnector:4PX、云途;17TRACK 轨迹客户端)
├── publish
刊登与定价:刊登中心、刊登 / 价格模板、批量改价、自动调价、竞品价格;PublishConnector
├── ads
广告接口 SPI(AdsConnector、Amazon Ads SP / SB / SD)
├── cs
客服与评价:买家消息、评价、回复模板、售后工单;MessageConnector
├── fba
FBA 运营:库存健康、移除订单、索赔、费用核查、亚马逊报告
├── owh
海外仓:OwhConnector(谷仓、万邑通、4PX 海外仓)、入库 / 出库 / 退件 / 调拨 / 费用 / 收货差异
├── dev
产品开发、利润试算、1688 采购(ali1688 签名与客户端)
├── oper
运营监控:ASIN 监控、促销、运营目标与绩效、店铺授权
├── analytics
销量统计、销量预测、商品分析、库存快照
├── dashboard
电商看板
├── jxc
进销存报表(菜单在「供应链」下)
├── ai
AI 问数工具、AI 文本(草拟回复、翻译)
├── demo
演示数据框架(DemoContributor)与基础数据
├── controller / service / mapper / entity / dto / model
店铺、在线商品、订单、包裹、退货、头程、结算、利润等核心功能

mapper XML 在 src/main/resources/mapper/ecom/(子功能在 mapper/ecom/<子包>/),语言包在 src/main/resources/i18n/ecom.properties / ecom_en.properties。

前端 ​

lemon-web/src
├── api/<模块>/*.js
接口封装(电商在 api/ecom)
├── views/<模块>/<页面>/index.vue 页面,菜单的 component 即相对 views 的路径(电商页面都在 views/ecom)
├── components
通用组件(TableToolbar、SearchForm、FormDrawer、SubPage、DictTag、LineItemsTable ...) 与业务组件(components/ecom:StoreSelect、ChannelSelect、DemoDataBanner ...)
├── composables
useTable、useColumns、useFormDrawer、useDict、useAction、useLineItems、useRemoteOptions
├── layout
四种布局、侧边栏、顶部菜单、多标签页、界面设置
├── locales
语言包 zh-CN / en-US,按模块拆分(ecom.js、ecomOrder.js、ecomPublish.js ...)
├── constants/enums.js
由后端枚举生成的常量(npm run gen:enums)
└── router / store / directives / utils

电商功能在顶部导航中分布在「商品管理」「订单管理」「运营管理」「物流管理」四个模块,以及「供应链」「财务管理」中的部分分组;页面地址统一为 /ecom/<页面>,模块只是导航上的归类。

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