Documentation modifications

adas-core.Test/Repositories/PumpAlarmStateRepositoryTest.cs

@@ -8,6 +8,13 @@ using MongoDB.Driver;
 
 namespace adas_core.Test.Repositories;
 
+/// <summary>
+/// Integration test fixture that validates the behavior of <see cref="PumpAlarmStateRepository"/>.
+/// </summary>
+/// <remarks>
+/// All tests in this fixture belong to the Integration category and are expected to depend on external infrastructure.
+/// </remarks>
+/// <!-- aidoc:v1 sig=879ce74 -->
 [TestFixture]
 [Category("Integration")]
 public class PumpAlarmStateRepositoryTest
@@ -141,6 +148,10 @@ public class PumpAlarmStateRepositoryTest
             Assert.That(found, Is.Not.Null);
         }
 
+    /// <summary>
+    /// Verifies that the upsert operation updates an existing active <see cref="PumpAlarmState"/> record instead of inserting a duplicate, replacing the previous <see cref="PumpAlarmState.LastUpdated"/> timestamp while ignoring the supplied <see cref="PumpAlarmState.Id"/>.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=0dc3309 body=3185eb8 -->
     [Test]
     public async Task UpsertActiveAsync_UpdatesExisting()
     {
@@ -273,6 +284,10 @@ public class PumpAlarmStateRepositoryTest
             }
         }
     
+    /// <summary>
+    /// Verifies that invoking the upsert operation twice with the same <see cref="PumpAlarmState"/> keeps the active alarm set unique per device, confirming the operation is idempotent and does not insert duplicate records.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=24cec53 body=37f0fc6 -->
     [Test]
     public async Task UpsertActiveAsync_NoDuplicateOnRepeatedCalls()
     {