Organisation et équipes

L'organisation est l'espace de travail principal dans Almirant. Tous les projets, membres, intégrations et configurations appartiennent à une organisation. Au sein de l'organisation, vous pouvez gérer des équipes pour organiser le travail de manière plus précise.

Qu'est-ce qu'une organisation ?

Une organisation dans Almirant représente votre entreprise, votre équipe ou votre groupe de travail. C'est le conteneur de niveau supérieur qui regroupe :

• Projets -- Tous les projets créés appartiennent à une organisation.
• Membres -- Les personnes qui ont accès à l'organisation et à ses projets.
• Intégrations -- Les connexions avec des services externes (GitHub, Vercel, Telegram).
• Fournisseurs IA -- La configuration des fournisseurs et quotas d'intelligence artificielle.
• API Keys -- Les tokens d'accès pour les intégrations externes et MCP.

Configurer l'organisation

Pour accéder à la configuration de votre organisation :

1. Cliquez sur le nom de votre organisation dans le menu latéral.
2. Sélectionnez Configuration ou accédez-y directement depuis Settings.

Données de l'organisation

Champ	Description	Obligatoire
Nom	Nom de l'organisation qui apparaît sur toute la plateforme	Oui
Logo	Image représentative de l'organisation	Non
Slug	Identifiant unique dans l'URL de l'organisation	Oui

Pour mettre à jour les données :

1. Accédez à Configuration > General.
2. Modifiez les champs souhaités.
3. Enregistrez les modifications.

Gestion des membres

Les membres sont les personnes qui ont accès à l'organisation et peuvent travailler sur ses projets.

Inviter des membres

1. Accédez à Configuration > Membres.
2. Cliquez sur Inviter un membre.
3. Saisissez l'email du nouveau membre.
4. Sélectionnez le rôle qu'il aura dans l'organisation.
5. Envoyez l'invitation.

Le membre recevra un email avec un lien pour rejoindre l'organisation. S'il a déjà un compte Almirant, il y sera ajouté directement. Sinon, il devra d'abord créer un compte.

Rôles des membres

Almirant définit des rôles pour contrôler le niveau d'accès de chaque membre :

Rôle	Permissions
Owner	Contrôle total de l'organisation. Peut gérer les membres, la configuration, la facturation et supprimer l'organisation
Admin	Peut gérer les membres, les projets, les intégrations et la configuration. Ne peut pas supprimer l'organisation
Member	Peut travailler sur les projets attribués, créer et modifier des work items, utiliser AI Planning et les agents

Principe du moindre privilège

Attribuez le rôle le plus restrictif qui permet à chaque membre de réaliser son travail. Réservez le rôle Owner à une ou deux personnes et Admin aux team leads.

Voir les membres actifs

La liste des membres affiche :

• Le nom et l'email de chaque membre.
• Le rôle attribué.
• La date d'arrivée.
• L'état de l'invitation (en attente, acceptée).

Modifier le rôle d'un membre

1. Accédez à Configuration > Membres.
2. Recherchez le membre dans la liste.
3. Cliquez sur le sélecteur de rôle.
4. Sélectionnez le nouveau rôle.
5. Confirmez la modification.

Supprimer un membre

1. Accédez à Configuration > Membres.
2. Recherchez le membre dans la liste.
3. Cliquez sur Supprimer ou sur l'icône de suppression.
4. Confirmez la suppression.

attention

Supprimer un membre révoque immédiatement son accès. Les work items attribués au membre conserveront l'attribution historique, mais le membre ne recevra plus de notifications. Réattribuez les work items actifs avant de supprimer le membre.

Équipes

Les équipes permettent de regrouper des membres au sein d'une organisation afin de faciliter l'attribution du travail et la communication.

Créer une équipe

1. Accédez à Configuration > Équipes.
2. Cliquez sur Créer une équipe.
3. Définissez un nom pour l'équipe (par exemple : "Frontend", "Backend", "QA").
4. Ajoutez des membres à l'équipe en les sélectionnant dans la liste des membres de l'organisation.
5. Enregistrez l'équipe.

Utilisation des équipes

Les équipes sont utiles pour :

• Attribution rapide -- Attribuer des work items à une équipe entière plutôt qu'à des membres individuels.
• Filtrage -- Filtrer le board par équipe pour ne voir que les tâches d'un groupe spécifique.
• Visibilité -- Comprendre rapidement qui fait partie de chaque domaine fonctionnel.

Transférer des projets entre organisations

Si vous avez accès à plusieurs organisations, vous pouvez transférer des projets de l'une à l'autre. Consultez la section transfert de projet pour plus de détails.

Pour les développeurs

Outils MCP

Les tools suivants sont disponibles via MCP pour gérer les membres :

Tool	Description	Paramètres principaux
list_members	Liste les membres de l'organisation	organizationId

Exemple : lister les membres

Tool: list_members
Parametros:
  organizationId: "uuid-de-la-organizacion"

Renvoie la liste des membres avec leur nom, email, rôle et état.

Routes de l'application

Route	Description
/settings	Configuration générale de l'organisation
/settings/members	Gestion des membres
/settings/teams	Gestion des équipes