conception-assistant/README.md

# =Ý Conception Assistant

Un assistant intelligent de conception technique avec fonctionnalités IA avancées pour l'analyse, l'amélioration et la gestion de documents de conception.

## ( Fonctionnalités

### =Ë Gestion des Journaux
- **Création et édition** de journaux de conception avec éditeur riche
- **Sauvegarde automatique** avec horodatage
- **Chargement de journaux** précédents via interface modale
- **Table des matières** dynamique avec navigation intelligente
- **Prévisualisation Markdown** avec rendu professionnel

### > Assistant IA Intégré (Mistral AI)

#### = **Reformulation Intelligente**
- Reformulation de texte sélectionné avec prévisualisation
- Validation avant application
- Conservation de l'intention originale

#### =
 **Analyse Automatisée**
- **Détection d'incohérences** dans le document
- **Vérification de doublons** et redondances
- **Conseils d'amélioration** personnalisés

#### =€ **Mode Liberté Intelligent** (Nouveau !)
- **Jusqu'à 15 itérations** d'amélioration automatique
- **Analyse itérative** : chaque amélioration enrichit le document
- **Arrêt intelligent** quand plus rien d'évident à améliorer
- **Confiance 90%+** : ne modifie que ce qui est certain

### <¨ Interface & Expérience

#### < **Thèmes**
- **Mode sombre/clair** avec persistance des préférences
- **Variables CSS** cohérentes pour tous les composants

#### =A **Mode Prévisualisation**
- **Toggle édition/visualisation** en un clic
- **Rendu Markdown complet** : titres, listes, code, liens, citations
- **Styling professionnel** pour présentation finale

#### >í **Navigation Avancée**
- **Table des matières** générée automatiquement
- **Scroll intelligent** vers les sections
- **Raccourcis clavier** (Ctrl+S pour sauvegarde)

### =ä Export & Import
- **Export Markdown** (.md) natif
- **Import de fichiers** Markdown
- **Templates prédéfinis** pour démarrage rapide

## =à Installation

### Prérequis
- **Node.js** 16+
- **npm** ou **yarn**
- **Clé API Mistral** (pour les fonctions IA)

### Installation
```bash
# Cloner le repository
git clone https://github.com/votre-repo/conception-assistant.git
cd conception-assistant

# Installer les dépendances
npm install

# Copier et configurer les variables d'environnement
cp config/.env.example config/.env
```

### Configuration
Éditez `config/.env` avec vos paramètres :

```env
# Server Configuration
PORT=3000

# Mistral AI Configuration
MISTRAL_API_KEY=votre_clé_api_mistral_ici
MISTRAL_MODEL=mistral-large-latest
MISTRAL_BASE_URL=https://api.mistral.ai/v1

# AI Features Configuration
AI_ENABLED=true
AI_MAX_TOKENS=35000
AI_TEMPERATURE=0.3
AI_TOP_P=0.85
```

### Lancement
```bash
# Démarrer l'application
npm start

# Accéder à l'application
http://localhost:3000
```

## <› Configuration IA Avancée

### Paramètres Optimisés pour la Précision
- **AI_TEMPERATURE=0.3** : Réponses précises et cohérentes
- **AI_MAX_TOKENS=35000** : Support des longs documents
- **AI_TOP_P=0.85** : Vocabulaire focalisé

### Températures Spécialisées par Fonction
- **Reformulation** : 0.2 (très précise)
- **Analyses** : 0.1 (factuelle)
- **Conseils** : 0.4 (équilibrée)
- **Mode Liberté** : 0.2 (itératif intelligent)

## =€ Mode Liberté - Fonctionnement Avancé

Le **Mode Liberté Intelligent** analyse votre document de manière itérative :

1. **Analyse** du contenu actuel
2. **Identification** du point le plus évident à améliorer
3. **Application** de l'amélioration avec 90%+ de confiance
4. **Mise à jour** du document avec le nouveau contenu
5. **Répétition** du processus sur le document enrichi
6. **Arrêt automatique** quand plus rien d'évident

### Exemple de Session
```
Itération 1 : Ajout section "Contraintes techniques"
Itération 2 : Détail des "Risques identifiés"
Itération 3 : Complétion "Plan de tests"
Itération 4 : STOP - Aucune amélioration évidente
```

## =Ö Utilisation

### Créer un Nouveau Journal
1. Utilisez l'éditeur principal pour rédiger
2. La table des matières se met à jour automatiquement
3. Sauvegardez avec **Ctrl+S** ou le bouton =¾

### Utiliser l'IA
1. **Reformulation** : Sélectionnez du texte ’ bouton "Reformuler"
2. **Analyse** : Boutons "Incohérences", "Doublons", "Conseils"
3. **Mode Liberté** : Choisir le nombre d'itérations ’ "Mode Liberté"

### Mode Prévisualisation
1. Cliquez sur **=A Visualiser**
2. Consultez le rendu final professionnel
3. Cliquez sur ** Éditer** pour revenir à l'édition

## <× Architecture Technique

### Backend
- **Express.js** : Serveur web
- **Mistral AI** : Modèles de langage avancés
- **Multer** : Upload de fichiers
- **dotenv** : Gestion configuration

### Frontend
- **Vanilla JavaScript** : Interface réactive
- **CSS Variables** : Thèmes dynamiques
- **Markdown Parser** : Rendu intelligent
- **LocalStorage** : Persistance locale

### Structure
```
conception-assistant/
 app.js                 # Serveur principal
 routes/
    ai.js             # Routes IA avec logique avancée
    upload.js         # Upload de fichiers
 assets/
    js/app.js         # Application frontend
    css/style.css     # Styles et thèmes
 views/                # Composants d'interface
 uploads/              # Fichiers uploadés
 config/               # Configuration
```

## > Contribution

1. **Fork** le projet
2. **Créer** une branche feature (`git checkout -b feature/nouvelle-fonctionnalite`)
3. **Commit** vos changements (`git commit -am 'Ajout nouvelle fonctionnalité'`)
4. **Push** vers la branche (`git push origin feature/nouvelle-fonctionnalite`)
5. **Créer** une Pull Request

## =Ý Changelog

### Version Actuelle
-  Mode Liberté intelligent (15 itérations max)
-  Prévisualisation Markdown complète
-  Navigation table des matières optimisée
-  Configuration IA précise (35k tokens)
-  Interface thèmes sombre/clair
-  Formatage Markdown avancé (titres, listes, code, citations)

## =Ä Licence

MIT License - Voir le fichier [LICENSE](LICENSE) pour plus de détails.

## <˜ Support

Pour toute question ou problème :
- =ç Email : support@conception-assistant.com
- = Issues : [GitHub Issues](https://github.com/votre-repo/conception-assistant/issues)
- =Ö Documentation : [Wiki](https://github.com/votre-repo/conception-assistant/wiki)

---

**Conception Assistant** - Votre partenaire intelligent pour la conception technique ! =€