feat(uns): equipment CRUD with #122 driver-cluster guard

2026-06-08 12:47:19 -04:00
parent 8b1d3de806
commit 2836a0704b
4 changed files with 523 additions and 0 deletions
@@ -0,0 +1,43 @@
+namespace ZB.MOM.WW.OtOpcUa.AdminUI.Uns;
+
+/// <summary>
+/// Parameter object carrying the operator-editable fields for an equipment create or update,
+/// so <see cref="IUnsTreeService.CreateEquipmentAsync"/> and
+/// <see cref="IUnsTreeService.UpdateEquipmentAsync"/> avoid an unwieldy positional signature.
+/// The <c>EquipmentId</c> and <c>EquipmentUuid</c> are system-generated (decision #125) and are
+/// therefore not part of this input. Optional string fields that arrive whitespace-only are
+/// collapsed to <c>null</c> by the service.
+/// </summary>
+/// <param name="Name">UNS level-5 segment; matches <c>^[a-z0-9-]{1,32}$</c>.</param>
+/// <param name="MachineCode">Operator colloquial id; unique fleet-wide.</param>
+/// <param name="UnsLineId">Logical FK to the owning <see cref="Configuration.Entities.UnsLine"/>.</param>
+/// <param name="DriverInstanceId">Optional driver binding; whitespace/empty means driver-less.</param>
+/// <param name="ZTag">Optional ERP equipment id.</param>
+/// <param name="SAPID">Optional SAP PM equipment id.</param>
+/// <param name="Manufacturer">Optional OPC 40010 manufacturer name.</param>
+/// <param name="Model">Optional OPC 40010 model designation.</param>
+/// <param name="SerialNumber">Optional OPC 40010 serial number.</param>
+/// <param name="HardwareRevision">Optional OPC 40010 hardware revision.</param>
+/// <param name="SoftwareRevision">Optional OPC 40010 software revision.</param>
+/// <param name="YearOfConstruction">Optional OPC 40010 year of construction.</param>
+/// <param name="AssetLocation">Optional OPC 40010 asset location.</param>
+/// <param name="ManufacturerUri">Optional OPC 40010 manufacturer URI.</param>
+/// <param name="DeviceManualUri">Optional OPC 40010 device-manual URI.</param>
+/// <param name="Enabled">Whether the equipment is surfaced in deployments.</param>
+public sealed record EquipmentInput(
+    string Name,
+    string MachineCode,
+    string UnsLineId,
+    string? DriverInstanceId,
+    string? ZTag,
+    string? SAPID,
+    string? Manufacturer,
+    string? Model,
+    string? SerialNumber,
+    string? HardwareRevision,
+    string? SoftwareRevision,
+    short? YearOfConstruction,
+    string? AssetLocation,
+    string? ManufacturerUri,
+    string? DeviceManualUri,
+    bool Enabled);