Documentation modifications

adas-core.Test/Services/PointOfCareServiceTest.cs

@@ -14,6 +14,13 @@ using Options = Microsoft.Extensions.Options.Options;
 
 namespace adas_core.Test.Services;
 
+/// <summary>
+/// Test fixture that exercises the behavior of <see cref="PointOfCareService"/>.
+/// </summary>
+/// <remarks>
+/// Marked with <see cref="TestFixtureAttribute"/> so that the test runner discovers and executes the contained test methods.
+/// </remarks>
+/// <!-- aidoc:v1 sig=4b0404e -->
 [TestFixture]
 public class PointOfCareServiceTests
 {
@@ -210,6 +217,13 @@ public class PointOfCareServiceTests
             Assert.That(result, Is.EqualTo(expectedPointOfCareList));
         }
 
+    /// <summary>
+    /// Verifies that <see cref="PointOfCareService.CheckNextAdmission"/> resolves the <see cref="PointOfCare"/> through the cache factory,
+    /// looks up the next <see cref="Admission"/> when <see cref="PointOfCare.AdmissionId"/> is null, assigns it to the PoC,
+    /// transitions the <see cref="StatusEnum.PointOfCare"/> status to Reserved, and invokes <see cref="IPointOfCareRepository.Update"/> exactly once,
+    /// without taking the <c>FindByIdAllConfig</c> code path.
+    /// </summary>
+    /// <!-- aidoc:v1 sig=32ec21f body=2809040 -->
     [Test]
     public void CheckNextAdmission_ValidPatientLocation_UpdatesPoCStatus_AndCallsUpdate()
     {