Initial commit

INTERFACE_TIM_USER_GUIDE.md

@@ -0,0 +1,267 @@
+# Interface TIM - Guide Utilisateur
+
+## Introduction
+
+Bienvenue dans l'interface TIM (Traitement Interactif Médical), votre outil de révision et validation du codage PMSI. Ce guide vous aidera à utiliser efficacement toutes les fonctionnalités de l'interface.
+
+## Démarrage rapide
+
+### Accès à l'interface
+1. Ouvrez votre navigateur (Chrome, Firefox, Safari ou Edge recommandés)
+2. Accédez à l'URL de l'interface TIM
+3. Connectez-vous avec vos identifiants
+
+### Vue d'ensemble
+L'interface est divisée en 3 panneaux principaux:
+- **Panneau gauche**: Liste des codes proposés
+- **Panneau central**: Documents sources
+- **Panneau droit**: Détails du code sélectionné
+
+## Fonctionnalités principales
+
+### 1. Navigation dans les codes
+
+#### Sélectionner un code
+- Cliquez sur un code dans le panneau gauche
+- Utilisez les flèches ↑/↓ pour naviguer au clavier
+
+#### Comprendre les badges de confiance
+- 🟢 **Vert (≥80%)**: Haute confiance
+- 🟠 **Orange (50-80%)**: Confiance moyenne
+- 🔴 **Rouge (<50%)**: Faible confiance
+
+#### Indicateur de complétude
+Un indicateur en haut du panneau codes montre le pourcentage de codes avec preuves.
+
+### 2. Visualisation des documents
+
+#### Changer de document
+- Cliquez sur les onglets en haut du panneau central
+- Les documents contenant des preuves sont marqués d'un badge
+
+#### Zones mises en évidence
+Les preuves sont mises en évidence avec des couleurs:
+- 🔵 **Bleu**: Diagnostic Principal (DP)
+- 🟢 **Vert**: Diagnostic Relié (DR)
+- 🟡 **Jaune**: Diagnostic Associé Significatif (DAS)
+- 🟣 **Violet**: Acte CCAM
+
+#### Naviguer vers une preuve
+- Cliquez sur une preuve dans le panneau détails
+- Le document s'ouvre automatiquement et scroll vers la zone
+
+### 3. Détails d'un code
+
+#### Informations affichées
+- Code et libellé
+- Score de confiance
+- Raisonnement du système
+- Liste des preuves avec liens vers documents
+- Faits cliniques liés
+- Boutons d'action
+
+#### Faits cliniques
+Les faits cliniques sont organisés par catégorie:
+- 🤒 Symptômes
+- 🩺 Diagnostics
+- 💊 Traitements
+- 🔬 Procédures
+- 📋 Antécédents
+- ⚠️ Allergies
+- 💉 Médicaments
+- 🧪 Résultats de laboratoire
+
+### 4. Filtres et recherche
+
+#### Filtrer les codes
+Dans le panneau codes, utilisez les filtres:
+- **Type de code**: DP, DR, DAS, CCAM
+- **Niveau de confiance**: Élevé, Moyen, Faible
+- **Sans preuves**: Afficher uniquement les codes sans preuves
+
+#### Rechercher dans les documents
+1. Cliquez sur la barre de recherche (ou Ctrl+F)
+2. Tapez votre terme de recherche
+3. Appuyez sur Entrée pour naviguer entre les occurrences
+4. Le nombre d'occurrences est affiché
+
+### 5. Mode comparaison
+
+#### Activer le mode comparaison
+- Cliquez sur le bouton "Mode comparaison" en haut du panneau codes
+- Les codes proposés et corrigés s'affichent côte à côte
+
+#### Comprendre les couleurs
+- 🔴 **Rouge**: Code différent (correction apportée)
+- 🟢 **Vert**: Code identique (pas de correction)
+
+#### Commentaires de correction
+Les commentaires des corrections précédentes sont affichés sous chaque code.
+
+### 6. Actions sur les codes
+
+#### Corriger un code
+1. Sélectionnez le code à corriger
+2. Cliquez sur "✏️ Corriger"
+3. Saisissez le nouveau code et libellé
+4. Ajoutez un commentaire (optionnel)
+5. Validez
+
+#### Ajouter un commentaire
+1. Sélectionnez le code
+2. Cliquez sur "💬 Commenter"
+3. Saisissez votre commentaire
+4. Validez
+
+#### Valider un code
+1. Sélectionnez le code
+2. Cliquez sur "✅ Valider"
+3. Confirmez la validation
+
+### 7. Raccourcis clavier
+
+#### Navigation
+- **↑/↓**: Naviguer entre les codes
+- **←/→**: Naviguer entre les preuves
+- **Tab**: Naviguer entre les panneaux
+
+#### Actions
+- **Ctrl+Enter**: Valider le séjour
+- **Ctrl+E**: Ouvrir le modal de correction
+- **Ctrl+F**: Activer la recherche
+- **?**: Afficher l'aide des raccourcis
+- **Échap**: Fermer les modals
+
+### 8. Redimensionnement des panneaux
+
+#### Ajuster la taille
+1. Placez votre curseur sur le séparateur entre deux panneaux
+2. Le curseur change en ↔️
+3. Cliquez et glissez pour redimensionner
+4. Les dimensions sont sauvegardées automatiquement
+
+#### Réinitialiser
+Double-cliquez sur un séparateur pour réinitialiser aux dimensions par défaut.
+
+### 9. Export PDF
+
+#### Générer un PDF
+1. Cliquez sur le bouton "📄 Exporter PDF" en haut de l'interface
+2. Le PDF est généré automatiquement
+3. Le téléchargement démarre
+
+#### Contenu du PDF
+Le PDF inclut:
+- Informations du séjour
+- Tous les codes proposés avec scores de confiance
+- Nombre de preuves par code
+- Corrections apportées avec commentaires
+- Date de génération
+
+### 10. Mode responsive (mobile/tablette)
+
+#### Affichage mobile
+Sur les petits écrans (< 768px):
+- Les panneaux s'empilent verticalement
+- Les onglets deviennent des boutons
+- Les filtres se replient dans un menu
+
+#### Navigation tactile
+- Swipe gauche/droite pour changer de document
+- Tap pour sélectionner un code
+- Long press pour afficher les options
+
+## Conseils et astuces
+
+### Optimiser votre workflow
+1. **Utilisez les raccourcis clavier** pour gagner du temps
+2. **Filtrez les codes sans preuves** pour les traiter en priorité
+3. **Activez le mode comparaison** pour voir rapidement les corrections
+4. **Ajustez la taille des panneaux** selon vos préférences
+
+### Gérer les gros volumes
+1. **Utilisez la recherche** pour trouver rapidement des informations
+2. **Les documents volumineux** se chargent progressivement
+3. **Le cache** améliore les performances lors de la navigation
+
+### Accessibilité
+1. **Navigation clavier complète** disponible
+2. **Contraste élevé** pour une meilleure lisibilité
+3. **Taille de police** ajustable dans les paramètres du navigateur
+4. **Lecteurs d'écran** supportés avec labels ARIA
+
+## Résolution de problèmes
+
+### L'interface ne charge pas
+- Vérifiez votre connexion internet
+- Actualisez la page (F5)
+- Videz le cache du navigateur
+- Vérifiez que vous utilisez un navigateur supporté
+
+### Les documents ne s'affichent pas
+- Vérifiez que le séjour contient des documents
+- Attendez le chargement complet (indicateur de progression)
+- Vérifiez les logs d'erreur (F12 > Console)
+
+### Les preuves ne sont pas mises en évidence
+- Vérifiez que le code a des preuves
+- Attendez le chargement du document
+- Vérifiez que le document contient bien les preuves
+
+### Performances lentes
+- Fermez les onglets inutiles du navigateur
+- Videz le cache de l'interface (paramètres)
+- Vérifiez votre connexion internet
+- Utilisez un navigateur récent
+
+### Erreur "Too many requests"
+- Vous avez dépassé la limite de 10 requêtes par minute
+- Attendez 1 minute avant de réessayer
+- Contactez l'administrateur si le problème persiste
+
+## Support
+
+### Obtenir de l'aide
+- Appuyez sur **?** pour afficher l'aide des raccourcis
+- Consultez la documentation technique (INTERFACE_TIM_README.md)
+- Contactez le support technique
+
+### Signaler un bug
+1. Notez les étapes pour reproduire le problème
+2. Faites une capture d'écran si possible
+3. Vérifiez les logs d'erreur (F12 > Console)
+4. Contactez le support avec ces informations
+
+### Demander une fonctionnalité
+- Contactez l'équipe de développement
+- Décrivez votre besoin et cas d'usage
+- Expliquez comment cela améliorerait votre workflow
+
+## Mises à jour
+
+### Nouvelles fonctionnalités
+Consultez le changelog (INTERFACE_TIM_CHANGELOG.md) pour voir les dernières mises à jour.
+
+### Compatibilité
+L'interface est compatible avec:
+- Chrome 90+
+- Firefox 88+
+- Safari 14+
+- Edge 90+
+
+## Glossaire
+
+- **DP**: Diagnostic Principal
+- **DR**: Diagnostic Relié
+- **DAS**: Diagnostic Associé Significatif
+- **CCAM**: Classification Commune des Actes Médicaux
+- **PMSI**: Programme de Médicalisation des Systèmes d'Information
+- **TIM**: Traitement Interactif Médical
+- **Preuve**: Extrait de document justifiant un code
+- **Fait clinique**: Information médicale extraite des documents
+
+## Conclusion
+
+L'interface TIM est conçue pour rendre votre travail de codage plus efficace et agréable. N'hésitez pas à explorer toutes les fonctionnalités et à personnaliser l'interface selon vos préférences.
+
+Bon codage ! 🎯