=== Summary: 675 files | 7 generated | 484 fresh | 4605 untracked | 4268 adopted | 355 marked | 466 validated-ok | 2+0 stale (sig+body) | 0 skipped | 0 failed | elapsed 11:08:11.442 (40091.44s) ===

adas-core.Application/Customizations/CHUO/CalculatedObservations.cs

@@ -14,6 +14,7 @@ namespace adas_core.Application.Customizations.CHUO;
 /// <remarks>
 /// Instances are constructed with an <see cref="IServiceProvider"/> used to resolve dependencies required by the implementation.
 /// </remarks>
+/// <!-- aidoc:v1 sig=c3598e8 -->
 public class CalculatedObservations(IServiceProvider serviceProvider) : ICalculatedObservations
 {
     private readonly ILogger<CalculatedObservations> _logger =
@@ -23,6 +24,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// Asynchronously calculates the active bolus for the specified patient.
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient for whom the active bolus is being calculated.</param>
+    /// <!-- aidoc:v1 sig=7d38721 body=6805ef5 -->
     public Task CalculateActiveBolus(ObjectId patientId)
     {
         return Task.CompletedTask;
@@ -33,6 +35,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="pumpObservation">The pump observation to map.</param>
     /// <returns>A <see cref="Task{PumpObservation}"/> containing the provided pump observation.</returns>
+    /// <!-- aidoc:v1 sig=50be4c1 body=e481734 -->
     public async Task<PumpObservation> Map(PumpObservation pumpObservation)
     {
         return await Task.FromResult(pumpObservation);
@@ -43,6 +46,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="activeMedicines">The list of medicines currently active for the patient.</param>
     /// <param name="patientId">The identifier of the patient for whom the observation is calculated.</param>
+    /// <!-- aidoc-review:v1 severity=low kind=stale_summary
+    ///      "Method body returns Task.CompletedTask and does not actually perform any medicine observation calculation; the summary describes intended/pending behavior." -->
     public Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         return Task.CompletedTask;
@@ -55,6 +60,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="newObservation">The new patient observation to compare and reconcile against the last stored observation.</param>
     /// <returns>A task that yields the corrected <see cref="PatientObservation"/>, or <c>null</c> when no time inconsistency is found.</returns>
     /// <exception cref="NotImplementedException">Thrown because the method has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=cb71754 body=bfa6f2f -->
     public Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
     {
         throw new NotImplementedException();
@@ -66,6 +72,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="id">The unique identifier of the patient whose active treatments are being requested.</param>
     /// <returns>A task that represents the asynchronous operation. The task result contains a collection of nullable <see cref="PatientTreatment"/> objects representing the patient's active treatments.</returns>
     /// <exception cref="NotImplementedException">Thrown to indicate that the method has not yet been implemented.</exception>
+    /// <!-- aidoc:v1 sig=db74f82 body=bfa6f2f -->
     public Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         throw new NotImplementedException();
@@ -77,6 +84,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="obs">The patient observation to map.</param>
     /// <param name="onlyByName">Indicates whether mapping should be performed by name only.</param>
     /// <returns>A task containing the provided observation.</returns>
+    /// <!-- aidoc:v1 sig=21d06c4 body=8f6255b -->
     public Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation
     {
         _logger.LogTrace("Mapping {name} observation {obs}", obs.Name, obs);
@@ -91,6 +99,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="treatment">The patient treatment to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the resulting <see cref="PatientTreatment"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown when the method is invoked, as the mapping has not been implemented.</exception>
+    /// <!-- aidoc:v1 sig=adce250 body=bfa6f2f -->
     public Task<PatientTreatment> Map(PatientTreatment treatment)
     {
         throw new NotImplementedException();
@@ -102,6 +111,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="diagnosis">The patient diagnosis to be mapped.</param>
     /// <returns>A task representing the asynchronous operation, containing the mapped <see cref="PatientDiagnosis"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown because the mapping logic has not yet been implemented.</exception>
+    /// <!-- aidoc:v1 sig=8ddf601 body=bfa6f2f -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
     {
         throw new NotImplementedException();
@@ -113,6 +123,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to be pre-mapped prior to insertion.</param>
     /// <returns>A completed task containing the provided list of patient observations.</returns>
+    /// <!-- aidoc:v1 sig=5a37e9b body=0791af0 -->
     public Task<List<PatientObservation>> PreMapList(List<PatientObservation> listToInsert)
     {
         return Task.FromResult(listToInsert);
@@ -124,6 +135,7 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="obs">The existing patient observation to be returned.</param>
     /// <param name="alarmToInsert">The alarm to be associated with the observation (currently not applied).</param>
     /// <returns>A completed <see cref="Task{PatientObservation}"/> containing the original observation.</returns>
+    /// <!-- aidoc:v1 sig=405db8e body=ea790e4 -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
     {
         return Task.FromResult(obs);
@@ -135,6 +147,8 @@ public class CalculatedObservations(IServiceProvider serviceProvider) : ICalcula
     /// <param name="obs">The patient observation that triggers the alarm.</param>
     /// <param name="name">The name of the alarm to send.</param>
     /// <param name="code">The optional alarm code providing additional classification for the alarm.</param>
+    /// <!-- aidoc-review:v1 severity=low kind=missing_returns
+    ///      "Method returns Task but no <returns> tag is present to describe the asynchronous result." -->
     public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
     {
         return Task.CompletedTask;