From 6491943930bf991042c503dd405026f44d429dff Mon Sep 17 00:00:00 2001 From: Matthieu Date: Thu, 21 May 2026 11:17:59 +0200 Subject: [PATCH] =?UTF-8?q?docs=20:=20ajoute=20la=20section=20Messagerie?= =?UTF-8?q?=20au=20centre=20d'aide=20+=20maj=20admin/int=C3=A9grations=20(?= =?UTF-8?q?mail=20OVH)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 4.7 (1M context) --- frontend/content/help/07-admin.md | 10 ++++++ frontend/content/help/08-integrations.md | 28 ++++++++++++++++- frontend/content/help/10-messaging.md | 40 ++++++++++++++++++++++++ frontend/pages/help.vue | 1 + 4 files changed, 78 insertions(+), 1 deletion(-) create mode 100644 frontend/content/help/10-messaging.md diff --git a/frontend/content/help/07-admin.md b/frontend/content/help/07-admin.md index 1f00d0b..5f32a64 100644 --- a/frontend/content/help/07-admin.md +++ b/frontend/content/help/07-admin.md @@ -64,3 +64,13 @@ L'admin (`/admin`) est divisé en plusieurs onglets, chacun gérant une ressourc - Configure le calendrier CalDav par défaut - Test de connexion intégré - Active la **sync calendrier** sur les tâches planifiées + +## Onglet *Mail* + +Configure la **boîte mail partagée** (OVH) lue dans la section *Messagerie*. + +- **Réception (IMAP)** : hôte, port (993 par défaut), chiffrement (SSL / TLS / aucun) +- **Envoi (SMTP)** : hôte, port (465 par défaut), chiffrement +- **Identifiants** : nom d'utilisateur + mot de passe (chiffré côté serveur, jamais réaffiché — un indicateur signale qu'un mot de passe est déjà enregistré), et chemin du dossier *Envoyés* +- **Toggle `enabled`** : active la messagerie +- **Test de connexion** intégré (vérifie l'accès IMAP et compte les dossiers) diff --git a/frontend/content/help/08-integrations.md b/frontend/content/help/08-integrations.md index fa008f9..d863b9a 100644 --- a/frontend/content/help/08-integrations.md +++ b/frontend/content/help/08-integrations.md @@ -1,6 +1,6 @@ # Intégrations -Lesstime s'intègre avec **3 outils externes** pour fluidifier le workflow dev. +Lesstime s'intègre avec **4 outils externes** pour fluidifier le workflow dev. ## 🌳 Gitea @@ -64,3 +64,29 @@ Sur une tâche avec **scheduled start + end** : - **Pas de retour Zimbra → Lesstime** : si tu modifies l'événement dans Zimbra, Lesstime ne le voit pas - **Récurrences** : les patterns RRULE basiques sont supportés (daily, weekly avec jours, monthly) + +## 📧 Messagerie (Mail OVH) + +Boîte mail partagée OVH (IMAP) lue directement dans Lesstime. + +### Configuration + +1. **Admin → Mail** : + - Réception **IMAP** (hôte, port, chiffrement) et envoi **SMTP** (hôte, port, chiffrement) + - Identifiants (mot de passe chiffré côté serveur) + dossier *Envoyés* + - **Test de connexion** intégré +2. Active la config (toggle `enabled`) + +### Utilisation + +- La section **Messagerie** (barre latérale) affiche dossiers, messages et lecteur +- **Synchronisation IMAP à la demande** via le bouton *Rafraîchir* (traitée en asynchrone par Messenger) +- Depuis un mail : **créer une tâche** pré-remplie ou **lier à une tâche** existante +- Badge de non-lus dans la barre latérale, rafraîchi automatiquement (toutes les 30 s) + +> 📖 Le guide complet de la messagerie est dans la section *Messagerie*. + +### Limites + +- **Lecture seule** : pas de rédaction / réponse / suppression de mail depuis l'interface +- Réservée aux rôles **admin** et **user** (pas les clients) diff --git a/frontend/content/help/10-messaging.md b/frontend/content/help/10-messaging.md new file mode 100644 index 0000000..350f99a --- /dev/null +++ b/frontend/content/help/10-messaging.md @@ -0,0 +1,40 @@ +# Messagerie + +Lesstime intègre une **boîte mail partagée** (OVH, protocole IMAP) directement dans l'application. Tu lis les mails de l'équipe et tu les transformes en tâches sans quitter Lesstime. + +> 📥 La messagerie est accessible depuis l'entrée **Messagerie** de la barre latérale (icône enveloppe). Un **badge** y affiche le nombre de mails non lus, toutes boîtes confondues. + +> 🛡️ Réservée aux rôles **ROLE_ADMIN** et **ROLE_USER**. Les utilisateurs *client* sont redirigés vers leur portail. + +## L'interface + +L'écran est organisé en **3 colonnes** : + +1. **Dossiers** — l'arborescence de la boîte (INBOX, Envoyés, sous-dossiers…), avec le compteur de non-lus par dossier. INBOX est sélectionné par défaut. +2. **Messages** — la liste du dossier sélectionné (expéditeur, objet, date). Les mails non lus sont mis en avant. Un bouton **Charger plus** récupère les messages suivants (pagination). +3. **Lecteur** — le mail sélectionné : en-tête (expéditeur, destinataires, date), corps du message et **pièces jointes**. + +## Lire un message + +- Clique sur un message dans la liste : son détail s'affiche et il est **automatiquement marqué comme lu**. +- Tu peux le repasser **non lu** ou l'**étoiler** (flag) pour le retrouver plus tard. +- Les **pièces jointes** sont listées dans le lecteur : clique pour les télécharger, les images peuvent être prévisualisées. + +## Synchronisation + +- Le bouton **Rafraîchir** (en haut de l'écran) déclenche une **synchronisation IMAP à la demande** : Lesstime va chercher les nouveaux mails sur le serveur. Le traitement est asynchrone, la liste se met à jour quelques secondes après. +- En arrière-plan, le **compteur de non-lus** de la barre latérale se rafraîchit automatiquement (toutes les 30 s). + +## Transformer un mail en action + +Depuis le lecteur, deux boutons relient un mail au suivi de projet : + +- **Créer une tâche** — ouvre une tâche pré-remplie à partir du mail (objet, contenu). Tu choisis le projet et les métadonnées, le mail reste lié à la tâche. +- **Lier à une tâche** — rattache le mail à une tâche **existante**. + +> 💡 C'est le pont entre la boîte mail de l'équipe et le kanban : une demande reçue par mail devient une tâche traçable en deux clics. + +## Limites + +- **Lecture seule** : l'interface ne permet pas (encore) de **rédiger, répondre ou transférer** un mail, ni de supprimer un message. +- La configuration du serveur (IMAP/SMTP, identifiants) se fait dans **Admin → Mail** — voir la section *Administration*. diff --git a/frontend/pages/help.vue b/frontend/pages/help.vue index 24c12c0..26ed15b 100644 --- a/frontend/pages/help.vue +++ b/frontend/pages/help.vue @@ -24,6 +24,7 @@ const META: Record(() => {