# spring-cloud-ai-scaffold

**Repository Path**: chnj1981/spring-cloud-ai-scaffold

## Basic Information

- **Project Name**: spring-cloud-ai-scaffold
- **Description**: Spring Cloud AI 脚手架 - 集成 AI 能力的微服务架构
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-16
- **Last Updated**: 2026-04-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Spring Cloud AI Scaffold

Spring Cloud AI 脚手架 - 集成 AI 能力的微服务架构

## 项目简介

这是一个基于 Spring Cloud 的微服务脚手架，集成了 Spring AI、Spring Cloud Alibaba 等组件，适合快速构建 AI 应用。

## 模块说明

```
spring-cloud-ai-scaffold/
├── spring-ai-common          # 公共模块：工具类、响应封装、异常定义
├── spring-ai-api-gateway     # API网关：路由、鉴权、限流
├── spring-ai-user-service    # 用户服务：用户管理、认证授权
└── spring-ai-chat-service   # 聊天服务：AI对话、会话管理
```

## 技术栈

| 技术 | 版本 | 说明 |
|------|------|------|
| Spring Boot | 3.3.0 | 基础框架 |
| Spring Cloud | 2023.0.1 | 微服务框架 |
| Spring AI | 1.0.0-M4 | AI集成框架 |
| Spring AI Alibaba | 1.0.0.2 | 阿里云AI集成 |
| MyBatis Plus | 3.5.5 | ORM框架 |
| Redis | - | 缓存/会话存储 |
| MySQL | 8.0 | 关系数据库 |
| JWT | 0.12.3 | 身份认证 |

## 快速开始

### 环境要求

- JDK 17+
- Maven 3.8+
- MySQL 8.0+
- Redis 6.0+

### 构建项目

```bash
# 克隆项目
git clone https://gitee.com/chnj1981/spring-cloud-ai-scaffold.git
cd spring-cloud-ai-scaffold

# 构建
mvn clean install -DskipTests
```

### 配置说明

1. 修改各模块的 `application.yml` 配置
2. 配置数据库连接信息
3. 配置 Redis 连接信息
4. 配置 AI 模型 API Key

### 启动服务

```bash
# 启动网关
cd spring-ai-api-gateway
mvn spring-boot:run

# 启动用户服务
cd spring-ai-user-service
mvn spring-boot:run

# 启动聊天服务
cd spring-ai-chat-service
mvn spring-boot:run
```

## API 文档

启动服务后访问:
- Swagger UI: http://localhost:8080/swagger-ui
- Knife4j: http://localhost:8080/doc.html

## License

MIT License