erp-java/README.md

ERP Java 微服务

项目简介

ERP系统的Java微服务版本，采用Spring Cloud微服务架构。

技术栈

• 框架: Spring Boot 3.x, Spring Cloud 2023
• 数据库: MySQL 8.0, Redis 7
• 消息队列: RocketMQ
• 服务注册: Nacos
• ORM: MyBatis Plus, JPA
• 构建工具: Maven 3.8+
• Java版本: JDK 17+

项目结构

├── common/                 # 公共模块
│   ├── common-config/     # 配置模块
│   ├── common-core/       # 核心实体
│   ├── common-mybatis/    # MyBatis增强
│   ├── common-redis/      # Redis封装
│   └── common-web/        # Web增强
├── gateway/               # 网关服务
├── services/              # 业务服务
│   ├── user-service/      # 用户服务
│   ├── order-service/     # 订单服务
│   ├── product-service/   # 商品服务
│   ├── inventory-service/ # 库存服务
│   ├── finance-service/   # 财务服务
│   └── ...
├── nacos/                # Nacos配置
├── rocketmq/             # RocketMQ配置
├── seata/                # Seata分布式事务
└── deploy/              # 部署脚本

快速开始

环境要求

• JDK 17+
• Maven 3.8+
• MySQL 8.0
• Redis 7
• Nacos (可选)
• RocketMQ (可选)

构建

# 全量构建
mvn clean package -DskipTests

# 单服务构建
cd services/user-service
mvn clean package -DskipTests

配置

修改 services/*/src/main/resources/application.yml 中的数据库和Redis配置。

运行

# 运行单个服务
java -jar services/user-service/target/user-service.jar

# 使用Docker运行
docker-compose up -d

服务列表

服务	端口	说明
user-service	8082	用户认证服务
order-service	8084	订单服务
product-service	8083	商品服务
inventory-service	8085	库存服务
tenant-service	8086	租户服务
permission-service	8087	权限服务
dashboard-service	8088	仪表盘服务

API文档

启动服务后访问: http://localhost:服务端口/swagger-ui.html

开发指南

新增服务

1. 在 services/ 下创建新服务模块
2. 参考已有服务的pom.xml配置
3. 添加到根pom.xml的modules中
4. 创建数据库表和实体类
5. 实现Controller, Service, Repository层

代码规范

• 遵循阿里巴巴Java开发规范
• 使用Lombok简化代码
• 所有API返回统一格式: ApiResponse
• 分页查询使用PageResponse

许可证

私有项目，仅限内部使用