# 📖 Guide d'Utilisation des Tooltips

## 🎯 Qu'est-ce qu'un Tooltip ?

Un **tooltip** (infobulle) est une petite fenêtre d'aide qui apparaît lorsque vous survolez un élément avec votre souris. Dans l'interface OMOP, tous les tooltips sont identifiés par une **icône bleue (?)**.

## 🖱️ Comment Utiliser les Tooltips

### Étape 1 : Repérez l'icône (?)
Cherchez les petites icônes bleues rondes avec un point d'interrogation blanc à côté des titres et labels.

### Étape 2 : Survolez avec la souris
Placez votre curseur sur l'icône (?) sans cliquer.

### Étape 3 : Lisez l'explication
Une bulle d'information apparaît automatiquement avec l'explication en français.

### Étape 4 : Retirez la souris
L'infobulle disparaît automatiquement quand vous éloignez le curseur.

## 📍 Où Trouver les Tooltips ?

### 🏠 Page Dashboard
- À côté du titre "Dashboard OMOP Pipeline"
- Sur chaque carte de statistique (Patients, Visites, Conditions, En attente)
- Sur la section "Exécutions récentes (24h)"
- Sur la section "Historique ETL"

### ⚙️ Page ETL Manager
- À côté du titre "Gestionnaire ETL"
- Sur "Nouveau Pipeline ETL"
- Sur chaque champ du formulaire :
  - Table source
  - Table cible
  - Taille de batch
  - Nombre de workers
  - Mode séquentiel
- Sur "Jobs en cours"

### 🗄️ Page Schema Manager
- À côté du titre "Gestion des Schémas"
- Sur "Créer les schémas"
- Sur "État des schémas"

### ✅ Page Validation
- À côté du titre "Validation des données"
- Sur "Actions"
- Sur "Codes non mappés"

### 📝 Page Logs
- À côté du titre "Logs système"
- Sur "Filtres"
- Sur "Logs récents"
- Sur "Erreurs de validation"

## 💡 Exemples Concrets

### Exemple 1 : Comprendre "ETL"
**Situation** : Vous ne savez pas ce que signifie "ETL"

**Solution** :
1. Allez sur la page "ETL Manager"
2. Survolez l'icône (?) à côté du titre "Gestionnaire ETL"
3. Lisez : "ETL signifie Extract-Transform-Load (Extraire-Transformer-Charger). Ce processus extrait les données brutes du staging, les transforme au format OMOP CDM, et les charge dans les tables OMOP finales."

### Exemple 2 : Choisir le nombre de workers
**Situation** : Vous ne savez pas combien de workers configurer

**Solution** :
1. Sur la page "ETL Manager", dans le formulaire
2. Survolez l'icône (?) à côté de "Nombre de workers"
3. Lisez : "Nombre de processus parallèles pour le traitement. Recommandé: 4-8 workers. Plus de workers = traitement plus rapide mais plus de charge CPU."
4. Décision : Utilisez 4-8 workers pour un bon équilibre

### Exemple 3 : Comprendre les codes non mappés
**Situation** : Vous voyez des "codes non mappés" et ne comprenez pas

**Solution** :
1. Sur la page "Validation"
2. Survolez l'icône (?) à côté de "Codes non mappés"
3. Lisez : "Liste des codes sources qui n'ont pas pu être mappés vers les vocabulaires OMOP standard. Ces codes nécessitent une attention pour améliorer la qualité des données."

## 🎓 Conseils pour les Nouveaux Utilisateurs

### Pour Découvrir l'Interface
1. **Visitez chaque page** (Dashboard, ETL Manager, Schema Manager, Validation, Logs)
2. **Survolez tous les (?)** pour comprendre chaque élément
3. **Prenez des notes** si nécessaire sur les concepts importants

### Pour Utiliser une Fonctionnalité
1. **Lisez d'abord les tooltips** de la section concernée
2. **Comprenez les paramètres** avant de les modifier
3. **Suivez les recommandations** indiquées dans les tooltips

### Pour Résoudre un Problème
1. **Consultez les tooltips** de la page concernée
2. **Vérifiez les logs** (page Logs) avec les explications des tooltips
3. **Utilisez la validation** (page Validation) pour identifier les problèmes

## 🌟 Avantages des Tooltips

✅ **Pas besoin de documentation externe** - Tout est expliqué dans l'interface  
✅ **Explications contextuelles** - L'aide apparaît exactement où vous en avez besoin  
✅ **En français** - Accessible à tous vos collaborateurs  
✅ **Toujours à jour** - Les explications sont intégrées au code  
✅ **Non intrusif** - Les tooltips n'apparaissent que si vous le souhaitez  

## 🔍 Glossaire Rapide (via Tooltips)

Voici les concepts clés expliqués dans les tooltips :

| Concept | Où le trouver | Explication courte |
|---------|---------------|-------------------|
| **ETL** | ETL Manager (titre) | Extract-Transform-Load : processus de transformation des données |
| **OMOP CDM** | Dashboard (Patients) | Standard de données de santé version 5.4 |
| **Staging** | ETL Manager (Table source) | Zone de stockage temporaire des données brutes |
| **Batch size** | ETL Manager (formulaire) | Nombre d'enregistrements traités par lot |
| **Workers** | ETL Manager (formulaire) | Processus parallèles pour le traitement |
| **Codes non mappés** | Validation | Codes sources sans correspondance OMOP |
| **Schémas** | Schema Manager | Structures de base de données (OMOP, Staging, Audit) |

## 📞 Support

Si un tooltip n'est pas clair ou si vous avez besoin de plus d'informations :
1. Consultez la documentation complète dans les fichiers `.md` du projet
2. Vérifiez les logs pour plus de détails techniques
3. Contactez l'administrateur système

## 🎉 Bonne Utilisation !

Les tooltips sont là pour vous aider à utiliser l'interface OMOP de manière autonome et efficace. N'hésitez pas à les consulter aussi souvent que nécessaire !