# 项目上下文

> AI启动时必读此文件，快速了解项目全貌

## 一、项目信息

| 项目 | 内容 |
|------|------|
| **项目编号** | 011-ai-interview-2601 |
| **项目路径** | `projects/011-ai-interview-2601/` |
| **当前阶段** | 开发阶段 - 核心功能完成，语音模式优化中 |
| **项目状态** | 🟡 开发中 - 文字模式可用，语音模式待优化 |
| **启动日期** | 2026-01-20 |
| **技术栈** | Vue3 + TypeScript + FastAPI + Coze API + @coze/realtime-api |

## 二、AI启动指令

请依次阅读以下文件：

1. **框架层**（了解规则）
   - `../../_framework/agents/00-框架总览.md`
   - 检查 `agents/` 是否有项目覆盖

2. **项目文档**（了解当前状态）
   - `docs/同步清单.md`
   - `docs/项目状态快照.md`
   - `docs/决策记录.md`（最近10条）

3. **技术选型**（本项目有覆盖）
   - `docs/技术选型.md` ⚠️ 必读，包含框架规范覆盖说明

## 三、文件访问边界

| 区域 | 读取 | 写入 |
|------|------|------|
| ✅ 本项目目录 | 允许 | 允许 |
| ✅ `_framework/` | 允许 | ⚠️ 需确认 |
| ⚠️ `_private/` | 需许可 | ❌ **绝对禁止** |
| ❌ 其他项目 | 禁止 | 禁止 |

## 四、关键联系人

| 角色 | 姓名 | 说明 |
|------|------|------|
| 项目负责人 | | |
| 技术负责人 | | |

## 五、项目简介

**AI Interview** - AI 语音面试系统

为轻医美行业打造 AI 面试官系统，实现咨询师岗位的智能初试：
1. 候选人访问网页，输入姓名、上传简历
2. 系统"模拟来电"，候选人接听后进入实时语音面试
3. AI 面试官按预设流程提问（销售技能、销售观、素质项、求职动机）
4. 面试结束后，系统生成评分和分析报告
5. HR/管理员在后台查看候选人的完整分析报告

## 六、现有资源

| 资源 | ID | 说明 |
|------|-----|------|
| Workflow A (初始化) | 7597357422713798710 | 接收 name + file_url，生成 session_id |
| Workflow B (面试) | 7595077233002840079 | 4 维度提问、评分、生成报告 |
| Workflow C (查询) | 7597376294612107318 | 数据库增删改查封装 |
| Coze 数据库 | 7595077053909712922 | assessments, logs, config 三表 |
| 文件服务器 | files.test.ai.ireborn.com.cn | 自建 Nginx + PHP 文件服务 |

## 七、技术栈覆盖

> ⚠️ 本项目与框架规范有以下差异，详见 `docs/技术选型.md`

| 项目 | 框架默认 | 本项目 |
|------|----------|--------|
| AI 网关 | OpenRouter | Coze API |
| 数据存储 | MySQL | Coze 数据库 |
| 实时音视频 | - | 火山引擎 RTC |

## 八、注意事项

- Coze PAT Token 和 RTC AppKey 必须存储在后端，禁止暴露给前端
- 语音格式需匹配 Coze 支持的格式（推荐 PCM 16000Hz）
- 需处理网络不稳定时的断线重连逻辑

## 九、进度文档

- 📋 **最新进度**: `docs/项目进度总结-20260121-final.md`
- 📚 **框架经验**: `_framework/specs/Coze集成经验.md`

## 十、已完成功能清单

| 模块 | 功能 | 状态 |
|------|------|------|
| 用户端 | 欢迎页、信息采集、面试初始化 | ✅ |
| 用户端 | 文字面试模式 | ✅ |
| 用户端 | 语音面试模式 | 🟡 RTC 正常，session_id 传递待优化 |
| 管理后台 | 登录、数据概览、面试列表、详情 | ✅ |
| 管理后台 | 骨架屏加载、阶段标签 | ✅ |
| 后端 | 文件上传、初始化、聊天、房间 API | ✅ |
| 后端 | 管理后台 API (通过 Workflow C) | ✅ |

---

> 最后更新：2026-01-21