# interview-platform

**Repository Path**: jovan_yang/interview-platform

## Basic Information

- **Project Name**: interview-platform
- **Description**: AI 面试备战平台
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-10
- **Last Updated**: 2026-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 面试备战平台 (Interview Platform)

AI 驱动的面试备战 Monorepo：简历解析、岗位拆解、模拟面试、MiMo ASR/TTS、复盘报告。

## 项目结构

```
.
├── apps/
│   ├── web/          # 前端 React + Vite + Tailwind
│   └── server/       # 后端 Express + PostgreSQL + WebSocket
├── docs/             # PRD 与架构文档
├── docker-compose.yml
├── .env.example      # 环境变量模板（复制为 .env）
└── package.json      # npm workspaces 根配置
```

## 快速开始

### 1. 安装依赖

```bash
npm install
```

### 2. 配置环境变量

```bash
cp .env.example .env
# 编辑 .env，填入数据库、Redis、XIAOMI_API_KEY 等
```

### 3. 启动基础设施（可选）

```bash
npm run docker:up
```

### 4. 启动开发服务

```bash
npm run dev
```

- 前端：http://localhost:5173
- 后端：http://localhost:3001
- 健康检查：http://localhost:3001/api/health

## 常用命令

| 命令 | 说明 |
|------|------|
| `npm run dev` | 同时启动前后端 |
| `npm run dev:web` | 仅前端 |
| `npm run dev:server` | 仅后端 |
| `npm run build` | 构建前端 |
| `npm run test` | 后端单元测试 |
| `npm run typecheck` | 全项目类型检查 |
| `npm run seed` | 初始化种子数据 |

## 环境变量说明

所有服务共用仓库根目录的 `.env` 文件。后端通过 `apps/server/config` 加载，请勿在子包内单独维护密钥。

详见 [.env.example](./.env.example)。