Documentation modifications

adas-core.Test/Customizations/HUVH/UCIA/CalculatedObservationsTest.cs

@@ -13,6 +13,13 @@ using Options = Microsoft.Extensions.Options.Options;
 
 namespace adas_core.Test.Customizations.HUVH.UCIA;
 
+/// <summary>
+/// Test fixture that validates the behavior of <see cref="CalculatedObservationsTest"/> related functionality within the test suite.
+/// </summary>
+/// <remarks>
+/// Marked with <c>TestFixture</c> and assigned <c>Order(2)</c> to control its execution sequence relative to other fixtures.
+/// </remarks>
+/// <!-- aidoc:v1 sig=d5b9e22 -->
 [TestFixture]
 [Order(2)]
 public class CalculatedObservationsTest
@@ -298,6 +305,10 @@ public class CalculatedObservationsTest
                 Times.Once);
         }
 
+    /// <summary>
+    /// Verifies that the mapping logic inserts a calculated ventilation mode observation when an <c>Air_Flow</c> <see cref="PatientObservation"/> is processed and the patient's coding system is <c>CCC</c>, ensuring the insert call is triggered exactly once.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=20f6c3b body=3db2e9e -->
     [Test]
     public async Task CalculateVentilationMode_Should_Insert_When_AirFlow_Arrives_And_CCC_Mode()
     {
@@ -488,6 +499,10 @@ public class CalculatedObservationsTest
             );
         }
 
+    /// <summary>
+    /// Verifies that the over-analgesia calculation does not create a new <see cref="PatientObservation"/> when the required conditions are not met: the source observation value falls below the expected threshold and the patient has no active <see cref="PatientTreatment"/>s.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=8fad758 body=1678766 -->
     [Test]
     public async Task CalculateOverAnalgesia_Should_Not_Create_Observation_When_Conditions_Are_Not_Met()
     {
@@ -547,6 +562,10 @@ public class CalculatedObservationsTest
             );
         }
 
+    /// <summary>
+    /// Verifies that driving pressure is not calculated nor persisted through <see cref="CalculatedObservations.Map"/> when the complementary <see cref="PatientObservation"/> required for the calculation is missing for the patient.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=5427d69 body=8449228 -->
     [Test]
     public async Task CalculateDrivingPressure_Should_Not_Calculate_If_Observation_Is_Missing()
     {
@@ -603,6 +622,13 @@ public class CalculatedObservationsTest
             );
         }
 
+    /// <summary>
+    /// Verifies that the ROX index mapping operation does not persist a calculated
+    /// <see cref="PatientObservation"/> when the required complementary observation
+    /// (needed to compute the ratio) cannot be retrieved, ensuring the calculation
+    /// is skipped instead of being stored with incomplete data.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=6d25e04 body=89d4d97 -->
     [Test]
     public async Task CalculateRoxIndex_Should_Not_Calculate_If_Observation_Is_Missing()
     {