Projets
Projets en tableau, fiches avec responsables, échéances et jalons, notes de version et journal public, feuilles de route publiques avec votes, suivi et courriels aux personnes concernées.
@fraza-pro/module-projects donne à l'équipe d'un site un outil de projets, et au public une feuille de route par projet, où il lit et vote. L'équipe range ses fiches en colonnes, les assigne, les date et les groupe en jalons. Les personnes qui ont voté ou qui suivent une fiche reçoivent un courriel quand elle est prévue, puis quand elle est livrée, avec un lien pour se désabonner.
npm i @fraza-pro/module-projects| Paquet | @fraza-pro/module-projects |
|---|---|
| Licence | Fraza Pro. Voir Licence et propriété. |
| Registre | https://registry.fraza.ca/, avec la clé du projet. Voir Modules Pro. |
| Activation | FRAZA_MODULE_PROJECTS=true |
Pour l'installer, voir Installation.
Projets et fiches
Un projet a son tableau, ses colonnes, ses étiquettes et ses jalons. Les projets sont égaux : chacun vit sous son slug, dans l'admin (/admin/projects/<projet>) comme sur le site (/za/projects/<projet>). Un projet actif est toujours mis en avant : c'est celui que lit un site qui n'en nomme aucun, ou le premier projet public quand il est interne. Un projet terminé s'archive : il quitte la liste et le site, et garde ses fiches.
Une fiche, c'est ce que l'équipe décide de faire : « Export des factures ». Elle appartient à un projet, se trouve dans une de ses colonnes, et porte un type (Tâche, Bug, Idée, Amélioration), une priorité, parfois une échéance, un jalon et des responsables. Elle paraît sur la feuille de route publique quand elle, sa colonne et son projet sont publics. Une fiche interne garde le travail technique que personne dehors n'a besoin de voir.
Un jalon groupe des fiches autour d'un but daté : une version, une étape d'un projet client. Il montre son avancement, et donne ses notes de version en Markdown à partir de ses fiches terminées. Fermé, il paraît dans le journal public du projet et dans son flux RSS.
Avec le module Rétroaction
Projets fonctionne seul. Avec @fraza-pro/module-feedback, Rétroaction reprend les projets d'ici, les rapports envoyés par le formulaire se lient aux fiches, leurs auteurs reçoivent les courriels d'une fiche, et la feuille de route publique propose « Signaler un bug » et « Proposer une idée ». Voir Avec Rétroaction.
Pages de cette section
| Page | Contenu |
|---|---|
| Installation | Installer le module, créer les tables, ouvrir un premier projet. |
| Configuration | Variables d'environnement, permissions, entrée d'admin, tâche planifiée. |
| Administration | La liste des projets, Mes fiches, les onglets d'un projet, la page d'une fiche, les jalons, les réglages. |
| Pages publiques | La liste des projets, la feuille de route, une colonne entière, le journal, la page d'une fiche, le vote, le suivi, les courriels et le désabonnement. |
| Modèle de données | Les tables fraza_projects_*, les migrations, les abonnés, les désabonnements et les images des descriptions. |
| API | Routes HTTP, et l'intégration projects que lisent les autres modules. |
| Intégrer au site | Construire la feuille de route et la page d'une fiche dans le design du site. |
| Avec Rétroaction | Ce qui change quand le module Rétroaction est installé aussi. |
Ce que le module apporte
| Partie | Détail |
|---|---|
| Tables | fraza_projects_project, _column, _tag, _milestone, _item, _item_assignee, _item_event, _item_update, _vote, _follower, _email_optout, _storage_deletion. |
| Admin | Une section « Projets » : la liste des projets, Mes fiches, et pour chaque projet ses onglets Vue d'ensemble, Tableau (filtres, cartes placées à la main), Liste, Jalons et Réglages. La page d'une fiche, avec son fil de mises à jour, son historique, ses votants, et la fusion d'un doublon. |
| Notifications | Dans la cloche de l'admin : une fiche assignée, une fiche qu'on porte qui change de colonne. |
| Pages publiques | /za/projects (les projets publics), /za/projects/<projet> (sa feuille de route, et ?colonne=<clé> pour une colonne entière), /za/projects/<projet>/journal (ses versions), /za/projects/<projet>/<fiche> (une fiche, à voter et à suivre), /za/projects/desabonnement (le lien des courriels). Un flux RSS du journal. |
| Courriels | Celui d'une colonne qui prévient (« C'est prévu », « C'est fait »), et « Du nouveau » pour une mise à jour envoyée par l'équipe. Chacun porte un lien de désabonnement. |
| Tâche planifiée | projects-images, chaque heure : retire du stockage les images que plus aucune description ne nomme. |
| Intégration | projects, publiée pour les autres modules. Voir API. |