=== 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/HGM/CalculatedObservations.cs

@@ -14,6 +14,7 @@ namespace adas_core.Application.Customizations.HGM;
 /// <summary>
 /// Represents a collection of calculated observations, providing a concrete implementation of the <see cref="ICalculatedObservations"/> contract.
 /// </summary>
+/// <!-- aidoc:v1 sig=1b16cfc -->
 public class CalculatedObservations : ICalculatedObservations
 {
     private readonly List<string> _highFrequencyVentilation = [];
@@ -51,6 +52,8 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation to be mapped.</param>
     /// <param name="onlyByName">Flag indicating whether the mapping should be restricted to name-based criteria.</param>
     /// <returns>The mapped patient observation, or the original observation if no applicable mapping is found.</returns>
+    /// <!-- aidoc-review:v1 severity=medium kind=stale_summary
+    ///      "The onlyByName parameter is documented as a 'Flag indicating whether the mapping should be restricted to name-based criteria,' but the parameter is never used in the method body. The switch statement processes cases based on name regardless of this flag." -->
     public async Task<T?> Map<T>(T obs, bool onlyByName = false) where T : BasePatientObservation
     {
         if (string.IsNullOrEmpty(obs.Name)) return obs;
@@ -72,6 +75,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="treatment">The <see cref="PatientTreatment"/> instance to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the resulting <see cref="PatientTreatment"/>.</returns>
     /// <exception cref="System.NotImplementedException">Thrown to indicate that the method has not yet been implemented.</exception>
+    /// <!-- aidoc:v1 sig=adce250 body=bfa6f2f -->
     public Task<PatientTreatment> Map(PatientTreatment treatment)
     {
         throw new NotImplementedException();
@@ -83,6 +87,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="diagnosis">The patient diagnosis to be mapped.</param>
     /// <returns>A task that represents the asynchronous mapping operation, containing the mapped <see cref="PatientDiagnosis"/>.</returns>
     /// <exception cref="NotImplementedException">Thrown when the method is invoked, as the mapping logic has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=8ddf601 body=bfa6f2f -->
     public Task<PatientDiagnosis> Map(PatientDiagnosis diagnosis)
     {
         throw new NotImplementedException();
@@ -93,6 +98,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="pumpObservation">The pump observation to map.</param>
     /// <returns>A completed task containing the provided <see cref="PumpObservation"/>.</returns>
+    /// <!-- aidoc:v1 sig=50be4c1 body=e481734 -->
     public async Task<PumpObservation> Map(PumpObservation pumpObservation)
     {
         return await Task.FromResult(pumpObservation);
@@ -104,6 +110,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="patientId">The unique identifier of the patient for whom the active bolus is calculated.</param>
     /// <exception cref="NotImplementedException">The method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=7d38721 body=bfa6f2f -->
     public Task CalculateActiveBolus(ObjectId patientId)
     {
         throw new NotImplementedException();
@@ -115,6 +122,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="activeMedicines">The list of active medicines currently associated with the patient.</param>
     /// <param name="patientId">The unique identifier of the patient for whom the observation is being calculated.</param>
     /// <exception cref="NotImplementedException">The method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=b7a50a4 body=bfa6f2f -->
     public Task CalculateMedicineObservation(List<Medicine> activeMedicines, ObjectId patientId)
     {
         throw new NotImplementedException();
@@ -126,6 +134,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="newObservation">The new patient observation to reconcile against the last recorded observation.</param>
     /// <returns>A task that returns the corrected <see cref="PatientObservation"/>, or <c>null</c> when no last observation is available to compare against.</returns>
     /// <exception cref="System.NotImplementedException">The method is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=cb71754 body=bfa6f2f -->
     public Task<PatientObservation?> FixTimeInconsistencyWithLast(PatientObservation newObservation)
     {
         throw new NotImplementedException();
@@ -137,6 +146,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="id">The identifier of the patient whose active treatments are being requested.</param>
     /// <returns>A task that yields a collection of active <see cref="PatientTreatment"/> entries for the patient.</returns>
     /// <exception cref="NotImplementedException">Thrown because the method has not been implemented yet.</exception>
+    /// <!-- aidoc:v1 sig=db74f82 body=bfa6f2f -->
     public Task<IEnumerable<PatientTreatment?>> GetActiveTreatmentsByPatient(ObjectId id)
     {
         throw new NotImplementedException();
@@ -147,6 +157,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// </summary>
     /// <param name="listToInsert">The list of patient observations to be pre-mapped.</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);
@@ -158,6 +169,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="obs">The patient observation to return as the mapped result.</param>
     /// <param name="alarmToInsert">The patient observation alarm to be considered during mapping.</param>
     /// <returns>A <see cref="Task{PatientObservation}"/> containing the provided <paramref name="obs"/>.</returns>
+    /// <!-- aidoc:v1 sig=405db8e body=ea790e4 -->
     public Task<PatientObservation> MapSourceAlarm(PatientObservation obs, PatientObservationAlarm alarmToInsert)
     {
         return Task.FromResult(obs);
@@ -171,6 +183,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// <param name="code">The optional alarm code identifying the alarm type.</param>
     /// <returns>A task that represents the asynchronous alarm sending operation.</returns>
     /// <exception cref="NotImplementedException">Thrown when the method is invoked, as it is not yet implemented.</exception>
+    /// <!-- aidoc:v1 sig=90426a4 body=bfa6f2f -->
     public Task SendAlarm(PatientObservation obs, string name, AlarmEnum.Name? code)
     {
         throw new NotImplementedException();
@@ -180,6 +193,7 @@ public class CalculatedObservations : ICalculatedObservations
     /// Calculates and persists the ventilation mode (<c>Resp_Type</c>) for a patient observation by mapping the observed value against known high-frequency, invasive, and non-invasive ventilation vocabularies, defaulting to <c>None</c> when the value is empty or unrecognized.
     /// </summary>
     /// <param name="obs">The base patient observation whose value is used to derive the respiration type; it is cast to <see cref="PatientObservation"/> to access the value.</param>
+    /// <!-- aidoc:v1 sig=dd5b490 body=f8d6b73 -->
     private async Task CalculateVentilationMode(BasePatientObservation obs)
     {
         var pobs = (PatientObservation)obs;