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é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. |
| 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-projectsAjouter l'activation à .env.local, ou aux variables de la plateforme en production :
FRAZA_MODULE_PROJECTS=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_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
- Ouvrir
/za/projects: la liste des projets publics, avec « Principal ». - 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. - Se connecter avec un autre compte et voter pour elle sur
/za/projects/principal. - 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-updateLa 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/coreenpeerDependency. 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.