# AMS

**Repository Path**: ypd0210/artificial-intelligence-management-system

## Basic Information

- **Project Name**: AMS
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 人工智能管理系统 (AIMS)

一个基于 Spring Cloud 微服务架构的人工智能管理系统，提供 AI 聊天、文档解析、RAG（检索增强生成）等核心功能。

## 项目简介

AIMS（Artificial Intelligence Management System）是一个企业级的 AI 服务管理平台，采用微服务架构设计，支持多租户对话、知识库管理和智能文档分析。

## 技术栈

### 后端技术
- **Spring Boot 3.x** - 基础框架
- **Spring Cloud** - 微服务治理
- **Spring AI** - AI 能力集成
- **MyBatis Plus** - ORM 框架
- **Redis** - 缓存与会话存储
- **MongoDB** - 聊天历史存储
- **MinIO** - 对象存储服务
- **Weaviate** - 向量数据库
- **Milvus** - 另一个向量数据库选项
- **OpenAI** - 大语言模型

### 架构模式
- 微服务架构 (Spring Cloud Gateway)
- Feign 客户端服务调用
- 负载均衡 (Spring Cloud LoadBalancer)

## 模块说明

| 模块 | 说明 |
|------|------|
| **AMSCore** | 核心公共模块，提供通用常量、工具类、响应封装 |
| **AiCenter** | AI 核心服务，提供智能对话、PDF 解析、RAG 检索 |
| **AmsGateway** | API 网关，统一入口，负载均衡，跨域处理 |
| **AuthCenter** | 认证中心，负责用户认证与授权 |
| **CommonService** | 公共服务，提供文件上传、存储桶管理 |
| **CommonWeb** | Web 公共组件，异常处理、数据验证 |
| **FeignApi** | Feign 接口定义，供服务间调用 |

## 核心功能

### 🤖 AI 智能对话
- 流式响应输出
- 多轮对话支持
- 基于 Redis 的会话记忆存储

### 📄 文档智能解析
- PDF 文件上传与管理
- 文档内容向量化存储
- 语义搜索与问答

### 🔍 RAG 检索增强
- 结合向量数据库实现知识检索
- 支持 Weaviate/Milvus 向量存储
- 余弦距离/欧氏距离计算

### 📁 文件管理
- MinIO 对象存储集成
- 存储桶创建与管理
- 文件预览与下载（带签名 URL）

## 快速开始

### 环境要求
- JDK 17+
- Maven 3.8+
- Redis
- MongoDB
- MinIO
- Weaviate 或 Milvus

### 构建项目

```bash
# 克隆项目
git clone https://gitee.com/ypd0210/artificial-intelligence-management-system.git

# 进入项目目录
cd artificial-intelligence-management-system

# 编译打包
mvn clean package -DskipTests
```

### 启动服务

建议按以下顺序启动：

1. **启动注册中心** (Nacos/Eureka)
2. **启动 AmsGateway** - 端口 8080
3. **启动 AuthCenter** - 认证服务
4. **启动 CommonService** - 文件服务
5. **启动 AiCenter** - AI 核心服务

### 配置说明

各模块配置文件位于 `src/main/resources/application.yaml`：

```yaml
# AiCenter 主要配置
spring:
  ai:
    openai:
      api-key: your-api-key
      chat:
        options:
          model: gpt-4
    vectorstore:
      weaviate:
        host: localhost
        scheme: http

# CommonService MinIO 配置
minio:
  endpoint: http://localhost:9000
  access-key: minioadmin
  secret-key: minioadmin
  bucket: your-bucket
```

## API 文档

启动服务后访问 Swagger 文档：
- AiCenter: `http://localhost:8081/swagger-ui.html`
- CommonService: `http://localhost:8082/swagger-ui.html`

### 核心接口

#### AI 对话
```bash
# 流式聊天
POST /ai/chat?question=你好&chatId=xxx

# PDF 问答
POST /ai/chat/pdf?question=总结文档&chatId=xxx&topK=3

# 文档解析上传
POST /ai/analyze/pdf?chatId=xxx
```

#### 文件管理
```bash
# 上传文件
POST /file/upload?chatId=xxx

# 预览文件
GET /file/preview?fileName=xxx

# 下载文件
GET /file/download?fileName=xxx

# 分页查询
GET /file/page?chatId=xxx&pageNum=1&pageSize=10
```

## 项目结构

```
├── AMSCore/                 # 核心公共模块
│   ├── common/              # 公共组件
│   ├── config/              # 配置类
│   ├── domain/              # 领域模型
│   └── support/             # Spring 工具
├── AiCenter/                # AI 核心服务
│   ├── client/              # Feign 客户端
│   ├── config/              # AI 配置
│   ├── controller/          # 控制器
│   ├── exception/           # 异常处理
│   ├── pojo/                # 数据模型
│   ├── repository/          # 数据仓储
│   ├── service/             # 业务服务
│   └── tools/               # 工具类
├── AmsGateway/              # API 网关
├── AuthCenter/              # 认证服务
├── CommonService/           # 公共服务
│   ├── config/              # 配置
│   ├── controller/          # 控制器
│   ├── mapper/              # 数据映射
│   ├── service/             # 服务层
│   └── util/                # 工具类
├── CommonWeb/               # Web 公共组件
│   ├── config/              # 配置
│   ├── entity/              # 实体类
│   ├── exception/           # 异常处理
│   ├── handler/             # 处理器
│   ├── model/               # 数据模型
│   └── util/                # 工具类
└── FeignApi/                # Feign API
```

## 许可证

本项目基于 [MIT License](LICENSE) 开源协议。

## 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/xxx`)
3. 提交更改 (`git commit -m 'Add xxx'`)
4. 推送分支 (`git push origin feature/xxx`)
5. 创建 Pull Request