# machine-monolith-java

**Repository Path**: machineswift/machine-monolith-java

## Basic Information

- **Project Name**: machine-monolith-java
- **Description**: ERP系统（单体架构）
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-06
- **Last Updated**: 2026-02-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Machine Monolith Java

<div align="center">

![Java](https://img.shields.io/badge/Java-21-orange.svg)
![Spring Boot](https://img.shields.io/badge/Spring%20Boot-3.5.8-brightgreen.svg)
![License](https://img.shields.io/badge/License-MIT-blue.svg)
![Maven](https://img.shields.io/badge/Maven-3.6+-red.svg)

**企业级 Java 单体应用系统 - 基于 Spring Boot 3 的现代化企业管理系统**

[功能特性](#-功能特性) • [技术栈](#-技术栈) • [快速开始](#-快速开始) • [项目结构](#-项目结构) • [文档](#-文档)

</div>

---

## 📖 项目简介

Machine Monolith Java 是一个基于 Spring Boot 3 构建的企业级单体应用系统，采用现代化的技术栈和架构设计，提供完整的身份认证、权限管理、数据管理、客户关系管理、人力资源管理等企业级功能模块。

本项目采用多模块 Maven 架构，通过 Spring Boot Starter 机制实现模块化封装，支持灵活的扩展和定制。系统内置完善的权限控制、多租户支持、文件存储、消息通知等企业级特性。

## ✨ 功能特性

### 🔐 身份认证与授权 (IAM)
- **多种登录方式**：支持用户名密码、手机验证码登录
- **OAuth2 认证**：完整的 OAuth2 授权服务器和资源服务器实现
- **第三方登录**：集成 Gitee、飞书等第三方平台登录
- **JWT Token**：基于 JWT 的无状态认证机制
- **权限管理**：基于角色的访问控制（RBAC），支持细粒度权限控制
- **组织架构**：支持多级组织架构管理
- **用户管理**：完整的用户生命周期管理

### 📊 数据管理 (Data)
- **基础数据管理**：区域、品牌、物料、供应商等基础数据维护
- **标签系统**：灵活的多级标签分类体系
- **附件管理**：统一的文件上传、下载、分类管理
- **店铺管理**：多店铺信息管理
- **消息通知**：站内消息和消息模板管理
- **下载中心**：文件下载中心功能

### 👥 客户关系管理 (CRM)
- **客户管理**：客户信息维护和客户关系跟踪
- **会员管理**：会员等级、积分、权益管理

### 👨‍💼 人力资源管理 (HRM)
- **组织架构**：部门、岗位管理
- **员工管理**：员工信息、入职、离职管理
- **岗位管理**：岗位信息维护


## 📁 项目结构

```
machine-monolith-java/
├── machine-apps/                    # 应用模块
│   └── machine-manage-app/         # 主应用入口
│       ├── src/main/java/          # Java 源代码
│       └── src/main/resources/     # 配置文件
│
├── machine-clients/                 # 客户端模块（API 接口定义）
│   ├── machine-iam-client/         # IAM 客户端
│   ├── machine-data-client/        # 数据服务客户端
│   ├── machine-crm-client/          # CRM 客户端
│   ├── machine-hrm-client/          # HRM 客户端
│   ├── machine-scm-client/          # SCM 客户端
│   └── machine-tpp-client/          # 第三方平台客户端
│
├── machine-services/                # 服务实现模块
│   ├── machine-iam-service/        # IAM 服务实现
│   ├── machine-data-service/       # 数据服务实现
│   ├── machine-crm-service/        # CRM 服务实现
│   ├── machine-hrm-service/        # HRM 服务实现
│   └── machine-scm-service/         # SCM 服务实现
│
├── machine-starters/                # Spring Boot Starter 模块
│   ├── machine-common-boot-starter/        # 通用 Starter
│   ├── machine-mybatis-boot-starter/      # MyBatis Starter
│   ├── machine-redis-boot-starter/         # Redis Starter
│   ├── machine-security-boot-starter/      # 安全认证 Starter
│   └── machine-obs-boot-starter/           # 对象存储 Starter
│
├── machine-generals/                # 通用模块
│   └── machine-common-sdk/         # 通用 SDK
│
├── pom.xml                          # 父 POM
└── README.md                        # 项目说明文档
```


### 模块说明

- **machine-apps**: 应用层，包含主应用入口和控制器
- **machine-clients**: 客户端层，定义服务接口和 DTO
- **machine-services**: 服务层，实现业务逻辑和数据访问
- **machine-starters**: 自动配置模块，封装通用功能
- **machine-generals**: 通用工具和 SDK

## 📄 许可证

本项目采用 [MIT License](LICENSE) 许可证。

## 👥 作者

**machineswift**

- Gitee: [@machineswift](https://gitee.com/machineswift)