Installation

Cette page couvre l'installation de @lrvo/module-forms dans un projet déjà structuré par @lrvo/start. Le module n'est jamais déclaré à la main : il est découvert au boot par scan des dépendances, comme décrit dans Cycle de vie d'un module.

Prérequis

• Un projet généré par npx @lrvo/start, avec @lrvo/core installé.
• NEXT_PUBLIC_URL renseignée. Ce n'est pas une recommandation : sans elle, toute soumission est rejetée. Voir plus bas.

Installer

npm i @lrvo/module-forms

Ajouter la variable d'activation au .env :

#------ MODULE - FORMS ------#
LRVO_MODULE_FORMS=true

Sans ce drapeau, le module est ignoré : aucune table, aucune route, aucune entrée d'admin.

Régénérer les manifestes puis créer les tables :

npx lrvo-modules sync    # déclenché automatiquement au postinstall
npx lrvo-db init         # crée lrvo_forms_form et lrvo_forms_submission

Version de core exigée

Le module réclame @lrvo/core 1.0.70 ou plus, et le boot refuse une combinaison plus ancienne en nommant le module. C'est ce core qui sait générer app/.lrvo/public-pages.server.js, le manifeste par lequel la page publique /lrvo/forms/<slug> s'enregistre.

Sur un projet créé avant cette version, app/lrvo/[...path]/page.js doit gagner l'import du manifeste :

npx lrvo-doctor --fix
npx lrvo-modules sync

lrvo-db init saute les tables déjà présentes. Le module n'a aucune migration de schéma : les tables sont créées telles quelles ou laissées intactes. Voir Modèle de données.

Vérifier l'origine publique

C'est l'étape que l'on oublie, et elle rend le module inutilisable si elle manque.

NEXT_PUBLIC_URL=https://exemple.com
NEXT_PUBLIC_URL_DEV=http://localhost:3000

Le routeur du core protège toute requête modifiante par une comparaison d'origine. L'en-tête Origin de la requête doit correspondre à l'origine déclarée dans ces variables. Si aucune n'est renseignée, la comparaison échoue systématiquement et la soumission remonte en 403.

Le symptôme est trompeur : le formulaire s'affiche, se remplit, et l'envoi échoue sans message explicite côté visiteur.

Voir Soumissions pour le détail de cette protection.

Activer les courriels

Les notifications à l'équipe et les accusés de réception passent par le service de courriel du core, donc par le fournisseur configuré pour le projet.

LRVO_EMAIL_RESEND_APIKEY=re_...
LRVO_EMAIL_FROM_ADDRESS=[email protected]
LRVO_EMAIL_FROM_NAME=Exemple

Sans ces variables, le module fonctionne : les soumissions sont enregistrées et consultables dans l'admin, seuls les courriels ne partent pas. Leur échec n'a jamais d'effet sur la soumission.

Voir core/email.

Activer les champs fichier

Un formulaire qui accepte des pièces jointes a besoin du stockage objet du core, configuré par les variables LRVO_STORAGE_*. Voir core/storage.

Sans ces variables, un formulaire sans champ fichier fonctionne normalement.

Afficher un premier formulaire

Créer un formulaire depuis /admin/forms, lui donner un slug, puis l'ouvrir directement à son URL de page publique :

/lrvo/forms/<slug>

Cette page est enregistrée par le module au boot, il n'y a rien à câbler. Elle sert avant tout à vérifier l'installation : pour un vrai site, préférer le bloc du BlockEditor ou le composant FormEmbed. Voir Affichage.

Vérifier

1. La connexion à la base répond :

   npx lrvo-db test

2. Formulaires apparaît dans la barre latérale de l'admin, avec les items Formulaires et Soumissions.
3. Créer un formulaire, l'ouvrir à /lrvo/forms/<slug>, l'envoyer, puis retrouver la soumission dans /admin/forms/submissions.

Si l'envoi échoue, vérifier d'abord NEXT_PUBLIC_URL, puis attendre trois secondes avant de valider : un envoi trop rapide est refusé par la protection anti-robot. Voir Soumissions.

Les permissions du module sont enregistrées et attribuées au rôle admin pendant lrvo-db init. Un module ajouté après coup n'a donc besoin que d'un npx lrvo-db init pour que forms.view et forms.manage apparaissent dans /admin/roles.

Mettre à jour

npx lrvo-update

Le module déclare la version minimale de @lrvo/core dont il a besoin. Un npm i @lrvo/module-forms@latest sur un projet dont le core est trop ancien produit un ERESOLVE au message peu parlant : lrvo-update résout au contraire le core et les modules ensemble, et laisse en place tout module qu'il ne peut pas monter.

Les notes de version sont livrées avec le package, dans node_modules/@lrvo/module-forms/CHANGELOG.md.

Notes

• Le module dépend de @lrvo/core en peerDependency et n'a aucune dépendance de runtime. L'envoi de courriel et le client de stockage viennent du core.
• Désinstaller le module ne supprime pas les tables. dropTables est exporté depuis @lrvo/module-forms pour le faire explicitement.
• Un nouveau formulaire est créé actif. Le passer inactif le retire de la page publique et fait échouer les soumissions, sans toucher aux réponses déjà reçues.