feat(adminui): ConvertRelayVirtualTagsToAliasesAsync (relay VTag -> alias Tag)

2026-06-11 21:32:43 -04:00
parent fe068652b3
commit 943bc5f709
4 changed files with 712 additions and 0 deletions
@@ -554,4 +554,15 @@ public interface IUnsTreeService
    /// <param name="ct">A token to cancel the operation.</param>
    /// <returns>Success, a concurrency failure, or a delete-failed failure.</returns>
    Task<UnsMutationResult> DeleteScriptedAlarmAsync(string scriptedAlarmId, byte[] rowVersion, CancellationToken ct = default);
+
+    /// <summary>Convert pure-relay VirtualTags (body == return ctx.GetTag("X").Value;) to Galaxy alias
+    /// Tags. <paramref name="equipmentId"/> null = fleet-wide; otherwise scoped to that equipment.
+    /// <paramref name="dryRun"/> = true previews without mutating. FleetAdmin-gated at the call site.
+    /// Operates on the editable config (does not publish).</summary>
+    /// <param name="equipmentId">The equipment to scope to; <c>null</c> sweeps every equipment.</param>
+    /// <param name="dryRun"><c>true</c> previews the conversion without mutating the config.</param>
+    /// <param name="ct">A token to cancel the operation.</param>
+    /// <returns>The per-relay converted and skipped lists, plus whether the pass was applied.</returns>
+    Task<RelayConversionResult> ConvertRelayVirtualTagsToAliasesAsync(
+        string? equipmentId, bool dryRun, CancellationToken ct = default);
 }