# 技术选型

> 本项目技术选型说明，包含与框架规范的覆盖声明

---

## 一、遵循框架规范

| 层级 | 技术 | 说明 |
|------|------|------|
| **前端框架** | Vue 3 + TypeScript | 符合框架规范 |
| **构建工具** | Vite | 符合框架规范 |
| **UI 组件库** | Element Plus | 符合框架规范 |
| **CSS 方案** | Tailwind CSS | 符合框架规范 |
| **HTTP 客户端** | Axios | 符合框架规范 |
| **状态管理** | Pinia | 按需使用 |
| **后端框架** | Python + FastAPI | 符合框架规范 |
| **容器化** | Docker + Docker Compose | 符合框架规范 |

---

## 二、技术选型覆盖

> 以下选项与框架默认规范不同，需特别说明

| 项目 | 框架默认 | 本项目选择 | 覆盖原因 |
|------|----------|------------|----------|
| **AI 网关** | OpenRouter.ai | Coze API | 复用已有 Coze 工作流，包含完整面试逻辑 |
| **数据存储** | MySQL | Coze 数据库 | 复用现有数据结构，减少开发工作量 |
| **实时音视频** | - | 火山引擎 RTC | 与 Coze 同属火山引擎生态，官方支持对接 |

---

## 三、第三方服务依赖

### 3.1 Coze 平台

| 资源 | ID | 用途 |
|------|-----|------|
| Bot（工作流） | 7595113005181386792 | AI 面试官对话逻辑 |
| 数据库 | 7595077053909712922 | 候选人数据存储 |

**API 端点**：
- 基础 URL：`https://api.coze.cn`
- 文件上传：`POST /v1/files/upload`
- 语音房间：`POST /v1/audio/rooms`
- 数据库查询：`POST /v1/database/query`

### 3.2 火山引擎 RTC

| 配置项 | 说明 |
|--------|------|
| SDK | `@volcengine/rtc` |
| 音频格式 | PCM 16000Hz |
| 用途 | 前端与 Coze Bot 实时语音通话 |

---

## 四、环境变量

```bash
# Coze 配置
COZE_API_BASE=https://api.coze.cn
COZE_PAT_TOKEN=pat_xxx              # 从 Coze 平台获取
COZE_BOT_ID=7595077233002840079
COZE_DATABASE_ID=7595077053909712922

# 火山引擎 RTC 配置
VOLCENGINE_APP_ID=xxx               # 从火山引擎控制台获取
VOLCENGINE_APP_KEY=xxx

# 服务配置
API_PORT=8000
FRONTEND_URL=http://localhost:5173
```

---

## 五、前端依赖清单

```json
{
  "dependencies": {
    "vue": "^3.4.0",
    "vue-router": "^4.2.0",
    "pinia": "^2.1.0",
    "axios": "^1.6.0",
    "element-plus": "^2.5.0",
    "@element-plus/icons-vue": "^2.3.0",
    "@volcengine/rtc": "^4.x"
  },
  "devDependencies": {
    "typescript": "^5.3.0",
    "vite": "^5.0.0",
    "tailwindcss": "^3.4.0",
    "@vitejs/plugin-vue": "^5.0.0"
  }
}
```

---

## 六、后端依赖清单

```txt
# requirements.txt
fastapi>=0.109.0
uvicorn>=0.27.0
httpx>=0.26.0
python-multipart>=0.0.6
pydantic>=2.5.0
python-dotenv>=1.0.0
```

---

## 变更日志

| 日期 | 变更内容 | 操作人 |
|------|---------|--------|
| 2026-01-20 | 初始化技术选型 | AI |
