=== 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.Domain/Models/BasePatientObservation.cs

@@ -11,6 +11,7 @@ namespace adas_core.Domain.Models;
 /// <remarks>
 /// This type is intended to be subclassed by concrete converters that implement specific serialization and deserialization logic for patient observation types.
 /// </remarks>
+/// <!-- aidoc:v1 sig=d585833 -->
 public class BasePatientObservation : JsonConverter
 {
     public ObjectId Id { get; set; }
@@ -50,6 +51,7 @@ public class BasePatientObservation : JsonConverter
     /// Falls back to the base <see cref="object.ToString"/> implementation if JSON serialization fails.
     /// </summary>
     /// <returns>A JSON-formatted string of the object, or the result of <c>base.ToString()</c> if serialization throws an exception; may be <see langword="null"/> only if the underlying <c>ToString()</c> returns <see langword="null"/>.</returns>
+    /// <!-- aidoc:v1 sig=5e4fc16 body=7f15aa0 -->
     public string? ToJsonString()
         {
             try
@@ -66,6 +68,7 @@ public class BasePatientObservation : JsonConverter
     /// Returns a string representation of the patient observation, including its identifier, patient identifier, timestamp, and conditionally included optional fields (such as system identifier, code, coding system, end time, name, and units) when they have values. Any child creation observations are also appended to the output.
     /// </summary>
     /// <returns>A formatted string that lists the patient observation properties prefixed with <c>BasePatientObservation[</c> and suffixed with <c>]</c>.</returns>
+    /// <!-- aidoc:v1 sig=d27f326 body=128cf3b -->
     public override string ToString()
         {
             List<string> items =
@@ -90,6 +93,7 @@ public class BasePatientObservation : JsonConverter
     /// Converts the current object's properties into a list of formatted key-value strings, including core identifiers and timestamp, and conditionally appending optional fields only when they contain values.
     /// </summary>
     /// <returns>A list of strings where each entry is formatted as "key: value" representing the object's properties.</returns>
+    /// <!-- aidoc:v1 sig=ea52c68 body=e7737e2 -->
     public List<string> ToListString()
         {
             List<string> items =
@@ -111,6 +115,7 @@ public class BasePatientObservation : JsonConverter
     /// </summary>
     /// <param name="objectType">The type to evaluate for conversion support.</param>
     /// <returns><c>true</c> if <paramref name="objectType"/> is <see cref="BasePatientObservation"/>; otherwise, <c>false</c>.</returns>
+    /// <!-- aidoc:v1 sig=ee00023 body=5861409 -->
     public override bool CanConvert(Type objectType)
         {
             return objectType == typeof(BasePatientObservation);
@@ -122,6 +127,7 @@ public class BasePatientObservation : JsonConverter
     /// <param name="writer">The <see cref="JsonWriter"/> to which the filtered JSON will be written.</param>
     /// <param name="value">The object to serialize. If <see langword="null"/>, nothing is written.</param>
     /// <param name="serializer">The <see cref="JsonSerializer"/> used during the conversion process.</param>
+    /// <!-- aidoc:v1 sig=0bafa81 body=d69e337 -->
     public override void WriteJson(JsonWriter writer, object? value, JsonSerializer serializer)
         {
             if (value == null) return;
@@ -141,6 +147,8 @@ public class BasePatientObservation : JsonConverter
     /// <param name="serializer">The serializer instance performing the deserialization.</param>
     /// <returns>An object instance built from the JSON data.</returns>
     /// <exception cref="NotImplementedException">Always thrown because the method has not been implemented.</exception>
+    /// <!-- aidoc-review:v1 severity=high kind=wrong_returns
+    ///      "The <returns> tag states 'An object instance built from the JSON data', but the method always throws NotImplementedException and never returns an object instance." -->
     public override object ReadJson(JsonReader reader, Type objectType, object? existingValue,
             JsonSerializer serializer)
         {
@@ -152,6 +160,7 @@ public class BasePatientObservation : JsonConverter
 /// Represents a parent data class that serves as a base container for shared data members and functionality.
 /// Provides a foundational structure intended to be inherited by more specific data classes.
 /// </summary>
+/// <!-- aidoc:v1 sig=46770a1 -->
 public class ParentDataClass
 {
     public string? Code { get; set; }