Initial commit: AI Interview System

This commit is contained in:
111
2026-01-23 13:57:48 +08:00
commit 95770afe21
127 changed files with 24686 additions and 0 deletions

104
CONTEXT.md Normal file
View File

@@ -0,0 +1,104 @@
# 项目上下文
> 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