GitScrum / Docs

Comment GitScrum Fonctionne

GitScrum organise le travail dans une hiérarchie à trois niveaux: les Workspaces contiennent des Projets, les Projets contiennent des Tâches. Cette structure correspond directement à la façon dont les agences opèrent — le workspace est votre agence, les projets sont les engagements clients, et les tâches sont le travail réel.

Comprendre cette hiérarchie est clé pour utiliser GitScrum efficacement. Tout part des paramètres du workspace vers les tâches individuelles. Les membres de l'équipe peuvent appartenir à un workspace et être assignés à des projets spécifiques avec différents niveaux de permissions.

La Hiérarchie du Workspace

Workspace

Le workspace est le conteneur de niveau supérieur. Pensez-y comme votre agence ou entreprise dans GitScrum. Il contient tous vos projets, membres d'équipe, informations de facturation et paramètres globaux.

Lorsque vous créez un compte, GitScrum crée automatiquement votre premier workspace. La plupart des agences n'en ont besoin que d'un seul. Créez des workspaces supplémentaires uniquement si vous avez besoin d'isolation complète des données entre unités commerciales ou si vous gérez plusieurs agences séparées.

Les paramètres du workspace affectent tous les projets à l'intérieur: planning de travail, fuseau horaire, plan de facturation, intégrations avec GitHub ou GitLab. Les changements ici se propagent vers le bas.

Projet

Un projet est là où le travail réel se passe. Chaque projet a son propre tableau Kanban, sprints, user stories, wiki, discussions, stockage de fichiers et suivi du temps. Les membres de l'équipe sont assignés aux projets avec des rôles spécifiques.

Pour les agences, un projet par engagement client a du sens. Un client peut avoir plusieurs projets au fil du temps — un lancement de site web, puis une app mobile, puis maintenance continue. Chacun est un projet séparé avec son propre tableau et calendrier.

Les projets peuvent être publics (visibles par quiconque avec le lien) ou privés (membres de l'équipe uniquement). Les projets publics sont utiles pour le travail open-source ou les tableaux de bord clients où les parties prenantes ont juste besoin de voir la progression.

Tâche

Les tâches sont les unités atomiques de travail. Elles vivent sur le tableau Kanban et se déplacent entre les colonnes au fur et à mesure que le travail progresse. Chaque tâche a un code unique (comme PRJ-123), titre, description, assigné, date limite, labels, estimations de temps et temps enregistré.

Les tâches peuvent avoir des checklists, pièces jointes, commentaires et historique d'activité. Elles peuvent être liées aux user stories pour les workflows Scrum ou exister indépendamment pour des configurations Kanban-uniquement plus simples. Le suivi du temps s'intègre directement — démarrez un timer, travaillez, arrêtez quand c'est terminé.

Le Tableau Kanban

Chaque projet a un tableau Kanban comme vue centrale. Les tâches sont affichées comme des cartes dans des colonnes. Glissez les cartes entre colonnes pour mettre à jour leur statut. C'est là que les développeurs passent la plupart de leur temps.

Les colonnes par défaut sont Backlog, À Faire, En Cours et Terminé. Vous pouvez les personnaliser — ajoutez Review, QA, Bloqué, ce qui correspond à votre workflow. Chaque colonne peut avoir des limites de travail en cours pour prévenir la surcharge.

Le tableau supporte le filtrage par assigné, label, sprint et date limite. La recherche avancée trouve les tâches par numéro ou contenu. Les raccourcis clavier rendent la navigation rapide. La synchronisation en temps réel signifie que tout le monde voit les changements instantanément.

Sprints et User Stories

Pour les équipes suivant Scrum, GitScrum supporte les sprints et user stories. Les user stories décrivent des fonctionnalités du point de vue utilisateur — "En tant qu'utilisateur, je veux..." — et regroupent les tâches liées.

Les sprints sont des itérations limitées dans le temps, généralement deux semaines. Vous planifiez ce qu'il faut accomplir, travaillez pendant le sprint, puis examinez les résultats. GitScrum suit la vélocité (combien de story points vous complétez par sprint) et génère des graphiques burndown montrant la progression.

Les story points sont estimés pendant le raffinement du backlog. GitScrum inclut le planning poker pour l'estimation collaborative. Glissez les user stories pour les prioriser. Quand un sprint commence, les stories engagées sont verrouillées — vous pouvez voir ce qui était planifié versus ce qui a été réellement livré.

Vous ne faites pas Scrum? Pas de problème. Les sprints et user stories sont optionnels. Beaucoup d'équipes utilisent GitScrum comme outil Kanban pur avec juste des tâches et des colonnes.

Suivi du Temps

Le suivi du temps est intégré dans chaque tâche. Cliquez sur le bouton play pour démarrer un timer. Travaillez. Cliquez sur stop quand c'est terminé. Le temps est enregistré automatiquement avec la date actuelle et des notes optionnelles.

Vous pouvez aussi ajouter des entrées de temps manuellement — utile pour enregistrer le travail fait hors ligne ou ajuster les entrées. Le temps enregistré alimente les rapports de projet, montrant les heures passées par tâche, par membre d'équipe, par période.

Les plannings de travail définis au niveau workspace (jours ouvrés et heures par jour) affectent les calculs de capacité. Si quelqu'un a 40 heures de travail assignées dans une semaine et travaille des journées de 8 heures, GitScrum les montre à pleine capacité. La sur-allocation déclenche des avertissements.

Les données de temps s'exportent vers les rapports. Les agences utilisent cela pour la facturation client, la planification de capacité et comprendre où le temps va réellement.

Rôles et Permissions

GitScrum a quatre rôles avec différents niveaux de permissions:

  • Agency Owner — Accès complet à tout. Gère la facturation, les paramètres du workspace, tous les membres de l'équipe, tous les projets. Peut supprimer le workspace. Généralement le fondateur ou titulaire du compte.
  • Manager — Peut gérer les projets, créer et assigner des tâches, voir tous les rapports. Ne peut pas accéder à la facturation ni retirer les Agency Owners. Typiquement les gestionnaires de projet ou chefs d'équipe.
  • Developer — Peut travailler sur les projets assignés, compléter des tâches, suivre le temps, commenter sur les éléments de travail. Ne peut pas changer les paramètres du projet ni accéder aux autres projets. Le rôle standard pour les développeurs et contractuels.
  • Client — Accès limité en lecture seule. Voit la progression du projet et peut commenter sur les tâches auxquelles il est invité. Ne peut pas voir les discussions internes, les détails de suivi du temps ou les autres projets. Parfait pour les parties prenantes qui ont besoin de visibilité sans accès complet.

Les permissions sont appliquées aux niveaux workspace et projet. Un Developer dans le workspace peut être assigné à des projets spécifiques — ils voient et interagissent uniquement avec ces projets.

Les rôles peuvent être surchargés par projet. Un membre de l'équipe peut être Developer dans un projet mais Manager dans un autre, selon ses responsabilités.

Intégrations

GitHub et GitLab

Connectez vos dépôts pour lier automatiquement commits, branches et pull requests aux tâches. Référencez un code de tâche dans votre message de commit (comme "Fix login issue #PRJ-123") et GitScrum montre ce commit sur la tâche.

Quand une pull request est fusionnée, GitScrum peut automatiquement déplacer la tâche vers Terminé. Les informations de branche apparaissent sur les cartes de tâche pour que l'équipe sache qui travaille sur quoi.

Extension VS Code

L'extension VS Code amène GitScrum dans votre éditeur. Voyez vos tâches assignées, démarrez et arrêtez le suivi du temps, mettez à jour le statut des tâches, ajoutez des commentaires — tout sans passer au navigateur.

Créez des tâches à partir de commentaires TODO dans votre code. L'extension lit vos fichiers et vous permet de convertir des notes inline en tâches suivies en un clic.

Extension Chrome

Capturez des écrans et créez des tâches depuis n'importe quelle page web. Trouvé un bug sur staging? Capturez l'écran, ajoutez une description, assignez-le à vous-même — terminé. La capture s'attache automatiquement à la tâche.

Création rapide de tâches sans quitter votre contexte actuel. Utile pour les équipes support, QA, ou quiconque trouve des problèmes en naviguant.

Serveur MCP pour Assistants IA

GitScrum fournit un serveur MCP (Model Context Protocol) qui se connecte aux assistants IA comme Claude, GitHub Copilot et autres. L'IA peut lire vos tâches, mettre à jour le statut, enregistrer du temps et gérer des projets en langage naturel.

Demandez "Quelles sont mes tâches ouvertes?" ou "Enregistre 2 heures sur PRJ-123" et l'assistant l'exécute directement. Fonctionne depuis VS Code, terminal, ou tout client compatible MCP.

Un Workflow Typique

Voici à quoi ressemble une semaine typique pour une agence de développement utilisant GitScrum:

  1. Lundi matin — L'équipe ouvre le tableau Kanban. Chaque développeur prend des tâches de À Faire et les déplace vers En Cours. Le suivi du temps commence.
  2. Pendant la journée — Les développeurs travaillent sur les tâches, enregistrant le temps au fur et à mesure. Les commentaires sur les tâches capturent les décisions et blocages. Les PRs référencent les codes de tâches.
  3. Standup quotidien — Le tableau sert d'agenda pour le standup. Qu'est-ce qui est en cours? Qu'est-ce qui est bloqué? Qu'est-ce qui est passé à Terminé hier?
  4. Pull request fusionnée — L'intégration GitHub déplace la tâche vers Terminé automatiquement. Le temps passé est enregistré.
  5. Fin du sprint — Les rapports de vélocité montrent combien de story points ont été complétés. Le graphique burndown montre si l'équipe a atteint l'objectif. La rétrospective utilise les données pour s'améliorer.
  6. Check-in client — Partagez un lien en lecture seule vers le projet. Le client voit la progression sans avoir besoin de se connecter. Ou ajoutez-les comme rôle Client pour les commentaires.

Ce workflow évolue des développeurs solo aux équipes de 50 personnes. La hiérarchie et les permissions gardent tout organisé au fur et à mesure que vous grandissez.

Prochaines Étapes

Maintenant que vous comprenez l'architecture: