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

#### 👁️ **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 **👁️ 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

--

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