📝 Add docstrings to LNK-4651-AddHic-Type-for-AdhocReportGeneration

Docstrings generation was requested by @arianamihailescu.

* #1345 (comment)

The following files were modified:

* `DotNet/Report/Application/Factory/ScheduledReportFactory.cs`
* `DotNet/Report/Listeners/GenerateReportListener.cs`

Author: coderabbitai[bot]

DotNet/Report/Application/Factory/ScheduledReportFactory.cs

@@ -7,6 +7,11 @@ namespace LantanaGroup.Link.Report.Application.Factory;
 
 public class ScheduledReportFactory
 {
+    /// <summary>
+    /// Create a ScheduledReportListSummary populated from the provided ReportSchedule domain model.
+    /// </summary>
+    /// <param name="reportScheduleModel">The domain ReportSchedule to map into a summary object.</param>
+    /// <returns>A ScheduledReportListSummary with fields copied from <paramref name="reportScheduleModel"/>; `Id` is the empty string if the source Id is null, and `Submitted` is `true` when `SubmitReportDateTime` has a value.</returns>
     public ScheduledReportListSummary FromDomain(ReportSchedule reportScheduleModel)
     {
         return new ScheduledReportListSummary()

DotNet/Report/Listeners/GenerateReportListener.cs

@@ -1,4 +1,4 @@
-using Confluent.Kafka;
+using Confluent.Kafka;
 using Confluent.Kafka.Extensions.Diagnostics;
 using Hl7.Fhir.Model;
 using Hl7.Fhir.Serialization;
@@ -93,6 +93,10 @@ protected override Task ExecuteAsync(CancellationToken stoppingToken)
         }
 
 
+        /// <summary>
+        /// Runs the Kafka consumer loop that processes GenerateReportRequested messages to schedule or regenerate reports, create patient submission entries, and emit downstream events (evaluation requests or data-acquisition requests).
+        /// </summary>
+        /// <param name="cancellationToken">Token used to stop the consumer loop and cancel in-flight operations.</param>
         private async Task StartConsumerLoop(CancellationToken cancellationToken)
         {
             var config = new ConsumerConfig()
@@ -422,4 +426,4 @@ private static string GetFacilityIdFromHeader(Headers headers)
             return facilityId;
         }
     }
-}
+}