Content
# 🎯 AlternanceAI — Assistant IA pour la Recherche d'Alternance
Application web Flask complète pour automatiser et optimiser la recherche d'alternance : tracking des candidatures, génération de CVs personnalisés par IA, simulateur d'entretien, scoring d'offres et bien plus.
> 🚧 **En développement actif** — fonctionnalités principales opérationnelles, tests de robustesse en cours.
---
## ✨ Fonctionnalités principales
### 📋 Tracking des candidatures
- Tableau Kanban (En attente / Relancé / Entretien / Accepté / Refusé)
- Historique complet des actions par candidature
- Checklist personnalisée par candidature
- Détection automatique des doublons
- Export PDF et Excel de toutes les candidatures
### 🤖 Génération IA (Claude / Gemini)
- **CV personnalisé** adapté à chaque offre (10 CVs spécialisés intégrés)
- **Lettre de motivation** générée en quelques secondes
- **Recommandation de CV** selon le poste et l'entreprise
- **Optimisation LinkedIn** par section
- **Proposition de projet** pour épater l'entreprise en entretien
- **Veille entreprise** automatique avant chaque entretien
### 🎙️ Simulateur d'entretien
- Génération de questions techniques et comportementales
- Évaluation de tes réponses par l'IA avec feedback détaillé
- Mémo de préparation personnalisé par entreprise
### 📊 Tableau de bord & Stats
- Taux de réponse, taux de conversion, candidatures par semaine
- Synthèse hebdomadaire automatique
- Calendrier des relances et événements
- Scoring des offres par rapport à ton profil
### 📬 Relances & Contacts
- Génération automatique d'emails de relance
- Gestion du réseau de contacts
- Envoi d'emails intégré (SMTP)
- Suivi des messages par contact
### 🌐 Portfolio
- Génération automatique d'un portfolio HTML à partir de ton profil
- Mise en avant des projets GitHub
### 🔌 Intégration MCP (Claude Desktop)
- Serveur MCP pour utiliser l'app directement depuis Claude Desktop
- Commandes vocales / textuelles depuis l'interface Claude
---
## 🏗️ Architecture
```
AlternanceAI/
├── app.py # Serveur Flask principal (60+ routes API)
├── cv_module.py # Module génération & personnalisation CVs
├── profil_module.py # Module profil candidat
├── projets_module.py # Module gestion projets GitHub
├── scraper.py # Scraping offres d'alternance
├── cv_personalizer.py # Personnalisation IA des CVs
├── portfolio_gen.py # Génération portfolio HTML
├── notifier.py # Système de notifications
├── mcp_server.py # Serveur MCP Claude Desktop
├── error_handler.py # Gestion d'erreurs centralisée
├── static/ # Assets front-end
├── data/
│ ├── alternance.db # Base SQLite (candidatures, contacts...)
│ └── generated_cvs/ # CVs générés
└── requirements.txt
```
## ⚙️ Installation
```bash
git clone https://github.com/STEPHANIE3004/alternanceai.git
cd alternanceai
pip install -r requirements.txt
python app.py
# → http://localhost:5000
```
## 🔑 Configuration (optionnelle)
L'app fonctionne **sans clé API** — elle génère des prompts à coller dans Claude/Gemini.
Pour activer la génération automatique, créer un fichier `.env` :
```
CLAUDE_API_KEY="sk-ant-..."
GEMINI_API_KEY="AIza..."
```
Ou configurer depuis l'interface → **⚙️ Configuration**.
## 🛠️ Stack technique
**Backend** : Python 3 · Flask · SQLite · ReportLab (PDF) · OpenPyXL (Excel)
**IA** : Anthropic Claude API · Google Gemini API · Mode prompt (sans clé)
**Intégration** : MCP Server · SMTP · France Travail API
**Frontend** : HTML/CSS/JS · Interface responsive
## 📌 État du développement
| Module | État |
|--------|------|
| Tracking candidatures (Kanban + CRUD) | ✅ Stable |
| Génération CV + LM par IA | ✅ Stable |
| Simulateur d'entretien | ✅ Stable |
| Export PDF / Excel | ✅ Stable |
| Scraping offres | ✅ Stable |
| Scoring offres | ✅ Stable |
| Notifications & relances | 🚧 En test |
| MCP Server Claude Desktop | 🚧 En test |
| Portfolio génération | 🚧 En test |
## 👩💻 Auteure
**Vanelle Stéphanie MANGOUA DJOUSSEU**
BTS Systèmes Numériques — Option Informatique & Réseaux
Recherche d'alternance en IA & Systèmes Embarqués
[](https://github.com/STEPHANIE3004)
