# ai-interview-system

**Repository Path**: cloudxf/ai-interview-system

## Basic Information

- **Project Name**: ai-interview-system
- **Description**: 本项目是一个智能面试系统，利用大语言模型实现自动化面试流程。系统支持：
- **AI实时面试**：模拟真实面试场景，自动提问和评估
- **语音交互**：支持语音问答，实时语音识别和合成
- **情绪分析**：结合面部表情进行多模态评估
- **题库管理**：丰富的面试题库和知识库管理
- **简历解析**：自动解析简历并生成个性化面试问题
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-07-19
- **Last Updated**: 2026-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI面试助手系统

> 基于大语言模型的智能面试系统，支持实时语音交互、面部表情分析和多模态评估。

## 🎯 项目简介

本项目是一个智能面试系统，利用大语言模型实现自动化面试流程。系统支持：
- **AI实时面试**：模拟真实面试场景，自动提问和评估
- **语音交互**：支持语音问答，实时语音识别和合成
- **情绪分析**：结合面部表情进行多模态评估
- **题库管理**：丰富的面试题库和知识库管理
- **简历解析**：自动解析简历并生成个性化面试问题

## 🛠️ 技术栈

### 后端技术
| 技术 | 版本 | 说明 |
|------|------|------|
| Java | 21 | 编程语言 |
| Spring Boot | 3.2.x | 后端框架 |
| Spring Security | 6.x | 安全框架 |
| MySQL | 8.0+ | 关系型数据库 |
| Redis | 7.0+ | 缓存和会话管理 |
| MinIO | 8.x | 对象存储 |
| LangChain4j | 0.28.x | 大模型集成框架 |
| 阿里云NLS | - | 语音识别与合成 |
| DashScope | - | 情绪分析服务 |

### 前端技术
| 技术 | 版本 | 说明 |
|------|------|------|
| Vue | 3.4.x | 前端框架 |
| Vite | 6.5.x | 构建工具 |
| Pinia | 2.1.x | 状态管理 |
| Vue Router | 4.3.x | 路由管理 |
| WebSocket | - | 实时通信 |

## ✨ 功能特性

### 核心功能
- **AI面试模块**：智能提问、实时评估、多轮对话
- **语音交互**：实时ASR语音识别、TTS语音合成
- **视频分析**：面部表情识别、情绪分析
- **题库管理**：面试题库增删改查、分类管理
- **知识问答**：基于知识库的问答系统
- **简历解析**：PDF简历解析、信息提取

### 用户功能
- 用户注册与登录
- 面试历史记录
- 收藏题目管理
- 面试评分查看
- 数据统计展示

## 📁 项目结构

```
├── coonsultant/                    # 后端项目
│   ├── src/main/java/com/example/coonsultant/
│   │   ├── controller/            # REST API 控制层
│   │   ├── service/               # 业务逻辑层
│   │   ├── mapper/                # 数据访问层
│   │   ├── pojo/                  # 数据模型
│   │   ├── config/                # 配置类
│   │   ├── websocket/             # WebSocket 处理
│   │   └── aiservice/             # AI服务接口
│   ├── src/main/resources/
│   │   ├── mapper/                # MyBatis XML
│   │   ├── application.yml        # 应用配置
│   │   └── database.sql           # 数据库脚本
│   ├── knowledge_base/            # 知识库文件
│   └── pom.xml                    # Maven配置

└── Interview Question Answering System/
    └── InterviewQuestionAnsweringSystemQd/
        ├── src/
        │   ├── views/             # 页面组件
        │   ├── components/        # 公共组件
        │   ├── api/               # API封装
        │   ├── stores/            # Pinia状态管理
        │   └── router/            # 路由配置
        ├── public/                # 静态资源
        ├── index.html             # HTML入口
        └── package.json           # 前端依赖
```

## 🚀 快速开始

### 环境要求

- **Java**: JDK 21+
- **Maven**: 3.8+
- **Node.js**: 18+
- **MySQL**: 8.0+
- **Redis**: 7.0+
- **MinIO**: 8.x (可选)

### 后端启动

1. **克隆项目**
   ```bash
   git clone <仓库地址>
   cd coonsultant
   ```

2. **配置数据库**
   - 创建数据库：`interview_system`
   - 执行初始化脚本：`src/main/resources/database.sql`
   - 配置连接信息：`src/main/resources/application.yml`

3. **配置第三方服务**
   - 阿里云NLS配置（ASR/TTS）
   - 阿里云DashScope配置（情绪分析）
   - MinIO配置（可选）

4. **启动服务**
   ```bash
   mvn spring-boot:run
   ```

### 前端启动

1. **进入前端目录**
   ```bash
   cd "Interview Question Answering System/InterviewQuestionAnsweringSystemQd"
   ```

2. **安装依赖**
   ```bash
   npm install
   ```

3. **启动开发服务器**
   ```bash
   npm run dev
   ```

### 访问地址

- 后端API：`http://localhost:8080`
- 前端页面：`http://localhost:5173`

## 🔌 API接口

### 主要接口列表

| 模块 | 路径 | 方法 | 说明 |
|------|------|------|------|
| 用户 | `/api/users/login` | POST | 用户登录 |
| 用户 | `/api/users/register` | POST | 用户注册 |
| 面试 | `/api/interview/start` | POST | 开始面试 |
| 面试 | `/api/interview/submit` | POST | 提交答案 |
| 题库 | `/api/questions` | GET | 获取题库列表 |
| 题库 | `/api/questions/{id}` | GET | 获取题目详情 |
| 知识库 | `/api/knowledge` | GET | 获取知识库 |
| AI面试 | `/api/ai/interview` | POST | AI面试对话 |
| 评分 | `/api/score/{userId}` | GET | 获取用户评分 |

详细API文档请查看：[API文档.md](./src/main/resources/API文档.md)

## 🔧 配置说明

### 应用配置 (`application.yml`)

```yaml
server:
  port: 8080

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/interview_system
    username: root
    password: password

redis:
  host: localhost
  port: 6379

# AI服务配置
ai:
  openai:
    base-url: https://api.openai.com/v1
    api-key: your-api-key
    model-name: gpt-3.5-turbo

# 阿里云服务配置
aliyun:
  nls:
    app-key: your-app-key
    access-key-id: your-access-key
    access-key-secret: your-secret

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

## 📊 数据库结构

### 核心表结构

| 表名 | 说明 |
|------|------|
| `users` | 用户信息表 |
| `interview` | 面试记录表 |
| `question` | 题目表 |
| `category` | 分类表 |
| `knowledge` | 知识库表 |
| `score` | 评分表 |
| `favorite` | 收藏表 |

详细数据库设计请查看：[database.sql](./src/main/resources/database.sql)

## 🤝 贡献指南

欢迎提交Issue和PR！

1. Fork本仓库
2. 创建功能分支：`git checkout -b feature/xxx`
3. 提交修改：`git commit -m 'Add xxx feature'`
4. 推送到分支：`git push origin feature/xxx`
5. 创建Pull Request

## 📄 许可证

本项目采用 MIT 许可证，详见 [LICENSE](./LICENSE) 文件。

## 📞 联系方式

如有问题或建议，欢迎通过以下方式联系：

- 项目地址：[Gitee仓库](https://gitee.com/yk2333666/ai-interview-system)

---

**⭐ 如果这个项目对你有帮助，请给个Star支持一下！**