# RAG-Ai-应用系统-1班3组

**Repository Path**: grade-23-full-stack-class-1/rag-ai-application-system-class1-group3

## Basic Information

- **Project Name**: RAG-Ai-应用系统-1班3组
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2025-08-03
- **Last Updated**: 2025-08-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# RAG AI应用系统 - 基于向量数据库的智能问答平台

## 📋 项目介绍

### 项目概述
本项目是一个基于RAG（Retrieval-Augmented Generation）技术的智能问答系统，采用向量数据库存储文档知识，结合大语言模型提供精准的智能问答服务。系统支持多格式文档上传、智能分片、向量检索和AI对话，为用户提供高效的知识管理和智能交互体验。

### 技术栈说明
- **后端框架**: .NET 8.0 + ASP.NET Core + Entity Framework Core
- **数据库**: PostgreSQL + pgvector (向量数据库扩展)
- **前端管理**: Vue 3 + Element Plus + Vite + Pinia
- **移动端**: uni-app (跨平台开发框架)
- **架构模式**: 整洁架构 (Clean Architecture) + DDD (领域驱动设计)
- **部署**: Nginx + Systemd

### 功能特性介绍
- 🚀 **智能文档处理**: 支持PDF、Word、Excel等多种格式文档上传和智能分片
- 🔍 **向量检索**: 基于pgvector的高效相似度搜索和语义匹配
- 💬 **AI智能对话**: 支持普通模式和流式模式，提供上下文感知的智能问答
- 👥 **用户权限管理**: 基于角色的权限控制系统，支持多级用户管理
- 📱 **跨平台支持**: Web管理后台 + 移动端应用，响应式设计
- 🔧 **系统配置**: 灵活的AI模型配置和系统参数设置

## 🛠️ 开发环境运行说明

### 环境要求
- **操作系统**: Windows 10/11, macOS, Linux (Ubuntu 20.04+)
- **后端环境**: .NET 8.0 SDK
- **数据库**: PostgreSQL 15+ + pgvector扩展
- **前端环境**: Node.js 18+ + pnpm
- **移动端**: HBuilderX (uni-app开发工具)

### 安装步骤

#### 1. 克隆项目
```bash
git clone https://gitee.com/grade-23-full-stack-class-1/rag-ai-application-system-class1-group3.git
cd rag-ai-application-system-class1-group3
```

#### 2. 后端环境配置
```bash
cd backend/src/BaseBackend.Api
# 安装依赖
dotnet restore
# 配置数据库连接字符串 (appsettings.json)
# 运行数据库迁移
dotnet ef database update
# 启动后端服务
dotnet run
```

#### 3. 前端管理后台配置
```bash
cd frontend/UserManage
# 安装依赖
pnpm install
# 配置API地址 (src/api/apiServer.js)
# 启动开发服务器
pnpm dev
```

#### 4. 移动端配置
```bash
cd frontend/uni-apps
# 使用HBuilderX打开项目
# 配置API地址 (api/apiServer.js)
# 编译运行
```

### 配置说明
- **数据库连接**: 修改 `backend/src/BaseBackend.Api/appsettings.json` 中的连接字符串
- **AI服务配置**: 在管理后台的AI设置页面配置OpenAI API密钥和模型参数
- **文件存储**: 配置文档上传路径和存储策略
- **跨域设置**: 配置CORS策略以支持前后端分离部署

### 常见问题解答
**Q: pgvector扩展安装失败？**
A: 确保PostgreSQL版本兼容，在Debian/Ubuntu系统上使用提供的安装脚本。

**Q: 前端无法连接后端API？**
A: 检查CORS配置、API地址配置和防火墙设置。

**Q: 文档上传失败？**
A: 检查文件权限、存储路径配置和文件大小限制。

## 🚀 部署方案

### Docker部署方案
```bash
# 使用提供的部署脚本
chmod +x scripts/server.sh
sudo ./scripts/server.sh
```

### 生产环境部署说明
1. **服务器要求**: 推荐2核4G以上配置，Ubuntu 20.04+系统
2. **域名配置**: 配置域名解析和SSL证书
3. **数据库优化**: 配置PostgreSQL连接池和性能参数
4. **监控告警**: 配置系统监控和日志收集
5. **备份策略**: 定期备份数据库和文件存储

### 部署脚本提供
- **自动部署脚本**: `scripts/server.sh` - 适用于Debian/Ubuntu系统
- **一键部署**: 自动安装依赖、配置服务、启动应用
- **服务管理**: 自动配置systemd服务和Nginx反向代理

## 🎨 项目展示

### 运行效果截图

#### 管理后台界面
**知识库管理页**
![知识库管理](https://gitee.com/pxllx/picture-bed/raw/master/img/202508151412286.png)

**文件上传功能**
![文件上传](https://gitee.com/pxllx/picture-bed/raw/master/img/202508151413331.png)

**AI系统设置页**
![AI设置](https://gitee.com/pxllx/picture-bed/raw/master/img/202508151425998.png)

#### 用户端界面
**AI对话测试普通模式**
![AI对话普通模式](https://gitee.com/pxllx/picture-bed/raw/master/img/202508151420888.png)

**AI对话测试流式模式**
![AI对话流式模式](https://gitee.com/pxllx/picture-bed/raw/master/img/202508151423998.png)

**AI会话页面**
![AI会话](https://gitee.com/pxllx/picture-bed/raw/master/img/202508151428297.png)

#### 移动端效果
**手机端适配**
![移动端效果1](https://gitee.com/pxllx/picture-bed/raw/master/img/202508151433993.png)

![移动端效果2](https://gitee.com/pxllx/picture-bed/raw/master/img/202508151432460.png)

#### 关键功能演示
**文件上传成功**
![上传成功](https://gitee.com/pxllx/picture-bed/raw/master/img/202508151415023.png)

**查看分片**
![查看分片](https://gitee.com/pxllx/picture-bed/raw/master/img/202508151419540.png)

**个人信息页**
![个人信息](https://gitee.com/pxllx/picture-bed/raw/master/img/202508151429460.png)

### 演示视频或在线地址
- **在线演示**: 可通过成员部署地址访问体验
- **功能演示**: 包含完整的系统功能演示流程

### 成员部署访问地址
- **李政哲**: http://takagi.fun
- **彭小林**: http://zmxhpxl.cn  
- **赖嘉伟**: http://jia.kakacardigan.cn
- **肖诗浩**: http://47.99.120.245

## 🔐 默认账户信息
- **超级管理员**: root
- **默认密码**: rootroot

## 📚 相关文档
- [API接口文档](docs/API接口文档.md)
- [技术设计文档](docs/技术设计文档.md)
- [用户手册](docs/用户手册.md)
- [开发日志](docs/开发日志.md)