Documentation modifications

adas-core.Application/Services/AppointmentService.cs

@@ -14,6 +14,13 @@ using Patient = adas_core.Domain.Models.MongoModels.Patient;
 
 namespace adas_core.Application.Services;
 
+/// <summary>
+/// Implements <see cref="IAppointmentService"/> to coordinate appointment management operations, persisting data through <see cref="IAppointmentRepository"/> and <see cref="IAppointmentArchiveRepository"/> while integrating supporting services such as <see cref="IPatientService"/>, <see cref="IObservationService"/>, <see cref="IDiagnosisService"/>, and <see cref="IUnitService"/>.
+/// </summary>
+/// <remarks>
+/// Defers initialization of <see cref="IPatientService"/> and <see cref="IObservationService"/> via <see cref="Lazy{T}"/>, reads configuration through <see cref="IOptions{TOptions}"/> bound to <c>ApiSettings</c> and <c>CacheSettings</c>, logs diagnostics with <see cref="ILogger{TCategoryName}"/>, and accesses the current request through <see cref="IHttpContextAccessor"/>. It also relies on <see cref="ILocalAuditService"/>, <see cref="IPointOfCareService"/>, <see cref="ISubscribersService"/>, <see cref="IClientMessageService"/>, and <see cref="ICacheService"/> to support auditing, point-of-care workflows, subscriber notifications, messaging, and caching.
+/// </remarks>
+/// <!-- aidoc:v1 sig=7de86ff -->
 public class AppointmentService(
     IAppointmentRepository appointmentRepository,
     IAppointmentArchiveRepository appointmentArchiveRepository,