Procurations et organisations complexes

Cette page explique comment une organisation agit pour le compte d'une autre grâce à une procuration : quels droits obtient une personne quand elle bascule, ce qu'elle voit dans l'espace personnel et qui reçoit les emails. Tout est illustré sur une organisation fictive, avec deux simulateurs. Elle complète Calcul des droits d'accès, Rôles et autorisations et Notifications et emails.

L'essentiel

1. Chacun agit d'abord pour son organisation. Ses droits sont ceux ouverts par les contrats de son organisation, limités par son profil : Admin, rôles métier ou accès personnalisés.
2. Pour agir pour une autre organisation, on bascule. « Changer d'organisation » propose son organisation, ses organisations descendantes et les organisations qui ont donné une procuration à la sienne. Rien d'autre.
3. Une procuration relie une mandante à un délégataire. Elle porte des droits délégués et un mode de notification.
4. Après bascule, on n'obtient jamais plus que chez soi. Les droits sont l'intersection du profil de la personne, des contrats des deux organisations et des droits délégués.
5. Les rôles délégués choisissent aussi les emails. Ils décident quels emails de la mandante arrivent chez le délégataire. Chaque personne reste ensuite filtrée par ses propres préférences.

L'organisation d'exemple : la Métropole de Valbrune

La Métropole vend ses biens réformés. Deux services possèdent des biens à vendre : le Parc auto et les Espaces verts. Trois services transverses font le travail pour eux : le Pôle Enchères prépare et publie les ventes, la Régie des retraits gère l'après-vente, la Trésorerie suit la facturation. Tous sont des organisations enfants de la Métropole, sur la même boutique, et héritent de son contrat vendeur.

flowchart TD
  mere["Métropole de Valbrune"] --> parc["Parc auto"]
  mere --> verts["Espaces verts"]
  mere --> ench["Pôle Enchères"]
  mere --> regie["Régie des retraits"]
  mere --> treso["Trésorerie"]

Qui peut faire quoi

Les droits d'une personne se calculent en trois couches. Chacune ne peut que retirer des accès, jamais en ajouter.

Les contrats de l'organisation

Ce qu'une organisation peut faire vient de ses contrats actifs, plus ceux de ses organisations parentes lorsqu'ils sont transférés aux organisations filles (voir Héritage entre organisations d'un même groupe). Une organisation sans contrat vendeur ne peut pas publier de lot, quel que soit le profil de ses membres.

Le profil de la personne

La liste exacte des accès de chaque rôle est dans Rôles et autorisations.

Le contexte : pour qui la personne agit

Accès après bascule = accès du profil de la personne
                    ∩ accès des contrats de son organisation (et des parents en transfert)
                    ∩ accès des contrats de l'organisation active (et des parents en transfert)
                    ∩ accès des rôles délégués (sauf délégation Admin et organisation descendante)

Sofia (Pôle Enchères, Fiches produits + Ventes) bascule dans le Parc auto
Procuration du Parc auto : Fiches produits + Ventes
→ 8 accès : fiches produit (créer, modifier, supprimer), séances, événements,
  publication, retrait de la vente, assignation, factures de vente

Nadia (Pôle Enchères, rôle Organisation) bascule dans le Parc auto
Procuration du Parc auto : Fiches produits + Ventes
→ aucun accès : ses accès (adresses, utilisateurs, documents…) ne font pas partie des rôles délégués

Nadia bascule dans les Espaces verts
Procuration des Espaces verts : Admin
→ ses 7 accès Organisation, sans filtre supplémentaire

Claire (Métropole, Admin) bascule dans la Trésorerie
Organisation descendante : pas de procuration, aucun filtre de rôle
→ tous les accès ouverts par les contrats des deux organisations

Simulateur de bascule

Choisissez une personne, puis cliquez sur une organisation dans son sélecteur, comme dans l'espace personnel. Le détail du calcul et les accès obtenus s'affichent à droite.

Configurer une procuration

Les procurations se gèrent depuis la fiche organisation de l'admin, section « Hiérarchie ». Une matrice affiche, pour chaque organisation de la hiérarchie, la relation avec l'organisation courante : aucune, donne à, reçoit de ou réciproque. Ses colonnes « Peut agir pour » et « Agit pour nous » séparent les procurations détenues de celles accordées.

Quand le flag est actif, chaque case ouvre une fenêtre « Nouvelle procuration : délégataire agit pour mandante » :

L'assistant d'onboarding d'organisation de l'espace personnel propose aussi cette matrice, limitée aux relations : il ne règle ni les droits délégués ni le mode, et une procuration ajoutée par ce biais est créée en Admin et Partage.

Ce que voit l'espace personnel

Le sélecteur « Changer d'organisation »

• Il est affiché en haut du menu avec le nom de l'organisation active ; il n'est cliquable que si la personne a au moins deux organisations possibles.
• Il contient son organisation, ses organisations descendantes et ses organisations mandantes, présentées en arbre selon la hiérarchie, triées par nom, avec une recherche.
• N'y figurent pas les organisations bloquées, archivées ou supprimées (seuls les statuts « validée » et « à valider » comptent), ni les organisations internes déclarées sur la boutique.
• Rien ne distingue visuellement une organisation obtenue par procuration d'une organisation descendante.

Après la bascule

• L'espace s'affiche au nom de l'organisation choisie ; les menus et les boutons suivent les accès calculés pour ce contexte.
• Les listes de lots et de brouillons couvrent l'organisation active et ses organisations descendantes ; la liste des factures couvre l'organisation active seule.
• Quand l'organisation active fait partie d'une hiérarchie (parent ou enfants), la liste des brouillons affiche une colonne « Propriétaire ».
• À la création d'un brouillon en libre-service, la personne choisit l'organisation pour laquelle elle dépose ; choisir une organisation mandante bascule la session dessus avant la création (voir Workflow item).

Sans bascule

La lecture ne passe pas par les procurations. Sans bascule, l'espace ne montre que les objets dont l'organisation de la personne, ou une de ses organisations descendantes, est vendeuse, propriétaire, opératrice ou créatrice. Pour travailler sur le catalogue du Parc auto, Sofia bascule. Seule exception : le référentiel de marques et de modèles propre à une organisation mandante reste consultable par le délégataire.

Les notifications

Quand un événement concerne une organisation (une publication soumise, un paiement confirmé…), l'email part en trois étapes.

1. Quelles organisations ? L'organisation concernée, plus chaque délégataire dont les rôles délégués couvrent cet email. Une procuration Post-vente couvre « Paiement de l'acheteur confirmé », pas « Publication soumise ».
2. Partage ou transfert ? Si au moins une procuration concernée est en Transfert, l'organisation concernée ne reçoit plus cet email. Filet de sécurité : si aucun délégataire n'a de destinataire, l'email revient à l'organisation concernée.
3. Quelles personnes ? Dans chaque organisation retenue, chaque personne est filtrée par ses préférences d'emails et par son statut (les comptes bloqués sont exclus). Pour les emails de vérification KYB, seules les personnes qui peuvent gérer les documents de leur organisation sont retenues. Une même adresse ne reçoit l'email qu'une fois.

Seuls les rôles Fiches produits, Ventes, Post-vente et Finance transmettent des emails par procuration. Une délégation Admin les transmet tous. Les rôles Organisation et Achats ne transmettent aucun email.

Les mêmes listes servent à pré-régler les préférences d'une personne : quand on lui attribue des rôles métier ou qu'on les change, les emails désactivables étrangers à ses rôles sont exclus de ses préférences. Ces préférences se modifient ensuite depuis le back-office. Repasser une personne en Admin ne réinitialise pas ses préférences.

Simulateur d'emails

Choisissez l'organisation concernée par l'événement et l'email : le simulateur indique qui le reçoit, et pourquoi. Dans la configuration de la boutique Agorastore en recette, tous les emails proposés sont désactivables.

Trois cas à retenir :

• Le transfert l'emporte. « Paiement de l'acheteur confirmé » pour le Parc auto : la Régie des retraits est en Transfert et la Trésorerie en Partage. Le Parc auto ne reçoit rien ; Malik, Julie et Paul reçoivent.
• Le rôle ne suffit pas. « Vérification KYB : authentification requise » pour le Parc auto : le Pôle Enchères est concerné grâce au rôle Ventes, mais seule Nadia peut gérer les documents. Sofia et Théo ne reçoivent rien.
• Les préférences restent individuelles. « Validation de mise en vente demandée » pour le Parc auto : au Pôle Enchères, Sofia (Ventes) reçoit l'email, Théo (Fiches produits seul) non.

Cas particuliers et limites

Références techniques

Jira : US RA20-6565 (procurations à rôles) et RA20-6566 (emails par rôle), rattachées à RA20-6507.