feat(uns): UnsNode VM + pure tree-assembly helper
This commit is contained in:
Joseph Doherty
@@ -0,0 +1,242 @@
|
||||
namespace ZB.MOM.WW.OtOpcUa.AdminUI.Uns;
|
||||
|
||||
/// <summary>
|
||||
/// The kind of node within the unified-namespace (UNS) browse tree. Determines
|
||||
/// how the renderer styles the row and which entity (if any) it links to.
|
||||
/// </summary>
|
||||
public enum UnsNodeKind
|
||||
{
|
||||
Enterprise,
|
||||
Cluster,
|
||||
Area,
|
||||
Line,
|
||||
Equipment,
|
||||
Tag,
|
||||
VirtualTag,
|
||||
}
|
||||
|
||||
/// <summary>
|
||||
/// View-model for a single node in the UNS browse tree. Carries the stable
|
||||
/// identity, display text and lazy-load metadata the renderer needs, plus
|
||||
/// transient UI state (expansion/loading) that is never persisted.
|
||||
/// </summary>
|
||||
public sealed class UnsNode
|
||||
{
|
||||
/// <summary>The kind of node — drives styling and entity linking.</summary>
|
||||
public required UnsNodeKind Kind { get; init; }
|
||||
|
||||
/// <summary>Stable per-node identifier, unique within the tree (e.g. <c>eq:{equipmentId}</c>).</summary>
|
||||
public required string Key { get; init; }
|
||||
|
||||
/// <summary>Human-readable label shown in the tree.</summary>
|
||||
public required string DisplayName { get; init; }
|
||||
|
||||
/// <summary>Owning cluster id for Area/Line/Equipment (and the cluster itself); null for Enterprise.</summary>
|
||||
public string? ClusterId { get; init; }
|
||||
|
||||
/// <summary>This node's own logical entity id (UnsAreaId/UnsLineId/EquipmentId/TagId/VirtualTagId); null for Enterprise.</summary>
|
||||
public string? EntityId { get; init; }
|
||||
|
||||
/// <summary>Badge count. For equipment this is tag + virtual-tag count; for container nodes it is the direct child count.</summary>
|
||||
public int ChildCount { get; set; }
|
||||
|
||||
/// <summary>True when this node has children that are loaded lazily (equipment with <see cref="ChildCount"/> > 0).</summary>
|
||||
public bool HasLazyChildren { get; init; }
|
||||
|
||||
/// <summary>Eagerly-materialised children. Empty for lazy-loaded equipment until expanded.</summary>
|
||||
public List<UnsNode> Children { get; } = new();
|
||||
|
||||
// --- Runtime UI state (not persisted) ---
|
||||
|
||||
/// <summary>Whether the node is currently expanded in the UI.</summary>
|
||||
public bool Expanded { get; set; }
|
||||
|
||||
/// <summary>Whether the node's lazy children have been loaded.</summary>
|
||||
public bool Loaded { get; set; }
|
||||
|
||||
/// <summary>Whether a lazy-load is currently in flight for this node.</summary>
|
||||
public bool Loading { get; set; }
|
||||
|
||||
/// <summary>Last load error message, if any.</summary>
|
||||
public string? Error { get; set; }
|
||||
}
|
||||
|
||||
/// <summary>Flat structural row describing a cluster and its enterprise/site placement.</summary>
|
||||
public readonly record struct ClusterRow(string ClusterId, string Enterprise, string Site, string Name);
|
||||
|
||||
/// <summary>Flat structural row describing a UNS area and its owning cluster.</summary>
|
||||
public readonly record struct AreaRow(string UnsAreaId, string ClusterId, string Name);
|
||||
|
||||
/// <summary>Flat structural row describing a UNS line and its owning area.</summary>
|
||||
public readonly record struct LineRow(string UnsLineId, string UnsAreaId, string Name);
|
||||
|
||||
/// <summary>Flat structural row describing an equipment node, its owning line and its tag/virtual-tag counts.</summary>
|
||||
public readonly record struct EquipmentRow(
|
||||
string EquipmentId,
|
||||
string UnsLineId,
|
||||
string MachineCode,
|
||||
string Name,
|
||||
int TagCount,
|
||||
int VirtualTagCount);
|
||||
|
||||
/// <summary>
|
||||
/// Pure, EF-free assembly of the UNS browse tree from flat structural rows.
|
||||
/// Builds Enterprise → Cluster → Area → Line → Equipment with deterministic
|
||||
/// ordinal ordering and equipment lazy-load metadata.
|
||||
/// </summary>
|
||||
public static class UnsTreeAssembly
|
||||
{
|
||||
/// <summary>
|
||||
/// Builds the Enterprise→Cluster→Area→Line→Equipment tree. Empty clusters
|
||||
/// (and enterprises whose clusters have no areas) are retained. Ordering is
|
||||
/// deterministic and ordinal at every level.
|
||||
/// </summary>
|
||||
public static IReadOnlyList<UnsNode> Build(
|
||||
IReadOnlyList<ClusterRow> clusters,
|
||||
IReadOnlyList<AreaRow> areas,
|
||||
IReadOnlyList<LineRow> lines,
|
||||
IReadOnlyList<EquipmentRow> equipment)
|
||||
{
|
||||
// Index children by their parent key for O(1) lookup during nesting.
|
||||
var areasByCluster = areas
|
||||
.GroupBy(a => a.ClusterId, StringComparer.Ordinal)
|
||||
.ToDictionary(g => g.Key, g => g.ToList(), StringComparer.Ordinal);
|
||||
|
||||
var linesByArea = lines
|
||||
.GroupBy(l => l.UnsAreaId, StringComparer.Ordinal)
|
||||
.ToDictionary(g => g.Key, g => g.ToList(), StringComparer.Ordinal);
|
||||
|
||||
var equipmentByLine = equipment
|
||||
.GroupBy(e => e.UnsLineId, StringComparer.Ordinal)
|
||||
.ToDictionary(g => g.Key, g => g.ToList(), StringComparer.Ordinal);
|
||||
|
||||
// Top level: distinct enterprises, ordered ordinally.
|
||||
var enterprises = clusters
|
||||
.GroupBy(c => c.Enterprise, StringComparer.Ordinal)
|
||||
.OrderBy(g => g.Key, StringComparer.Ordinal)
|
||||
.Select(entGroup =>
|
||||
{
|
||||
var clusterNodes = entGroup
|
||||
.OrderBy(c => c.Name, StringComparer.Ordinal)
|
||||
.ThenBy(c => c.ClusterId, StringComparer.Ordinal)
|
||||
.Select(c => BuildCluster(c, areasByCluster, linesByArea, equipmentByLine))
|
||||
.ToList();
|
||||
|
||||
var ent = new UnsNode
|
||||
{
|
||||
Kind = UnsNodeKind.Enterprise,
|
||||
Key = $"ent:{entGroup.Key}",
|
||||
DisplayName = entGroup.Key,
|
||||
ClusterId = null,
|
||||
EntityId = null,
|
||||
HasLazyChildren = false,
|
||||
};
|
||||
ent.Children.AddRange(clusterNodes);
|
||||
ent.ChildCount = ent.Children.Count;
|
||||
return ent;
|
||||
})
|
||||
.ToList();
|
||||
|
||||
return enterprises;
|
||||
}
|
||||
|
||||
private static UnsNode BuildCluster(
|
||||
ClusterRow cluster,
|
||||
IReadOnlyDictionary<string, List<AreaRow>> areasByCluster,
|
||||
IReadOnlyDictionary<string, List<LineRow>> linesByArea,
|
||||
IReadOnlyDictionary<string, List<EquipmentRow>> equipmentByLine)
|
||||
{
|
||||
var areaNodes = (areasByCluster.TryGetValue(cluster.ClusterId, out var clusterAreas)
|
||||
? clusterAreas
|
||||
: Enumerable.Empty<AreaRow>())
|
||||
.OrderBy(a => a.Name, StringComparer.Ordinal)
|
||||
.ThenBy(a => a.UnsAreaId, StringComparer.Ordinal)
|
||||
.Select(a => BuildArea(a, cluster.ClusterId, linesByArea, equipmentByLine))
|
||||
.ToList();
|
||||
|
||||
var node = new UnsNode
|
||||
{
|
||||
Kind = UnsNodeKind.Cluster,
|
||||
Key = $"clu:{cluster.ClusterId}",
|
||||
DisplayName = string.IsNullOrEmpty(cluster.Site)
|
||||
? cluster.Name
|
||||
: $"{cluster.Site} ({cluster.Name})",
|
||||
ClusterId = cluster.ClusterId,
|
||||
EntityId = cluster.ClusterId,
|
||||
HasLazyChildren = false,
|
||||
};
|
||||
node.Children.AddRange(areaNodes);
|
||||
node.ChildCount = node.Children.Count;
|
||||
return node;
|
||||
}
|
||||
|
||||
private static UnsNode BuildArea(
|
||||
AreaRow area,
|
||||
string clusterId,
|
||||
IReadOnlyDictionary<string, List<LineRow>> linesByArea,
|
||||
IReadOnlyDictionary<string, List<EquipmentRow>> equipmentByLine)
|
||||
{
|
||||
var lineNodes = (linesByArea.TryGetValue(area.UnsAreaId, out var areaLines)
|
||||
? areaLines
|
||||
: Enumerable.Empty<LineRow>())
|
||||
.OrderBy(l => l.Name, StringComparer.Ordinal)
|
||||
.ThenBy(l => l.UnsLineId, StringComparer.Ordinal)
|
||||
.Select(l => BuildLine(l, clusterId, equipmentByLine))
|
||||
.ToList();
|
||||
|
||||
var node = new UnsNode
|
||||
{
|
||||
Kind = UnsNodeKind.Area,
|
||||
Key = $"area:{area.UnsAreaId}",
|
||||
DisplayName = area.Name,
|
||||
ClusterId = clusterId,
|
||||
EntityId = area.UnsAreaId,
|
||||
HasLazyChildren = false,
|
||||
};
|
||||
node.Children.AddRange(lineNodes);
|
||||
node.ChildCount = node.Children.Count;
|
||||
return node;
|
||||
}
|
||||
|
||||
private static UnsNode BuildLine(
|
||||
LineRow line,
|
||||
string clusterId,
|
||||
IReadOnlyDictionary<string, List<EquipmentRow>> equipmentByLine)
|
||||
{
|
||||
var equipmentNodes = (equipmentByLine.TryGetValue(line.UnsLineId, out var lineEquipment)
|
||||
? lineEquipment
|
||||
: Enumerable.Empty<EquipmentRow>())
|
||||
.OrderBy(e => e.Name, StringComparer.Ordinal)
|
||||
.ThenBy(e => e.EquipmentId, StringComparer.Ordinal)
|
||||
.Select(e => BuildEquipment(e, clusterId))
|
||||
.ToList();
|
||||
|
||||
var node = new UnsNode
|
||||
{
|
||||
Kind = UnsNodeKind.Line,
|
||||
Key = $"line:{line.UnsLineId}",
|
||||
DisplayName = line.Name,
|
||||
ClusterId = clusterId,
|
||||
EntityId = line.UnsLineId,
|
||||
HasLazyChildren = false,
|
||||
};
|
||||
node.Children.AddRange(equipmentNodes);
|
||||
node.ChildCount = node.Children.Count;
|
||||
return node;
|
||||
}
|
||||
|
||||
private static UnsNode BuildEquipment(EquipmentRow equipment, string clusterId)
|
||||
{
|
||||
var childCount = equipment.TagCount + equipment.VirtualTagCount;
|
||||
return new UnsNode
|
||||
{
|
||||
Kind = UnsNodeKind.Equipment,
|
||||
Key = $"eq:{equipment.EquipmentId}",
|
||||
DisplayName = equipment.Name,
|
||||
ClusterId = clusterId,
|
||||
EntityId = equipment.EquipmentId,
|
||||
ChildCount = childCount,
|
||||
HasLazyChildren = childCount > 0,
|
||||
};
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user