Initial release: DictIA v0.8.14-alpha (fork de Speakr, AGPL-3.0)

client_docs/depannage/fonctionnalites.md

@@ -0,0 +1,175 @@
+# Dépannage : Fonctionnalités
+
+Ce guide couvre les problèmes liés aux fonctionnalités spécifiques de DictIA et les solutions pour les résoudre.
+
+---
+
+## Identification des locuteurs
+
+### Les locuteurs ne sont pas identifiés
+
+Si vos transcriptions n'affichent aucune distinction entre les locuteurs (tout le texte est attribué à un seul intervenant), cela peut être dû à la configuration du service de transcription.
+
+**Que faire** :
+
+- Vérifiez que l'identification des locuteurs est bien activée dans vos paramètres. Lors du téléversement ou du retraitement d'un enregistrement, assurez-vous que l'option d'identification des locuteurs est cochée.
+- Vérifiez les paramètres de nombre de locuteurs. Si le nombre minimum et maximum sont tous les deux réglés à 1, l'identification est effectivement désactivée. Utilisez une plage raisonnable, par exemple 2 à 6 locuteurs pour la plupart des réunions.
+- Si le problème persiste, contactez le support InnovA AI.
+
+### Tous les locuteurs affichent « LOCUTEUR INCONNU »
+
+Si la transcription affiche « LOCUTEUR INCONNU » au lieu de locuteurs numérotés (LOCUTEUR_00, LOCUTEUR_01, etc.), cela indique un problème de configuration du service de transcription côté serveur.
+
+**Que faire** :
+
+- Contactez le support InnovA AI pour vérifier la configuration du service de transcription.
+
+### Comment identifier les locuteurs après la transcription
+
+Après la transcription, les locuteurs apparaissent avec des étiquettes génériques (LOCUTEUR_01, LOCUTEUR_02, etc.). Pour les identifier :
+
+1. Cliquez sur l'étiquette d'un locuteur dans la transcription.
+2. Attribuez-lui un nom (par exemple, « Marie Tremblay »).
+3. Ce profil de locuteur est sauvegardé dans votre bibliothèque personnelle.
+4. Lors de futurs enregistrements, DictIA peut suggérer automatiquement l'identité des locuteurs en fonction de leurs profils vocaux.
+
+Gérez votre bibliothèque de locuteurs dans *Paramètres du compte* > *Gestion des locuteurs*.
+
+---
+
+## Partage d'enregistrements
+
+### Le bouton de partage est désactivé
+
+Le partage par lien externe nécessite que votre instance DictIA soit accessible via une connexion sécurisée (HTTPS). Si le bouton de partage est désactivé ou affiche une erreur, cela signifie que cette condition n'est pas remplie.
+
+**Que faire** :
+
+- Contactez le support InnovA AI pour configurer l'accès HTTPS sur votre instance.
+
+### Les liens de partage ne fonctionnent pas
+
+Si vous avez créé un lien de partage mais que les destinataires ne peuvent pas y accéder :
+
+**Que faire** :
+
+- Vérifiez que le lien n'a pas été révoqué. Consultez vos partages actifs dans l'interface de gestion des partages.
+- Assurez-vous que le destinataire dispose d'une connexion internet et utilise un navigateur récent.
+- Si le problème persiste, contactez le support InnovA AI.
+
+### Partage interne (entre utilisateurs)
+
+Pour partager un enregistrement avec un collègue qui dispose d'un compte DictIA :
+
+- Utilisez la fonction de partage interne plutôt que les liens externes.
+- Recherchez l'utilisateur par son nom d'utilisateur et définissez le niveau d'accès souhaité : lecture seule, modification ou re-partage.
+- Le destinataire verra l'enregistrement partagé dans sa liste.
+
+---
+
+## Recherche IA (recherche sémantique)
+
+### La Recherche IA ne retourne aucun résultat
+
+La Recherche IA utilise une technologie de recherche sémantique qui comprend le sens et le contexte de vos questions, plutôt que de chercher des mots-clés exacts.
+
+**Causes possibles** :
+
+- **Enregistrements non indexés** : Vos enregistrements doivent être traités et indexés avant d'être consultables via la Recherche IA. Ce processus peut prendre un certain temps après la transcription.
+- **Formulation de la question** : La Recherche IA fonctionne mieux avec des questions complètes plutôt qu'avec des mots isolés.
+
+**Que faire** :
+
+- Posez des questions complètes. Par exemple, « Qu'avons-nous décidé concernant le budget? » fonctionne mieux que simplement « budget décision ».
+- Patientez quelques minutes après une nouvelle transcription pour que l'indexation soit complétée.
+- Si aucun enregistrement n'apparaît jamais dans les résultats de recherche, contactez le support InnovA AI pour vérifier que la recherche sémantique est activée et fonctionnelle.
+
+### Résultats de recherche non pertinents
+
+**Que faire** :
+
+- Reformulez votre question de manière plus précise ou plus détaillée.
+- Essayez différentes formulations pour le même sujet.
+- Gardez en tête que la Recherche IA comprend le sens, pas les mots exacts. « Combien coûte le projet? » trouvera du contenu qui parle de « budget » ou de « montant estimé ».
+
+---
+
+## Application mobile
+
+### Installation de l'application mobile
+
+DictIA est une application web progressive (PWA). Cela signifie que vous n'avez pas besoin de l'installer depuis un magasin d'applications. Pour l'installer sur votre appareil :
+
+**Sur iPhone/iPad (Safari)** :
+
+1. Ouvrez DictIA dans Safari.
+2. Appuyez sur le bouton de partage (icône avec une flèche vers le haut).
+3. Sélectionnez « Sur l'écran d'accueil ».
+
+**Sur Android (Chrome)** :
+
+1. Ouvrez DictIA dans Chrome.
+2. Appuyez sur le menu (trois points) en haut à droite.
+3. Sélectionnez « Installer l'application » ou « Ajouter à l'écran d'accueil ».
+
+### L'application mobile ne fonctionne pas correctement
+
+**Que faire** :
+
+- Assurez-vous d'utiliser un navigateur compatible (Safari sur iOS, Chrome sur Android).
+- Vérifiez votre connexion internet.
+- Essayez de supprimer l'application de votre écran d'accueil et de la réinstaller.
+- Videz le cache du navigateur si l'application se comporte de manière inattendue.
+
+### L'enregistrement audio ne fonctionne pas sur mobile
+
+Certains navigateurs mobiles ont des restrictions sur l'accès au microphone.
+
+**Que faire** :
+
+- Assurez-vous que DictIA a la permission d'accéder au microphone de votre appareil.
+- Sur iOS, utilisez Safari (les autres navigateurs peuvent avoir des limitations).
+- Vérifiez que votre navigateur est à jour.
+
+---
+
+## Connexion et accès au compte
+
+### Impossible de se connecter
+
+**Que faire** :
+
+- Vérifiez que vous utilisez le bon nom d'utilisateur et le bon mot de passe. Ceux-ci sont sensibles à la casse (majuscules/minuscules).
+- Si vous avez oublié votre mot de passe, utilisez la fonction de réinitialisation du mot de passe sur la page de connexion (si disponible sur votre instance).
+- Contactez votre administrateur ou le support InnovA AI si vous ne parvenez pas à récupérer l'accès à votre compte.
+
+### Compte verrouillé
+
+Si votre compte semble verrouillé ou désactivé :
+
+**Que faire** :
+
+- Contactez votre administrateur DictIA pour vérifier le statut de votre compte.
+
+---
+
+## Avis d'enregistrement (conformité légale)
+
+Dans de nombreuses juridictions, vous devez informer les participants qu'ils sont enregistrés. DictIA permet d'afficher un avis de consentement avant tout enregistrement.
+
+Si l'avis d'enregistrement ne s'affiche pas alors qu'il devrait :
+
+**Que faire** :
+
+- Contactez votre administrateur ou le support InnovA AI pour activer et configurer l'avis d'enregistrement dans les paramètres système.
+
+---
+
+## Besoin d'aide supplémentaire?
+
+Si les solutions ci-dessus ne résolvent pas votre problème, contactez le support InnovA AI en fournissant :
+
+- La description du problème et les étapes pour le reproduire.
+- Le navigateur et l'appareil utilisés.
+- Des captures d'écran si possible.
+- Votre version de DictIA (disponible dans *Paramètres* > *À propos*).

client_docs/depannage/index.md

@@ -0,0 +1,49 @@
+# Dépannage
+
+Cette section vous aide à identifier et résoudre les problèmes courants que vous pourriez rencontrer avec DictIA. Les guides sont organisés par catégorie pour vous permettre de trouver rapidement la solution appropriée.
+
+---
+
+## Guides de dépannage
+
+### [Problèmes de transcription](transcription.md)
+
+Résolvez les problèmes liés à la transcription de vos enregistrements :
+
+- Qualité de transcription insuffisante
+- Problèmes de langue et de détection automatique
+- Vocabulaire personnalisé et termes spécialisés
+- Résumés qui ne se génèrent pas correctement
+- Formats audio non reconnus
+
+### [Problèmes de performance](performance.md)
+
+Résolvez les problèmes de lenteur et de traitement :
+
+- Interface web lente ou saccadée
+- Fichiers volumineux et délais de traitement
+- Enregistrements bloqués dans la file d'attente
+- Délais d'expiration sur les longs enregistrements
+
+### [Problèmes de fonctionnalités](fonctionnalites.md)
+
+Résolvez les problèmes liés aux fonctionnalités spécifiques :
+
+- Identification des locuteurs
+- Partage d'enregistrements
+- Recherche IA (recherche sémantique)
+- Application mobile
+- Connexion et accès au compte
+
+---
+
+## Informations utiles pour le support
+
+Si les solutions proposées ne résolvent pas votre problème, contactez le support InnovA AI en fournissant les informations suivantes :
+
+- **Version de DictIA** : Disponible dans l'onglet *À propos* des paramètres de votre compte.
+- **Description du problème** : Décrivez les étapes que vous avez suivies et le comportement observé.
+- **Messages d'erreur** : Notez tout message d'erreur affiché à l'écran.
+- **Navigateur utilisé** : Indiquez le navigateur et sa version (ex. : Chrome 120, Firefox 121).
+
+**Contact** : Communiquez avec l'équipe InnovA AI via les canaux de support mis à votre disposition par votre administrateur.

client_docs/depannage/performance.md

@@ -0,0 +1,93 @@
+# Dépannage : Performance
+
+Ce guide couvre les problèmes de performance courants dans DictIA et les solutions pour les résoudre.
+
+---
+
+## Transcription lente
+
+Le temps de traitement d'une transcription dépend de plusieurs facteurs :
+
+- **Durée de l'enregistrement** : Plus le fichier audio est long, plus le traitement prend de temps. Un enregistrement d'une heure prend naturellement plus de temps qu'un enregistrement de 5 minutes.
+- **Taille du fichier** : Les fichiers volumineux nécessitent plus de temps de transfert et de traitement.
+- **Charge du système** : Si plusieurs utilisateurs téléversent des enregistrements simultanément, les temps de traitement augmentent.
+- **Modèle de transcription** : Les modèles plus précis sont généralement plus lents. Un modèle optimisé pour la vitesse traite plus rapidement mais peut être légèrement moins précis.
+
+**Que faire** :
+
+- Patientez. La plupart des transcriptions se complètent en quelques minutes pour des enregistrements de durée normale (moins de 30 minutes).
+- Pour les fichiers très volumineux, prévoyez un temps de traitement plus long.
+- Si les transcriptions sont systématiquement très lentes, contactez le support InnovA AI.
+
+---
+
+## Fichiers volumineux qui échouent
+
+Certains fichiers très volumineux (plus de 25 Mo) peuvent échouer lors du traitement si le service de transcription impose des limites de taille.
+
+**Que faire** :
+
+- DictIA peut être configuré pour découper automatiquement les fichiers volumineux en segments plus petits. Si vos fichiers échouent systématiquement, contactez le support InnovA AI pour activer ou ajuster le découpage automatique.
+- Si possible, compressez vos fichiers audio avant de les téléverser (par exemple, convertissez un fichier WAV en MP3).
+
+---
+
+## Délai d'expiration sur les longs enregistrements
+
+Les enregistrements très longs (plus de 30 minutes) peuvent dépasser le délai d'attente maximal du service de transcription.
+
+**Que faire** :
+
+- Si un enregistrement long échoue avec un message de délai d'expiration, contactez le support InnovA AI pour ajuster le paramètre de délai maximal.
+- En attendant, vous pouvez découper votre enregistrement en segments plus courts (par exemple, par tranches de 30 minutes) et les téléverser séparément.
+
+---
+
+## Enregistrements bloqués après un redémarrage
+
+Si le système a été redémarré pendant le traitement d'enregistrements, ceux-ci reprennent automatiquement au prochain démarrage. La file d'attente est persistante, donc aucun téléversement n'est perdu.
+
+**Que faire** :
+
+- Patientez quelques minutes après un redémarrage pour que les enregistrements en cours reprennent leur traitement.
+- Si un enregistrement reste bloqué plus de 30 minutes après un redémarrage, contactez le support InnovA AI.
+
+---
+
+## L'interface web est lente ou saccadée
+
+La performance du navigateur peut se dégrader dans certaines situations :
+
+### Transcriptions très longues
+
+Les enregistrements de plus de 2 heures génèrent un volume important de texte que certains navigateurs peinent à afficher de manière fluide. L'affichage en mode « bulles » pour les transcriptions avec identification des locuteurs est particulièrement exigeant en ressources.
+
+**Que faire** :
+
+- Utilisez l'affichage simple plutôt que l'affichage en bulles pour les transcriptions très longues.
+- Fermez les autres onglets de votre navigateur pour libérer de la mémoire.
+
+### Cache du navigateur
+
+Le cache local peut devenir volumineux ou corrompu avec le temps, ce qui ralentit l'interface.
+
+**Que faire** :
+
+- Effectuez un rafraîchissement complet de la page avec **Ctrl+Maj+R** (Windows) ou **Cmd+Maj+R** (Mac).
+- Videz le cache de votre navigateur si le problème persiste.
+
+### Navigateur et appareil
+
+- Assurez-vous d'utiliser une version récente de votre navigateur (Chrome, Firefox, Edge ou Safari).
+- Sur les appareils mobiles ou les ordinateurs plus anciens, la performance peut être réduite avec de très longues transcriptions.
+
+---
+
+## Besoin d'aide supplémentaire?
+
+Si les solutions ci-dessus ne résolvent pas votre problème, contactez le support InnovA AI en fournissant :
+
+- La description du problème et les étapes pour le reproduire.
+- Le navigateur et l'appareil utilisés.
+- La durée approximative de l'enregistrement concerné.
+- Votre version de DictIA (disponible dans *Paramètres* > *À propos*).

client_docs/depannage/transcription.md

@@ -0,0 +1,136 @@
+# Dépannage : Transcription
+
+Ce guide couvre les problèmes courants liés à la transcription de vos enregistrements dans DictIA et les solutions à appliquer.
+
+---
+
+## La transcription ne démarre pas
+
+Lorsqu'un enregistrement reste au statut « En attente » ou « En file d'attente » pendant une période prolongée, voici les causes possibles :
+
+**Statut « En file d'attente »** : Les enregistrements affichent ce statut lorsqu'ils attendent un processus de traitement disponible. Si plusieurs enregistrements sont en file d'attente, ils seront traités dans un ordre équitable entre les utilisateurs. Aucun utilisateur ne peut monopoliser la file d'attente.
+
+**Que faire** :
+
+- Patientez quelques minutes. Si votre instance est partagée avec d'autres utilisateurs, votre enregistrement sera traité à son tour.
+- Si l'enregistrement reste bloqué plus de 30 minutes, contactez le support InnovA AI.
+
+---
+
+## La transcription échoue immédiatement
+
+Un échec rapide de la transcription indique généralement un problème de configuration côté serveur.
+
+**Que faire** :
+
+- Vérifiez que votre fichier audio n'est pas corrompu en l'écoutant dans un autre lecteur.
+- Réessayez le téléversement de votre fichier.
+- Si le problème persiste, contactez le support InnovA AI.
+
+---
+
+## Qualité de transcription insuffisante
+
+La précision de la transcription dépend fortement de la qualité audio. Voici les facteurs qui influencent les résultats :
+
+### Qualité audio
+
+- **Bruit de fond** : Le bruit ambiant, la musique ou les conversations en arrière-plan dégradent considérablement les résultats.
+- **Chevauchement des voix** : Lorsque plusieurs personnes parlent en même temps, la transcription devient imprécise.
+- **Microphone** : Un mauvais positionnement du microphone ou un micro de faible qualité affecte la clarté.
+
+**Bonnes pratiques pour un enregistrement de qualité** :
+
+- Enregistrez dans un environnement calme.
+- Utilisez un microphone de bonne qualité, positionné près des intervenants.
+- Pour les réunions, placez le micro au centre de la table.
+- Évitez la musique de fond ou les bruits parasites.
+
+### Problème de langue
+
+Si la langue de transcription configurée ne correspond pas à la langue réellement parlée dans l'enregistrement, la précision diminue fortement.
+
+**Que faire** :
+
+- Vérifiez le paramètre de langue dans vos réglages de compte, sous *Préférences de langue*.
+- Vous pouvez sélectionner une langue spécifique ou laisser la détection automatique si vos enregistrements sont dans des langues variées.
+- Pour la transcription en chinois, assurez-vous que le modèle utilisé est compatible. Certains modèles simplifiés ne prennent pas correctement en charge le chinois. Si vous obtenez du texte romanisé au lieu de caractères chinois, contactez le support InnovA AI.
+
+---
+
+## Termes spécialisés mal transcrits
+
+Il est fréquent que les noms propres, acronymes, termes techniques ou noms de marque soient mal transcrits. DictIA offre deux fonctionnalités pour corriger cela :
+
+### Vocabulaire personnalisé
+
+Fournissez une liste de termes séparés par des virgules que le moteur de transcription doit prioriser. Par exemple, si « PyAnnote » est systématiquement transcrit comme « piano » ou « pie annotate », ajoutez-le à votre vocabulaire personnalisé.
+
+### Indice de transcription (Initial Prompt)
+
+Donnez au moteur de transcription un contexte plus large sur le contenu de votre enregistrement, ce qui l'aide à faire de meilleurs choix lexicaux.
+
+### Niveaux de configuration
+
+Ces paramètres peuvent être définis à plusieurs niveaux, du plus prioritaire au moins prioritaire :
+
+1. **Par téléversement** : Dans les options avancées lors du téléversement d'un fichier.
+2. **Par étiquette** : Dans les paramètres d'une étiquette (appliqué automatiquement lorsque cette étiquette est sélectionnée).
+3. **Par dossier** : Dans les paramètres d'un dossier (appliqué à tous les enregistrements du dossier).
+4. **Par utilisateur** : Dans les *Paramètres du compte*, section *Options de transcription* (vos valeurs par défaut personnelles).
+
+---
+
+## Erreur « Format non reconnu »
+
+Si vous recevez une erreur indiquant que le format audio n'est pas reconnu, cela signifie que le service de transcription ne prend pas en charge le codec de votre fichier.
+
+**Que faire** :
+
+- Convertissez votre fichier audio dans un format plus courant (MP3 ou WAV) avant de le téléverser.
+- Si le problème se produit fréquemment, contactez le support InnovA AI pour qu'une solution automatique soit configurée.
+
+---
+
+## Le résumé ne se génère pas
+
+Si aucun résumé n'est produit après la transcription :
+
+**Que faire** :
+
+- Vérifiez que la transcription elle-même a été complétée avec succès.
+- Essayez de retraiter le résumé en cliquant sur « Retraiter le résumé » dans la page de l'enregistrement.
+- Si le problème persiste, contactez le support InnovA AI.
+
+---
+
+## La langue du résumé ne correspond pas à vos préférences
+
+Si les résumés sont générés dans une langue différente de celle configurée dans vos préférences :
+
+**Que faire** :
+
+- Vérifiez vos préférences de langue dans *Paramètres du compte* > *Préférences de langue*.
+- Essayez de retraiter le résumé après avoir confirmé vos préférences.
+- Si le problème persiste malgré des préférences correctes, contactez le support InnovA AI. Ce comportement peut être lié au modèle IA utilisé par votre instance.
+
+---
+
+## Transcription modifiable
+
+Sachez que les transcriptions sont entièrement modifiables après leur génération. Si vous constatez des erreurs :
+
+- Cliquez sur le bouton *Modifier* au-dessus de la transcription.
+- Corrigez les termes mal transcrits, les noms propres ou les attributions de locuteurs.
+- Vos modifications sont préservées, même si vous retraitez le résumé ou utilisez la Conversation IA.
+
+---
+
+## Besoin d'aide supplémentaire?
+
+Si les solutions ci-dessus ne résolvent pas votre problème, contactez le support InnovA AI en fournissant :
+
+- La description du problème et les étapes pour le reproduire.
+- Le format et la durée approximative de votre fichier audio.
+- Tout message d'erreur affiché à l'écran.
+- Votre version de DictIA (disponible dans *Paramètres* > *À propos*).