Demandes d'aide

Les demandes d'aide constituent le système intégré de suivi des problèmes et d'assistance d'Aptli. Tout utilisateur peut soumettre une demande d'aide directement depuis la page de détail d'un enregistrement — la demande est automatiquement rattachée à cet enregistrement, ce qui évite toute ambiguïté sur son objet. Les administrateurs gèrent la file d'attente depuis le panneau Admin.

Qui utilise les demandes d'aide ?

Soumettre une demande d'aide (depuis n'importe quel enregistrement)

Chaque page de détail d'enregistrement (/[entité]/[id]) comporte un bouton Demander de l'aide dans l'en-tête — repérez l'icône badge-help. Cela inclut les projets, rapports, tâches, ordres de travail, validations, sites, ressources et éléments de stock.

Étapes :

1. Ouvrez la page de détail de n'importe quel enregistrement (ex. une tâche, un ordre de travail ou un profil utilisateur)
2. Cliquez sur Demander de l'aide dans l'en-tête de la page
3. Un panneau coulissant s'ouvre sur la droite — l'enregistrement est déjà rattaché comme cible (affiché sous forme de puce en lecture seule dans le champ À propos de)
4. Remplissez les champs :
   • Titre (obligatoire) — une description courte et claire du problème
   • Description — étapes pour reproduire ou contexte supplémentaire
   • Rôle cible — quelle équipe doit traiter cette demande (liste déroulante avec recherche ; optionnel — laisser vide pour n'importe quel administrateur)
   • Urgence — Faible / Moyenne / Élevée / Critique
   • Pièces jointes — photos ou fichiers optionnels
   • Notifier le rôle cible — case à cocher optionnelle pour envoyer immédiatement un e-mail au rôle cible
5. Cliquez sur Soumettre

L'URL de contexte est capturée silencieusement afin que les administrateurs puissent revenir directement à la page sur laquelle vous vous trouviez.

Pas de superposition — Continuez à travailler pendant que vous rédigez

Le panneau d'aide s'ouvre comme un panneau coulissant sur la droite sans superposition modale, ce qui vous permet de faire défiler, lire et copier du texte depuis l'enregistrement en arrière-plan pendant que vous rédigez votre description. Fermez le panneau et vos modifications sur l'enregistrement restent intactes.

Badge de demandes d'aide associées

Chaque enregistrement acceptant des demandes d'aide affiche un badge de demandes d'aide agrégé à côté du bouton Demander de l'aide. Le badge résume en un coup d'œil les demandes ouvertes sur cet enregistrement précis.

• Gris / zéro — aucune demande associée
• Coloré / compteur — une ou plusieurs demandes ; survoler pour obtenir un détail par statut

Cliquer sur le badge accède à la vue liste filtrée, restreinte à cet enregistrement.

Partager un enregistrement dans une demande

Chaque page de détail comporte également un bouton Partager qui copie un lien court (ex. /help/:id) dans le presse-papiers. Collez-le n'importe où — Slack, e-mail ou dans la description d'une autre demande d'aide — et il renvoie vers l'enregistrement exact pour quiconque l'ouvre.

Niveaux d'urgence

Les demandes héritées stockées avec des urgences numériques sont automatiquement converties vers les nouveaux libellés à la lecture — aucune migration nécessaire.

Admin : Gestion de la file d'attente

Accédez à Admin → Demandes d'aide (/admin/help-requests) pour afficher toutes les demandes soumises.

Filtrage

• Utilisez la barre de filtre en haut pour rechercher par titre ou description
• Utilisez le filtre de statut — par défaut sur Ouvert afin que les administrateurs voient d'abord les tâches à traiter. Autres options : Engagé, Reporté, Échoué, Résolu
• Activez Afficher les éléments supprimés en haut à droite pour afficher les demandes archivées
• Utilisez Mes demandes (lien en haut du panneau) pour voir uniquement les demandes que vous avez personnellement soumises

Affichage d'une demande

Cliquez sur la flèche d'expansion de n'importe quelle ligne pour afficher tous les détails de la demande, notamment :

• E-mail du demandeur et date de soumission
• Enregistrement rattaché (la cible — rendu sous forme de lien)
• URL de contexte (la page sur laquelle se trouvait l'utilisateur lors de la soumission)
• Description et pièces jointes
• Rôle cible attribué
• Statut actuel et urgence

Mise à jour d'une demande

Dans la vue développée, les administrateurs peuvent :

• Modifier le statut (voir cycle de vie ci-dessous)
• Réattribuer le rôle cible
• Ajuster l'urgence si l'évaluation initiale était erronée
• Enregistrer une note de résolution, un résolu par et un résolu le (rempli automatiquement lors du passage au statut Résolu)

Enregistrez les modifications à l'aide du bouton Soumettre les modifications (icône de téléchargement vers le cloud, en haut à droite). Les modifications prennent effet immédiatement.

Cycle de vie des demandes

open → committed (travail commencé)
     → deferred  (pris en compte, pas encore planifié)
     → failed    (n'a pas pu être résolu)
     → resolved  (terminé — capture resolvedAt/resolvedBy/resolutionNote)

Résoudre une demande

Cliquez sur Résoudre dans la vue développée pour ouvrir la fenêtre modale de résolution. Saisissez une note de résolution résumant ce qui a été fait, puis confirmez — la demande passe à resolved, horodatée avec votre utilisateur et la date. Le demandeur voit la note de résolution lorsqu'il revisite la demande.

Actions groupées

Sélectionnez plusieurs lignes à l'aide des cases à cocher pour :

• Suppression groupée ou restauration groupée des demandes
• Mise à jour groupée des propriétés partagées à l'aide du bouton Paramètres (roue dentée) dans la barre d'outils flottante

Sécurité — Le demandeur est imposé côté serveur

Le demandeur d'une demande d'aide est imposé depuis la session côté serveur. Un utilisateur ne peut pas usurper le demandeur d'un autre utilisateur lors de la soumission. Les modifications par un administrateur ne changent pas le demandeur d'origine.

Conseils

• Ouvrez le panneau depuis l'enregistrement concerné — la cible rattachée évite à l'administrateur de devoir demander « de quel enregistrement s'agit-il ? »
• Soyez précis dans le titre. « La carte ne se charge pas sur le site S-42 » est plus exploitable que « problème de carte ».
• Utilisez le rôle cible lorsque vous savez quelle équipe gère ce type de problème — cela aide les administrateurs à trier plus rapidement
• Les demandes critiques doivent également être communiquées directement (téléphone, message) — la file d'attente dans l'application n'est pas un système d'alerte en temps réel
• Notifier le rôle cible est utile pour les problèmes urgents où vous souhaitez que l'équipe d'administration soit contactée immédiatement
• Les demandes résolues restent dans le système — filtrez par Résolu (ou Afficher les éléments supprimés) pour consulter les résolutions historiques