Documentation modifications

adas-core.Application/Services/UnitService.cs

@@ -16,6 +16,13 @@ using Serilog;
 
 namespace adas_core.Application.Services;
 
+/// <summary>
+/// Implements <see cref="IUnitService"/>, coordinating unit-related operations by persisting data through <see cref="IUnitRepository"/> and integrating with patient, master list, subscriber, client messaging, point-of-care, and auditing services.
+/// </summary>
+/// <remarks>
+/// Collaborators exposed as <see cref="Lazy{T}"/> (<see cref="IPatientService"/> and <see cref="IClientMessageService"/>) are instantiated on demand. The service uses <see cref="ILogger{T}"/> for structured logging, <see cref="IHttpContextAccessor"/> to access the current HTTP context, and <see cref="ILocalAuditService"/> to record audit entries.
+/// </remarks>
+/// <!-- aidoc:v1 sig=690f007 -->
 public class UnitService(
     IUnitRepository unitRepository,
     Lazy<IPatientService> patientService,