Documentation modifications

adas-core.Test/Repositories/PumpArchiveRepositoryTest.cs

@@ -9,10 +9,24 @@ using Options = Microsoft.Extensions.Options.Options;
 
 namespace adas_core.Test.Repositories;
 
+/// <summary>
+/// Integration test fixture that validates the behavior of the <c>PumpArchiveRepository</c> against its real dependencies rather than mocked collaborators.
+/// </summary>
+/// <remarks>
+/// Categorized as <c>Integration</c> so it can be filtered separately from unit tests during test execution.
+/// </remarks>
+/// <!-- aidoc:v1 sig=c26548c -->
 [TestFixture]
 [Category("Integration")]
 public class PumpArchiveRepositoryTest
 {
+    /// <summary>
+    /// Performs one-time initialization for the test fixture by seeding two <see cref="PumpObservation"/>
+    /// records into the archive collection: one with the current timestamp and another with a timestamp
+    /// ten days in the past, enabling tests of the <see cref="PumpArchiveRepository"/> archive behavior
+    /// across different observation times.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=81c0015 body=344b169 -->
     [OneTimeSetUp]
     public async Task Init()
     {