# Guide utilisateur

Ce guide couvre l'utilisation quotidienne de l'application (fonctions
generales, communes a toutes les installations).

Les **modules** sont optionnels : chaque installation n'active que ceux
dont elle a besoin. Un module apporte ses propres ecrans, ses propres
roles et **sa propre documentation**, publiee dans son repertoire
`modules/<nom>/docs/` — par exemple
[modules/oracle/docs/guide-utilisateur.md](../mon-appli/modules/oracle/docs/guide-utilisateur.md)
ou
[modules/postgresql/docs/guide-utilisateur.md](../mon-appli/modules/postgresql/docs/guide-utilisateur.md).

Vous n'avez pas besoin de ces chemins au quotidien : l'entree
**Documentation** de la barre de navigation presente tous les documents
auxquels votre profil donne acces, quels que soient les modules
installes (voir §4).

Pour l'installation et la configuration initiale, voir
[guide-administrateur.md](guide-administrateur.md).

---

## Table des matieres

- [1. Connexion et profil](#1-connexion-et-profil)
- [2. Tableau de bord](#2-tableau-de-bord)
- [3. Personnalisation](#3-personnalisation)
- [4. Documentation](#4-documentation)

---

## 1. Connexion et profil

### Ecran de connexion

L'application propose trois methodes d'authentification (selon la
configuration de votre site) :

- **Locale** : identifiant et mot de passe stockes dans l'application.
- **LDAP / Active Directory** : les identifiants sont verifies aupres de
  l'annuaire d'entreprise.
- **OAuth / OIDC** : authentification deleguee a un fournisseur
  d'identite (SSO).

![Connexion](imgs/01-GU-cnx.png)

Apres connexion, vous etes redirige vers le tableau de bord.

### Profil utilisateur

Accessible via le menu utilisateur en haut a droite, la page **Profil**
affiche :

- Votre identifiant et adresse e-mail
- Vos roles (droits d'acces)
- Votre langue et votre theme preferes
- Les preferences propres aux modules installes auxquels vous avez acces
  (voir §3)

Vous pouvez modifier la langue et le theme depuis cette page ou via les
selecteurs de la barre de navigation ; les preferences de module se
reglent depuis cette page (voir §3).

![profil](imgs/02-GU-profile.png)

### Deconnexion

Cliquez sur **Deconnexion** dans le menu utilisateur. La session est
detruite et vous etes redirige vers l'ecran de connexion.

---

## 2. Tableau de bord

La page d'accueil affiche :

- Un message de bienvenue avec votre identifiant
- La liste de vos roles
- Des liens rapides vers les modules actifs auxquels vous avez acces
- Un lien vers le panneau d'administration (si vous etes administrateur)

![Accueil](imgs/03-GU-index.png)

---

## 3. Personnalisation

### Langue

L'application est disponible en 7 langues : francais, anglais, allemand,
espagnol, italien, polonais, roumain. Le selecteur de langue est
accessible dans la barre de navigation (icone drapeau ou code langue).

Le choix est sauvegarde dans votre profil et persiste entre les sessions.

### Theme

Cinq themes sont disponibles :

| Theme | Description |
|-------|-------------|
| **Clair** | Fond clair, texte sombre (defaut) |
| **Sombre** | Fond sombre, texte clair |
| **Systeme** | Suit le mode clair/sombre de votre OS |
| **Daltonien** | Palette adaptee aux daltoniens |
| **Personnalise** | Theme defini par l'administrateur |

Le selecteur de theme est dans la barre de navigation.

### Page d'accueil des modules de supervision de bases

Les modules qui donnent acces a un parc de bases de donnees (Oracle et
PostgreSQL, par exemple) vous laissent choisir le rapport affiche
automatiquement apres avoir selectionne une base — pour arriver
directement sur les sessions plutot que sur la configuration.

Deux facons de le regler :

- depuis **Mon profil**, avec le selecteur « Page d'accueil apres selection
  d'une base » (un par module concerne) ;
- directement depuis le rapport souhaite, en cliquant le bouton flottant
  **☆ Definir comme accueil** en bas a droite. L'etoile devient pleine
  lorsque la page est votre accueil ; recliquer revient au defaut.

Ce choix est propre a votre compte. Le detail des rapports eligibles est
donne dans le guide du module concerne.

---

## 4. Documentation

L'entree **Documentation** de la barre de navigation regroupe tous les
documents auxquels votre profil donne acces, classes en quatre familles :

| Famille | Contenu |
|---------|---------|
| Administration generale | Installation, configuration, securite de l'application |
| Administration des modules | Configuration de chaque module |
| Guide d'utilisation general | Ce document |
| Guides d'utilisation des modules | Un guide par module active |

Le classement est automatique : **vous ne voyez que ce qui vous
concerne**. Un utilisateur sans role d'administration ne voit que les
guides d'utilisation, et uniquement ceux des modules auxquels il a acces.

Les liens entre documents et les images sont pris en charge : vous pouvez
naviguer d'un guide a l'autre sans quitter l'application.

---
