# fast-archetype-generator

**Repository Path**: yaozd/fast-archetype-generator

## Basic Information

- **Project Name**: fast-archetype-generator
- **Description**: Fast Archetype Generator 是一个基于 Maven Archetype 的项目脚手架生成器，用于快速创建具有完整微服务架构的 Spring Boot 项目
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-02-03
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Fast Archetype Generator

Fast Archetype Generator 是一个基于 Maven Archetype 的项目脚手架生成器，用于快速创建具有完整微服务架构的 Spring Boot 项目。

## 目录结构

生成的项目采用模块化设计，包含以下核心模块：

```
project-name/
├── project-name-adapter/       # 适配层，处理外部请求（如 Web 控制器）
├── project-name-app/           # 应用层，实现业务逻辑
├── project-name-client/        # 客户端模块，提供给其他服务调用的客户端
├── project-name-domain/        # 领域层，核心业务逻辑和实体定义
├── project-name-infrastructure/ # 基础设施层，提供数据访问和技术组件支持
├── start/                      # 启动模块，Spring Boot 启动类
└── pom.xml                     # 父级 pom.xml，管理所有依赖和插件
```

## 技术栈

- **Java 版本**: 21
- **Spring Boot**: 3.2.0
- **Spring Cloud**: 2023.0.0
- **Spring Cloud Alibaba**: 2023.0.1.0

### 核心组件

- **持久层**: MyBatis Plus 3.5.5, Druid 1.2.21, MySQL 8.0.33
- **工具类**: Lombok 1.18.30, MapStruct 1.6.3, Hutool 5.8.20, Guava 32.1.3-jre
- **文档**: SpringDoc OpenAPI 2.3.0
- **测试**: JUnit 5.10.1, Mockito 5.8.0
- **安全**: Sa-Token 1.44.0
- **缓存**: Redisson 3.41.0
- **其他**: FastJSON2 2.0.58, Jakarta Validation 3.0.2

## 使用方法

### 安装 Archetype

```bash
mvn install
```

### 使用 Archetype 创建新项目

```bash
mvn archetype:generate \
  -DarchetypeGroupId=com.cwh \
  -DarchetypeArtifactId=fast-archetype-generator \
  -DarchetypeVersion=1.0.0-SNAPSHOT \
  -DgroupId=com.example \
  -DartifactId=demo \
  -Dversion=1.0.0-SNAPSHOT \
  -Dpackage=com.example.demo
```

或者交互式生成：

```bash
mvn archetype:generate -DarchetypeGroupId=com.cwh -DarchetypeArtifactId=fast-archetype-generator
```

按照提示输入 groupId、artifactId 、version和package 即可生成新的项目。

## 项目特点

1. **模块化设计**: 清晰的分层架构，符合领域驱动设计（DDD）思想
2. **技术集成**: 预集成了主流的开发框架和中间件
3. **开箱即用**: 包含基础的 Controller 示例和启动类
4. **易于扩展**: 可在现有架构基础上轻松添加新功能模块

## 启动项目

生成项目后，进入项目目录并运行：

```bash
cd fantscreat-user
mvn spring-boot:run -f start/pom.xml
```

或通过 IDE 运行 StartApplication 类。

访问测试接口：
```
GET http://localhost:8080/api/test/hello
```

## 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目。