132 lines
5.3 KiB
Markdown
132 lines
5.3 KiB
Markdown
# 📖 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 !
|