Files

T

zdh 0985dacbfe feat: init yueqian-erp based on xingyun

- Change groupId: com.lframework -> com.yueqian
- Change artifactId: xingyun -> yueqian-erp
- Rename modules: xingyun-* -> yueqian-erp-*
- Update Java packages: com.lframework.xingyun -> com.yueqian.xingyun
- Preserve external Jugg framework dependencies as com.lframework
- Update README and documentation

2026-06-13 20:07:18 +08:00

5.8 KiB

Raw Permalink Blame History

月千 ERP 后端

月千 ERP 是面向中小企业的开源进销存系统后端仓库，覆盖基础资料、商品中心、采购、销售、零售、库存、盘点、结算、报表和系统管理等核心业务场景。当前仓库同时保留单体部署与 Spring Cloud 部署两种运行形态，便于快速落地或按需拆分。

本项目基于月千 ERP 二次开发，groupId: com.yueqian，artifactId: yueqian-erp。

仓库定位

yueqian-erp-api：单体启动模块
cloud/yueqian-erp-cloud-api：云端业务服务入口
cloud/yueqian-erp-cloud-gateway：云端网关
yueqian-erp-core：基础依赖与公共模型
yueqian-erp-comp：公共组件服务
yueqian-erp-basedata：基础资料
yueqian-erp-sc：采购、销售、零售、库存、物流
yueqian-erp-settle：费用、预付款、对账、结算
yueqian-erp-chart：统计分析与图表报表

运行形态

单体模式

适合本地开发和快速部署，统一从 yueqian-erp-api 启动。

Cloud 模式

保留 yueqian-erp-cloud-api + yueqian-erp-cloud-gateway 双服务形态，适合接入 Nacos、Gateway 等云端基础设施后使用。

环境要求

JDK 21
Maven 3.9+
MySQL 5.7.18+
Redis 4.0.8+
RabbitMQ 3.12.4+
Cloud 模式额外需要：Nacos，以及对应的云端配置环境

快速开始

构建全部模块

mvn clean package -DskipTests

启动单体应用

本地联调优先使用 self Profile，配置文件组合为 application.yml + application-self.yml：

mvn -pl yueqian-erp-api -am spring-boot:run -Dspring-boot.run.profiles=self

如果使用默认环境，也可以通过 Maven Profile 启动：

mvn -pl yueqian-erp-api -am spring-boot:run -Pdev

构建云端模块

mvn -pl cloud/yueqian-erp-cloud-api -am package
mvn -pl cloud/yueqian-erp-cloud-gateway -am package

Cloud 后端容器运行

yueqian-erp-cloud-api 与 yueqian-erp-cloud-gateway 支持作为独立云端服务镜像运行，默认通过外部 Nacos 获取配置与注册发现信息。

mvn -pl cloud/yueqian-erp-cloud-api -am package -DskipTests
mvn -pl cloud/yueqian-erp-cloud-gateway -am package -DskipTests

如果希望直接在模块目录里执行镜像构建脚本，请先手动完成对应模块的 Maven 打包：

Linux/macOS:

mvn -pl cloud/yueqian-erp-cloud-api -am package -DskipTests
cd cloud/yueqian-erp-cloud-api
sh build-image.sh

mvn -pl cloud/yueqian-erp-cloud-gateway -am package -DskipTests
cd ../yueqian-erp-cloud-gateway
sh build-image.sh

Windows PowerShell:

mvn -pl cloud/yueqian-erp-cloud-api -am package -DskipTests
cd cloud/yueqian-erp-cloud-api
.\build-image.ps1

mvn -pl cloud/yueqian-erp-cloud-gateway -am package -DskipTests
cd ..\yueqian-erp-cloud-gateway
.\build-image.ps1

Windows cmd:

mvn -pl cloud/yueqian-erp-cloud-api -am package -DskipTests
cd cloud\yueqian-erp-cloud-api
build-image.bat

mvn -pl cloud/yueqian-erp-cloud-gateway -am package -DskipTests
cd ..\yueqian-erp-cloud-gateway
build-image.bat

具体的镜像构建、模块级 docker compose 用法和环境变量约定见 docs/docker-cloud.md。

单体后端容器运行

yueqian-erp-api 支持作为单体后端镜像运行，MySQL、Redis、RabbitMQ 默认按外部基础设施接入。

mvn -pl yueqian-erp-api -am package -DskipTests
docker build -t yueqian-erp-api:local -f yueqian-erp-api/target/Dockerfile yueqian-erp-api/target

如果希望直接在模块目录里执行镜像构建脚本，请先手动完成 yueqian-erp-api 的 Maven 打包：