aivanov_CIM/INTERFACE_TIM_USER_GUIDE.md

# 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 ! 🎯