Ajout de références externes sur chaque objet pour faciliter la mise à jour des actifs

[gallak]

Le besoin

Alimenter les objets de mercator depuis une ou plusieur sources ( ex une source pour créer l'objet, une autre peut le mettre à jour) et quelque soitr le type d'objet.

Une fois que tout les actifs sont créés mis a jour, le cartographe prend la suite pour faire les liens

Le problème
Les objets n'ont pas les meme identifiants partout :
Ex pour un serveur

• son nom DNS : srv1-mail-sortant.domain.fr
• son nom technique sur proxmox : vm354453
• son identiant IPAM : obj354234

Cela pose problème pour assurer une mis a jour régulière . cela implique de faire une analyse complète des actif de Mercator.

proposition

Rajouter un attribut par objet : external_cross_ref (suggestion de nom) multivalué avec formalisme suivant {ID_SOURCE}ID_OBJET

En reprenant l'exemple sir dessus

l'objet mercator "srv1-mail-sortant.domain.fr" aurait dans le champs external_cross_ref la valeur suivant : {PROXMOX}vm354453|{IPAM}obj354234

Cela simplifierai grandement les mises a jour des objets.

[dbarzin]

Bonne idée, le problème de réconciliation d'identifiants entre référentiels est réel et souvent sous-estimé.

On propose d'ajouter un champ ext_refs (texte, multivalué) sur les objets de Mercator, avec le formalisme {SOURCE}ID|{SOURCE}ID.

Exemple pour un serveur connu sous trois identités :

{PROXMOX}vm354453|{IPAM}obj354234

Pour les recherches via l'API, pas besoin d'endpoint dédié. Le système de filtres existant couvre le besoin dès que le champ est dans $fillable :

# Retrouver un objet par référence exacte
GET /api/logical-servers?filter[ext_refs]={PROXMOX}vm354453

# Lister tous les objets liés à une source
GET /api/logical-servers?filter[ext_refs]={PROXMOX}

Le second appel déclenche un LIKE '%{PROXMOX}%', ce qui permet de lister tous les objets d'un référentiel donné.

Les accolades {SOURCE} jouent le rôle de namespace et évitent les conflits d'ID entre référentiels — un même identifiant obj123 dans PROXMOX et dans l'IPAM restera distinguable.

Mercator stocke les références croisées. La logique de synchronisation multi-sources (quel script crée, quel script met à jour) reste côté import — ce n'est pas dans le scope de Mercator.

On va créer une migration DB dans les prochains jours pour ajouter ce champ dans toutes les tables de Mercator.

[dbarzin]

🎉 Le champ ext_refs a été ajouté à tous les modèle de Mercator : #2425