Installation
Installer @fraza-pro/module-feedback, créer les tables et recevoir un premier rapport.
Cette page installe @fraza-pro/module-feedback dans un projet créé par npx @fraza/start. Le module est découvert au démarrage par le scan des dépendances, comme décrit dans Cycle de vie d'un module. Son utilisation en production demande une licence Fraza Pro : voir Licence et propriété.
Prérequis
| Prérequis | Pourquoi |
|---|---|
La clé du projet dans .npmrc | Le registre ne sert @fraza-pro/* qu'avec elle. Voir Modules Pro. |
NEXT_PUBLIC_URL | Le routeur du core refuse une écriture dont l'origine ne correspond pas, et les liens des courriels en sont dérivés. |
FRAZA_ENCRYPTION_KEY | Signe le délai minimum du formulaire et les liens de suivi. Sans elle, le délai n'est pas vérifié et un rapport envoyé sans compte n'a pas de lien de suivi. |
| Les courriels du core (Resend ou SMTP) | Pour l'accusé de réception et les réponses. Sans eux, le reste fonctionne. |
| Le stockage du core (facultatif) | Pour les captures d'écran. Sans lui, le formulaire n'en propose pas. |
| Le module Projets (facultatif) | Pour lier les rapports aux fiches d'une feuille de route. Voir Avec le module Projets. |
Installer
npm i @fraza-pro/module-feedbackAjouter l'activation à .env.local, ou aux variables de la plateforme en production :
FRAZA_MODULE_FEEDBACK=trueRégénérer les manifestes et créer les tables :
npx fraza-modules sync
npx fraza-db initfraza-db init crée les tables fraza_feedback_* et le projet « Principal », puis donne les trois permissions du module au rôle admin.
Sur une base qui avait déjà le module, npx fraza-db migrate passe les migrations. Voir Modèle de données.
Premier essai
- Ouvrir
/za/feedback/nouveau: le formulaire, sur un seul écran. - Envoyer un bug, sans compte, avec une adresse courriel. Le dernier écran donne le lien de suivi.
- Dans l'admin, ouvrir Rétroaction › Boîte de réception : le rapport y est, et la cloche l'a annoncé.
- Sur la page du rapport, écrire une Réponse à l'auteur : elle part par courriel, et se lit sur la page de suivi.
- Fermer le rapport avec la raison « Réglé ».
Avec le module Projets, l'étape suivante est de choisir la feuille de route qui reçoit les rapports. Voir Avec le module Projets.
Mettre un lien vers le formulaire
Le module ne touche pas au menu du site. Ajouter un lien « Signaler un problème » vers le formulaire, dans l'en-tête ou le pied de page. Le paramètre depuis joint au rapport la page d'où vient la personne :
<a href={`/za/feedback/nouveau?type=bug&depuis=${encodeURIComponent(pathname)}`}>Signaler un problème</a>