aivanov_database/omop/GUIDE_TOOLTIPS.md

📖 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 !