=== 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) ===

2026-06-28 02:50:05 -07:00
parent a19fb90902
commit 586f02a2ca
654 changed files with 5260 additions and 0 deletions
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents an observation that conveys a boolean value, extending the base <see cref="Observation"/> type.
 /// </summary>
+/// <!-- aidoc:v1 sig=16d4255 -->
 public class BoolObservation : Observation
 {
    public bool Value { get; set; }
@@ -13,6 +14,7 @@ public class BoolObservation : Observation
    /// </summary>
    /// <param name="obs">The list of patient observations from which the first entry is converted.</param>
    /// <returns>A <see cref="BoolObservation"/> containing the boolean value of the first observation, or <see langword="null"/> if the list contains no observations.</returns>
+    /// <!-- aidoc:v1 sig=42167d6 body=3489a3a -->
    internal static BoolObservation? From(List<PatientObservation> obs)
        {
            if (obs.Count > 0)
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents an observation that is associated with a chart, providing chart-specific contextual data derived from the base <see cref="Observation"/> type.
 /// </summary>
+/// <!-- aidoc:v1 sig=f15917b -->
 public class ChartObservation : Observation
 {
    public List<double> Values { get; set; } = [];
@@ -20,6 +21,7 @@ public class ChartObservation : Observation
    /// <param name="obs">The list of patient observations to convert.</param>
    /// <returns>A new <see cref="ChartObservation"/> instance.</returns>
    /// <exception cref="ArgumentNullException">Thrown when <paramref name="obs"/> is null.</exception>
+    /// <!-- aidoc:v1 sig=7d736f9 body=29be5c3 -->
    internal static ChartObservation From(List<PatientObservation> obs)
        {
            return obs == null ? throw new ArgumentNullException(nameof(obs)) : new ChartObservation();
@@ -6,6 +6,7 @@ namespace adas_core.Domain.Models.Observations;
 /// Represents an observation that captures a double-precision floating-point measurement or value.
 /// Inherits from the base <see cref="Observation"/> type, providing a specialized observation variant for numeric data of type <see cref="double"/>.
 /// </summary>
+/// <!-- aidoc:v1 sig=bb4c3dc -->
 public class DoubleObservation : Observation
 {
    public double? Value { get; set; }
@@ -16,6 +17,7 @@ public class DoubleObservation : Observation
    /// </summary>
    /// <param name="obs">The list of patient observations to convert. At least one element is required to produce a result.</param>
    /// <returns>A <see cref="DoubleObservation"/> populated with the converted double values, or <c>null</c> if the list is empty.</returns>
+    /// <!-- aidoc:v1 sig=0b5761e body=41f15e7 -->
    public static DoubleObservation? From(List<PatientObservation> obs)
        {
            if (obs.Count > 0)
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a complete observation as a specialized form of the <see cref="Observation"/> base class.
 /// </summary>
+/// <!-- aidoc:v1 sig=2c8f902 -->
 public class FullObservation : Observation
 {
    public DateTime LastObservationDate;
@@ -25,6 +26,7 @@ public class FullObservation : Observation
    /// </summary>
    /// <param name="obs">The list of patient observations to convert; only the first two entries are used when present.</param>
    /// <returns>A <see cref="FullObservation"/> built from the first observation, or <c>null</c> if <paramref name="obs"/> contains no items.</returns>
+    /// <!-- aidoc:v1 sig=aca4f16 body=dd762ba -->
    public static FullObservation? From(List<PatientObservation> obs)
        {
            if (obs.Count > 0)
@@ -9,6 +9,7 @@ namespace adas_core.Domain.Models.Observations;
 /// <remarks>
 /// Serves as a specialized observation for capturing and modeling medication-specific data within the inheritance hierarchy.
 /// </remarks>
+/// <!-- aidoc:v1 sig=a00759f -->
 public class Medication : Observation
 {
    /// <summary>
@@ -65,6 +66,7 @@ public class Medication : Observation
 /// <summary>
 /// Represents a value or data entry associated with a drug, such as dosage, concentration, or other pharmaceutical-related information.
 /// </summary>
+/// <!-- aidoc:v1 sig=a9fb501 -->
 public class DrugValue
 {
    /// <summary>
@@ -102,6 +104,7 @@ public class DrugValue
    /// Copies the values from the specified <see cref="DrugValue"/> instance into the current instance, replacing the existing Id, Text, Units, Time, CodingSystem, and Result properties.
    /// </summary>
    /// <param name="common">The <see cref="DrugValue"/> instance whose property values will be copied to the current instance.</param>
+    /// <!-- aidoc:v1 sig=04f2026 body=2cd00f7 -->
    public void Copy(DrugValue common)
        {
            Id = common.Id;
@@ -119,6 +122,7 @@ public class DrugValue
 /// <remarks>
 /// As an abstract class, it must be inherited by a derived class that supplies the concrete implementation for the double-based drug value behavior.
 /// </remarks>
+/// <!-- aidoc:v1 sig=2c61895 -->
 public abstract class DrugDoubleValue : DrugValue
 {
    /// <summary>
@@ -141,6 +145,7 @@ public abstract class DrugDoubleValue : DrugValue
 /// <remarks>
 /// Inherits from <see cref="DrugValue"/> and is intended to be derived by concrete classes that encapsulate string-typed drug data associated with a <see cref="PumpElement"/>.
 /// </remarks>
+/// <!-- aidoc:v1 sig=b31b430 -->
 public abstract class DrugStringValue(PumpElement pumpElement) : DrugValue(pumpElement)
 {
    public string? Value { get; set; } = pumpElement.Value?.ToString();
@@ -149,6 +154,7 @@ public abstract class DrugStringValue(PumpElement pumpElement) : DrugValue(pumpE
 /// <summary>
 /// Represents a double-precision drug value that describes the flow of a fluid for the specified <see cref="PumpElement"/>.
 /// </summary>
+/// <!-- aidoc:v1 sig=afae0d5 -->
 public class FlowFluid(PumpElement pumpElement) : DrugDoubleValue(pumpElement);

 /// <summary>
@@ -157,6 +163,7 @@ public class FlowFluid(PumpElement pumpElement) : DrugDoubleValue(pumpElement);
 /// <remarks>
 /// Inherits from <see cref="DrugDoubleValue"/>, sharing the pump element context with its base type.
 /// </remarks>
+/// <!-- aidoc:v1 sig=e2e9e55 -->
 public class VolumeFluidDeliveryTotal(PumpElement pumpElement) : DrugDoubleValue(pumpElement);

 /// <summary>
@@ -165,11 +172,13 @@ public class VolumeFluidDeliveryTotal(PumpElement pumpElement) : DrugDoubleValue
 /// <remarks>
 /// Inherits from <see cref="DrugDoubleValue"/> and is constructed with a <see cref="PumpElement"/> instance that is forwarded to the base constructor.
 /// </remarks>
+/// <!-- aidoc:v1 sig=8d4645b -->
 public class PumpDeliveryPressure(PumpElement pumpElement) : DrugDoubleValue(pumpElement);

 /// <summary>
 /// Represents the remaining volume of fluid to be infused (TBI) associated with a pump element, implemented as a drug-related double value.
 /// </summary>
+/// <!-- aidoc:v1 sig=dc8c1c6 -->
 public class VolumeFluidTbiRemain(PumpElement pumpElement) : DrugDoubleValue(pumpElement);

 /// <summary>
@@ -178,12 +187,14 @@ public class VolumeFluidTbiRemain(PumpElement pumpElement) : DrugDoubleValue(pum
 /// <remarks>
 /// Inherits from <see cref="DrugDoubleValue"/> and is constructed with a <see cref="PumpElement"/> to capture time-related fluid volume metrics.
 /// </remarks>
+/// <!-- aidoc:v1 sig=9b38fa5 -->
 public class VolumeFluidTimePdRemain(PumpElement pumpElement) : DrugDoubleValue(pumpElement);

 /// <summary>
 /// Represents the active sources of a pump element as a drug string value.
 /// Inherits from <see cref="DrugStringValue"/>, encapsulating source information for pump operations.
 /// </summary>
+/// <!-- aidoc:v1 sig=ded4b3d -->
 public class PumpActiveSources(PumpElement pumpElement) : DrugStringValue(pumpElement)
 {
    public string? ValueId { get; set; } = pumpElement.ValueId;
@@ -193,11 +204,13 @@ public class PumpActiveSources(PumpElement pumpElement) : DrugStringValue(pumpEl
 /// <summary>
 /// Represents a drug value associated with a pump element, inheriting from the DrugStringValue base class.
 /// </summary>
+/// <!-- aidoc:v1 sig=284cad0 -->
 public class Drug(PumpElement pumpElement) : DrugStringValue(pumpElement);

 /// <summary>
 /// Represents a pump mode as a drug-related string value, inheriting string-based value semantics from <see cref="DrugStringValue"/>.
 /// </summary>
+/// <!-- aidoc:v1 sig=d46f699 -->
 public class PumpMode : DrugStringValue
 {
    /// <summary>
@@ -214,6 +227,7 @@ public class PumpMode : DrugStringValue
 /// <summary>
 /// Represents the operational status of a pump as a drug-related string value.
 /// </summary>
+/// <!-- aidoc:v1 sig=b46795e -->
 public class PumpStatus : DrugStringValue
 {
    /// <summary>
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a single observation or recorded data point.
 /// </summary>
+/// <!-- aidoc:v1 sig=3ba0a3e -->
 public class Observation
 {
 }
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a paginated collection of observation results, typically used to return a subset of observations along with associated pagination metadata.
 /// </summary>
+/// <!-- aidoc:v1 sig=088f64b -->
 public class ObservationPaginatedResult
 {
    public int Count { get; set; } = 0;
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a request for retrieving observations data, typically used to encapsulate query parameters or filtering criteria when interacting with an observations service or repository.
 /// </summary>
+/// <!-- aidoc:v1 sig=c2fdd1a -->
 public class ObservationsRequest
 {
    public string? PatientNumber { get; set; }
@@ -3,6 +3,7 @@
 /// <summary>
 /// Represents a prediction result or data model for medication observation.
 /// </summary>
+/// <!-- aidoc:v1 sig=bf83932 -->
 public class PredictMedicationObservation
 {
    public string MedicineText { get; set; } = string.Empty;
@@ -6,6 +6,7 @@
 /// <remarks>
 /// This class specializes the Observation concept for textual or string-based content, inheriting the core observation behavior from its parent class.
 /// </remarks>
+/// <!-- aidoc:v1 sig=9cacd8d -->
 public class StringObservation : Observation
 {
    public string Value { get; set; } = string.Empty;
@@ -16,6 +17,7 @@ public class StringObservation : Observation
    /// </summary>
    /// <param name="obs">The list of <see cref="PatientObservation"/> instances to convert.</param>
    /// <returns>A <see cref="StringObservation"/> populated with the string value of the first observation, or <c>null</c> if the list contains no elements.</returns>
+    /// <!-- aidoc:v1 sig=ae5156f body=38bc202 -->
    public static StringObservation? From(List<PatientObservation> obs)
        {
            if (obs.Count > 0)