Aller au contenu

Guide utilisateur - Back-Office LMELP

Bienvenue

Le Back-Office LMELP est une application web simple et intuitive pour consulter et modifier les descriptions des épisodes de podcast. Cette interface vous permet de corriger et améliorer les descriptions générées automatiquement.

Accès à l'application

URL d'accès

L'application est accessible via le frontend sur le port standard : 

http://localhost:5173

Le backend utilise maintenant un système d'auto-découverte unifié pour éviter les conflits : - Port par défaut : 54321 (si disponible) - Ports alternatifs : 54322-54350 (sélection automatique si 54321 occupé) - Découverte automatique : Le frontend trouve automatiquement le bon port - Support pour Claude Code : Scripts d'auto-découverte pour les outils d'IA

Démarrage simplifié

Plus de configuration manuelle de ports ! Le système fonctionne automatiquement :

  1. Démarrer le backend : Se lance automatiquement sur un port libre
  2. Démarrer le frontend : Trouve automatiquement le backend
  3. Accéder à l'application : Toujours sur http://localhost:5173

Prérequis

  • Navigateur web moderne (Chrome, Firefox, Safari, Edge)
  • Connexion réseau locale au serveur
  • Aucune configuration de port nécessaire (gestion automatique)

Vue d'ensemble de l'interface

L'interface comprend maintenant deux pages principales :

Page d'accueil (Dashboard)

┌─────────────────────────────────────┐
│        Back-office LMELP            │
│   Gestion des épisodes du           │
│     Masque et la Plume              │
└─────────────────────────────────────┘

┌──────────────────────────────────────────────────────────────┐
│                  Informations générales                     │
│                                                              │
│ [...]     [142]     [37]      [45]      [28]       [27]     │
│Dernière  Épisodes  Titres  Descriptions Avis      Avis      │
│mise à    au total  corrigés  corrigées  critiques critiques │
│jour                                     extraits  analysés  │
│                                                              │
│ [128]     [86]        [52]                                   │
│Livres   Livres    Livres non                                │
│en base  suggérés   trouvés                                  │
└──────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────┐
│      Fonctions disponibles          │
│                                     │
│ ┌─────────────┐ ┌─────────────┐     │
│ │📝 Episode - │ │🔍 Recherche │     │
│ │  Modification│ │  avancée    │     │
│ │  Titre/Desc.│ │             │     │
│ │    [→]      │ │    [→]      │     │
│ └─────────────┘ └─────────────┘     │
└─────────────────────────────────────┘

Page de gestion des épisodes

┌─────────────────────────────────────┐
│ 🏠 Accueil    Gestion des Épisodes  │
└─────────────────────────────────────┘

┌─────────────────────────────────────┐
│           Sélecteur d'épisodes      │
│  [Dropdown: Choisir un épisode ▼]  │
└─────────────────────────────────────┘

┌─────────────────────────────────────┐
│         Détails de l'épisode        │
│ (Interface identique à l'ancienne)  │
└─────────────────────────────────────┘

Accès depuis un téléphone mobile

Pour accéder à l'application depuis votre téléphone ou tablette, consultez le guide détaillé : Accès Mobile

Configuration rapide

  1. Démarrez l'application avec ENVIRONMENT=development ./scripts/start-dev.sh
  2. Trouvez l'adresse IP de votre ordinateur (ipconfig ou ifconfig)
  3. Sur votre téléphone, ouvrez http://[ADRESSE_IP]:5173

L'interface s'adapte automatiquement aux écrans mobiles pour une utilisation optimale.

Système d'auto-découverte (Issue #56)

Pour les utilisateurs

Le système d'auto-découverte garantit que l'application fonctionne sans configuration manuelle :

  • Démarrage simplifié : Plus besoin de configurer des ports
  • Résolution automatique des conflits : Le système trouve automatiquement des ports libres
  • Reconnexion intelligente : Le frontend se reconnecte automatiquement au backend

Bénéfices pour le développement

Lorsque vous travaillez avec des outils d'IA comme Claude Code :

  • Découverte automatique des services : Les outils trouvent automatiquement les ports
  • Tests d'API simplifiés : Plus besoin de deviner les URLs
  • Détection de redémarrage : Les outils peuvent détecter si le backend doit être relancé

Fichiers techniques

Le système utilise un fichier .dev-ports.json qui contient : - Les ports utilisés par le backend et frontend - Les informations de processus pour validation - Les timestamps pour détecter les services obsolètes

Ce système est transparent pour l'utilisateur final mais améliore grandement l'expérience de développement.

Utilisation pas à pas

1. Navigation dans l'application

Page d'accueil

  1. Consultez les statistiques générales en haut de page
  2. Cliquez sur "Episode - Modification Titre/Description" pour accéder à la gestion des épisodes
  3. Cliquez sur "Recherche avancée" pour rechercher dans toutes les collections de données
  • Depuis la page d'épisodes : Cliquez sur "🏠 Accueil" pour revenir au tableau de bord
  • Depuis l'accueil : Les fonctions disponibles sont directement accessibles

2. Sélectionner un épisode

  1. Accédez à la page "Gestion des Épisodes" depuis l'accueil
  2. Ouvrez le sélecteur d'épisodes en haut de la page
  3. Parcourez la liste des épisodes disponibles
  4. Cliquez sur l'épisode que vous souhaitez modifier

📋 La liste affiche le titre complet de chaque épisode avec la date

3. Consulter les informations

Une fois l'épisode sélectionné, vous verrez :

  • Titre complet de l'épisode
  • Date de diffusion
  • Type d'émission (livres, cinéma, musique, etc.)
  • Durée au format MM:SS
  • URL de l'épisode original
  • Transcription complète (si disponible)

4. Modifier la description

Description originale

  • Zone en lecture seule
  • Contient la description automatique générée
  • Sert de référence pour vos corrections

Description corrigée

  • Zone éditable où vous pouvez saisir vos modifications
  • Sauvegarde automatique dès que vous arrêtez de taper
  • Indicateur visuel de l'état de sauvegarde

Comment modifier

  1. Cliquez dans la zone "Description corrigée"
  2. Tapez votre version améliorée
  3. Formatez le texte (passages à la ligne, ponctuation)
  4. Attendez la confirmation de sauvegarde automatique

Fonctionnalités avancées

Sauvegarde automatique

L'application sauvegarde automatiquement vos modifications :

  • ⏳ "Sauvegarde en cours..." : Vos changements sont en train d'être enregistrés
  • ✅ "Sauvegardé" : Vos modifications sont confirmées
  • ❌ "Erreur de sauvegarde" : Un problème est survenu (voir Résolution des problèmes)

Formatage du texte

Vous pouvez utiliser : - Passages à la ligne : Appuyez sur Entrée - Espaces multiples : Pour l'alignement - Tirets : Pour structurer les listes - Signes de ponctuation : Points, virgules, deux-points

Protection mémoire

L'application surveille automatiquement l'utilisation mémoire :

  • Surveillance continue : Monitoring invisible en arrière-plan
  • Alertes préventives : Avertissements si consommation élevée
  • Protection d'urgence : Rechargement automatique si nécessaire

🛡️ Cette protection évite les plantages et garantit une expérience stable

Conseils d'utilisation

Bonnes pratiques

✅ À faire : - Corriger les erreurs de transcription automatique - Ajouter de la ponctuation pour la lisibilité - Structurer avec des passages à la ligne - Conserver les informations importantes (durée, invités)

❌ À éviter : - Supprimer complètement le contenu original - Ajouter des informations non présentes dans l'audio - Utiliser des caractères spéciaux complexes

Optimisation du workflow

  1. Lisez d'abord la description originale complètement
  2. Écoutez l'extrait si nécessaire (via l'URL fournie)
  3. Corrigez progressivement par petites sections
  4. Vérifiez que la sauvegarde est confirmée avant de passer au suivant

Types d'épisodes

L'application gère différents types d'émissions :

📚 Livres

  • Critiques littéraires
  • Nouveautés éditoriales
  • Interviews d'auteurs

🎬 Cinéma

  • Critiques de films
  • Actualité cinématographique
  • Rencontres avec des réalisateurs

🎵 Musique

  • Nouveaux albums
  • Concerts et festivals
  • Interviews d'artistes

🎭 Spectacles

  • Théâtre
  • Danse
  • Arts vivants

Données affichées

Métadonnées techniques

  • Fichier audio : Nom du fichier source
  • URL : Lien vers l'épisode en ligne
  • Durée : Temps total en secondes et format lisible
  • Date : Date de diffusion originale

Contenu éditorial

  • Titre : Titre complet de l'émission
  • Description : Résumé automatique à corriger
  • Transcription : Texte intégral généré automatiquement

L'application utilise maintenant un système de navigation à deux pages :

Depuis la page d'accueil

  • Cliquez sur les fonctions disponibles pour y accéder directement
  • Visualisez les statistiques globales en un coup d'œil

Depuis une page de fonction (ex: Gestion des Épisodes)

  • Cliquez sur "🏠 Accueil" pour revenir au tableau de bord principal
  • Le titre de la page courante est affiché à côté du lien d'accueil

Changement d'épisode

Pour passer à un autre épisode sur la page de gestion :

  1. Utilisez le sélecteur en haut de page
  2. Choisissez un nouvel épisode
  3. Confirmez que vos modifications précédentes sont sauvegardées

⚠️ Les modifications non sauvegardées peuvent être perdues

Rechargement de page

En cas de problème :

  1. Rechargez la page (F5 ou Ctrl+R)
  2. Vérifiez que le serveur backend fonctionne
  3. Sélectionnez de nouveau votre épisode

Support et aide

Ressources disponibles

Contact support

En cas de problème persistant :

  1. Consultez le guide de résolution de problèmes
  2. Vérifiez les logs de la console navigateur (F12)
  3. Contactez l'équipe technique avec les détails de l'erreur

Cette documentation correspond à la version actuelle du Back-Office LMELP. Pour les développeurs, consultez la documentation technique.