Documentation modifications

adas-core.Application/Services/PointOfCareService.cs

@@ -17,6 +17,20 @@ using MongoDB.Driver;
 
 namespace adas_core.Application.Services;
 
+/// <summary>
+/// Implements <see cref="IPointOfCareService"/> to provide point-of-care business logic that
+/// coordinates persistence, patient, unit, admission, messaging, audit, and caching concerns
+/// through its injected collaborators.
+/// </summary>
+/// <remarks>
+/// The service uses <see cref="IPointOfCareRepository"/> for data access and <see cref="ILogger{T}"/>
+/// for logging. <see cref="IPatientService"/>, <see cref="IUnitService"/>,
+/// <see cref="IClientMessageService"/>, and <see cref="IAdmissionService"/> are resolved lazily
+/// via <see cref="Lazy{T}"/>. Additional collaborators include <see cref="ISubscribersService"/>,
+/// <see cref="ILocalAuditService"/>, <see cref="ICacheService"/>, <see cref="IHttpContextAccessor"/>,
+/// and <see cref="IOptions{TOptions}"/> bound to CacheSettings.
+/// </remarks>
+/// <!-- aidoc:v1 sig=0a9722c -->
 public class PointOfCareService(
     ILogger<PointOfCareService> logger,
     IPointOfCareRepository pointOfCareRepository,