# AiDwInterview

**Repository Path**: leejersey/ai-dw-interview

## Basic Information

- **Project Name**: AiDwInterview
- **Description**: AI 面试助手是一款智能面试辅助平台，集成了 AI 技术帮助求职者准备面试。平台提供面试押题、专项练习、HR 面试模拟等功能，采用 SSE 流式响应提供实时交互体验。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-02-05
- **Last Updated**: 2026-08-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 面试助手（AiInterview）

基于 **React + NestJS + LangChain** 构建的企业级 AI 面试 SaaS 平台。

## 📋 项目概述

AI 面试助手是一款智能面试辅助平台，集成了 AI 技术帮助求职者准备面试。平台提供面试押题、专项练习、HR 面试模拟等功能，采用 SSE 流式响应提供实时交互体验。

## 🏗️ 项目结构

```
AiInterview/
├── ww-client/                    # 前端项目（React + TypeScript + Vite）
│   ├── src/
│   │   ├── components/           # 通用组件
│   │   ├── contexts/             # React Context
│   │   ├── pages/                # 页面组件
│   │   ├── services/             # API 服务
│   │   └── assets/               # 静态资源
│   └── ...
│
├── ww-server/                    # 后端项目（NestJS + LangChain）
│   ├── src/
│   │   ├── auth/                 # 认证模块
│   │   ├── user/                 # 用户模块
│   │   ├── interview/            # 面试模块（核心业务）
│   │   ├── payment/              # 支付模块
│   │   ├── wechat/               # 微信模块
│   │   ├── sts/                  # STS 临时凭证模块
│   │   └── common/               # 公共模块
│   └── ...
│
└── README.md                     # 项目总览（本文件）
```

## 🛠️ 技术栈

### 前端（ww-client）

| 分类 | 技术 |
|------|------|
| **框架** | React 19.x |
| **构建工具** | Vite 7.x |
| **语言** | TypeScript 5.x |
| **路由** | React Router 7.x |
| **HTTP 客户端** | Axios |
| **样式** | CSS |

### 后端（ww-server）

| 分类 | 技术 |
|------|------|
| **框架** | NestJS 11.x |
| **AI 框架** | LangChain 1.1.1 + DeepSeek |
| **数据库** | MongoDB 9.x + Mongoose ODM |
| **认证系统** | JWT + Passport |
| **语言** | TypeScript 5.x |

## ✨ 核心功能

- 🎯 **面试押题** - AI 智能生成面试题目
- 📝 **专项练习** - 分类练习面试题
- 🗣️ **HR 模拟面试** - AI 模拟真实 HR 面试场景
- 📊 **面试报告** - 详细的面试表现分析
- 👤 **用户管理** - 注册、登录、个人中心
- 📋 **面试记录** - 历史面试记录查看

## 🚀 快速开始

### 环境要求

- Node.js >= 18.x
- npm >= 9.x
- MongoDB >= 6.x

### 1. 克隆项目

```bash
git clone https://github.com/your-username/AiInterview.git
cd AiInterview
```

### 2. 启动后端服务

```bash
cd ww-server

# 安装依赖
npm install --legacy-peer-deps

# 配置环境变量（参考 .env.development）
cp .env.development .env

# 启动开发服务器
npm run start:dev
```

后端服务将在 `http://localhost:3000` 运行。

### 3. 启动前端应用

```bash
cd ww-client

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端应用将在 `http://localhost:5173` 运行。

## 📖 详细文档

- [前端文档](./ww-client/README.md)
- [后端文档](./ww-server/README.md)

## 🔧 开发脚本

### 前端脚本

```bash
npm run dev        # 启动开发服务器
npm run build      # 构建生产版本
npm run lint       # 代码检查
npm run preview    # 预览生产版本
```

### 后端脚本

```bash
npm run start:dev  # 启动开发服务器（热重载）
npm run start:prod # 启动生产服务器
npm run build      # 构建项目
npm run test       # 运行测试
npm run lint       # 代码检查
npm run format     # 代码格式化
```

## 🌍 环境配置

### 后端环境变量（ww-server/.env）

```env
# 数据库配置
MONGODB_URI=mongodb://localhost:27017/wwzhidao
DB_TYPE=mongodb

# JWT 配置
JWT_SECRET=your-secret-key
JWT_EXPIRES_IN=24h

# 服务器配置
PORT=3001
NODE_ENV=development

# AI 配置
DEEPSEEK_API_KEY=your-deepseek-api-key
DEEPSEEK_MODEL=deepseek-chat
MAX_TOKENS=4000
```

## 📄 License

UNLICENSED