Aller au contenu

Installation

Installer @fraza-pro/module-projects, créer les tables, ouvrir le premier projet et y faire avancer une première fiche.

Cette page installe @fraza-pro/module-projects 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érequisPourquoi
La clé du projet dans .npmrcLe registre ne sert @fraza-pro/* qu'avec elle. Voir Modules Pro.
NEXT_PUBLIC_URLLe routeur du core refuse une écriture dont l'origine ne correspond pas, et les liens des courriels en sont dérivés.
Les courriels du core (Resend ou SMTP)Pour les courriels des colonnes et des mises à jour. Sans eux, le reste fonctionne.
Le stockage du core (facultatif)Pour les images des descriptions et des mises à jour. Sans lui, l'envoi d'une image est refusé, le texte s'enregistre.

Installer

npm i @fraza-pro/module-projects

Ajouter l'activation à .env.local, ou aux variables de la plateforme en production :

FRAZA_MODULE_PROJECTS=true

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

npx fraza-modules sync
npx fraza-db init

fraza-db init crée les tables fraza_projects_* et donne les trois permissions du module au rôle admin. Quand il crée la table fraza_projects_project, il crée aussi un premier projet, « Principal » (slug principal), mis en avant, avec les cinq colonnes du modèle Feuille de route. C'est un projet comme les autres : il se renomme, s'archive ou se supprime. Un site qui a supprimé tous ses projets ne le retrouve pas à un fraza-db init suivant : la table existe déjà.

Vérifier

  1. Ouvrir /za/projects : la liste des projets publics, avec « Principal ».
  2. Dans l'admin, ouvrir Projets, puis le projet « Principal », et cliquer Nouvelle fiche. La fiche arrive dans « À l'étude » et paraît sur /za/projects/principal.
  3. Se connecter avec un autre compte et voter pour elle sur /za/projects/principal.
  4. Dans l'onglet Tableau du projet, glisser la carte vers Planifié et confirmer : le compte qui a voté reçoit « C'est prévu ».

Mettre un lien vers les feuilles de route

Le module ne touche pas au menu du site. Ajouter un lien vers /za/projects, la liste des projets publics, ou vers /za/projects/<projet> pour un seul projet, dans l'en-tête ou le pied de page. Un site qui construit ses feuilles de route dans son design règle d'abord FRAZA_MODULE_PROJECTS_PUBLIC_PATH : voir Intégrer au site.

Mettre à jour

npx fraza-update

La commande installe la dernière version de tous les paquets Fraza du site, toutes à la fois, puis enchaîne fraza-modules sync, fraza-db migrate et fraza-doctor. Mettre à jour @fraza-pro/module-projects seul, par npm i, laisserait le core et les autres modules en arrière.

Le schéma initial vit dans createTables(). Ses évolutions arrivent par des migrations versionnées, que fraza-db migrate applique avant que la nouvelle version serve. Voir Modèle de données.

Notes

  • Le module dépend de @fraza/core en peerDependency. Il n'embarque pas sa propre copie du core.
  • Désinstaller le module ne supprime ni les tables ni les images du stockage. dropTables, exporté depuis @fraza-pro/module-projects, supprime les tables, pas les images.

Sur cette page