managerr/frontend/docs/USER_GUIDE.md

# Guide d'utilisation de Managerr

## Table des matières
1. [Introduction](#introduction)
2. [Premiers pas](#premiers-pas)
   - [Inscription](#inscription)
   - [Connexion](#connexion)
3. [Interface principale](#interface-principale)
   - [Barre de navigation](#barre-de-navigation)
   - [Thème clair/sombre](#thème-clairsombre)
4. [Tableau de bord](#tableau-de-bord)
   - [Agenda mensuel](#agenda-mensuel)
   - [Prochains téléchargements](#prochains-téléchargements)
5. [Gestion des films](#gestion-des-films)
   - [Liste des films](#liste-des-films)
   - [Films manquants](#films-manquants)
   - [Films à venir](#films-à-venir)
   - [Historique](#historique-des-films)
6. [Gestion des séries](#gestion-des-séries)
   - [Liste des séries](#liste-des-séries)
   - [Épisodes manquants](#épisodes-manquants)
   - [Épisodes à venir](#épisodes-à-venir)
   - [Historique](#historique-des-séries)
7. [Paramètres](#paramètres)
   - [Configuration de Sonarr](#configuration-de-sonarr)
   - [Configuration de Radarr](#configuration-de-radarr)
   - [Test des connexions](#test-des-connexions)
8. [Conseils et astuces](#conseils-et-astuces)
9. [Dépannage](#dépannage)

## Introduction

Managerr est une application web qui vous permet de gérer vos films et séries TV à partir d'une interface unifiée en utilisant les API de Sonarr et Radarr. Ce guide vous aidera à prendre en main l'application et à utiliser toutes ses fonctionnalités.

## Premiers pas

### Inscription

1. Accédez à la page d'accueil de l'application
2. Cliquez sur "S'inscrire"
3. Remplissez le formulaire avec votre nom d'utilisateur, votre email et un mot de passe sécurisé
4. Cliquez sur "Créer un compte"

### Connexion

1. Accédez à la page d'accueil de l'application
2. Cliquez sur "Se connecter"
3. Entrez votre email et votre mot de passe
4. Cliquez sur "Connexion"

## Interface principale

### Barre de navigation

La barre de navigation vous permet d'accéder aux différentes sections de l'application :
- **Tableau de bord** : Vue d'ensemble avec l'agenda mensuel
- **Films** : Gestion de votre collection de films
- **Séries** : Gestion de vos séries TV
- **Paramètres** : Configuration des API Sonarr et Radarr
- **Déconnexion** : Pour quitter votre session

### Thème clair/sombre

Managerr prend en charge les thèmes clair et sombre :
- Le bouton de bascule du thème se trouve dans la barre de navigation
- Par défaut, l'application utilise les préférences de votre système
- Vous pouvez basculer manuellement entre les modes clair et sombre à tout moment

## Tableau de bord

### Agenda mensuel

L'agenda mensuel affiche tous les films et épisodes à venir :
- Naviguez entre les mois avec les flèches de navigation
- Chaque jour contenant des sorties est marqué d'un indicateur
- Cliquez sur un jour pour voir les détails des sorties prévues

### Prochains téléchargements

Cette section affiche la liste des prochains films et épisodes qui seront téléchargés, triés par date.

## Gestion des films

### Liste des films

- Affiche tous les films de votre bibliothèque Radarr
- Recherche et filtre par titre, genre, année, etc.
- Tri par différents critères (titre, date d'ajout, etc.)
- Cliquez sur un film pour voir ses détails

### Films manquants

- Affiche les films qui sont dans votre bibliothèque mais pas encore téléchargés
- Indique le statut de recherche pour chaque film
- Permet de déclencher une recherche manuelle

### Films à venir

- Affiche les films dont la sortie est prévue prochainement
- Indique les dates de sortie au cinéma et en Blu-ray/DVD

### Historique des films

- Affiche l'historique des téléchargements de films
- Inclut les informations sur la qualité et la date de téléchargement

## Gestion des séries

### Liste des séries

- Affiche toutes les séries de votre bibliothèque Sonarr
- Recherche et filtre par titre, genre, réseau, etc.
- Tri par différents critères (titre, date d'ajout, etc.)
- Cliquez sur une série pour voir ses détails et la liste des saisons/épisodes

### Épisodes manquants

- Affiche les épisodes qui sont dans votre bibliothèque mais pas encore téléchargés
- Regroupés par série et saison
- Permet de déclencher une recherche manuelle

### Épisodes à venir

- Affiche les épisodes dont la diffusion est prévue prochainement
- Indique les dates de diffusion et les chaînes/réseaux

### Historique des séries

- Affiche l'historique des téléchargements d'épisodes
- Inclut les informations sur la qualité et la date de téléchargement

## Paramètres

### Configuration de Sonarr

1. Accédez à la page "Paramètres"
2. Dans la section Sonarr, entrez :
   - L'URL de votre serveur Sonarr (ex : http://192.168.1.100:8989)
   - Votre clé API Sonarr (disponible dans les paramètres de Sonarr)
3. Cliquez sur "Tester la connexion" pour vérifier que tout fonctionne
4. Cliquez sur "Enregistrer" pour sauvegarder vos paramètres

### Configuration de Radarr

1. Accédez à la page "Paramètres"
2. Dans la section Radarr, entrez :
   - L'URL de votre serveur Radarr (ex : http://192.168.1.100:7878)
   - Votre clé API Radarr (disponible dans les paramètres de Radarr)
3. Cliquez sur "Tester la connexion" pour vérifier que tout fonctionne
4. Cliquez sur "Enregistrer" pour sauvegarder vos paramètres

### Test des connexions

- Le bouton "Tester la connexion" vérifie que :
  - L'URL est accessible
  - La clé API est valide
  - La version de l'API est compatible
- Un message vous informera du résultat du test

## Conseils et astuces

- **Mise en cache** : L'application met en cache certaines données pour améliorer les performances. Si vous ne voyez pas les changements récents, essayez de rafraîchir la page.
- **Mode responsive** : L'application s'adapte automatiquement à tous les appareils, y compris les smartphones et les tablettes.
- **Raccourcis clavier** : Utilisez la touche "T" pour basculer rapidement entre les thèmes clair et sombre.

## Dépannage

### Problèmes de connexion aux API

1. Vérifiez que vos serveurs Sonarr et Radarr sont en cours d'exécution
2. Assurez-vous que les URLs sont correctes et incluent le port
3. Vérifiez que vos clés API sont valides
4. Assurez-vous que votre réseau permet les connexions aux ports de Sonarr et Radarr

### Problèmes d'affichage

1. Essayez d'actualiser la page
2. Videz le cache de votre navigateur
3. Essayez un autre navigateur pour voir si le problème persiste

Si vous rencontrez d'autres problèmes, n'hésitez pas à ouvrir une issue sur GitHub ou à contacter l'équipe de support.