Aide de pulpForge

pulpForge est l'outil de suivi de projets logiciels de pulpSuite. Il s'inspire d'Azure DevOps (types d'éléments de travail, catégories d'états, sprints, dépôts liés, plans de test simplifiés) avec l'ergonomie rapide d'un outil comme Linear. Il fonctionne dans le navigateur, sans installation ni compte. Par défaut, tout reste sur votre appareil ; vous pouvez aussi partager vos projets avec une équipe ou les ouvrir sur un téléphone : voir Partager avec une équipe ou un téléphone.

Un projet se regarde sous six écrans : Carnet, Tableau, Sprints, Requêtes, Dépôts et Tests. Importer, Corbeille et Réglages complètent le menu. Chaque projet s'ouvre dans un onglet, en haut de la fenêtre.

Premiers pas

1. Ouvrez pulpForge. À la première ouverture, un projet d'exemple s'affiche tout seul pour voir à quoi ressemble pulpForge : l'espace client d'une entreprise de bâtiment fictive, avec son carnet, son tableau, ses sprints, son dépôt de code et ses tests. Il n'est jamais enregistré et ne se mélange pas à vos projets. Commencer à zéro ou Supprimer l'exemple l'enlève d'un clic (fermer son onglet aussi), Importer mes données ouvre un export à importer, et Fichier › Revoir l'exemple le rouvre. Votre premier projet ou votre premier import le remplace. Ensuite, choisissez Nouveau projet (une clé de 2 à 10 lettres comme PRJ donne les numéros lisibles PRJ-42, et un processus Agile, Scrum ou Simple donne les types d'éléments et les états de départ) ou Importer un export d'un autre outil.
2. Dans le Carnet, cliquez sur Nouvel élément, tapez un titre puis Entrée : l'élément est créé et la saisie continue. Tab fait de l'élément suivant un enfant, Maj+Tab remonte d'un niveau.
3. Cliquez sur un élément pour ouvrir sa fiche : état, assigné, points, heures, échéance, étiquettes, description en Markdown, critères d'acceptation, liens, code, pièces jointes et historique.
4. Dans Sprints, créez un sprint, glissez des éléments du carnet vers le sprint, puis Démarrer. La jauge compare le reste à faire à la capacité de l'équipe.
5. Chaque modification s'enregistre aussitôt. Fichier › Enregistrer sous écrit une sauvegarde complète .pforge.

Tâches courantes

Comment organiser le carnet ?

Les éléments s'emboîtent en épopées › fonctionnalités › récits › tâches. Un triangle replie ou déplie une branche ; le cumul des points et du reste à faire s'affiche sur chaque parent. Glissez la poignée d'une ligne : déposer sur le haut ou le bas d'une autre ligne change l'ordre, déposer au milieu en fait un enfant. Un élément ne peut jamais devenir l'enfant de l'un de ses propres descendants : le message vous l'explique. Au clavier, Alt+↑ et Alt+↓ réordonnent.

Comment fonctionne la saisie rapide ?

Pendant la frappe, pulpForge suggère le type (anomalie, récit, tâche…) et la priorité d'après les mots du titre, en français, anglais et espagnol, et signale les doublons probables (« Ressemble à PRJ-12 »). Lier comme doublon crée le lien en même temps que l'élément. Rien n'est imposé : changez le type dans la liste à côté du champ.

Comment découper un récit en tâches ?

Écrivez une liste à puces dans la description du récit. Un bouton Créer N tâches enfants apparaît : une puce, une tâche.

Comment suivre l'avancement sur le tableau ?

Le Tableau range les cartes par catégorie d'état (à faire, en cours, résolu, terminé) ; un sous-état personnalisé s'affiche en pastille. Faites glisser une carte pour changer son état : si le flux d'états du type l'interdit, la carte revient avec un message. Choisissez les couloirs par assigné ou par parent (déposer une carte dans le couloir d'une personne la lui assigne). Une limite de travail en cours par colonne (bouton « … » de la colonne) colore la colonne en rouge quand elle est dépassée : c'est une alerte, pas un blocage. Sur téléphone, le menu « … » d'une carte change son état sans glisser.

Comment planifier un sprint ?

Dans Sprints, le carnet est à gauche et le sprint à droite : glissez, ou utilisez la flèche d'une ligne. Modifier règle les dates, l'objectif, la capacité par personne (heures par jour, jours d'absence) et les jours chômés de l'équipe. La jauge passe au rouge si le reste à faire dépasse la capacité. Le burndown montre la courbe idéale (du total à zéro sur les jours ouvrés) et la courbe réelle, relevée chaque jour à la première ouverture. Un seul sprint est actif à la fois ; Terminer propose de passer ce qui n'est pas fini au sprint suivant, de le remettre dans le carnet ou de le laisser. Résumé compose un texte à partir des chiffres du sprint, et Notes de version liste les éléments terminés par type (Enregistrer (.md) ou Ouvrir dans pulpDoc).

Comment relier des éléments entre eux et à d'autres applications ?

Dans la fiche, Liens : bloque, bloqué par, doublon de, lié à, teste… Pour relier un élément à une demande de modification de pulpProduct ou à une opportunité de pulpClient, collez la référence pulp:… copiée dans l'autre application. Le bouton Copier la référence de la fiche fait l'inverse.

Comment relier des commits, des branches et des demandes de fusion ?

Dans Dépôts, ajoutez l'adresse web d'un dépôt (jamais d'identifiant ni de jeton : une adresse qui en contient est refusée). pulpForge ne contacte pas le dépôt. Importer un journal Git affiche une commande à lancer dans votre dépôt (bouton Copier) ; importez ensuite le fichier produit, ou collez son contenu. Les commits qui citent PRJ-12, AB#12 ou #12 sont rattachés aux éléments, ainsi que les branches feature/PRJ-12-…. « Fixes PRJ-3 » ou « corrige #4 » propose de fermer l'élément : une liste à cocher demande votre confirmation, rien n'est fermé automatiquement.

Comment importer les résultats de tests ?

Dans Tests, importez un rapport JUnit XML. Les résultats sont rapprochés de vos cas de test (par clé d'origine, sinon par le nom du test) et pulpForge propose de créer les cas manquants. Le taux de réussite s'affiche par build. Un test en échec a un bouton Créer une anomalie, pré-remplie avec le message d'échec dans les étapes de reproduction.

Comment importer depuis Jira, Azure DevOps, GitHub ou GitLab ?

Importer (ou glissez le fichier sur la fenêtre). L'assistant reconnaît le format, puis propose le projet cible (un nouveau projet prend la clé d'origine), les correspondances (types, états, priorités, personnes), un aperçu (à créer, à mettre à jour, avertissements) et l'import. Les numéros d'origine sont conservés quand la clé de projet est la même (PRJ-12 reste PRJ-12). Un état inconnu garde son nom comme état personnalisé. Un import ajoute, il n'écrase jamais : un fichier réimporté ne crée rien, et les éléments déjà présents sont proposés en « mettre à jour » (avec les différences) ou « ignorer ».

Comment exporter ou imprimer ?

Requêtes : filtres combinables (type, état, catégorie, assigné, étiquette, sprint, zone, texte), que Enregistrer la requête garde pour plus tard, puis Exporter : CSV au format Jira, CSV au format Azure DevOps, JSON au format GitHub, ou CSV avec les en-têtes dans votre langue. Le menu Fichier propose aussi les exports Jira, Azure DevOps et GitHub de tout le projet, les Notes de version et Imprimer (tout le carnet ou le sprint actif).

Comment régler un projet ?

Dans Réglages : Projets (nom, processus, Zones pour ranger les éléments, et Afficher les fins de sprint dans l'agenda de la suite), Flux d'états (ajouter un état, choisir sa catégorie, Limiter les transitions permises, Rétablir le flux par défaut), Personnes (le carnet des assignés, qui sert aussi à la capacité des sprints), Affichage (thème) et Données (sauvegarde, recherche intelligente, Revoir l'exemple).

Comment retrouver ce que j'ai supprimé ?

Corbeille : éléments, sprints, dépôts, projets, personnes et requêtes supprimés s'y trouvent et se restaurent. Il n'y a pas de suppression définitive dans cette version.

Partager avec une équipe ou un téléphone

• Fichier partagé : Fichier › Enregistrer comme fichier partagé… place vos projets (par exemple Produit.pforge) dans un dossier synchronisé (OneDrive, Nextcloud, kDrive) ou sur un lecteur réseau. Vos collègues l'ouvrent par Fichier › Ouvrir un dossier partagé… ; chacun voit les modifications des autres dès que le dossier est synchronisé. Ouvrir une ancienne sauvegarde .pforge ajoute son contenu au fichier ouvert.
• État du fichier : la pastille de la barre de titre indique Sur cet ordinateur ou Partagé · N appareils ; un clic montre qui a vu vos modifications (« 5 modifications pas encore vues par Paul ») et propose Synchroniser maintenant.
• Modifications en même temps : si deux personnes changent le même champ d'un élément, la valeur la plus récente est gardée et un avis vous prévient, avec Garder ou Revenir à l'autre valeur.
• Numéros en double : deux personnes hors connexion peuvent créer chacune un PRJ-42. À la fusion, le plus récent est renuméroté (« PRJ-42 est devenu PRJ-57 ») et un avis le signale. La fiche affiche Ancien numéro : PRJ-42, et la recherche, les liens et le journal Git comprennent toujours l'ancien numéro.
• Pièces jointes : elles suivent le fichier. Jusqu'à 8 Mo, elles arrivent toutes seules sur chaque appareil ; au-delà, la pièce affiche À télécharger. Une pièce Pas encore arrivé sera là quand le dossier aura fini de se synchroniser.
• Sauvegarde automatique : Fichier › Sauvegarde automatique… fait une copie complète chaque jour dans le dossier de votre choix ; un rappel s'affiche si vos projets n'ont jamais été sauvegardés ou depuis plus de 7 jours.
• Mon téléphone : Fichier › Ouvrir sur mon téléphone… affiche un code QR ; flashez-le, vérifiez que le code à 6 chiffres est le même sur les deux appareils, choisissez Lecture seule ou Modification et la durée. Le téléphone affiche vos projets en direct depuis l'ordinateur, sans rien garder.
• Invité sur un ticket : dans la fiche d'un élément, Inviter sur cette fiche envoie un code QR ou un lien. La personne ne voit que ce ticket, ses sous-éléments, ses liens et son historique. Une fenêtre d'accord apparaît sur votre ordinateur : comparez le code, puis Refuser, Lecture seule ou Modification. En lecture seule, toute la fiche est grisée sous le bandeau Lecture seule ; un invité peut ouvrir les pièces jointes, pas en ajouter.
• Qui est connecté : « N appareil(s) connecté(s) » s'affiche dans l'en-tête ; Fichier › Appareils connectés… liste les séances, et Couper l'accès met fin à l'une d'elles immédiatement.
• Limites : le dossier partagé demande un ordinateur avec Chrome ou Edge ; quiconque a accès au dossier voit et modifie tous les projets du fichier (pas de droits par personne, chiffrez-le si besoin) ; les modifications arrivent au rythme de la synchronisation du dossier, pas en temps réel. Pour le téléphone et les invités, l'ordinateur doit rester allumé, avec pulpForge ouvert.

Tout le détail : Partager un fichier avec son équipe ou son téléphone et Où sont vos données et comment travailler à plusieurs.

Formats pris en charge

Raccourcis clavier

Sur Mac, Cmd remplace Ctrl.

L'IA dans pulpForge

Tout se calcule sur votre appareil.

• Classement automatique : type et priorité suggérés d'après le titre (règles de mots, aucun téléchargement).
• Doublons probables : sans module, comparaison par mots communs ; avec la recherche intelligente (Réglages › Données, un petit module téléchargé une fois avec votre accord), comparaison du sens des textes. Vider la mémoire de la recherche intelligente efface ce qu'elle a retenu sur cet appareil.
• Estimation suggérée : médiane des points des cinq éléments terminés les plus semblables, jamais imposée.
• Correspondances d'import : types, états, priorités et personnes sont proposés automatiquement.
• Résumé de sprint : texte composé à partir des chiffres, sans rédaction automatique.
• pulpAssist : recherche d'éléments, création, changement d'état, statut du sprint et notes de version ; chaque modification passe par une carte de confirmation.

FAQ et dépannage

Mes données sont-elles envoyées quelque part ?

Pas sans que vous le décidiez. Par défaut, elles restent dans votre navigateur, sur cet appareil : pensez à la sauvegarde automatique ou à exporter une sauvegarde .pforge de temps en temps. Si vous partagez un fichier, il va dans le dossier que vous avez choisi ; rien n'est envoyé à pulpSuite.

Puis-je travailler à plusieurs ?

Oui, en partageant un fichier : dans un dossier synchronisé, en échange direct entre ordinateurs, sur votre téléphone ou en invitant quelqu'un sur un ticket (voir Partager avec une équipe ou un téléphone). Le serveur pulpSuite (temps réel, droits par personne, accès depuis tous les navigateurs et les téléphones) n'est pas encore disponible ; le branchement sur une base de données d'entreprise existante est prévu, sans date annoncée. Sur un même appareil, deux onglets ouverts se synchronisent, et deux modifications du même champ en même temps ouvrent une boîte pour choisir la valeur à garder.

Pourquoi mon état n'est-il pas dans la liste de déplacement ?

Le flux d'états du type peut limiter les passages permis (Réglages › Flux d'états). Les états refusés sont grisés.

pulpForge est-il connecté à GitHub ou GitLab ?

Non : il lit les fichiers que vous lui donnez (exports de tickets, journal Git, rapports de tests) et ne contacte jamais vos dépôts.