Référentiel emplois et compétences — guide de configuration

Ce guide s'adresse aux administrateurs préparant le catalogue. Distinguez le responsable du paramétrage de la génération d'implémentation : une navigation moderne peut ouvrir un formulaire legacy. Consultez le guide fonctionnel pour les usages quotidiens et le guide technique pour les contrats et sources.

Responsabilités et générations

Responsable / périmètre	Legacy	Nextgen
Équipe projet / cœur plateforme	Profils de droits, activation par entreprise, définition des champs, traductions et préparation contrôlée des imports.	Authentification API, permissions par action, contexte entreprise, validation, persistance et consommateurs asynchrones.
Administrateur client	Écrans autorisés Emplois et compétences : référentiels, groupes, compétences, fiches métiers et statuts. Disponibilité selon l'entreprise et les droits réels.	API CRUD vérifiées. Aucun éditeur client nextgen dédié identifié dans les routes front inspectées ; ne pas inventer un écran équivalent ni utiliser un paramètre nextgen sans rapport.

Les administrateurs client peuvent gérer le catalogue dans l’espace Emplois et compétences lorsque leur rôle y est autorisé. Les API nextgen constituent des contrats d’intégration distincts ; utilisez les parcours activés pour votre déploiement.

Administrateur client — legacy

Préparer le catalogue dans l'ordre des dépendances

1. Convenez de la responsabilité des référentiels, des règles de publication, des langues et des codes stables.
2. Préparez les Référentiels avant les enregistrements qui en dépendent.
3. Préparez les Groupes de compétences, puis compétences et fiches métiers, puis les rattachements avec maîtrise attendue et importance lorsqu'elles sont prises en charge.
4. Vérifiez statut de publication, traductions et visibilité de cas représentatifs côté collaborateur avant généralisation.

Cet ordre est Documenté dans Confluence dans le playbook Jobs & Skills Framework, v8, 8 août 2023. Le code confirme les relations aux référentiels ; aucun import ni publication n'a été exécuté pendant ce travail.

Référentiels : distinguer visibilité et caractère principal

Ouvrez Emplois et compétences → Référentiels avec les droits nécessaires. Examinez le nom traduit, l'option public / visible par les collaborateurs et l'option principal avant toute sauvegarde selon votre processus habituel.

Champ	Valeurs / valeurs initiales établies	Périmètre, dépendance et effet
Nom	Texte traduit ; vérifier la validation réelle avant soumission.	Identifie le conteneur des métiers, compétences et groupes. Un libellé ne remplace pas un identifiant stable d'import.
Public / visibilité collaborateur	Booléen facultatif dans le formulaire legacy. Valeur des fiches existantes propre à chaque enregistrement ; défaut universel non établi.	Affecte la disponibilité dans les écrans concernés. Tous les parcours métiers collaborateur n'appliquent pas nécessairement le même prédicat de référentiel.
Principal	Booléen facultatif dans le formulaire legacy.	Le contrôleur actuel retire le caractère principal aux autres référentiels lorsqu'il est sélectionné. Fonction différente de la visibilité publique.
Type système	Le code distingue Neobrain et External.	Certains enregistrements système peuvent restreindre le renommage ; ne pas les modifier ou supprimer pour appliquer littéralement un ancien playbook.

Sources : legacy src/Company/ReferentialBundle/Controller/DefaultController.php et src/Main/ConfigBundle/Form/Type/ReferentialType.php. How to manage your repositories?, v10, 27 mars 2023, décrit visibilité et ancien comportement principal. Son affirmation d'absence d'impact client du caractère principal n'annule pas la règle actuelle d'unicité. Les différents parcours collaborateur exigent une vérification propre à la route.

Groupes de compétences

Ouvrez Groupes de compétences et examinez le groupe avant d'affecter des compétences. Vérifié dans le code, SkillGroupType expose intitulé traduit, référentiel, case mesurable, poids, type et position.

Paramètre	Valeurs et validation	Effet / préparation
Intitulé / référentiel	Intitulé traduit et référentiel obligatoires.	Préparer le conteneur avant les imports de compétences dépendants.
Type	Choix multiples parmi hard, soft et other.	Classifie le groupe. Le guide historique recommande un groupe par type ; il ne démontre pas une contrainte d'unicité actuelle.
Poids	Chaîne obligatoire non vide dans le formulaire inspecté.	Pondération configurée ; ne pas imposer une plage numérique ou une répartition 50/50 non vérifiées.
Mesurable	Booléen facultatif.	Confirmer les attentes d'évaluation avec l'équipe plateforme ; valeur initiale universelle non vérifiée.
Position	Entier ; repli à 1 si vide dans le formulaire.	Champ de classement présent dans le code actuel. L'affirmation du guide 2023 selon laquelle il n'était pas pris en charge n'a pas été revalidée en exécution.

How to manage your skills groups?, v4, 20 février 2023, décrit l'affectation des compétences sans groupe. Il s'agit d'un scénario de correction ; ne pas supposer qu'il réaffecte tous les groupes existants.

Contenu, traductions et identifiants des compétences

Ouvrez Compétences, sélectionnez le crayon et examinez chaque langue. Conservez une signification cohérente pour l'intitulé, la description et les niveaux de maîtrise. Une traduction peut être vide alors qu'une autre langue contient des données.

L’éditeur distingue intitulé, description et libellés de maîtrise par langue. Sélectionnez chaque langue à maintenir et relisez son contenu avant de l’enregistrer.

Afficher en taille réelle

Vérifié dans le code : SkillType expose contenu traduit, code/groupe facultatifs, référentiel obligatoire et tags. Le contrôleur peut générer un code NB_… lorsque la capacité d'auto-génération est active et que le code manque. Activation et défaut effectifs non établis. Ne remplacez pas les codes externes stables simplement parce que les intitulés changent. Le contrôle Traduction automatique était présent ; fournisseur, écrasement des valeurs et quotas non validés.

Définition des métiers, compétences attendues et publication

Préparez intitulé, missions/sections descriptives, référentiel, code stable et statut, puis les compétences rattachées. Le parcours documenté prévoit maîtrise attendue et importance par compétence. Distinguez-les de la maîtrise et de la motivation individuelles. Le DTO nextgen métier–compétence n'établit ni champ d'importance identique ni échelle fixe de maîtrise.

Les statuts sont propres à l'entreprise. Vérifiez la propriété de visibilité collaborateur du statut plutôt que le seul libellé « Publié ». Les champs personnalisés Métier peuvent ajouter des filtres distincts dans les contextes manager et collaborateur. Le champ « famille » observé était distinct du filtre standard Familles métiers.

Documenté dans Confluence : Creating a job description, v3, 10 novembre 2022. Vérifié dans le code : contrôleur legacy Job, actions JobStatus et filtres des champs Métier. Publication, ajout de compétences et modification de statut non exécutés.

Importer ou remplacer un référentiel

Le guide d'import Lexi, v4, 28 mai 2026, décrit la correspondance préalable des identités : un pour un, fusion, scission, ajout et retrait. Préservez délibérément le lien aux évaluations existantes. Un export Lexi n'est pas automatiquement un fichier d'import SmartMobility. Les exemples d'échelles de maîtrise et d'importance ne constituent pas des contraintes universelles des API nextgen.

Avant une migration approuvée, réconciliez codes, traductions, référentiels, groupes, exigences métier–compétence et correspondances d'évaluations dans un processus de test. Aucun import, rétablissement de sauvegarde ni retour arrière automatique testé ici. Revenir sur une case de visibilité ne restaure pas des données supprimées ou fusionnées.

Référence équipe plateforme — legacy

Les éléments suivants sont des dépendances du code, pas des instructions de libre-service client. Valeurs effectives de l'entreprise et défauts globaux non vérifiés.

Capacité / clé	Dépendance vérifiée et effet
referentiel_r, referentiel_c, job_c_d, job_duplicate	Droits selon l'action ; certains contrôles d'écriture métier utilisent OU, d'autres diffèrent. Auditer chaque route avant de modifier un profil.
job_direction_bofo	Active le filtre Direction manager dans le modèle inspecté.
module_metiers_filter_directions_bo	Malgré le nom, le modèle inspecté utilise l'inverse pour afficher le filtre Familles métiers. Vérifier le code avant tout changement.
module_metiers_filter_evolutions_bo	Conditionne le filtre d'évolutions par une visibilité inversée.
qualification_levels_bofo	Affiche les contrôles de qualification lorsque la capacité est active.
check_classification	Intervient dans la condition d'affichage de l'indicateur de classification.
Champs Métier, contextes bo / fo	Contrôlent les champs et filtres manager/collaborateur ; les libellés ne sont pas nécessairement traduits automatiquement.
jobs_matching_profile	Conditionne la zone de recommandations collaborateur. Une pastille visible n'établit ni seuil universel ni délai de rafraîchissement.
skill_autogenerated_code	Permet au contrôleur de générer un code absent ; confirmer la responsabilité des identifiants au préalable.
export_job_descriptions_as_CSV	Modifie le choix du format dans l'export legacy ; aucun export exécuté.

Sources : contrôleurs legacy Job et Skill, modèle de liste métiers, Customer/InternalJobBundle/Controller/DefaultController.php et SearchService.php. Le playbook 2023 recommande des filtres masqués et des pondérations pour son scénario projet ; ce ne sont pas des défauts globaux actuels. Son tableau de droits formulé négativement contredit des descriptions positives : les contrôles de route actuels fondent les affirmations d'implémentation.

Référence équipe plateforme — nextgen

Vérifié dans le code : prévoir authentification, permissions par action et contexte entreprise pour /api/v1/job, /skill, /skill-group, /referential et les compétences imbriquées d'un métier. Respecter la langue et les booléens requis du DTO référentiel ; une ligne d'import legacy n'est pas un corps de requête API.

Le listener rend principal le premier référentiel créé. La création/modification d'un référentiel principal retire ce statut au précédent. La suppression dépend d'un contrôle incluant les métiers, compétences et groupes liés ; ce n'est pas un nettoyage universel. Métiers/groupes sont configurés en suppression logique ; compétences, référentiels et relations métier–compétence ont d'autres politiques. Voir les contrats techniques.

Les événements d'affectation à un métier ou d'ajout de compétence peuvent propager les compétences manquantes aux collaborateurs de façon asynchrone. Prévoir les consommateurs et leur suivi dans le déploiement. Aucun engagement de mise à jour immédiate, de suppression symétrique ou de remplacement des évaluations n'est établi. Les imports AIhub sont des intégrations distinctes ; sauvegarder le catalogue ne prouve pas un rafraîchissement AIhub immédiat.

Administrateur client — nextgen

Aucun écran dédié identifié dans nextgen-front/src/router/private-routes.ts et la recherche ciblée dans les modules associés. Les API CRUD backend sont vérifiées ; parité des écrans, exposition du déploiement, attribution des rôles client et stockage commun avec le legacy restent non vérifiés. Utiliser l'interface autorisée disponible et le processus d'intégration convenu ; ne pas annoncer une page nextgen équivalente.

Validation, activation et dépannage

Validez dans un périmètre de test approuvé : intitulés EN/FR représentatifs, relations référentiel/groupe, stabilité des codes, maîtrise attendue distincte des évaluations, publication vue par un collaborateur, filtres des deux espaces et droits de chaque action. Recontrôlez traductions manquantes et règles propres aux routes lorsqu'un manager voit davantage qu'un collaborateur.

En cas de refus API, vérifiez l'action et le contexte entreprise. Pour un référentiel invalide ou un rattachement déjà présent, utilisez les contrats de validation du guide technique. Si les compétences individuelles tardent, examinez le traitement des événements avant de recréer la relation. La récupération après remplacement destructif exige une procédure de migration et de sauvegarde ; aucune n'a été exercée ici.

Preuves et limites

• Observé dans l'application : 15 octobre 2026, smartmobility.io ; session manager existante ; captures EN/FR séparées des listes et du formulaire de compétence. Aucun paramètre, droit, import ou formulaire enregistré. Captures plateforme et écran nextgen dédié indisponibles ; les tableaux de champs Référentiels/Groupes sont fondés sur le code.
• Vérifié dans le code : sources ci-dessus et nextgen src/Domain/V1/{Job,Skill,SkillGroup,JobSkill,Referential}/DTO, routes YAML, ReferentielListener, dépôts et consommateurs détaillés dans le guide technique. Les sources locales ne prouvent pas l'identité des déploiements ni un stockage partagé.
• Documenté dans Confluence : playbook et guides Référentiels/Groupes/Métiers/Lexi cités avec versions/dates vérifiées. Les entrées fournies Delivery Philosophy & Project Methodology, v7, 30 décembre 2025, et Onboarding/learning and partner certification, v9, 18 février 2026, concernent la méthode plutôt que les paramètres de cette fonctionnalité. L'entrée KBCT 2136702980 était inaccessible.
• Non vérifié : défauts effectifs, contraintes numériques de poids au-delà du formulaire, sauvegardes et erreurs complètes, écrasement des traductions, parité de l'éditeur nextgen, retour arrière de migration et livraison réelle des événements. Les divergences des guides Référentiels/Groupes de 2023 sont signalées ci-dessus.