lmxopcua/tests/Server/ZB.MOM.WW.OtOpcUa.OpcUaServer.Tests/AddressSpaceComposerEquipTokenTests.cs

using Shouldly;
using Xunit;
using ZB.MOM.WW.OtOpcUa.Configuration.Entities;

namespace ZB.MOM.WW.OtOpcUa.OpcUaServer.Tests;

/// <summary>
/// Verifies the live-edit compose seam (<see cref="AddressSpaceComposer.Compose"/>) substitutes the
/// reserved <c>{{equip}}</c> token in a shared VirtualTag script with each owning equipment's
/// derived tag base (from its child-tag <c>FullName</c>s) — so one script reused across N
/// identical machines resolves to N machine-specific dependency graphs.
///
/// <para><b>v3 Batch-1 DARK:</b> the per-equipment tag base is DERIVED from equipment-tag
/// <c>FullName</c>s, and equipment-tag variable plans do not materialize until Batch 4 (the composer
/// no longer takes tags — <c>baseByEquip</c> is empty this batch). With no base to substitute, the
/// <c>{{equip}}</c> token stays literal and these per-machine assertions have nothing to compare, so
/// the test is Skipped-with-reason. The seed + assertions are preserved verbatim (minus the retired
/// entity columns) so re-enabling in Batch 4 is a one-line change once the fan-out feeds the base.</para>
/// </summary>
public sealed class AddressSpaceComposerEquipTokenTests
{
    /// <summary>One shared <see cref="Script"/> using <c>ctx.GetTag("{{equip}}.Source")</c>, bound
    /// to two equipments (TestMachine_001 / _002) each with one equipment Tag whose FullName carries
    /// the per-machine base. Compose must expand the token per equipment in both the Expression and
    /// the parsed DependencyRefs.</summary>
    [Fact(Skip = DarkAddressSpaceReasons.EquipmentTagsDarkBatch4)]
    public void Compose_substitutes_equip_token_per_equipment()
    {
        // v3: no Namespace entity; DriverInstance no longer binds a Namespace; Equipment no longer
        // binds a driver. In Batch 4 the {{equip}} base derives from the equipment's child-tag
        // FullNames — here TestMachine_001.Source / TestMachine_002.Source — which flow through the
        // (dark this batch) equipment-tag plan set. Seeded for intent; not passed to Compose.
        var driver1 = new DriverInstance
        {
            DriverInstanceId = "drv-1",
            ClusterId = "c1",
            Name = "Modbus1",
            DriverType = "Modbus",
            DriverConfig = "{}",
        };
        var driver2 = new DriverInstance
        {
            DriverInstanceId = "drv-2",
            ClusterId = "c1",
            Name = "Modbus2",
            DriverType = "Modbus",
            DriverConfig = "{}",
        };
        var area = new UnsArea { UnsAreaId = "area-1", ClusterId = "c1", Name = "filling" };
        var line = new UnsLine { UnsLineId = "line-1", UnsAreaId = "area-1", Name = "line-1" };
        var equip1 = new Equipment { EquipmentId = "eq-1", UnsLineId = "line-1", Name = "TestMachine_001", MachineCode = "TESTMACHINE_001" };
        var equip2 = new Equipment { EquipmentId = "eq-2", UnsLineId = "line-1", Name = "TestMachine_002", MachineCode = "TESTMACHINE_002" };
        var script = new Script
        {
            ScriptId = "s-equip",
            Name = "over-50",
            SourceCode = "return System.Convert.ToInt32(ctx.GetTag(\"{{equip}}.Source\").Value) > 50;",
            SourceHash = "hash-equip",
        };
        var vt1 = new VirtualTag { VirtualTagId = "vt-1", EquipmentId = "eq-1", Name = "over50", DataType = "Boolean", ScriptId = "s-equip" };
        var vt2 = new VirtualTag { VirtualTagId = "vt-2", EquipmentId = "eq-2", Name = "over50", DataType = "Boolean", ScriptId = "s-equip" };

        var result = AddressSpaceComposer.Compose(
            new[] { area }, new[] { line }, new[] { equip1, equip2 },
            new[] { driver1, driver2 }, Array.Empty<ScriptedAlarm>(),
            virtualTags: new[] { vt1, vt2 },
            scripts: new[] { script });

        result.EquipmentVirtualTags.Count.ShouldBe(2);

        var plan1 = result.EquipmentVirtualTags.Single(p => p.VirtualTagId == "vt-1");
        plan1.Expression.ShouldContain("ctx.GetTag(\"TestMachine_001.Source\")");
        plan1.Expression.ShouldNotContain("{{equip}}");
        plan1.DependencyRefs.ShouldBe(new[] { "TestMachine_001.Source" });

        var plan2 = result.EquipmentVirtualTags.Single(p => p.VirtualTagId == "vt-2");
        plan2.Expression.ShouldContain("ctx.GetTag(\"TestMachine_002.Source\")");
        plan2.Expression.ShouldNotContain("{{equip}}");
        plan2.DependencyRefs.ShouldBe(new[] { "TestMachine_002.Source" });
    }
}