内容
# 🎯 AlternanceAI — 智能研究助手
一套完整的Flask网络应用程序，旨在自动化和优化实习研究：跟踪申请、由AI生成个性化简历、面试模拟、职位评分等。
> 🚧 **正在积极开发** — 主要功能已上线，正在进行稳健性测试。
---
## ✨ 主要功能
### 📋 申请跟踪
- 看板（待处理 / 已重启 / 面试 / 已接受 / 已拒绝）
- 每次申请的完整历史记录
- 每份申请的自定义检查清单
- 自动检测重复申请
- 所有申请的PDF和Excel导出
### 🤖 AI生成（Claude / Gemini）
- **个性化简历**，适应每份职位（集成10份专业简历）
- **求职信**，几秒钟内生成
- 根据职位和公司 **推荐简历**
- **LinkedIn优化**，按章节
- **项目建议**，在面试中给企业留下深刻印象
- **企业观察**，在每次面试前自动进行
### 🎙️ 面试模拟
- 技术和行为问题的生成
- AI评估您的回答，提供详细反馈
- 按公司定制的面试准备备忘录
### 📊 仪表盘和统计
- 回复率、转化率、每周申请数
- 自动每周总结
- 跟进和事件日历
- 根据您的个人资料对职位进行评分
### 📬 跟进和联系
- 自动生成跟进电子邮件
- 联系人网络管理
- 集成电子邮件发送（SMTP）
- 按联系人跟踪消息
### 🌐 项目集
- 根据您的个人资料自动生成HTML项目集
- 展示GitHub项目
### 🔌 MCP集成（Claude Desktop）
- MCP服务器，直接从Claude Desktop使用应用
- 通过Claude界面进行语音/文本命令
---
## 🏗️ 架构
```
AlternanceAI/
├── app.py # 主Flask服务器（60+ API路由）
├── cv_module.py # 简历生成和定制模块
├── profil_module.py # 候选人个人资料模块
├── projets_module.py # GitHub项目管理模块
├── scraper.py # 实习职位爬虫
├── cv_personalizer.py # 简历AI定制
├── portfolio_gen.py # HTML项目集生成
├── notifier.py # 通知系统
├── mcp_server.py # Claude Desktop MCP服务器
├── error_handler.py # 集中错误处理
├── static/ # 前端资产
├── data/
│ ├── alternance.db # SQLite数据库（申请、联系人...）
│ └── generated_cvs/ # 生成的简历
└── requirements.txt
```
## ⚙️ 安装
```bash
git clone https://github.com/STEPHANIE3004/alternanceai.git
cd alternanceai
pip install -r requirements.txt
python app.py
# → http://localhost:5000
```
## 🔑 配置（可选）
应用程序**无需API密钥**即可运行 — 它生成粘贴到Claude/Gemini的提示。
要启用自动生成，请创建`.env`文件：
```
CLAUDE_API_KEY="sk-ant-..."
GEMINI_API_KEY="AIza..."
```
或从界面配置 → **⚙️ 配置**。
## 🛠️ 技术栈
**后端**：Python 3 · Flask · SQLite · ReportLab（PDF）· OpenPyXL（Excel）
**AI**：Anthropic Claude API · Google Gemini API · 提示模式（无需密钥）
**集成**：MCP Server · SMTP · 法国就业API
**前端**：HTML/CSS/JS · 响应式界面
## 📌 开发状态
| 模块 | 状态 |
|--------|------|
| 申请跟踪（看板 + CRUD）| ✅ 稳定 |
| AI生成简历 + 求职信 | ✅ 稳定 |
| 面试模拟 | ✅ 稳定 |
| PDF / Excel导出 | ✅ 稳定 |
| 职位爬虫 | ✅ 稳定 |
| 职位评分 | ✅ 稳定 |
| 通知和跟进 | 🚧 测试中 |
| Claude Desktop MCP服务器 | 🚧 测试中 |
| 项目集生成 | 🚧 测试中 |
## 👩💻 作者
**Vanelle Stéphanie MANGOUA DJOUSSEU**
BTS系统 - 计算机和网络选项
人工智能和嵌入式系统实习研究
[](https://github.com/STEPHANIE3004)
