Pages publiques
Le formulaire sur un seul écran, le suivi d'un rapport, la section de l'espace client et les courriels envoyés par le module Rétroaction.
Les pages publiques prennent le cadre commun des modules et la marque du site. Voir Pages publiques. Pour des pages dans le design du site, voir Intégrer au site.
Le module sert deux pages : le formulaire et le suivi d'un rapport. /za/feedback mène au formulaire. La feuille de route publique est celle du module Projets : voir Pages publiques de Projets.
Avec FRAZA_MODULE_FEEDBACK_PUBLIC_PATH, ces pages ne s'affichent plus : chacune redirige vers la même adresse sous le chemin du site, paramètres compris. /za/feedback/nouveau?type=bug mène à /feuille-de-route/nouveau?type=bug.
Aucune de ces pages n'est indexée par les moteurs de recherche.
Le formulaire : /za/feedback/nouveau
Un seul écran, moins d'une minute.
- De quoi s'agit-il ? Un sélecteur en haut du formulaire : bug, idée ou question. Sans
typedans l'adresse, les trois choix s'affichent d'abord, puis le formulaire. Le sélecteur change de type sans rien perdre de ce qui est écrit. - Une phrase, le seul champ obligatoire, lue sur une ligne : un saut de ligne ou une tabulation devient une espace.
- Déjà sur la feuille de route ? Pour un bug ou une idée, avec le module Projets, les fiches publiques qui partagent des mots avec la phrase apparaissent pendant la saisie, trois au plus, la plus proche d'abord. Chacune mène à sa fiche, pour voter plutôt que d'écrire un doublon. Voir Avec Projets.
- Ça concerne…, un menu facultatif, quand l'équipe propose des étiquettes dans le formulaire : le rapport arrive déjà classé. « Je ne sais pas » par défaut. Voir Les étiquettes.
- Des détails facultatifs, avec une question qui dépend du type. Des captures d'écran à coller, glisser ou choisir : trois images au plus, 5 Mo chacune, JPG, PNG, GIF ou WebP. Au-delà de trois, les suivantes ne sont pas ajoutées et un message le dit.
- Un courriel facultatif, pour suivre la suite. Le champ n'apparaît pas pour un compte client connecté : l'adresse de son compte sert, et le rapport lui est lié.
Seul un compte client signe un rapport. Un compte d'équipe connecté à l'admin qui remplit le formulaire public y est un visiteur : il tape son adresse, et reçoit le lien de suivi signé. Même chose pour toute personne connectée sur un site sans comptes clients (sans FRAZA_CLIENTS=true). Voir Le site, l'espace client et l'admin.
Si le formulaire ne peut pas s'ouvrir, l'erreur s'affiche sous le choix du type.
La page d'origine, le navigateur, l'écran et la langue sont joints au rapport. La personne les voit sous « Informations jointes pour l'équipe » et peut retirer chacun d'eux.
| Paramètre | Effet |
|---|---|
type | bug, idea ou question : ouvre le formulaire avec ce type choisi. |
depuis | Un chemin du site, joint comme page d'origine. Autre chose qu'un chemin commençant par / est ignoré. |
Après l'envoi, le formulaire remercie et propose, selon le cas :
| Bouton | Quand |
|---|---|
| Suivre mon message | Envoi sans compte client, quand le site a FRAZA_ENCRYPTION_KEY : le lien de suivi. |
| Mes messages | Envoi depuis un compte client : la section de l'espace client. Absent sans espace client. |
| Voir la feuille de route | Avec le module Projets, quand le projet du rapport nomme un projet de Projets dont la feuille de route est publique. |
Contre les robots
Un champ invisible piège les robots : rempli, l'envoi reçoit un faux succès et rien n'est enregistré. Le formulaire reçoit à son ouverture un jeton signé par le serveur, et un envoi fait moins de trois secondes après est refusé. Un jeton de plus d'un jour a expiré : le formulaire en redemande un et renvoie une fois, sans rien dire. La route est limitée par le préréglage public_form du core.
Le suivi : /za/feedback/suivi/<jeton>
Une personne sans compte client reçoit ce lien à l'envoi et dans chaque courriel. La page montre son message, où il en est, et les échanges avec l'équipe : ses réponses publiques et les messages de l'auteur, sous « Mon message ». Jamais les notes internes, ni l'adresse ou le contexte joints.
| État affiché | Quand |
|---|---|
| Reçu | Le rapport attend dans la boîte de réception. |
| La colonne de sa fiche | Avec le module Projets, une fois le rapport lié à une fiche qui a une page publique. Une colonne interne se lit « En traitement », ou « Terminé » si elle est terminée. |
| En traitement ou Terminé | Le rapport est lié à une fiche interne, sans page publique. Selon que sa colonne est terminée ou non. |
| Réglé, Doublon ou Pas retenu | Le rapport est fermé. |
| Fermé | Le rapport est fermé comme indésirable : l'auteur ne lit jamais cette raison. |
Un rapport lié à une fiche qui a une page publique montre aussi le titre de la fiche, avec un lien vers cette page, et sa colonne. Pour une fiche interne, l'auteur ne lit ni son titre ni sa colonne : la page dit « Ce message est pris en charge par l'équipe : En traitement. », ou « Terminé ».
Répondre à l'équipe
Sous les échanges, le champ Écrire à l'équipe ajoute un message de l'auteur au rapport, 5000 caractères au plus. La page se relit après l'envoi et le message paraît avec les autres. L'équipe le lit dans les échanges du rapport, et les personnes qui ont feedback.manage reçoivent une notification. Voir Répondre ou noter.
Un rapport fermé ne reçoit plus de message : la page le dit à la place du champ, et invite à écrire une nouvelle demande. L'envoi est limité par le préréglage feedback_author_message, dix messages par adresse réseau toutes les dix minutes.
Le lien
Le lien est signé avec FRAZA_ENCRYPTION_KEY. Il cesse de fonctionner quand la conservation efface les données du rapport. Un lien faux ou effacé affiche « Lien introuvable », avec un bouton vers le formulaire. Le titre de l'onglet reste « Suivi » dans les deux cas : il ne dit pas si un jeton existe.
L'espace client : /compte/retroaction
Un compte client retrouve ses rapports dans la section « Rétroaction » de son espace client, chacun avec son état et ses échanges avec l'équipe, les plus récents d'abord. Sous un rapport ouvert, le même champ Écrire à l'équipe que sur la page de suivi, par une route qui vérifie la session : seul le compte client qui a envoyé le rapport y écrit. Un compte d'équipe n'y écrit pas. Un rapport dont la conservation a effacé les données n'en reçoit plus. La section paraît dès le premier rapport envoyé. Elle n'est pas enregistrée sur un site sans comptes clients. Elle propose Écrire à l'équipe, et Feuille de route quand le projet principal nomme un projet de Projets dont la feuille de route est publique. Voir Ajouter un espace client.
Plusieurs projets
Le projet principal garde les adresses ci-dessus. Dès que le site a plus d'un projet, chaque autre projet ajoute son slug :
| Page | Projet principal | Autre projet |
|---|---|---|
| Formulaire | /za/feedback/nouveau | /za/feedback/<projet>/nouveau |
| Base | /za/feedback, mène au formulaire | /za/feedback/<projet>, mène à son formulaire |
| Suivi | /za/feedback/suivi/<jeton> | la même : le jeton désigne le rapport |
- Le formulaire d'un projet porte son nom dans le titre de la page.
- Un rapport envoyé depuis le formulaire d'un projet arrive dans la boîte de réception de ce projet.
- Un projet privé répond 404 sur son formulaire, et son formulaire refuse les envois. Le suivi d'un de ses rapports reste ouvert à son auteur.
- Avec le module Projets, un projet archivé n'a plus de formulaire public : il sort de la liste des projets publics et son formulaire refuse les envois. Le suivi de ses rapports reste ouvert. Voir Avec le module Projets.
- L'espace client et la page de suivi nomment le projet d'un rapport, sauf le projet principal, qui va sans dire.
- Quand le projet principal est privé,
/za/feedback/nouveaumontre le formulaire du premier projet public et actif, dans l'ordre de l'admin. Sans projet public, l'adresse répond 404.
Les courriels
| Courriel | Quand | À qui |
|---|---|---|
| « Message reçu (n° 42) » | À l'envoi d'un rapport. La référence, le type, le projet quand ce n'est pas le principal, la date et l'heure d'envoi, et ce qui suivra. | L'auteur, si on a son adresse. Trois par adresse par heure au plus. |
| « Réponse au message : … » | L'équipe écrit une réponse publique. | L'auteur, si on a son adresse. Le message tel qu'écrit. |
| « Message fermé : … » | L'équipe ferme le rapport, seul ou dans une sélection. Une phrase selon la raison, et la raison. | L'auteur, si on a son adresse. Jamais pour un rapport fermé comme indésirable, ni quand on change seulement la raison d'un rapport déjà fermé. |
| « Message rouvert : … » | L'équipe rouvre le rapport. | L'auteur, si on a son adresse. Jamais pour un rapport qui était fermé comme indésirable. |
Aucun de ces courriels ne part pour un rapport dont la conservation a effacé les données. Ceux d'une fermeture et d'une réouverture partent une fois la réponse envoyée, d'après l'état du rapport à ce moment : un rapport rouvert entre-temps ne reçoit pas le courriel de sa fermeture. Ils reprennent le résumé, comme la réponse, et rien d'autre de ce que la personne a écrit.
Tous portent un bouton vers le suivi : l'espace client pour un rapport envoyé depuis un compte client, le lien signé sinon. Ce lien suit FRAZA_ACCOUNT_PATH. Sur un site sans comptes clients, un rapport lié à un compte, par exemple envoyé avant que le site ne retire FRAZA_CLIENTS=true, reçoit lui aussi le lien signé : il n'y a pas d'espace client où l'ouvrir. L'adresse d'un compte est lue au moment de l'envoi : une personne qui l'a changée reçoit le courriel à la nouvelle.
Les courriels passent par la file d'envoi du core : une panne du fournisseur les retarde sans les perdre. L'accusé de réception part vers une adresse que n'importe qui peut taper : il ne reprend rien de ce qui a été écrit, pas même le résumé. Sans quoi le formulaire relaierait le texte d'un inconnu, depuis le domaine du site, vers la boîte de son choix. Tout ce qu'il contient vient du site : la référence (le numéro du rapport, que l'équipe retrouve en le cherchant dans la boîte de réception), le type, le projet, l'heure d'envoi dans le fuseau du site (FRAZA_TIMEZONE), et une phrase sur la suite. Avec le module Projets, cette phrase annonce aussi les nouvelles de la fiche liée. Le reste se lit sur la page de suivi.
Avec le module Projets, les auteurs des rapports liés à une fiche reçoivent aussi les courriels de cette fiche, envoyés par Projets. Voir Avec le module Projets.