Documentation modifications

adas-core.Application/Services/AdminPanelService.cs

@@ -13,6 +13,13 @@ using Patient = adas_core.Domain.Models.MongoModels.Patient;
 
 namespace adas_core.Application.Services;
 
+/// <summary>
+/// Provides the administrative panel operations defined by <see cref="IAdminPanelService"/>, integrating patient, admission, discharge, authentication, medicine, point-of-care, unit, display, and configurable observation services.
+/// </summary>
+/// <remarks>
+/// The service receives its collaborators through primary constructor injection, including <see cref="IPatientService"/>, <see cref="IAdmissionService"/>, <see cref="IDischargeService"/>, <see cref="IAuthService"/>, <see cref="IMedicineService"/>, <see cref="IPointOfCareService"/>, <see cref="IUnitService"/>, <see cref="IDisplayService"/>, and <see cref="IConfigObservationService"/>, along with configuration via <see cref="IOptions{ApiSettings}"/> and logging through <see cref="ILogger{AdminPanelService}"/>.
+/// </remarks>
+/// <!-- aidoc:v1 sig=29af4d8 -->
 public class AdminPanelService(
     IOptions<ApiSettings> apiSettings,
     IPatientService patientService,
@@ -205,6 +212,12 @@ public class AdminPanelService(
             return true;
         }
 
+    /// <summary>
+    /// Updates the location of a patient identified by the source location in <paramref name="request"/>, relocating any occupant of the target location to the <see cref="VirtualPointOfCare.Pushed"/> point of care and creating a new <see cref="Patient"/> record when no matching patient is found.
+    /// </summary>
+    /// <param name="request">The <see cref="AdmPanelRequest"/> containing the original and the target <see cref="PatientLocation"/> values used to find and reassign the patient.</param>
+    /// <returns>A <see cref="Task{Boolean}"/> that resolves to <c>true</c> once the update or insertion has completed.</returns>
+    /// <!-- aidoc:v1 sig=d2e1ae3 body=d053266 -->
     public async Task<bool> UpdatePatientLocation(AdmPanelRequest request)
     {
         var patient = await patientService.FindByLocation(request.OldLocation);