Organisation¶

À quoi ça sert¶

Ce module modélise la structure juridique et organisationnelle d'une société : entités juridiques (holding, filiales, succursales) et départements (avec responsable, centre de coût et localisation), ainsi que la visualisation de l'organigramme.

Prérequis¶

Prérequis

Modules sous licence : HR
Permissions : org.manage, recruitment.requisition.create
Rôles : ORG_ADMIN, RECRUITER

Comment ça marche¶

1. Structurer les entités juridiques¶

Ouvrez Administration → Organisation (/dashboard/admin/org).
Dans l'onglet entités, cliquez sur Ajouter une entité.
Renseignez le nom, le type (Holding, Filiale, Succursale) et, le cas échéant, l'entité parente — ce qui permet de représenter un groupe avec une holding en tête et des filiales/succursales rattachées.
Les entités peuvent être modifiées ou supprimées tant qu'elles ne sont pas référencées ailleurs (départements, employés).

2. Créer les départements¶

Dans l'onglet départements, cliquez sur Ajouter un département.
Renseignez le nom, un code court, l'entité juridique de rattachement, un département parent (pour des sous-départements), un responsable (headUserId), un centre de coût et une localisation.
Les départements alimentent directement les filtres utilisés ailleurs dans Jigi : liste des employés, demandes de personnel, projections de coût de contrat, etc.

Accès en lecture élargi

La liste des départements est aussi accessible aux titulaires de la permission recruitment.requisition.create (pas seulement org.manage), pour permettre à un recruteur de choisir le bon département lors de la création d'une demande de personnel sans lui donner les droits d'administration de l'organisation.

3. Visualiser l'organigramme¶

Ouvrez Administration → Organisation → Organigramme (/dashboard/admin/org/chart) pour obtenir une représentation arborescente (visualisation D3) des entités et départements, utile pour repérer rapidement les rattachements manquants ou incohérents avant une réorganisation.

Qui peut faire quoi¶

Permission requise	Rôles concernés
`org.manage`	`ORG_ADMIN`, `RECRUITER`
`recruitment.requisition.create`	`ORG_ADMIN`, `RECRUITER`

Permission	Donne accès à
`org.manage`	Créer, modifier, supprimer les entités et départements ; consulter l'organigramme
`recruitment.requisition.create`	Lecture seule de la liste des départements (pour le formulaire de demande de personnel)

Rôle système	Accès
`ORG_ADMIN`	Toutes les actions (permission globale)
`HR_MANAGER`, `MANAGER`, `RECRUITER`	Aucun accès à la gestion de l'organisation par défaut — seul `RECRUITER` bénéficie indirectement de la lecture des départements via `recruitment.requisition.create`

Détails techniques

Entités : OrgEntity (table admin.entities, champ type = HOLDING/SUBSIDIARY/BRANCH), Department (table admin.departments, avec entity_id, parent_id, head_user_id, cost_centre, location).

Endpoints (OrgController, base /admin/org) :

GET/POST/PUT/DELETE /admin/org/entities[/{id}]
GET/POST/PUT/DELETE /admin/org/departments[/{id}]
GET /admin/org/tree — structure hiérarchique combinée pour la visualisation D3 (RH-65)

Les entités et départements peuvent aussi être créés en masse via l'import Excel (OrganisationImportExecutor, DepartmentImportExecutor) — voir Import en masse & audit.

Cas d'erreur et FAQ¶

Quelle est la différence entre une entité et un département ? Une entité est une structure juridique (holding, filiale, succursale) ; un département est une unité organisationnelle (ex. "Ventes France") rattachée à une entité juridique.

Peut-on avoir des départements imbriqués ? Oui, un département peut avoir un parent_id pointant vers un autre département, pour représenter des sous-équipes.

Un recruteur peut-il modifier les départements ? Non. La permission recruitment.requisition.create ne donne qu'un accès en lecture à la liste des départements, nécessaire pour renseigner une demande de personnel.

Comment visualiser rapidement toute la structure du groupe ? Utilisez l'écran Organigramme, qui affiche l'arbre complet entités + départements sous forme de graphe.